Skip to content
Apothem
Référence

Arbre de hiérarchie des répertoires

Carte visuelle de la structure de l'arbre des sources d'Apothem montrant les artefacts de configuration de l'écosystème, les niveaux d'exécution et l'emplacement des règles, commandes, compétences, travailleurs délégués, hooks et fichiers de support.

La carte structurelle canonique de l'arbre des sources d'Apothem rendue sous forme de graphe Mermaid. Chaque adaptateur per-harness sous src/apothem/harnesses/<harness>/ projette cet arbre dans le répertoire de configuration natif du harness (par exemple ~/.claude/ pour Claude Code). Chaque classe d'artefact déclarée à la Section 7 de CLAUDE.md y trouve sa place. Les répertoires d'état d'exécution (locaux à la machine, dans gitignore) sont inclus pour l'orientation mais ne contiennent jamais d'artefacts de configuration de l'écosystème.

Disposition

%%{ init: { "theme": "neutral" } }%%
%% verified: 2026-06-16 %%
%% provenance: README.md (Quick Start · Location) %%
%% cross-reference: site/content/docs/architecture/source-layout.mdx (Directory Layout summary) %%
graph TD
    accTitle: Apothem repository layout tree
    accDescr: Top-down tree showing every top-level directory of the apothem repository with its purpose and key contents as a comprehensive navigation reference for contributors.
    ROOT["apothem source tree<br/>(materializes into the harness config<br/>directory — e.g. ~/.claude/ for Claude Code)"]
    ROOT --> CONFIG_FILES["Config files<br/>CLAUDE.md · README.md · CHANGELOG.md<br/>settings.json<br/>pyproject.toml · .gitignore · .markdownlint.json"]
    ROOT --> RULES["src/apothem/rules/<br/>(.md files)"]
    ROOT --> COMMANDS["commands/<br/>(slash-command bodies)"]
    ROOT --> SKILLS["src/apothem/skills/<br/>{skill}/SKILL.md"]
    ROOT --> AGENTS["src/apothem/agents/<br/>(flat *.md entry points)"]
    ROOT --> HOOKS["src/apothem/hooks/"]
    HOOKS --> HOOKS_LIB["lib/<br/>bootstrap.{ps1,sh}<br/>find-python.{ps1,sh}<br/>resolve_root.py"]
    HOOKS --> HOOKS_MSGS["messages/<br/>(static context per event)"]
    HOOKS --> HOOKS_PY["dispatch.py<br/>session_start_bootstrap.py<br/>emit_hook_context.py"]
    ROOT --> TOOLS["scripts/<br/>validate_hooks.py<br/>validate_ecosystem.py<br/>chaos_pass.py<br/>src/apothem/benchmarks/<br/>lib/"]
    ROOT --> TESTS["tests/hooks/<br/>(pytest coverage)"]
    ROOT --> DOCS["site/content/docs/<br/>reference/ · architecture/<br/>governance/ · harnesses/<br/>runbooks/ · developer-guide.mdx"]
    ROOT --> MEMORY["memory/<br/>MEMORY.md (index)<br/>promotion-ledger.md<br/>expertise-gap-log.md<br/>{topic}.md files"]
    ROOT --> PLANS["plans/<br/>(per-suite folders<br/>PREAMBLE · MASTER-PLAN<br/>per-phase directories<br/>_spec/ · _inputs/ scratch tiers)"]
    ROOT --> PROJECTS["projects/<br/>{hash}/<br/>memory/ · sessions/<br/>(per-project runtime state)"]
    ROOT --> RUNTIME["runtime-data/<br/>history.jsonl · backups/<br/>(machine-local · gitignored)"]
    classDef cfg fill:#fff5d6,stroke:#aa8800
    classDef runtime fill:#e8f0ff,stroke:#3366aa,stroke-dasharray: 4 2
    class CONFIG_FILES,RULES,COMMANDS,SKILLS,AGENTS,HOOKS,HOOKS_LIB,HOOKS_MSGS,HOOKS_PY,TOOLS,TESTS,DOCS,MEMORY cfg
    class PLANS,PROJECTS,RUNTIME runtime

Lire le diagramme

  • Les nœuds jaunes pleins sont la configuration de l'écosystème : sous contrôle de version, validés, écrits intentionnellement.
  • Les nœuds bleus en pointillés sont les niveaux d'exécution : état local à la machine et artefacts per-suite / per-project qui suivent les conventions structurelles mais ne font pas partie de la configuration livrée.
  • Le sens de la flèche indique le confinement, et non le flux de données. Chaque enfant est un sous-répertoire direct de son parent.

Références croisées faisant autorité

  • CLAUDE.md Section 3 — table complète des répertoires d'artefacts.
  • CLAUDE.md Section 7 — registres (commandes, règles, travailleurs délégués, compétences, hooks).
  • site/content/docs/architecture/source-layout.mdx — résumé narratif des répertoires.
  • README.md Quick Start — aperçu destiné à l'opérateur.

Registres d'artefacts

Énumération complète des artefacts de l'écosystème Apothem : commandes, règles, travailleurs délégués, hooks, compétences, styles de sortie, discipline d'évolution des artefacts et déclarations de classes d'artefact vides.

`CLAUDE.md`

La configuration de l'écosystème, toujours chargée, qui fournit le contexte de base à chaque interaction, avec sept sections couvrant la suite de planification, l'identité, les répertoires, les niveaux de gouvernance, les directives, les mandats et les registres.

On this page

DispositionLire le diagrammeRéférences croisées faisant autorité