Á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, skills, 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 por entorno bajo
src/apothem/harnesses/<harness>/ proyecta este árbol en el directorio de
configuración nativo del entorno (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-22 %%
%% 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/dev/<br/>validate_hooks.py · validate_ecosystem.py<br/>chaos_pass.py · audit_all.py<br/>src/apothem/benchmarks/ · lib/"]
ROOT --> TESTS["tests/<br/>unit/ · integration/ · conformity/<br/>commands/ · packaging/ · property/ · hooks/"]
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, skills, 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, skills, output-styles, disciplina de evolución de artefactos y declaraciones de clases de artefacto vacías.
`CLAUDE.md`
La configuración de proyecto siempre cargada que da a cada interacción su contexto base: secciones en prosa sobre el canon de la superficie de IA, el bucle operativo, el propósito y las disciplinas, con los mandatos transversales operacionalizados en la cohorte de reglas.