완료를 검증하는 클로드 코드 워크플로 엔진

AI 코딩 도구의 고질병은 '다 됐다'는 착각이다. 테스트도 통과 못 했는데 작업을 끝냈다고 선언하거나, 대화를 초기화(/clear)하면 그동안의 결정이 통째로 날아간다. 최근 공개된 오픈소스 도니클로드(DonnyClaude)는 클로드 코드(Claude Code)를 '검증 워크플로 엔진'으로 감싸, 정해진 검사를 통과하기 전에는 작업을 완료로 처리하지 못하게 막는다.

무슨 일인가 / 배경

클로드 코드는 코드를 만들어내는 데는 뛰어나지만 긴 프로젝트에는 약하다. 맥락이 길어지면 대화가 지저분해지고, 하나의 프롬프트가 기획·구현·리뷰·검증을 혼자 다 하려다 스스로 채점한 결과를 '완료'라 우기는 실패가 반복된다. 도니클로드는 여기에 지속 가능한 기획 계층과 결정론적 검증 루프를 덧씌운다. 프로젝트 상태를 .planning/ 폴더에 파일로 적어 두기 때문에, 대화를 초기화하거나 새 세션을 열어도 작업 맥락이 살아남는다.

핵심 짚어보기

작동 방식은 네 가지 축으로 요약된다.

• 큰 작업을 요구사항·의존성 관문(gate)이 걸린 명시적 단계로 쪼갠다.
• 일을 역할별 서브에이전트(기획자·구현자·리뷰어·검증자)에게 나눠 맡긴다.
• 엔진이 뒷받침하는 검사를 통과하기 전에는 완료 표시를 거부한다.
• npx donnyclaude 한 줄이면 엔진과 스킬·에이전트, 13개 언어용 코딩 규칙, 훅, 큐레이션된 MCP 설정까지 한 번에 깔린다.

설치물은 모두 사용자 범위인 ~/.claude/ 아래로 들어가며, 프로젝트를 시작하기 전까지는 작업 폴더를 건드리지 않는다. 기존 설정은 덮어쓰지 않고 백업(settings.json.bak)한 뒤 병합한다. npx donnyclaude --dry-run으로 무엇이 바뀔지 미리 확인할 수 있어, 설치 전에 안전하게 점검할 수 있다.

1인기업 실전 적용 포인트

• 혼자 여러 프로젝트를 오가는 1인기업이라면, 결정과 진행 상태를 .planning/ 같은 파일로 남기는 방식만 따라 해도 세션이 끊길 때 잃는 맥락을 크게 줄일 수 있다.
• '생성-리뷰-검증'을 한 프롬프트에 몰아넣지 말고 역할별 에이전트로 분리하면, 스스로 채점하다 놓친 버그를 다른 에이전트가 걸러낸다.
• 자동화 파이프라인에 '테스트·요구사항 통과 전 완료 금지' 게이트를 심어, 미완성 결과물이 배포까지 흘러가는 사고를 막아라.
• 설치는 반드시 --dry-run으로 변경 사항을 먼저 확인한 뒤 진행해, 기존 ~/.claude 설정이 훼손되지 않게 하라.

전망 / 주의점

아직 별점이 한 자릿수인 초기 프로젝트이고, 검증 게이트를 촘촘히 걸수록 속도는 느려진다는 절충이 따른다. 그럼에도 방향성은 분명하다. LLM 코딩 도구의 다음 승부처는 '코드를 잘 짜느냐'가 아니라 '언제 진짜로 끝났는지 판단하느냐'로 옮겨가고 있다. 모델의 자기 선언 대신 결정론적 검사로 완료를 판정한다는 발상은, 자동화를 실무에 맡기려는 1인기업에게 특히 중요한 안전장치다.

출처: 해커뉴스 Show HN (https://github.com/d0nmega/donnyclaude)