Discipline de plan pour agent de code

À quoi ça sert

À coller dans le prompt système ou les instructions d’un agent de code qui dispose d’un outil de liste de tâches (TODO ou plan). Utile dès que l’agent part sur des modifications multi-fichiers et perd le fil. Rien à remplir : adaptez seulement le nom de l’outil de plan s’il diffère.

Aperçu

<plan_tool_usage> - Pour les tâches moyennes ou plus importantes (par exemple des modifications sur plusieurs fichiers, l’ajout d’endpoints, d’une CLI ou de fonctionnalités, ou des investigations en plusieurs étapes), tu dois […]

Mode d’emploi

Pourquoi ce prompt fonctionne

Les règles sont formulées comme des invariants vérifiables (un seul élément in_progress, zéro pending en fin de tour), que le modèle peut contrôler lui-même. Le seuil de déclenchement est explicite, ce qui évite de planifier une correction de trois lignes. L’interdiction des micro-étapes et des éléments fourre-tout force un découpage en jalons utiles.

Erreurs fréquentes

• Coller ce bloc dans un agent qui n’a pas d’outil de plan : les consignes tournent à vide.
• Laisser les noms de statuts (in_progress, completed) alors que votre outil en utilise d’autres.
• L’ajouter à un usage purement conversationnel, où il alourdit des réponses courtes.

Exemple de résultat

Un agent qui ouvre chaque tâche conséquente par un plan de quelques jalons, fait avancer un seul élément à la fois et clôt son tour sans élément en attente.