Agent bloqué ? Comment t'en sortir
Quand un agent de coding part en vrille, empiler des instructions n'aide presque jamais – une routine de récupération claire, si.
D'abord, arrête-toi
Quand un agent est perdu, empiler une instruction de plus n'aide pas. Plus de texte ne fait qu'aggraver un contexte déjà confus. Arrête-toi avant de taper quoi que ce soit d'autre.
Diagnostique avant de réparer
Ne fais pas confiance à ce que l'agent raconte sur son propre travail. Regarde ce qu'il a vraiment fait : le diff, les logs, les fichiers réellement touchés. Le résumé de l'agent et le changement réel peuvent être très éloignés l'un de l'autre.
Reprends en petit plutôt que de discuter
Discuter avec un agent perdu ne sert presque jamais à rien – le mauvais contexte reste là. Une session neuve et propre avec un brief précis et resserré bat souvent dix allers-retours de messages.
Git est ton bouton annuler
Si l'agent a tout cassé, reviens au dernier état bon : git checkout ou git revert (voir Git et GitHub pour les vibe coders). C'est presque toujours plus rapide que de réparer l'erreur en plein chaos.
Découpe la tâche en plus petit
Au lieu de « construis toute la fonctionnalité », donne à l'agent une seule bouchée : un fichier, une fonction, un test. Les petites tâches sont plus faciles à vérifier, et l'agent s'égare moins.
Quand changer de cap, quand le faire toi-même
Si l'agent se trompe deux fois sur la même erreur, une troisième tentative identique ne change presque jamais rien. Change d'approche ou de modèle. Et parfois, 10 minutes à le taper toi-même valent mieux que 60 minutes à batailler avec un agent – alors fais-le.
EXEMPLE
L'agent « corrige » un test qui échoue en le supprimant. Réaction : arrête-toi. `git revert` vers le dernier commit bon. Nouveau brief resserré : « Corrige la logique réelle du test. Ne supprime jamais un test pour le faire passer. »
QUIZ RAPIDE
L'agent est clairement parti en vrille. Quelle est la première étape la plus sensée ?
SOURCES
- Doc Claude Code : workflows courants ↗ code.claude.com
- Anthropic : Building effective agents ↗ www.anthropic.com