Nexus Lab a publié en open source ack-is-not-done-guard, un minuscule utilitaire qui empêche les agents de Claude Code basés sur les fichiers de prétendre qu'une tâche est terminée tant qu'ils n'ont pas atteint un état vérifié de « proven done ». Les développeurs lassés des complétions fantômes disposent désormais d'une protection concrète à intégrer dans leurs pipelines.
Pourquoi cet outil est important
Les agents Claude Code lisent et écrivent des fichiers, un flux de travail qui peut facilement confondre le début d'un processus avec sa fin.
Comment ça marche
L'utilitaire définit quatre états explicites :
- Acknowledged – la tâche est reconnue.
- Working – l'agent est en cours de traitement.
- Artifact delivered – les sorties requises ont été écrites.
- Proven done – toutes les conditions de complétion sont satisfaites.
Ce n'est que lorsqu'un agent atteint l'état « proven done » que la protection autorise la validation de la complétion. Le contrôle est léger ; il ne surveille pas les processus non liés et ne fait pas office de framework d'orchestration complet. Il s'intègre directement dans le flux de travail basé sur les fichiers attendu par Claude Code.
Qui en profite et qui est laissé de côté
Comme la protection se concentre exclusivement sur les états basés sur les fichiers, elle n'aidera pas les projets utilisant d'autres architectures d'agents ou nécessitant une supervision de flux de travail plus large. Ces équipes doivent toujours s'appuyer sur une surveillance externe ou une logique personnalisée.
À retenir
ack-is-not-done-guard prouve qu'un modèle d'état modeste et bien défini peut combler une lacune de fiabilité persistante dans les flux de travail de fichiers pilotés par l'IA, offrant aux développeurs un moyen simple et léger de s'assurer que le « terminé » d'un agent signifie réellement terminé.