Nexus Lab lançou como código aberto o ack-is-not-done-guard, um utilitário minúsculo que impede que agentes baseados em arquivos do Claude Code aleguem que uma tarefa está concluída até que alcancem um estado verificado de “proven done”. Desenvolvedores cansados de conclusões fantasmas agora têm uma proteção concreta para implementar em seus pipelines.
Por que a ferramenta é importante
Agentes do Claude Code leem e escrevem arquivos, um fluxo de trabalho que facilmente confunde o início de um processo com o seu fim.
Como funciona
O utilitário define quatro estados explícitos:
- Acknowledged – a tarefa é reconhecida.
- Working – o agente está processando ativamente.
- Artifact delivered – as saídas necessárias foram escritas.
- Proven done – todas as condições de conclusão foram satisfeitas.
Somente quando um agente atinge o estado “proven done” é que a proteção permite que uma alegação de conclusão passe. A verificação é leve; ela não monitora processos não relacionados nem atua como um framework de orquestração de grande escala. Ela se integra diretamente ao fluxo de trabalho baseado em arquivos que o Claude Code espera.
Quem ganha, quem fica de fora
Como a proteção foca estritamente em estados baseados em arquivos, ela não ajudará projetos que utilizam outras arquiteturas de agentes ou que necessitam de uma supervisão de fluxo de trabalho mais ampla. Essas equipes ainda devem depender de monitoramento externo ou lógica personalizada.
Conclusão
O ack-is-not-done-guard prova que um modelo de estado modesto e bem definido pode preencher uma lacuna de confiabilidade persistente em fluxos de trabalho de arquivos orientados por IA, oferecendo aos desenvolvedores uma maneira clara e de baixo overhead para confiar que o “concluído” de um agente realmente significa concluído.