`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.
CLAUDE.md es la configuración de proyecto que siempre está cargada. El entorno anfitrión la carga en cada interacción, por lo que su contenido es el contexto base que extiende todo otro artefacto. Se mantiene coherente con AGENTS.md (la superficie canónica de instrucciones para agentes) y con .github/copilot-instructions.md, que reflejan las mismas disciplinas.
Qué contiene
El CLAUDE.md del proyecto está redactado en secciones de prosa: el canon de superficies de IA, el bucle operativo plan → endurecer → lanzar, el propósito del proyecto y su diseño de fuentes, las disciplinas de planes, de publicación y de cabeceras de archivo, el manejo de la ambigüedad, y las convenciones de código y de adaptadores de entorno. Declara qué es el proyecto y cómo trabajar en él; no repite los mandatos de gobernanza, que viven en la cohorte de reglas y llegan al tiempo de ejecución como archivos de regla.
| Superficie de gobernanza | Dónde vive |
|---|---|
| Mandatos transversales (CM-N) | src/apothem/rules/operational-mandates.md y los archivos de regla por mandato |
| Los quince mandatos de producción (M-N) | los archivos de regla por mandato (definitiveness.md, pre-emission-gate.md, production-ready-prs.md, …) |
| Identidad cognitiva y postura de arquitectura | src/apothem/rules/cognitive-identity.md |
| Gobernanza escalada por seriedad | la sección Escalado por seriedad de cada regla |
La canalización /plan | los comandos /plan-* y src/apothem/skills/plan-suite/ |
| Directorios de artefactos | el diseño de fuentes: rules/, commands/, skills/, agents/, hooks/ |
Convenciones de identificadores de mandato
Tres prefijos tienen significados distintos:
- CM-N — mandato de configuración, definido en la cohorte de reglas
(
src/apothem/rules/operational-mandates.mdy los archivos de regla por mandato). - TM-N — mandato de plantilla, definido en
src/apothem/skills/plan-suite/master-template.md§4. - CP-N — principio central, definido en la misma plantilla §6.
La plantilla de la suite de plan es el registro canónico de TM/CP; las etapas de la canalización /plan resuelven las referencias cruzadas a través de ese archivo.
Véase también
Á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.
Convenciones de entorno multi-superficie
Referencia normativa canónica para la configuración de entornos multi-superficie y su coherencia entre los tiempos de ejecución de chat, de autocompletado en el IDE y de revisión de pull requests.