Ma pyramide Claude Code : un chef, des métiers, des missions

À coller dans Claude Code, dans un dossier de projet (terminal, ou app Claude, onglet Code). Il n’écrit que dans ce dossier et ne supprime rien. Claude vous demandera d’autoriser ce qu’il écrit : lisez, puis acceptez.

Installe « la pyramide » dans mon dossier actuel : un CHEF (cette session) qui parle avec moi et répartit le travail, des MÉTIERS (un sous-agent par domaine, avec ses règles et son ETAT.md) et des MISSIONS (un sous-agent par tâche, qui livre, archive sa trace et s'arrête). Plus un relais : quand une session sature, elle écrit ses notes dans une passation, repart à zéro et la relit. Un résumé automatique perd du détail ; des notes écrites, non.

Fais toutes les étapes toi-même, dans l'ordre. Si une étape échoue, arrête-toi et explique-moi pourquoi.

Règles pour toute l'installation :
- Écris seulement dans le dossier courant : rien dans mon dossier personnel ni dans ~/.claude, aucun réglage global modifié.
- N'installe rien, pas d'Internet, pas de serveur MCP.
- Ne supprime et n'écrase rien. CLAUDE.md existe : ajoute ta section à la fin. .claude/settings.json existe : fusionne. Autre fichier déjà là : n'y touche pas et signale-le. Montre-moi tout texte ajouté à un fichier existant.
- Jamais de secret (clé, mot de passe, token) dans ces fichiers.
- Déjà installé (une section « ## Pyramide » dans CLAUDE.md, ou un groupe de crochet qui contient ETAT.md) : n'ajoute pas une seconde fois, dis-le-moi.

0. Affiche le dossier courant. Si c'est mon dossier personnel (~) ou la racine /, arrête-toi et dis-moi de relancer Claude Code dans un dossier de projet. Sinon, liste l'existant (CLAUDE.md, .claude/, ETAT.md, metiers/, missions/, passations/) sans rien modifier.

1. Pose-moi UNE seule question : « Quels sont tes 2 à 4 domaines de travail, en quelques mots chacun ? » Attends ma réponse avant de créer quoi que ce soit. Sans réponse claire (rien, « défaut », je ne sais pas) : produit, communication, administratif. Plus de 4 : garde les 4 premiers. Pour chacun, un <nom> court en minuscules, sans accent ni espace.

2. Ajoute à la fin de CLAUDE.md (ou crée-le) :

## Pyramide
Le CHEF est la session principale : il parle avec moi, répartit le travail et ne fait pas lui-même le travail long. Les MÉTIERS sont des sous-agents (.claude/agents/) : <nom> (rôle en une ligne), etc. Les MISSIONS passent par le sous-agent « mission » : une tâche, un livrable, puis arrêt. Un métier ou une mission suit son fichier d'agent. Règles pour tous :
1. Le chef délègue le travail long et lance lui-même les missions.
2. Comptes rendus de 5 lignes au plus : le chef suit le travail délégué par ces comptes rendus, pas par le détail. Une mission n'en envoie qu'un, à la fin.
3. En fin de travail, mettre à jour son ETAT.md (le chef : celui de la racine ; un métier : metiers/<nom>/ETAT.md ; 15 lignes au plus : Fait, En cours, Prochaine étape, Fichiers clés).
4. Ne jamais inventer un fait, surtout dans un ETAT.md ou une passation. « Je ne sais pas » est permis.
5. Jamais de secret (clé, mot de passe, token) dans un fichier.
6. Session longue ou qui perd des détails : me proposer /relais.

3. Dans .claude/agents/, un <nom>.md par métier. La description se tire de mes mots seulement, rien d'inventé (« à préciser » si je n'ai rien dit) ; valeurs du front matter entre guillemets, pour que le YAML reste valide :
---
name: <nom>
description: "Métier <nom> : <ce que je fais dans ce domaine>. Pour tout travail de ce domaine."
tools: Read, Write, Edit, Glob, Grep, Bash
model: sonnet
---
Corps en 10 lignes au plus : rôle en une phrase ; lire d'abord metiers/<nom>/ETAT.md puis passations/<nom>.md s'il existe ; rester dans son domaine ; ni secret ni fait inventé ; en fin de travail, mettre à jour son ETAT.md ; finir par un compte rendu de 5 lignes au plus (fait, livrable et chemin, blocage, prochaine étape).
Plus mission.md : même front matter, avec name: mission et description: "Mission ponctuelle : un énoncé, un livrable, puis arrêt." Corps : une seule mission, rien de plus ; ni secret ni fait inventé ; écrire sa trace dans missions/archives/AAAA-MM-JJ-<nom-court>.md (date du jour avec `date +%F` ; énoncé, ce qui a été fait, livrable et chemin, ce qui reste ; si le fichier existe déjà, changer le nom court) ; ne jamais modifier ni supprimer une archive ; un seul compte rendu de 5 lignes au plus, puis s'arrêter.

4. Crée metiers/<nom>/ETAT.md pour chaque métier, et ETAT.md à la racine (s'il existe déjà : laisse-le tel quel et signale-le), avec ce gabarit :
# ETAT : <nom du dossier, ou du métier>
Mis à jour : AAAA-MM-JJ
## Fait
-
## En cours
-
## Prochaine étape
-
## Fichiers clés
-
À la racine (si tu le crées), sous « Fait », seulement : pyramide installée le <date>. Crée aussi les dossiers vides missions/archives/ et passations/.

5. Dans .claude/commands/ (front matter, valeurs entre guillemets : description, plus argument-hint s'il y a un argument) :
- relais.md : rôle = $ARGUMENTS (un seul mot en minuscules, sans espace ni /), ou « chef » si vide. Écrire passations/<rôle>.md en 40 lignes au plus : où j'en suis, décisions prises, pièges, prochaine étape précise, fichiers à relire. Réécrire le fichier en gardant ce qui reste vrai ; que des faits vérifiés, sinon « à vérifier ». Puis me dire : « Tape /clear : je relirai cette passation au redémarrage. »
- reprise.md : lire ETAT.md, les metiers/*/ETAT.md et passations/chef.md (signaler s'il y a d'autres passations dans passations/). Répondre en 5 lignes au plus : où on en est, ce qui bloque, prochaine étape. Info manquante : le dire.
- mission.md : lancer le sous-agent mission avec l'énoncé $ARGUMENTS (vide ou flou : me poser une seule question avant), puis relayer son compte rendu en 5 lignes au plus et mettre à jour l'ETAT.md de la racine si besoin.

6. Dans .claude/settings.json, ajoute ce groupe à hooks.SessionStart (garde tout l'existant, crée les clés qui manquent) :
{"hooks": {"SessionStart": [{"matcher": "startup|clear|compact", "hooks": [{"type": "command", "timeout": 10,
"command": "cd \"${CLAUDE_PROJECT_DIR:-.}\" || exit 0; if [ -f ETAT.md ]; then echo '--- ETAT.md ---'; head -n 20 ETAT.md; fi; if [ -f passations/chef.md ]; then echo \"--- Passation du chef (un métier l'ignore) ---\"; head -n 60 passations/chef.md; fi; exit 0"}]}]}}
Il ne relit que la passation du chef (passations/chef.md) ; un métier relit la sienne par son fichier d'agent. Sa sortie entre dans ton contexte au démarrage, après /clear et après un résumé automatique.

7. Vérifie : liste les fichiers créés ou modifiés ; le JSON de .claude/settings.json est valide (relis-le, sans installer d'outil) ; chaque agent commence par un front matter entre deux lignes --- avec name (égal au nom du fichier), description, tools et model ; lance une fois la commande du hook avec sh -c, sans créer de fichier temporaire hors du dossier, elle doit afficher ETAT.md sans erreur. Corrige ce qui manque.

8. Conclusion pour moi, 8 lignes au plus :
- ce qui a été créé ;
- quitter et relancer Claude Code dans ce dossier pour charger agents, commandes et hook ;
- les 3 phrases : /reprise (où on en est), /mission <énoncé> (une tâche ponctuelle), et /relais puis /clear quand une session sature (le chef relit seul sa passation) ;
- session dédiée à un métier : claude --agent <nom> dans un autre terminal, puis /relais <nom> ;
- en une phrase, ce que ça ne fait pas : pas de vue de plusieurs sessions côte à côte, pas de relais automatique (je tape moi-même /relais puis /clear), pas d'archivage de sessions dans une app ; métiers et missions sont des sous-agents.