By name: context-governance description: "OBLIGATOIRE AVANT de modifier: CLAUDE.md, AGENTS.md, .claude/skills/, .codex/skills/, docs/reference/*, la doc core (ARCHITECTURE.md, MODULE_GUIDE.md, VERSIONING.md, README.md racine), ou créer un nouveau skill projet. Déclencheurs: « ajouter une règle », « documenter », « où mettre », « nouveau skill », modification de CLAUDE.md ou de la doc core. NE PAS utiliser pour: documenter un module (README du module), écrire du code."
Gouvernance du contexte — RadioManager Modular
PRIMARY RESPONSIBILITY
Protéger l'architecture de contexte optimisée : décider OÙ va chaque information documentaire, faire respecter le budget de CLAUDE.md et le format des skills projet.
USE THIS SKILL WHEN
- On s'apprête à modifier CLAUDE.md, AGENTS.md, un skill projet ou docs/reference/.
- On modifie la doc core racine : ARCHITECTURE.md, MODULE_GUIDE.md, VERSIONING.md, README.md.
- On hésite sur l'emplacement d'une nouvelle règle, doc ou information.
- On crée un nouveau skill projet (template obligatoire ci-dessous).
DO NOT USE THIS SKILL WHEN
- On documente un module métier (→ README du module, via
module-development). - On écrit du code ou un CHANGELOG de release (→ skill du domaine).
TRIGGERS
CLAUDE.md, AGENTS.md, skill, documentation projet, doc core, ARCHITECTURE.md, MODULE_GUIDE.md, règle, convention, où mettre, gouvernance, docs/reference.
OWNED DIRECTORIES
CLAUDE.md,AGENTS.md,AGENT.md,CHANGELOG_AI.md- Doc core racine :
ARCHITECTURE.md,MODULE_GUIDE.md,VERSIONING.md,README.md .claude/skills/(sauf skills téléchargés externes),.claude/hooks/,.claude/settings.json.codex/skills/(pointeurs)docs/reference/
REQUIRED DEPENDENCIES
- Hook
.claude/hooks/check-context-budget.sh(déclaré dans.claude/settings.json) — applique le budget automatiquement
OPTIONAL DEPENDENCIES
- Mémoire projet (
memory/) — pour les faits de session non dérivables du repo
RELATED DOCUMENTATION
docs/GUIDE_OPTIMISATION_CONTEXTE.md— explication complète de l'architecture + recette réutilisable
Budget
| Fichier | Budget | Application |
|---|---|---|
CLAUDE.md |
160 lignes max | Hook automatique — bloque tout dépassement |
MEMORY.md (mémoire) |
index d'une ligne par mémoire | Détail dans des fichiers thématiques |
| Un skill | ~120 lignes | Au-delà, scinder ou renvoyer vers docs/reference/ |
Règles de placement — où va quoi
| Contenu | Emplacement |
|---|---|
| Règle nécessaire à CHAQUE session (identité, frontières d'import, règles critiques, commandes) | CLAUDE.md — compact |
| Workflow déclenché par un TYPE de tâche | Skill dans .claude/skills/<nom>/ |
| Référence consultable (endpoints, flows, schémas, listes) | docs/reference/*.md |
| Documentation d'un module | src/modules/<nom>/README.md + docs/ du module |
| Point d'entrée Codex (renvois courts) | AGENTS.md ; les .codex/skills/* restent des POINTEURS vers .claude/skills/ |
| Fait de session non dérivable du repo | Mémoire projet (memory/) — jamais CLAUDE.md |
| Spécifications, guides longs | docs/*.md |
| Doc core (ARCHITECTURE, MODULE_GUIDE, VERSIONING, README racine) | Vérifier contre le code AVANT édition (domaine API de vite.config.ts, types src/shared/types/module.ts, exports réels des hooks) ; jamais de duplication d'un README de module |
Procédure OBLIGATOIRE avant de modifier CLAUDE.md
- Skill d'abord : règle liée à un type de tâche ? → créer/enrichir le skill ; CLAUDE.md reçoit au plus 1 ligne dans « Workflows → Skills ».
- Référence ensuite : donnée consultable ? →
docs/reference/ou README du module. - Lien enfin : la ressource existe ? → pointer, ne pas dupliquer.
- CLAUDE.md en dernier recours : seulement si nécessaire à chaque session, en 1-3 lignes, en condensant l'existant si le budget approche.
Toute modification de CLAUDE.md doit le laisser plus petit ou égal, sauf justification explicite.
Template OBLIGATOIRE pour tout skill projet
Frontmatter : name + description au format machine :
"OBLIGATOIRE pour: <périmètre>. Déclencheurs: <mots-clés>. NE PAS utiliser pour: <exclusions (autre skill)>."
Sections, dans cet ordre, avant le contenu : PRIMARY RESPONSIBILITY, USE THIS SKILL WHEN,
DO NOT USE THIS SKILL WHEN, TRIGGERS, OWNED DIRECTORIES, REQUIRED DEPENDENCIES,
OPTIONAL DEPENDENCIES, RELATED DOCUMENTATION. Chaque skill projet doit nommer les skills
voisins dans ses exclusions/dépendances (découvrabilité sans tout charger). Si Codex doit le
voir : créer le pointeur .codex/skills/radiomanager-<nom>/SKILL.md.
Checklist avant commit documentaire
-
wc -l CLAUDE.md≤ 160 ; skills ≤ ~120 lignes. - Une information = un propriétaire ; les autres fichiers pointent.
- Nouveaux skills conformes au template ;
.codex/skills/*restés des pointeurs. - Module modifié → README du module à jour (pas CLAUDE.md).
- Changement structurel (mécanisme core, nouveau module, domaine/infra) → ARCHITECTURE.md / MODULE_GUIDE.md impactés ?
- Entrée
CHANGELOG_AI.mdsi la structure documentaire a changé.
Anti-patterns (interdits)
- Coller dans CLAUDE.md le détail d'une feature livrée (→ README module / CHANGELOG).
- Recopier une table/un flow déjà documenté (→ lien).
- Documenter deux fois « pour être sûr » (→ une source, des pointeurs).
- Stocker un état temporaire dans CLAUDE.md (→ mémoire projet).