Nexus Lab heeft ack-is-not-done-guard open-source gemaakt, een kleine utility die voorkomt dat file-based agents van Claude Code beweren dat een taak is voltooid voordat ze een geverifieerde “proven done”-status hebben bereikt. Ontwikkelaars die klaar zijn met phantom completions hebben nu een concrete guard die ze in hun pipelines kunnen implementeren.
Waarom dit hulpmiddel belangrijk is
Claude Code-agents lezen en schrijven bestanden, een workflow waarbij het begin van een proces gemakkelijk wordt verward met het einde ervan.
Hoe het werkt
De utility definieert vier expliciete statussen:
- Acknowledged – de taak is herkend.
- Working – de agent is actief bezig.
- Artifact delivered – de vereiste outputs zijn geschreven.
- Proven done – aan alle voltooiingsvoorwaarden is voldaan.
Pas wanneer een agent de status “proven done” bereikt, laat de guard een claim van voltooiing door. De controle is lichtgewicht; het monitort geen ongerelateerde processen en fungeert niet als een uitgebreid orchestration framework. Het sluit direct aan op de file-based workflow die Claude Code verwacht.
Wie profiteert en wie niet
Omdat de guard zich specifiek richt op file-based statussen, helpt het geen projecten die andere agent-architecturen gebruiken of bredere workflow-supervisie nodig hebben. Die teams moeten nog steeds vertrouwen op externe monitoring of aangepaste logica.
Conclusie
ack-is-not-done-guard bewijst dat een bescheiden, goed gedefinieerd statusmodel een hardnekkig gat in de betrouwbaarheid van AI-gestuurde file-workflows kan opvullen, waardoor ontwikkelaars een duidelijke manier met weinig overhead hebben om erop te vertrouwen dat “done” van een agent ook echt “klaar” betekent.