Nexus Lab udostępnił jako open-source ack-is-not-done-guard, niewielkie narzędzie, które zapobiega sytuacjom, w których oparte na plikach agenty Claude Code twierdzą, że zadanie zostało zakończone, zanim osiągną zweryfikowany stan „proven done”. Deweloperzy zmęczeni pozornymi ukończeniami mają teraz konkretny mechanizm zabezpieczający, który mogą wdrożyć w swoje potoki (pipelines).

Dlaczego to narzędzie jest ważne

Agenty Claude Code odczytują i zapisują pliki, co w procesie pracy może łatwo prowadzić do pomylenia początku procesu z jego końcem.

Jak to działa

Narzędzie definiuje cztery wyraźne stany:

  • Acknowledged – zadanie zostało rozpoznane.
  • Working – agent jest w trakcie aktywnego przetwarzania.
  • Artifact delivered – wymagane wyniki zostały zapisane.
  • Proven done – wszystkie warunki ukończenia zostały spełnione.

Dopiero gdy agent osiągnie stan „proven done”, mechanizm pozwala na zgłoszenie ukończenia zadania. Sprawdzanie jest lekkie; nie monitoruje niepowiązanych procesów ani nie działa jako pełnoskalowy framework do orkiestracji. Narzędzie integruje się bezpośrednio z opartym na plikach przepływem pracy, którego oczekuje Claude Code.

Kto zyskuje, a kto zostaje pominięty

Ponieważ mechanizm skupia się wąsko na stanach opartych na plikach, nie pomoże projektom korzystającym z innych architektur agentów lub wymagającym szerszego nadzoru nad przepływem pracy. Zespoły te muszą nadal polegać na zewnętrznym monitoringu lub własnej logice.

Podsumowanie

ack-is-not-done-guard udowadnia, że skromny, dobrze zdefiniowany model stanów może wypełnić trwałą lukę w niezawodności przepływów pracy opartych na plikach i AI, dając deweloperom jasny i mało obciążający sposób na upewnienie się, że „gotowe” zgłoszone przez agenta naprawdę oznacza koniec pracy.