Nexus Lab은 Claude Code 파일 기반 에이전트가 검증된 “proven done” 상태에 도달하기 전까지 작업을 완료했다고 주장하는 것을 방지하는 작은 유틸리티인 ack-is-not-done-guard를 오픈 소스로 공개했습니다. 유령 완료(phantom completions) 현상에 지친 개발자들은 이제 파이프라인에 바로 적용할 수 있는 구체적인 가드(guard)를 갖게 되었습니다.
이 도구가 중요한 이유
Claude Code 에이전트는 파일을 읽고 쓰는 작업을 수행하는데, 이러한 워크플로우는 프로세스의 시작과 끝을 쉽게 혼동할 수 있습니다.
작동 방식
이 유틸리티는 네 가지 명시적인 상태를 정의합니다:
- Acknowledged – 작업이 인식됨.
- Working – 에이전트가 활발히 처리 중임.
- Artifact delivered – 필요한 결과물이 작성됨.
- Proven done – 모든 완료 조건이 충족됨.
에이전트가 “proven done” 상태에 도달했을 때만 가드가 완료 선언을 통과시킵니다. 이 체크 과정은 가볍습니다. 관련 없는 프로세스를 모니터링하거나 대규모 오케스트레이션 프레임워크 역할을 수행하지 않습니다. Claude Code가 기대하는 파일 기반 워크플로우에 직접 연결됩니다.
수혜자와 제외 대상
이 가드는 파일 기반 상태에만 집중하기 때문에, 다른 에이전트 아키텍처를 사용하거나 더 광범위한 워크플로우 감독이 필요한 프로젝트에는 도움이 되지 않습니다. 그러한 팀들은 여전히 외부 모니터링이나 커스텀 로직에 의존해야 합니다.
요점
ack-is-not-done-guard는 작지만 잘 정의된 상태 모델이 AI 기반 파일 워크플로우의 지속적인 신뢰성 문제를 해결할 수 있음을 증명하며, 개발자들에게 에이전트의 “done”이 정말로 완료를 의미한다는 것을 신뢰할 수 있는 명확하고 오버헤드가 적은 방법을 제공합니다.