Claude Code
완전네이티브 WebFetch와 슬래시 명령을 갖춘 레퍼런스 구현.
오픈 방법론 · MIT · 에이전트 비종속
Deep Work Plan은 어떤 저장소든 구조화된 환경 — 컨텍스트, 가드레일, 지속되는 계획 — 으로 바꾸어, 어떤 코딩 에이전트든 정확하고 효율적으로 실행하며 장기 작업을 끝까지 완수합니다.
init.md 프롬프트를 복사하여 코딩 에이전트 — Claude Code, Cursor, Codex, 또는 다른 에이전트 — 에 붙여넣어 어떤 리포지토리든 AI-first로 만드세요.
Deep Work Plan은 리포지토리 자체가 하니스(harness)가 되는 스펙 주도 개발입니다.
문제와 해답
짧은 작업에서 코딩 에이전트는 놀라운 성능을 보입니다. 장기 미션 — 마이그레이션, 새 서브시스템, 수십 개 파일의 리팩터링 — 을 맡기면 표류합니다: 컨텍스트가 차고, 앞선 결정이 흐려지고, 수 시간의 작업이 한복간에서 멈춥니다.
Deep Work Plan 은 스펙 주도 개발로 답합니다. 지속되는 계획, 원자적 작업, 그리고 에이전트가 통과해야 하는 검증 게이트. 완료는 느낌이 아니라 — 검증 가능하고 리뷰 가능한 증거가 됩니다.
그리고 컨텍스트는 에이전트에게 가장 희소한 자원입니다. 그래서 하네스는 자기 자신의 지시사항 부하를 작고 감사 가능하게 유지하도록 설계되었습니다: 지시사항은 점진적으로 로드하고, 검증은 변경된 부분만 다루며, 학습은 작업 자리에서 이루어집니다. 플로우별 부하는 바이트로 측정되어 매 릴리스마다 공개됩니다 — 최신 릴리스에서는 실행 플로우가 45.7%, 재개 플로우가 67.5% 줄었습니다. 계획 자체도 같은 원리를 따릅니다: 범위가 한정된 수정에는 Lite 계획을, 몇 시간에 걸친 작업에는 Full 계획을 — 형식은 항상 작업의 범위를 따르며, 그 반대가 아닙니다.
완료가 무엇인지, 경계가 어디인지 정하는 것은 사람입니다. 계획이 의도를 담고, 에이전트가 시간을 소모합니다 — 늘 지켜볼 필요도, 이십 분마다 고칠 필요도 없습니다.
방법론 읽기 →
인간은 방향을 잡습니다. 에이전트가 실행합니다.
긴 작업은 어떤 모델의 컨텍스트도 채웁니다. 세부 사항은 사라지고 에이전트는 표류합니다. 서면 계획 — 원자적 작업, 검증 게이트, 재개 가능한 상태 — 이야말로 매 바퀴 돌아오는 기준입니다.
핵심 루프 보기 →
에이전트가 이탈하지 못하는 계획.
각 작업은 수용 기준과 통과해야 할 검사를 명시합니다. 에이전트가 완료된 느낌으로 끝낼 수는 없습니다 — 통과하거나, 아니면 작업은 열린 채로 남습니다.
사양 읽기 →
완료는 계약이지 감이 아닙니다.
컨텍스트, 도구, 가드레일, 상태는 어떤 에이전트나 읽을 수 있는 평범한 파일로 저장소 안에 살아 있습니다. 잠금도, 외부 두뇌도 없이 — 컨텍스트 초기화 이후에도 유지됩니다.
온보딩이 생성하는 것 보기 →
저장소가 곧 harness입니다.
컨텍스트는 에이전트에게 가장 희소한 자원입니다. 하네스는 점진적으로 로드하고, 변경된 부분만 검증하며, 작업마다 학습합니다 — 모든 플로우의 지시사항 부하는 측정되어 공개되고, 릴리스마다 갱신됩니다.
방법론 읽기 →
모든 토큰이 중요합니다.
추론 기반 온보딩
온보딩 흐름은 리포지토리의 실제 언어, 프레임워크, 패키지 관리자, 검증 명령을 살펴본 뒤, 그 리포지토리에 맞춘 산출물을 생성합니다. 범용 스텁은 실패로 간주됩니다.
매니페스트, 폴더 구조, CI를 읽어 실제 test, lint, build 명령을 추론한 뒤, 리포지토리를 개별 리포지토리 또는 오케스트레이터 허브로 분류합니다.
추론으로 작성된 AGENTS.md, 분류된 docs/ 계층, 그리고 주요 모듈마다 들어가는 README와 docs/ — 모두 플레이스홀더가 아니라 리포지토리의 실제 명령으로 채워집니다.
교차 에이전트용 .agents/ 디렉터리(스킬, 에이전트, 명령)와 .claude 및 .cursor → .agents 심링크를 만들고, CLAUDE.md를 AGENTS.md에 미러링하여 모든 도구가 하나의 진실 공급원을 읽도록 합니다.
Deep Work Plan 스킬을 연결하고 계획을 위한 gitignore된 .dwp/ 폴더를 생성한 뒤, 필수인 AI Diff Reviewer 로컬 리뷰를 설치하고, 필요하면 devcontainer 지원 같은 선택형 애드온을 추가로 얹습니다.
실행하면 무슨 일이 일어나는가
설치 방식을 고르거나 템플릿을 복사할 필요가 없습니다. 에이전트에게 한 줄을 건네면, 에이전트가 재사용 가능한 엔진인 스킬을 설치하고 리포지토리를 거기에 맞게 적응시킵니다.
deepworkplan.com/init.md의 온보딩 프롬프트와 그것이 링크하는 방법론, 스펙, 키트 — 곧 채택할 표준 — 를 읽습니다.
스킬은 모든 리포지토리에서 동일한 엔진입니다. 명령 한 줄로 라우터와 그 하위 스킬(create, execute, refine, resume, status, verify, onboard, author, upgrade)을 Claude Code, Cursor, Codex, Gemini, Copilot용으로 가져옵니다.
복사·붙여넣기가 아니라 실제 스택을 추론하여 AGENTS.md, 분류된 docs/ 트리, 모듈별 README, 추론된 .agents/ 키트, gitignore된 .dwp/를 작성합니다. 리포지토리가 하니스가 됩니다.
어떤 작업이든 장시간 Deep Work Plan을 생성하고 단계별로 실행합니다. 명시적인 인수 기준, 검증 게이트, 재개 가능한 상태와 함께 수 시간 동안 자율적으로 진행됩니다.
스킬은 어디서나 동일하게 설치됩니다. 적응되는 것은 리포지토리입니다 — 스택에 맞게 생성된 AGENTS.md, 문서, 추론된 .agents/ 키트. 이 분리가 방법론을 일회성 스캐폴드가 아니라 재사용 가능한 표준으로 만듭니다.
무엇을 얻는가
한 번의 실행, 원자적인 커밋. 모든 산출물은 Markdown이고 모든 변경은 감사 가능합니다.
플레이스홀더가 있는 템플릿이 아니라 리포지토리의 실제 스택, 명령, 구조에서 추론됩니다. CLAUDE.md는 AGENTS.md에 심링크됩니다.
아키텍처, 셋업, 표준, 문제 해결 — 그리고 코드베이스에서 생성된, 주요 모듈마다 들어가는 README와 docs/.
교차 에이전트용 .agents/ 디렉터리(스킬, 에이전트, 명령)와 .claude 및 .cursor → .agents 심링크로 모든 도구가 하나의 진실 공급원을 읽습니다.
create, execute, refine, resume, status, verify, onboard, author, upgrade — 리포지토리별 복사 없이 단일 스킬 팩으로 에이전트가 사용할 수 있습니다.
/dwp-verify는 스펙에 대비한 객관적 합격/불합격 보고서를 만들어, "AI-first"가 단언이 아니라 검증된 사실이 되게 합니다 — 모든 계획 이후 재검증도 가능합니다.
온보딩은 리포지토리를 개별 리포지토리(일반적인 경우) 또는 여러 리포지토리에 걸친 하위 계획을 조율하는 오케스트레이터 허브로 분류합니다.
author 하위 스킬(skill-create, agent-create)로 리포지토리가 자체 스킬, 에이전트, 명령을 발전시킬 수 있습니다. dependency-upgrade 같은 선택형 유지보수 애드온이 최신 상태를 유지하도록 돕습니다.
데몬도 외부 상태도 없습니다. 계획은 gitignore된 .dwp/ 폴더에 저장되며, 컨텍스트가 넘쳐도 git만으로 어떤 작업이든 재개됩니다.
에이전트
하나의 방법론, 여러 어댑터. Markdown은 프레임워크를 어떤 것에도 묶지 않습니다 — Markdown을 읽는 모든 에이전트가 Deep Work Plan을 실행할 수 있습니다.
네이티브 WebFetch와 슬래시 명령을 갖춘 레퍼런스 구현.
완전한 어댑터. WebFetch가 차단되면 오프라인 번들을 사용하세요.
오프라인 번들 권장. 규칙은 .codex/ 아래에 설치됩니다.
완전한 어댑터 — dwp-* 명령이 AGENTS.md와 # 절차를 통해 실행됩니다.
Gemini 2.5 Pro 이상이 필요하며 네이티브 WebFetch를 지원합니다.
오픈 소스. AGENTS.md를 네이티브로 읽고 # 명령으로 dwp-*를 실행합니다.
규칙과 # 명령 절차가 완전한 Deep Work Plan 루프를 구동합니다.
오픈 소스. Markdown 규칙과 # 명령이 모든 dwp-* 단계를 실행합니다.
네이티브 명령 표면을 갖춘 완전한 어댑터.
스택
이것은 템플릿이 아니라 추론 보조 자료입니다. 온보딩은 리포지토리의 실제 매니페스트를 읽고 스택별로 적응합니다 — 프리셋을 맹목적으로 복사하지 않습니다. 모노레포는 모듈별 문서를 받습니다.
두 가지 아키타입
온보딩은 아키타입에 따라 갈립니다. 대부분의 리포지토리는 개별 리포지토리입니다. 허브는 여러 리포지토리에 걸쳐 하위 Deep Work Plan을 조율합니다. 방법론은 둘 다 일급으로 다룹니다.
개별 저장소
자족적인 단일 코드베이스
오케스트레이터 허브
하위 저장소를 조정해요
하나의 주요 스택, 자체 검증 명령, 모듈별 문서를 갖춘 단일 코드베이스. 기본값이며, 리포지토리가 명백히 허브가 아닌 한 온보딩은 이를 가정합니다.
예를 들어 Django API, Vue 앱, TypeScript Lambda 서비스가 있습니다.
오케스트레이터 매니페스트를 통해 하위 리포지토리 전반의 작업을 조율하는 조율 리포지토리입니다. 각자 자신의 리포지토리에 커밋하는 하위 계획을 생성하며, 경계 규칙과 내비게이션 인덱스를 함께 둡니다.
예를 들어 다섯 개의 제품 리포지토리를 조율하는 허브가 있습니다.
방법론 대 도구
Deep Work Plan은 또 하나의 스캐폴더가 아닙니다. 스펙 주도 또는 스캐폴딩 도구 아래에 자리한 방법론 레이어이며, 장시간 자율 실행에 초점을 둡니다.
| 방법론 대 도구 | Deep Work Plan | 스캐폴딩 / 스펙 도구 |
|---|---|---|
| 주요 초점 | 장시간 자율 실행 | 스펙 또는 스캐폴드 생성 |
| 작업 단위 | Deep Work Plan(재개 가능한 세션) | 스펙 문서 또는 스캐폴드 |
| 상태 모델 | Git 네이티브 .dwp/ 폴더, 재개 가능 | 종종 외부 또는 IDE 내부 |
| 에이전트 결합 | 에이전트 비종속(Markdown과 Bash) | 종종 도구 또는 IDE 종속 |
| 컨텍스트 복구 | 컨텍스트 초과 후 재개 | 대개 작업을 다시 시작 |
| 라이선스 | MIT, 오픈 방법론 및 키트 | 경우에 따라 다름 |
기원
분산 팀을 위한 비동기 스탠드업을 만드는 회사 Dailybot이 구축했습니다. 우리는 사내에서 Deep Work Plan을 사용해 Django, Vue, TypeScript Lambda, Astro에 걸친 프로덕션 리포지토리를 에이전트가 조종할 수 있게 만들었습니다. 수개월의 프로덕션 사용 끝에 이 방법론을 MIT 라이선스로 공개했습니다.
리포지토리를 AI-first로 만드세요
에이전트에게 한 줄을 건네 /init.md를 가리키면 리포지토리가 AI-first가 됩니다. 스킬을 설치하고, 스택을 추론하고, 완전한 AGENTS.md 계층을 커밋합니다. 거기서부터 수 시간 동안 자율적으로 실행되는 Deep Work Plan을 생성하고 실행합니다.
에이전트와 개발자용MIT 라이선스 · 텔레메트리 없음 · 산출물은 gitignore된 .dwp/ 폴더로.