Nexus Lab ha rilasciato in open source ack-is-not-done-guard, una piccola utility che impedisce agli agenti basati su file di Claude Code di dichiarare che un compito è terminato finché non raggiungono uno stato verificato di "proven done". Gli sviluppatori stanchi delle "completazioni fantasma" hanno ora una protezione concreta da inserire nelle proprie pipeline.
Perché lo strumento è importante
Gli agenti di Claude Code leggono e scrivono file, un flusso di lavoro che può facilmente confondere l'inizio di un processo con la sua fine.
Come funziona
La utility definisce quattro stati espliciti:
- Acknowledged – il compito è riconosciuto.
- Working – l'agente è in fase di elaborazione attiva.
- Artifact delivered – gli output richiesti sono stati scritti.
- Proven done – tutte le condizioni di completamento sono soddisfatte.
Solo quando un agente raggiunge lo stato “proven done”, la protezione permette il passaggio della dichiarazione di completamento. Il controllo è leggero; non monitora processi non correlati né funge da framework di orchestrazione su larga scala. Si integra direttamente nel flusso di lavoro basato su file previsto da Claude Code.
Chi ne beneficia e chi ne resta escluso
Poiché la protezione si concentra strettamente sugli stati basati su file, non aiuterà i progetti che utilizzano altre architetture di agenti o che necessitano di una supervisione del flusso di lavoro più ampia. Quei team dovranno comunque fare affidamento su un monitoraggio esterno o su una logica personalizzata.
In sintesi
ack-is-not-done-guard dimostra che un modello di stato modesto e ben definito può colmare una persistente lacuna di affidabilità nei flussi di lavoro basati su file guidati dall'IA, offrendo agli sviluppatori un modo chiaro e con un basso carico di gestione per avere la certezza che il “fatto” di un agente significhi realmente fatto.