`CLAUDE.md`
Configuration de projet toujours chargée, qui donne à chaque interaction son contexte de base : sections en prose couvrant le canon de la surface IA, la boucle opérationnelle, la finalité et les disciplines, avec les mandats transversaux rendus opérationnels dans la cohorte de règles.
CLAUDE.md est la configuration de projet chargée en permanence. L'environnement hôte la charge à chaque interaction : son contenu constitue le contexte de base que chaque autre artefact étend. Il reste cohérent avec AGENTS.md (la surface canonique d'instructions destinée aux assistants) et .github/copilot-instructions.md, qui reproduisent les mêmes disciplines.
Ce qu'il contient
Le CLAUDE.md du projet est rédigé en sections de prose : le canon de la surface IA, la boucle opérationnelle plan → durcissement → livraison, la finalité du projet et l'agencement des sources, les disciplines des plans, de la publication et des en-têtes de fichiers, la gestion de l'ambiguïté, ainsi que les conventions de code et d'adaptateurs d'environnement. Il énonce ce qu'est le projet et comment y travailler ; il ne reformule pas les mandats de gouvernance, qui résident dans la cohorte de règles et sont exposés au runtime sous forme de fichiers de règles.
| Surface de gouvernance | Où elle réside |
|---|---|
| Mandats transversaux (CM-N) | src/apothem/rules/operational-mandates.md et les fichiers de règles par mandat |
| Les quinze mandats de production (M-N) | les fichiers de règles par mandat (definitiveness.md, pre-emission-gate.md, production-ready-prs.md, …) |
| Identité cognitive et posture d'architecture | src/apothem/rules/cognitive-identity.md |
| Gouvernance à échelle de sérieux | la section Seriousness Scaling de chaque règle |
Le pipeline /plan | les commandes /plan-* et src/apothem/skills/plan-suite/ |
| Répertoires d'artefacts | l'agencement des sources — rules/, commands/, skills/, agents/, hooks/ |
Conventions d'identifiant de mandat
Trois préfixes portent des significations distinctes :
- CM-N — mandat de configuration, défini dans la cohorte de règles
(
src/apothem/rules/operational-mandates.mdet les fichiers de règles par mandat). - TM-N — mandat de modèle, défini dans
src/apothem/skills/plan-suite/master-template.md§4. - CP-N — principe fondamental, défini dans le même modèle §6.
Le modèle de la suite de planification est le registre canonique TM/CP ; les étapes du pipeline /plan résolvent les références croisées via ce fichier.
Voir aussi
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.
Conventions d'environnements multi-surfaces
Référence normative canonique pour la configuration des environnements multi-surfaces et leur cohérence entre les environnements d'exécution de chat, de complétion dans l'IDE et de revue de PR.