Árbol de jerarquía de directorios
Mapa visual de la estructura del árbol de fuentes de Apothem que muestra los artefactos de configuración del ecosistema, los niveles de tiempo de ejecución y la ubicación de reglas, comandos, habilidades, trabajadores delegados, hooks y archivos de apoyo.
El mapa estructural canónico del árbol de fuentes de Apothem renderizado como
un grafo Mermaid. Cada adaptador per-harness bajo
src/apothem/harnesses/<harness>/ proyecta este árbol en el directorio de
configuración nativo del harness (p. ej. ~/.claude/ para Claude Code).
Cada clase de artefacto declarada en la Sección 7 de CLAUDE.md tiene aquí su
hogar. Los directorios de estado de tiempo de ejecución (locales de la máquina,
en gitignore) se incluyen para orientación pero nunca contienen artefactos de
configuración del ecosistema.
Disposición
%%{ 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 runtimeLeer el diagrama
- Los nodos amarillos sólidos son configuración del ecosistema: bajo control de versiones, validados, escritos intencionalmente.
- Los nodos azules discontinuos son niveles de tiempo de ejecución: estado local de la máquina y artefactos per-suite / per-project que siguen las convenciones estructurales pero no forman parte de la configuración entregada.
- La dirección de la flecha muestra contención, no flujo de datos. Cada hijo es un subdirectorio directo de su padre.
Referencias cruzadas autoritativas
CLAUDE.mdSección 3 — tabla completa de directorios de artefactos.CLAUDE.mdSección 7 — registros (comandos, reglas, trabajadores delegados, habilidades, hooks).site/content/docs/architecture/source-layout.mdx— resumen narrativo de directorios.README.mdQuick Start — visión general orientada al operador.
Registros de artefactos
Enumeración completa de los artefactos del ecosistema Apothem: comandos, reglas, trabajadores delegados, hooks, habilidades, estilos de salida, disciplina de evolución de artefactos y declaraciones de clases de artefacto vacías.
`CLAUDE.md`
La configuración del ecosistema, siempre cargada, que proporciona contexto de base a cada interacción, con siete secciones que cubren el conjunto de planificación, identidad, directorios, niveles de gobernanza, directivas, mandatos y registros.