Nexus Lab hat ack-is-not-done-guard als Open-Source-Tool veröffentlicht – ein winziges Hilfsprogramm, das verhindert, dass dateibasierte Claude Code-Agenten behaupten, eine Aufgabe sei abgeschlossen, bevor sie einen verifizierten „proven done“-Zustand erreicht haben. Entwickler, die genug von Schein-Abschlüssen haben, verfügen nun über einen konkreten Schutzmechanismus, den sie in ihre Pipelines integrieren können.

Warum das Tool wichtig ist

Claude Code-Agenten lesen und schreiben Dateien – ein Workflow, bei dem der Beginn eines Prozesses leicht mit dessen Ende verwechselt werden kann.

Funktionsweise

Das Hilfsprogramm definiert vier explizite Zustände:

  • Acknowledged – die Aufgabe wurde erkannt.
  • Working – der Agent arbeitet aktiv daran.
  • Artifact delivered – die erforderlichen Ausgaben wurden geschrieben.
  • Proven done – alle Abschlussbedingungen sind erfüllt.

Erst wenn ein Agent den Zustand „proven done“ erreicht, lässt der Guard die Meldung über den Abschluss zu. Die Prüfung ist leichtgewichtig; sie überwacht keine nicht damit zusammenhängenden Prozesse und fungiert nicht als umfassendes Orchestrierungs-Framework. Sie lässt sich direkt in den dateibasierten Workflow integrieren, den Claude Code erwartet.

Wer profitiert, wer nicht

Da sich der Guard eng auf dateibasierte Zustände konzentriert, hilft er Projekten nicht weiter, die andere Agenten-Architekturen nutzen oder eine umfassendere Workflow-Überwachung benötigen. Diese Teams müssen weiterhin auf externes Monitoring oder eigene Logik zurückgreifen.

Fazit

ack-is-not-done-guard beweist, dass ein bescheidenes, gut definiertes Zustandsmodell eine dauerhafte Lücke in der Zuverlässigkeit von KI-gesteuerten Datei-Workflows schließen kann. Es bietet Entwicklern eine klare, ressourcenschonende Möglichkeit, darauf zu vertrauen, dass das „Done“ eines Agenten auch wirklich „fertig“ bedeutet.