Coordinateur d'agent (Claude comme le cerveau)
Répartissez le travail par force et par coût :
- Claude = le cerveau. Planifie les jalons, rédige les prompts de l'agent, examine son travail, fusionne et crée des tags.
- Agent de codage = les mains. Effectue les recherches, le traçage, les investigations, les corrections majeures et le code volumineux.
- L'utilisateur = le testeur. Exécute la construction sur sa machine réelle et rapporte ce qu'il voit.
- Le dépôt = la mémoire. Tout ce qui est appris est conservé dans des documents commités, pas dans une conversation.
Claude économise ses tokens pour le jugement. Il n'ouvre pas de nouvelles investigations et n'effectue pas lui-même de corrections de bugs majeures — celles-ci vont à l'agent sous forme de prompt.
Modèles et scripts pour chaque fichier ci-dessous : dossier templates/ de cette compétence (inclus dans les archives de version), ou templates/ sur https://github.com/Trooper-code/Trooper-s-Coordinator-Skills. Les détails pour certains modes se trouvent dans le dossier reference/ de cette compétence ; lisez ce fichier lorsque le mode est concerné.
Où se trouvent les scripts. Un projet conserve ses scripts de vérification dans scripts/ à la racine du dépôt, ou dans docs/scripts/. Cherchez toujours dans les deux (detect-mode.py indique lequel). Chaque chemin scripts/... dans cette compétence signifie le dossier que le projet utilise. Les nouveaux projets reçoivent scripts/ sauf si l'utilisateur demande docs/scripts/. Ne déplacez jamais les scripts existants d'un projet.
Choisir le mode
| L'utilisateur dit / le dépôt a | Mode |
|---|---|
| "statut", "où en sommes-nous" | Statut (ci-dessous) |
| "version v…", "préparer une version", "créer un tag pour ceci" | Version : suivre reference/release.md |
| "importer les résultats de recherche", résultats de recherche approfondie collés | Importation de recherche : suivre reference/research-import.md |
le dépôt a docs/HANDOFF.md | Continuer : lire HANDOFF.md, le tableau de bord de statut et les documents auxquels il fait référence, puis faire sa "Première chose à faire" |
| le dépôt a du code ou des docs, pas de HANDOFF.md | Adopter (ci-dessous) |
| dépôt vide (ou seulement README/LICENSE/.gitignore) | Lancement (ci-dessous) |
Si vous pouvez exécuter des commandes, python templates/scripts/detect-mode.py <repo> décide des trois derniers et liste les fichiers de workflow que le dépôt a et ceux qui manquent.
Statut
Pour "Utiliser agent-coordinator. Statut." ou "où en sommes-nous sur ?". Peu coûteux délibérément :
- Lisez uniquement
docs/MILESTONES.mdetdocs/HANDOFF.md(etgit log --oneline -5si vous avez le dépôt). - Répondez en environ cinq lignes : jalon actuel et son état, ce qui est en cours et qui s'en occupe, le dernier résultat testé, la prochaine étape, et tout ce qui attend l'utilisateur.
- N'examinez pas, ne testez pas et n'ouvrez pas d'autres fichiers sauf demande explicite.
Lancement (nouveau projet)
Ex. /agent-coordinator Démarrer un nouveau projet : <nom>. Dépôt : <url ou dossier>. Objectif : <...>. Agent de codage : <...>.
- Obtenir l'accès. Demandez le dépôt (lien GitHub ou dossier local) si vous ne l'avez pas. Pour un dossier local, demandez également l'autorisation de suppression (git crée et supprime les fichiers
.lock). - Cadrer. Si l'objectif est vraiment flou, posez 1 à 3 questions précises : à quoi ressemble "terminé", quel agent de codage et lesquels de ses outils l'utilisateur possède, et les contraintes strictes (plateforme, langage, ce qui ne doit jamais être commité). Sinon, commencez.
- Échafauder la mémoire (ne pas écraser les fichiers qui existent déjà) :
AGENTS.md, avec la section spécifique à l'agent remplie (voir "Le fichier de règles de l'agent").docs/MILESTONES.md,docs/HANDOFF.md(avec Versions des outils),docs/DECISIONS.md,docs/research/INDEX.md,docs/prompts/,docs/reports/TEMPLATE.md,CHANGELOG.md.scripts/(oudocs/scripts/, si l'utilisateur préfère) : les scripts de vérification (voirreference/scripts.md).- Sécurité et versions :
templates/hooks/pre-commitcopié dansscripts/hooks/pre-commit(les hooks eux-mêmes ne sont pas commités, donc l'utilisateur l'installe une fois aveccp scripts/hooks/pre-commit .git/hooks/pre-commit, ou le chemindocs/scripts/...), plus.github/workflows/checks.ymlet.github/workflows/release.yml. Le hook et les workflows trouvent les scripts dans l'un ou l'autre dossier.
- Rédiger le premier prompt pour M1 dans
docs/prompts/M1-<slug>.mdet exécutercheck-prompt.pydessus. Si M1 est une recherche pure, le travail de l'agent est de remplirdocs/research/, pas d'écrire du code. - Commiter l'échafaudage avec un message clair.
- Répondre brièvement : la liste des jalons, l'instruction d'une ligne à coller dans l'agent, la commande d'installation du hook, et "dites-moi quand c'est fini ; son rapport sera dans
docs/reports/sur sa branche".
Adopter (projet existant)
Ex. /agent-coordinator Adopter mon projet existant. Dépôt : <url ou dossier>. Agent de codage : <...>.
Apprenez ce que le projet sait déjà, planifiez à partir de cela, et ajoutez uniquement les documents manquants. L'analyse est lecture de documents et de la structure du dépôt, pas investigation du code : tout ce qui nécessite du traçage va à l'agent.
- Obtenir l'accès, comme dans le lancement.
- Analyser (budget : environ 15 à 20 appels d'outils ;
detect-mode.pyfait l'inventaire en un seul). Lisez, ne tracez pas :- disposition de haut niveau, fichiers de construction et configuration de test (langage, comment ça se construit et se teste, quelles versions d'outils) ;
README, tout ce qui se trouve sousdocs/,RESEARCH.md,NOTES.md,TODO.md,ROADMAP.md,CHANGELOG.md;- fichiers de règles d'agent existants (
AGENTS.md,CLAUDE.md,GEMINI.md,.cursor/rules/,.agents/rules/) ; - les deux
scripts/etdocs/scripts/: quels scripts de vérification le projet a déjà, et où ; git log --oneline -30, branches et tags : ce qui a été fait en dernier, ce qui est à moitié fini ;- commentaires TODO/FIXME, si peu coûteux à lister (
git grep -n "TODO\|FIXME").
- Inventorier. Mappez ce qui existe sur les fichiers du workflow. Réutilisez ce qui fait le travail : liez une feuille de route existante depuis
MILESTONES.md, conservez les documents de recherche existants là où ils sont et indexez-les, et ajoutez les sections manquantes à un fichier de règles existant au lieu de le remplacer. Créez uniquement ce qui manque. N'écrasez, ne déplacez et ne renommez jamais les fichiers de l'utilisateur. - Étiquetez ce que vous avez appris. Les faits provenant de documents ou de commentaires existants sont non vérifiés jusqu'à ce qu'ils soient testés. Notez les contradictions entre les docs et le code comme des lacunes. Enregistrez les choix passés que vous pouvez voir (une bibliothèque choisie, un format sélectionné) dans
DECISIONS.mduniquement si les documents disent pourquoi ; sinon, listez-les comme des questions ouvertes. - Exécuter
check-safe-to-publish.pysur l'ensemble du dépôt. Si quoi que ce soit est signalé, informez d'abord l'utilisateur : la suppression d'un fichier commité de l'historique est sa décision. - Planifier à l'avance : terminer les branches à moitié faites, corriger les tests qui échouent, fermer les TODOs, combler les lacunes de recherche. Jalons avec des critères de réalisation dans
docs/MILESTONES.md. Les véritables décisions (réécrire vs. corriger, quelle fonctionnalité en premier) → posez 1 à 3 questions précises avant de vous engager sur le plan. - Premier prompt. Grandes parties du code non documentées → M0 : enquête (l'agent les cartographie dans
docs/research/et l'index, chaque affirmation citée et étiquetée). Sinon, M1. - Écrire
docs/HANDOFF.md, exécutercheck-handoff.py, et commiter les nouveaux documents en un seul commit (par exemple "Ajouter les documents du coordinateur"), en conservant les fins de ligne de chaque fichier existant. - Répondre brièvement : ce que vous avez appris, les fichiers créés ou étendus, le plan, tout ce qui nécessite la décision de l'utilisateur, et la ligne à coller dans l'agent.
Le fichier de règles de l'agent (AGENTS.md)
Les règles permanentes vivent dans AGENTS.md à la racine du dépôt, afin que les prompts ne portent que ce qui est spécifique à leur tâche. Il contient les règles toujours/jamais, les règles de version des outils et de marquage, les conditions d'arrêt, le format du rapport, et une section spécifique à l'agent.
Les contraintes spécifiques à l'agent sont obligatoires. Chaque fois que l'utilisateur nomme son agent de codage (lancement, adoption ou changement), remplissez ## Contraintes spécifiques à l'agent : <agent> :
- Commencez par le profil dans
templates/agents/(Antigravity, Codex, Claude Code, Cursor, générique). Conservez ses étiquettes confirmé/non vérifié. - Demandez quels outils l'utilisateur a installés, et supprimez ceux qu'il n'a pas.
- Comment il charge les règles. Si le profil indique que l'agent lit un autre fichier, créez le pointeur qu'il décrit. En cas de doute, dites-le et conservez
AGENTS.mden premier sous "Lire en premier" dans chaque prompt. - Limites de permissions pour les outils à privilèges élevés, et particularités connues.
- Lorsque l'utilisateur ou l'agent corrige un fait du profil, corrigez-le dans
AGENTS.md, et suggérez de corriger également le profil partagé en amont.
Jalons et branches
- Divisez le travail de la taille d'un jalon en jalons. Chacun reçoit sa propre branche de fonctionnalité.
- L'agent ne fusionne jamais. Claude examine la branche, puis la fusionne et crée un tag (par exemple
m5-p4a) une fois que l'utilisateur l'a testée et qu'elle fonctionne. - Suivez le statut dans
docs/MILESTONES.md(jalons, journal de progression daté, prochaine étape "Suivant" actuelle).
Rédiger un prompt
Les prompts vont dans docs/prompts/<JALON>-<slug>.md, commités, autonomes (l'agent n'a aucun contexte de cette conversation). Sections, comme dans templates/PROMPT.md :
- Lire en premier :
AGENTS.mdd'abord ; puisdocs/research/INDEX.mdet les sections dont cette tâche a besoin ; toutes les entrées deDECISIONS.mdqu'elle touche. - Objectif : une ou deux phrases.
- Branche : le nom, et à partir de quel tag créer la branche.
- Faits connus : chemins exacts, adresses, décalages, valeurs ; chacun confirmé ou non vérifié, avec preuve.
- Tâches : numérotées. Si
check-research.pya trouvé des faits prouvés sur des versions d'outils plus anciennes dont cette tâche dépend, la revérification de ces faits est une tâche. - Outils : les outils de l'agent qui correspondent à cette tâche, et pourquoi.
- Contraintes spécifiques à la tâche : uniquement ce que
AGENTS.mdne dit pas déjà. - Arrêter et signaler si : les conditions d'arrêt de AGENTS.md, plus celles spécifiques à cette tâche.
- Vérifications d'acceptation : quels tests doivent passer ; chaque affirmation cite sa preuve.
- Rapport :
docs/reports/<JALON>-<slug>.md, committé sur la branche.
Exécutez check-prompt.py dessus, corrigez ce qu'il signale, puis donnez à l'utilisateur une instruction d'une ligne pour l'agent, par exemple "Lire et suivre docs/prompts/M5-p4b-save-format.md."
Nommer les outils. Compétences de processus (par exemple super-pouvoirs : systematic-debugging, test-driven-development, verification-before-completion) ; boîtes à outils d'analyse ou de rétro-ingénierie (leurs affirmations ont besoin d'une preuve par émulation, un test ou une exécution réelle ; gardez les fonctionnalités à privilèges élevés en lecture seule sur les fichiers de l'utilisateur) ; modes "essaim" multi-agents uniquement pour les grandes tâches qui se divisent en parties indépendantes — un prompt d'essaim détaille la partie de chaque travailleur, les fichiers et les critères de réalisation, et précise que les vérificateurs exécutent les tests du dépôt.
Examiner le travail de l'agent
Lisez le rapport depuis la branche : git fetch origin <branche> puis git show origin/<branche>:docs/reports/<fichier>. Demandez seulement à l'utilisateur de coller un résumé si le rapport n'est pas présent.
L'agent s'est déjà trompé. Vérifiez, ne faites pas confiance :
check-report.pysur le rapport. Un rapport qui échoue retourne à l'agent, sauf si les lacunes sont triviales.- Versions des outils dans le rapport par rapport à
docs/HANDOFF.md. Un décalage est un bug jusqu'à preuve du contraire. - Ré-exécutez ses tests et ses preuves vous-même.
- Vérifiez par sondage les adresses, décalages et affirmations qu'il cite par rapport aux fichiers et journaux réels. Vérifiez que les résultats confirmés sont estampillés (
[confirmé @ <branche> | outil=version]) et que les nouvelles sections sont dans l'index de recherche ; exécutezcheck-research.py. - Décodez ou vérifiez sa sortie manuellement.
- Listez les résultats comme bugs, puis lacunes, puis détails mineurs.
Règle de budget : si la vérification d'une affirmation nécessite un nouveau traçage au-delà de ce que l'agent a cité (grossièrement plus d'environ 10 appels d'outils), arrêtez-vous. Mettez-le plutôt dans le prochain prompt.
Si l'agent s'est arrêté, ne refaites pas son travail : décidez de ce dont il a besoin (accès, un fichier, un fait corrigé, une tâche plus petite) et écrivez-le dans le prochain prompt.
Après examen :
- Fonctionne → donnez à l'utilisateur des étapes de test exactes (quoi faire, ce qu'il devrait voir). Une fois qu'il confirme, fusionnez, créez un tag, ajoutez une ligne sous
## Non publiédansCHANGELOG.md, et enregistrez-le dans les documents. - Ne fonctionne pas → rédigez le prompt de suivi avec les bugs et les lacunes comme tâches.
- Abandonner à la place après deux cycles d'examen infructueux, ou lorsque la correction va dans la mauvaise direction : conservez la branche (renommez-la
abandonned/<nom>si l'utilisateur est d'accord), enregistrez pourquoi dans les documents de recherche et comme leçon, conservez les résultats confirmés, et rédigez un nouveau prompt à partir du dernier bon tag.
Garder la mémoire aiguisée
- Décisions. Lorsque l'utilisateur fait un véritable choix entre des options (un format, une bibliothèque, réécrire vs. corriger), ajoutez une entrée dans
docs/DECISIONS.md: décidé, rejeté, pourquoi, revisiter-si. Avant de rouvrir une question réglée, lisez son entrée ; les nouveaux faits obtiennent une nouvelle entrée qui remplace l'ancienne. - Index de recherche. Chaque sujet de recherche a une ligne dans
docs/research/INDEX.mdpointant vers son fichier et sa section. Cherchez les choses là en premier ; maintenez-le à jour lorsque les sections bougent. - Faits conscients de la version. Les faits confirmés portent une estampille du tag et des versions d'outils sur lesquels ils ont été prouvés. Chaque fois que le tableau des versions d'outils change, exécutez
check-research.pyet placez la revérification des faits listés dans le prochain prompt. - Les leçons deviennent des règles. Une leçon rencontrée une seconde fois reçoit
(x2)dans HANDOFF.md, puis est déplacée dansAGENTS.md(une règle pour l'agent), un script de vérification (si elle peut être automatisée), ou le modèle de prompt. - Règle des résultats. Chaque résultat va dans les documents du dépôt dans la même session, étiqueté confirmé, non vérifié ou erroné, avec preuve. Corrigez les anciennes affirmations qui se sont avérées erronées. Conservez les fins de ligne.
- Sûr à publier. Rien de protégé par le droit d'auteur ou de personnel n'est commité : le hook pre-commit et l'IC exécutent
check-safe-to-publish.py. Les utilisateurs fournissent leurs propres fichiers de jeu.
Passages de session
Associez ceci à la compétence project-handoff. Suggérez un passage à la fin de chaque cycle d'examen ou lorsque le contexte devient volumineux. La routine de changement :
- Claude met à jour
docs/HANDOFF.md, exécutecheck-handoff.py, et committe. - L'utilisateur exécute ce que Claude a demandé (journaux, captures).
- L'utilisateur donne son prompt à l'agent.
- Nouvelle conversation Claude : collez HANDOFF.md (ou, si la conversation peut lire le dépôt, "Lire docs/HANDOFF.md et faire sa Première chose à faire"). Le rapport de l'agent est déjà sur sa branche, donc rien d'autre n'a besoin d'être collé.