Vous transformez une idée brute en une tâche bien formée dans TODO.md. L'idée brute :
$ARGUMENTS
Ceci est un workflow de raffinement, pas d'implémentation. N'écrivez pas de code. N'écrivez pas dans
TODO.md tant que la tâche n'est pas claire et que l'utilisateur ne l'a pas approuvée. Travaillez en ces étapes :
1. Lire la constitution
Trouvez les fichiers de constitution du projet et lisez-les — respectez leurs conventions, en particulier les niveaux de risque et toute règle concernant les agents autonomes / le cycle de vie des TODO.
- Si
sprint.confexiste, lisez les fichiers listés dansSPRINT_CONSTITUTION_FILES(dans l'ordre). - Sinon, lisez les fichiers
AGENTS.md,CLAUDE.mdqui existent (ainsi que tout guide spécifique au projet qu'ils référencent, par exemple unCLAUDE.mdfrontend). - Parcourez
.githooks/README.mds'il est présent, afin de décrire correctement l'effet en aval. Si aucun de ces fichiers n'existe, indiquez à l'utilisateur que le dépôt n'est pas encore amorcé et proposez/sprint:bootstrap.
2. Ancrer l'idée dans le code réel (ne pas deviner)
Trouvez les symboles/fichiers réels que l'idée touche et son rayon d'impact :
- Graphe de code (recommandé, s'il est disponible) : les outils
mcp__codegraph__*(codegraph_search,…_callers,…_callees,…_impact,…_context), ou la CLI (codegraph context "<l'idée>",codegraph callers <symbole>,codegraph impact <symbole>) ; exécutezcodegraph sync .d'abord si l'index semble obsolète. - Solution de repli (pas de graphe de code) : utilisez Grep/Glob pour localiser les symboles pertinents et leurs appelants. Lisez les quelques fichiers qui comptent vraiment. Nommez les fonctions/fichiers concrets et l'endroit où la modification atterrit.
3. L'interroger (le cœur de cette compétence)
Confrontez l'idée à ce que le code fait déjà. Faites émerger :
- S'agit-il d'une question ou d'une tâche ? S'il s'agit vraiment d'une question ("…ou est-ce que j'ai oublié quelque chose ?"), répondez-y d'abord à partir du code — la logique existante peut déjà en couvrir une partie.
- La portée réelle et le plus petit changement qui apporte de la valeur.
- Le niveau de risque (selon la constitution /
AGENTS.md). S'il est élevé, dites-le — il ne sera pas implémenté automatiquement ; la chaîne le délègue à un humain. - Les décisions qui appartiennent à l'utilisateur, pas à vous (choix produit/UX/politique). Posez ces quelques décisions à l'utilisateur avec AskUserQuestion. N'inventez pas de réponses à de véritables choix produit ; corrigez les hypothèses erronées à l'aide de preuves issues de la base de code.
4. Rédiger UN item structuré (les quatre ingrédients)
Rédigez un projet avec :
- une tâche impérative claire (pas de question),
- le niveau de risque,
- un critère de complétude concret (quel test ciblé doit passer / quel comportement est vérifiable),
- des indications de fichiers/fonctions issues de l'étape 2. Limitez-vous au plus petit changement utile. Montrez le projet et affinez-le jusqu'à ce que l'utilisateur soit satisfait.
5. L'écrire dans TODO.md, puis passer la main
- Ajoutez l'élément approuvé sous forme d'entrée
- [ ]près du sommet deTODO.md. - Demandez s'il faut en faire l'élément actif unique — si oui, déplacez les autres éléments actifs
dans un bloc
<!-- … -->(ou sous## 🚧 Reporté) selon la convention de saut, afin que la chaîne ne prenne que celui-ci. - Ne commitez pas automatiquement. Dites à l'utilisateur : commiter
TODO.mddémarre la chaîne planification→implémentation→revue (l'implémentation atterrit sur la branche d'implémentation, rien n'est fusionné automatiquement). Proposez de commiter s'il souhaite que le processus commence maintenant.
Gardez le dialogue serré : ancrez d'abord, ne posez que les décisions qui comptent, puis rédigez.