DonnyClaude는 Claude Code에 내구성이 있는 계획 레이어(durable planning layer)와 결정론적 검증 게이트(deterministic verification gates)를 추가하여, 테스트와 체크를 통과하기 전까지 모델이 작업을 완료된 것으로 표시할 수 없도록 합니다. npx donnyclaude로 설치하세요.
핵심 요약 (Key Takeaways)
- DonnyClaude는 Claude Code에 내구성이 있는 계획 레이어(durable planning layer)와 결정론적 검증 게이트(deterministic verification gates)를 추가하여, 테스트와 체크를 통과하기 전까지 모델이 작업을 완료된 것으로 표시할 수 없도록 합니다.
- npx donnyclaude로 설치하세요.
변경 사항 — 특정 업데이트 (버전/날짜 포함)
DonnyClaude (v0.1)는 Claude Code를 위한 검증된 워크플로 엔진(verified workflow engine)으로, GitHub에 오픈 소스로 출시되었습니다. 이는 AI 코딩 도구의 근본적인 약점을 해결합니다. 즉, 모델이 테스트, 요구 사항 또는 보안 체크를 실제로 통과하기 전에 작업을 "완료"되었다고 선언할 수 있다는 점입니다.
Claude Code는 코드를 생성하는 데 매우 뛰어나지만, 장기 프로젝트에서는 어려움을 겪습니다. /clear 이후에 컨텍스트(Context)가 엉망이 되고, 결정 사항이 유실되며, 과부하된 하나의 프롬프트가 계획, 코딩, 리뷰 및 검증을 스스로 수행하려고 시도합니다. DonnyClaude는 Claude Code를 내구성이 있는 계획 레이어(durable planning layer)와 결정론적 검증 루프(deterministic verification loop)로 감쌉니다.
사용자에게 미치는 영향 — 일상적인 Claude Code 사용에 대한 구체적 영향
DonnyClaude는 다단계 프로젝트에서 Claude Code를 사용하는 방식을 변화시킵니다. 모델이 성공을 선언하는 것을 신뢰하는 대신, 다음과 같은 워크플로(workflow)를 강제합니다:
- 프로젝트 상태를
.planning/에 기록 — 작업 내용이 /clear 및 새로운 세션 이후에도 유지됩니다. 결정 사항이 채팅 기록 속에서 사라지지 않고 내구성을 갖습니다.
- 대규모 작업을 명시적인 단계로 분할 — 각 단계 사이에 요구 사항 및 의존성 게이트(dependency gates)를 배치합니다.
- 범위가 지정된 하위 에이전트(subagents)로 작업 라우팅 — 플래너(Planners), 구현자(Implementers), 리뷰어(Reviewers), 검증자(Verifiers)가 각자의 역할을 수행합니다.
- 작업 완료 표시 거부 — 엔진 기반의 체크를 통과할 때까지 작업을 완료로 표시하지 않습니다. 실제 테스트를 대신하여 "괜찮아 보임"이라고 말하는 상황은 더 이상 발생하지 않습니다.
대부분의 Claude Code 설정은 프롬프트 팩 (prompt packs) 형태입니다. 즉, 모델에게 전달되는 지시 사항만 변경할 뿐, 모델이 스스로 성공을 선언하는 것을 여전히 신뢰합니다. DonnyClaude는 단 하나의 아이디어를 중심으로 구축되었습니다. 모델이 작업을 생성하되, 완료 여부는 지속 가능한 상태 (durable state), 회의적인 검토 (skeptical review), 그리고 결정론적 게이트 (deterministic gates)에 의해 결정된다는 것입니다.
지금 바로 사용해 보세요 — 이를 활용하기 위한 명령어, 설정 또는 프롬프트
DonnyClaude 설치:
이 명령은 Donny 엔진, 기술 (skills), 에이전트 (agents), 13개 언어에 대한 코딩 규칙 (coding rules), 프로젝트 훅 (project hooks), 그리고 큐레이션된 MCP 설정 (실시간 문서를 위한 Context7, 브라우저를 위한 Playwright)을 설치합니다. 그 후 Claude가 직접 첫 번째 프로젝트를 안내합니다.
DonnyClaude
주요 명령어:
npx donnyclaude --dry-run — 설치 시 변경될 사항 미리보기 (쓰기 작업 없음)
npx donnyclaude doctor — 설치 상태 점검
npx donnyclaude diff — 설치된 파일과 현재 버전 간의 차이(drift) 확인
npx donnyclaude uninstall — DonnyClaude가 소유한 모든 파일 제거 (사용자 파일은 유지)
Claude Code 내부에서:
이 명령은 연구(research) → 요구사항 생성(requirements generation) 과정을 트리거합니다.
설치되는 항목:
~/.claude/skills/, agents/, commands/, hooks/, rules/ — 툴킷 (toolkit)
~/.claude/donny/ — 워크플로 엔진 (workflow engine)
~/.claude/bin/, cco-memory/, scrapers/, docs/, statusline.py — 지원 도구 (support tools)
~/.claude/CLAUDE.md — 전체 운영 가이드 (또는 기존 파일에 추가되는 멱등성 표준 블록 (idempotent standards block))
~/.claude/settings.json — 기존 설정과 병합되며 백업됨
- Context7 및 Playwright를 위한 MCP 등록
기존 설정은 덮어쓰지 않고 보존됩니다. 삭제(uninstall) 시에는 이 패키지가 제공하는 파일만 제거하며, CLAUDE.md에서 관리되는 블록만 제거하고, settings.json은 그대로 두며, 사용자가 직접 생성한 파일은 절대 건드리지 않습니다.
사용 시점
DonnyClaude는 다음과 같은 프로젝트에서 빛을 발합니다:
- 결정 사항을 잃지 않고
/clear 명령어를 견뎌내야 하는 경우
- 검증 게이트(Verification gates) (테스트, 보안 점검, 요구사항 충족 여부)를 강제하고 싶은 경우
- 계획, 구현, 리뷰 및 검증이 필요한 다단계(Multi-phase) 프로젝트를 진행하는 경우
- 모델이 자신의 출력을 스스로 채점하도록 신뢰하는 대신, 결정론적인(Deterministic) "완료" 체크를 원하는 경우
빠른 일회성 스크립트나 단일 파일 수정에는 DonnyClaude가 과할 수 있습니다. 하지만 "괜찮아 보이네"라는 말만으로는 충분하지 않은 모든 프로젝트에서, 이는 반드시 필요한 계층(Layer)입니다.
출처: github.com
원문 게시지: gentic.news