La liste de tâchesThe task listLa lista de tareas
Parcours : Construire un agent de code, le harnais · OpérationnelCourse: Building a Coding Agent: the Harness · PractitionerCurso: Construir un agente de código: el harness · Operativo

≈ 9 min
Le problème
Le problème : sur une tâche en plusieurs étapes, l’agent réussit chaque action puis perd le fil, la demande initiale noyée sous les résultats d’outils.
Au programme de ce moduleIn this moduleEn el programa de este módulo
- 01Le problème≈ 9 min
- 02L’intuition≈ 8 min
- 03Le mécanisme≈ 9 min
- 04Le code, pas à pas≈ 10 min
- 05Pièges & pratiques≈ 10 min
- 06Exercice≈ 6 min
- 07Quiz≈ 5 min
Objectifs d’apprentissage
À la fin de ce module, vous saurez donner à votre agent un plan qu’il écrit, suit et met à jour lui-même, et le lui rappeler quand il l’oublie. Voici les acquis visés.
- Expliquer pourquoi un agent dérive sur une tâche longue, alors qu’il exécute correctement chaque action ;
- Coder un outil todo_write : une liste d’au plus vingt tâches, trois statuts, une seule tâche en cours, réécrite en entier à chaque appel ;
- Ajouter un rappel au bon moment grâce à un nouvel événement, PostToolBatch, annoncé une fois par tour ;
- Situer la liste de tâches : elle n’ajoute aucune capacité d’exécution, elle ajoute de la planification, et son intérêt dépend du modèle.
Sources
Curriculum open-source shareAI-lab/learn-claude-code, chapitre s05 (TodoWrite), publié sous licence MIT, © shareAI-lab, adaptation Getul. La notice de licence est reproduite sur la page Sources et références. Documentation publique de Claude Code (Anthropic) sur ses outils de suivi des tâches et sur l’événement PostToolBatch, citée pour comparer avec un outil en production. Le motif présenté est indépendant du fournisseur : il vaut pour toute API offrant l’appel d’outils.
L’agent qui perd le fil
Confiez à votre agent une tâche en plusieurs temps : « Renomme tous les fichiers Python du projet en snake_case, lance les tests, puis corrige ce qui échoue. » Il commence bien : trois fichiers renommés, un premier lancement des tests, deux échecs. Il se met à les corriger, relance les tests, les voit passer au vert, et conclut. Sept fichiers attendent toujours d’être renommés.
Aucune action n’était fausse, chaque appel d’outil était justifié. Ce qui a manqué, c’est la vue d’ensemble : à force de lire des sorties de tests et des messages d’erreur, l’agent a perdu de vue la demande initiale. Regardez où elle se trouve dans la conversation au moment où il conclut.
messages = [
{"role": "user", "content": "Renomme..., lance les tests, puis corrige"}, # la demande
{"role": "assistant", "content": [...]}, # renomme trois fichiers
{"role": "user", "content": [...]}, # trois tool_result
{"role": "assistant", "content": [...]}, # lance pytest
{"role": "user", "content": [...]}, # deux cents lignes de sortie de tests
# ... une trentaine de messages plus loin ...
{"role": "user", "content": [...]}, # le dernier résultat : tests au vert
]Plus la conversation s’allonge, plus le problème s’aggrave. Chaque résultat d’outil s’intercale entre la demande et le présent, et la consigne du début pèse de moins en moins face à la masse des sorties récentes. Sur une tâche de dix étapes, les dernières risquent de sortir du champ dès que les premières produisent du bruit.
Pour comprendre : la liste de courses
Personne ne fait les courses d’une semaine de mémoire. On écrit la liste avant de partir, on raye au fil des rayons, on la relit avant la caisse. La liste ne porte pas les sacs : elle évite d’oublier le lait. Un agent a besoin de la même chose : un plan écrit, qu’il relit et met à jour, pour compenser une conversation encombrée.
Vérifiez votre compréhensionCheck your understandingVerifique su comprensión
Votre agent a fait passer les tests au vert mais oublié la plupart des renommages. Quelle est la cause la plus probable ?
À retenir
Un agent peut réussir chaque action et rater la tâche : sans plan écrit, la demande initiale se dilue sous les résultats d’outils. Il lui faut un plan qu’il tient lui-même, et qui revient régulièrement dans la conversation.