Árvore de hierarquia de diretórios

Mapa visual da estrutura da árvore de fontes do Apothem mostrando os artefatos de configuração do ecossistema, os níveis de runtime e a localização de regras, comandos, habilidades, trabalhadores delegados, hooks e arquivos de apoio.

O mapa estrutural canônico da árvore de fontes do Apothem renderizado como um grafo Mermaid. Cada adaptador per-harness sob src/apothem/harnesses/<harness>/ projeta esta árvore no diretório de configuração nativo do harness (por exemplo, ~/.claude/ para Claude Code). Cada classe de artefato declarada na Seção 7 do CLAUDE.md tem aqui o seu lar. Os diretórios de estado de runtime (locais da máquina, em gitignore) são incluídos para orientação, mas nunca contêm artefatos de configuração do ecossistema.

Disposição

%%{ 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

Lendo o diagrama

Os nós amarelos sólidos são configuração do ecossistema: sob controle de versão, validados, escritos intencionalmente.
Os nós azuis tracejados são níveis de runtime: estado local da máquina e artefatos per-suite / per-project que seguem as convenções estruturais, mas não fazem parte da configuração entregue.
A direção da seta mostra contenção, não fluxo de dados. Cada filho é um subdiretório direto do seu pai.

Referências cruzadas autoritativas

CLAUDE.md Seção 3 — tabela completa de diretórios de artefatos.
CLAUDE.md Seção 7 — registros (comandos, regras, trabalhadores delegados, habilidades, hooks).
site/content/docs/architecture/source-layout.mdx — resumo narrativo de diretórios.
README.md Quick Start — visão geral voltada ao operador.

Árvore de hierarquia de diretórios

Disposição

Lendo o diagrama

Referências cruzadas autoritativas

On this page