Skip to content

오픈 방법론 · MIT · 에이전트 비종속

모델은 중요합니다. 컨텍스트는 더 중요합니다.

Deep Work Plan은 어떤 저장소든 구조화된 환경 — 컨텍스트, 가드레일, 지속되는 계획 — 으로 바꾸어, 어떤 코딩 에이전트든 정확하고 효율적으로 실행하며 장기 작업을 끝까지 완수합니다.

에이전트에 복사하기 https://deepworkplan.com/init.md

init.md 프롬프트를 복사하여 코딩 에이전트 — Claude Code, Cursor, Codex, 또는 다른 에이전트 — 에 붙여넣어 어떤 리포지토리든 AI-first로 만드세요.

Deep Work Plan은 리포지토리 자체가 하니스(harness)가 되는 스펙 주도 개발입니다.

바위 해안의 등대가 한 줄기 빛을 비추어 작은 배를 인도하는 모습 — 어떤 에이전트든 이끄는 든든한 하니스로서의 리포지토리를 떠올리게 하는 판화.
한쪽은 안개 속 암초 옆을 표류하는 배, 다른 쪽은 같은 배가 그려진 항로를 따라 항구 등불로 나아가는 모습의 판화 디프틱.

문제와 해답

짧은 작업에서 코딩 에이전트는 놀라운 성능을 보입니다. 장기 미션 — 마이그레이션, 새 서브시스템, 수십 개 파일의 리팩터링 — 을 맡기면 표류합니다: 컨텍스트가 차고, 앞선 결정이 흐려지고, 수 시간의 작업이 한복간에서 멈춥니다.

Deep Work Plan 은 스펙 주도 개발로 답합니다. 지속되는 계획, 원자적 작업, 그리고 에이전트가 통과해야 하는 검증 게이트. 완료는 느낌이 아니라 — 검증 가능하고 리뷰 가능한 증거가 됩니다.

컨텍스트는 에이전트에게 가장 귀한 자원입니다. 그래서 하네스는 자체 지시사항을 간결하고 감사할 수 있게 유지합니다. 지시사항은 단계적으로 로드되고, 검증은 변경된 부분에 집중하며, 각 작업에는 관련 컨텍스트가 제공됩니다. 플로우별 지시사항 용량을 바이트 단위로 공개해 그 부담을 확인할 수 있습니다. 계획도 작업에 맞춰 선택합니다. 범위가 정해진 수정에는 Lite, 몇 시간 걸리는 작업에는 Full을 사용합니다. 형식이 작업 범위를 따르므로 과정은 집중력을 유지하고 추적하기 쉽습니다.

방법론 · 제1막

완료가 무엇인지, 경계가 어디인지 정하는 것은 사람입니다. 계획이 의도를 담고, 에이전트가 시간을 소모합니다 — 늘 지켜볼 필요도, 이십 분마다 고칠 필요도 없습니다.

방법론 읽기 →

방법론 · 제2막

긴 작업은 어떤 모델의 컨텍스트도 채웁니다. 세부 사항은 사라지고 에이전트는 표류합니다. 서면 계획 — 원자적 작업, 검증 게이트, 재개 가능한 상태 — 이야말로 매 바퀴 돌아오는 기준입니다.

핵심 루프 보기 →

방법론 · 제3막

각 작업은 수용 기준과 통과해야 할 검사를 명시합니다. 에이전트가 완료된 느낌으로 끝낼 수는 없습니다 — 통과하거나, 아니면 작업은 열린 채로 남습니다.

사양 읽기 →

방법론 · 제4막

컨텍스트, 도구, 가드레일, 상태는 어떤 에이전트나 읽을 수 있는 평범한 파일로 저장소 안에 살아 있습니다. 잠금도, 외부 두뇌도 없이 — 컨텍스트 초기화 이후에도 유지됩니다.

온보딩이 생성하는 것 보기 →

방법론 · 제5막

컨텍스트는 에이전트에게 가장 희소한 자원입니다. 하네스는 점진적으로 로드하고, 변경된 부분만 검증하며, 작업마다 학습합니다 — 모든 플로우의 지시사항 부하는 측정되어 공개되고, 릴리스마다 갱신됩니다.

방법론 읽기 →

추론 기반 온보딩

어떤 리포지토리든 가리키세요. 복사·붙여넣기가 아니라 추론합니다.

온보딩 흐름은 리포지토리의 실제 언어, 프레임워크, 패키지 관리자, 검증 명령을 살펴본 뒤, 그 리포지토리에 맞춘 산출물을 생성합니다. 범용 스텁은 실패로 간주됩니다.

  1. 01

    스택과 아키타입을 추론합니다

    매니페스트, 폴더 구조, CI를 읽어 실제 test, lint, build 명령을 추론한 뒤, 리포지토리를 개별 리포지토리 또는 오케스트레이터 허브로 분류합니다.

  2. 02

    AGENTS.md, docs/, 모듈별 문서를 생성합니다

    추론으로 작성된 AGENTS.md, 분류된 docs/ 계층, 그리고 주요 모듈마다 들어가는 README와 docs/ — 모두 플레이스홀더가 아니라 리포지토리의 실제 명령으로 채워집니다.

  3. 03

    .claude 및 .cursor → .agents 심링크와 함께 .agents/를 구성합니다

    교차 에이전트용 .agents/ 디렉터리(스킬, 에이전트, 명령)와 .claude 및 .cursor → .agents 심링크를 만들고, CLAUDE.md를 AGENTS.md에 미러링하여 모든 도구가 하나의 진실 공급원을 읽도록 합니다.

  4. 04

    DWP 스킬을 설치하고 .dwp/를 구성합니다

    Deep Work Plan 스킬을 연결하고 계획을 위한 gitignore된 .dwp/ 폴더를 생성한 뒤, 필수인 AI Diff Reviewer 로컬 리뷰를 설치하고, 필요하면 devcontainer 지원 같은 선택형 애드온을 추가로 얹습니다.

실행하면 무슨 일이 일어나는가

지침은 한 줄. 나머지는 리포지토리가 합니다.

설치 방식을 고르거나 템플릿을 복사할 필요가 없습니다. 에이전트에게 한 줄을 건네면, 에이전트가 재사용 가능한 엔진인 스킬을 설치하고 리포지토리를 거기에 맞게 적응시킵니다.

  1. 01

    에이전트가 /init.md를 엽니다

    deepworkplan.com/init.md의 온보딩 프롬프트와 그것이 링크하는 방법론, 스펙, 키트 — 곧 채택할 표준 — 를 읽습니다.

  2. 02

    Deep Work Plan 스킬을 설치합니다

    스킬은 모든 리포지토리에서 동일한 엔진입니다. 명령 한 줄로 라우터와 그 하위 스킬(create, execute, refine, resume, status, verify, onboard, author, upgrade)을 Claude Code, Cursor, Codex, Gemini, Copilot용으로 가져옵니다.

  3. 03

    리포지토리를 적응시킵니다

    복사·붙여넣기가 아니라 실제 스택을 추론하여 AGENTS.md, 분류된 docs/ 트리, 모듈별 README, 추론된 .agents/ 키트, gitignore된 .dwp/를 작성합니다. 리포지토리가 하니스가 됩니다.

  4. 04

    계획하고 실행합니다

    어떤 작업이든 장시간 Deep Work Plan을 생성하고 단계별로 실행합니다. 명시적인 인수 기준, 검증 게이트, 재개 가능한 상태와 함께 수 시간 동안 자율적으로 진행됩니다.

스킬은 어디서나 동일하게 설치됩니다. 적응되는 것은 리포지토리입니다 — 스택에 맞게 생성된 AGENTS.md, 문서, 추론된 .agents/ 키트. 이 분리가 방법론을 일회성 스캐폴드가 아니라 재사용 가능한 표준으로 만듭니다.

무엇을 얻는가

에이전트가 자율적으로 일하는 데 필요한 모든 것.

한 번의 실행, 원자적인 커밋. 모든 산출물은 Markdown이고 모든 변경은 감사 가능합니다.

  • 리포지토리 루트의 AGENTS.md

    플레이스홀더가 있는 템플릿이 아니라 리포지토리의 실제 스택, 명령, 구조에서 추론됩니다. CLAUDE.md는 AGENTS.md에 심링크됩니다.

  • 분류된 docs/와 모듈별 문서

    아키텍처, 셋업, 표준, 문제 해결 — 그리고 코드베이스에서 생성된, 주요 모듈마다 들어가는 README와 docs/.

  • .claude 및 .cursor → .agents 심링크가 있는 .agents/

    교차 에이전트용 .agents/ 디렉터리(스킬, 에이전트, 명령)와 .claude 및 .cursor → .agents 심링크로 모든 도구가 하나의 진실 공급원을 읽습니다.

  • 설치된 Deep Work Plan 스킬

    create, execute, refine, resume, status, verify, onboard, author, upgrade — 리포지토리별 복사 없이 단일 스킬 팩으로 에이전트가 사용할 수 있습니다.

  • 직접 확인할 수 있는 적합성

    /dwp-verify는 스펙에 대비한 객관적 합격/불합격 보고서를 만들어, "AI-first"가 단언이 아니라 검증된 사실이 되게 합니다 — 모든 계획 이후 재검증도 가능합니다.

  • 두 가지 아키타입, 모두 처리

    온보딩은 리포지토리를 개별 리포지토리(일반적인 경우) 또는 여러 리포지토리에 걸친 하위 계획을 조율하는 오케스트레이터 허브로 분류합니다.

  • 리포지토리가 키워 가는 살아 있는 키트

    author 하위 스킬(skill-create, agent-create)로 리포지토리가 자체 스킬, 에이전트, 명령을 발전시킬 수 있습니다. dependency-upgrade 같은 선택형 유지보수 애드온이 최신 상태를 유지하도록 돕습니다.

  • Git 네이티브, 재개 가능, .dwp/

    데몬도 외부 상태도 없습니다. 계획은 gitignore된 .dwp/ 폴더에 저장되며, 컨텍스트가 넘쳐도 git만으로 어떤 작업이든 재개됩니다.

  • 다중 에이전트 위임 및 에코시스템 1.0

    격리된 워크트리, 게이트를 통한 검증된 증거, 선택형 고정 에코시스템 애드온을 통해 병렬 에이전트를 안전하게 조율합니다.

에이전트

이미 사용 중인 에이전트와 함께 작동합니다.

하나의 방법론, 여러 어댑터. Markdown은 프레임워크를 어떤 것에도 묶지 않습니다 — Markdown을 읽는 모든 에이전트가 Deep Work Plan을 실행할 수 있습니다.

Claude Code

완전

기본 슬래시 명령어를 갖춘 참조 구현체. 동작 검증 완료.

Cursor

완전

프로젝트 규칙과 .cursor → .agents 심볼릭 링크를 통한 전체 어댑터. 설치 검증 완료.

OpenAI Codex

완전

AGENTS.md와 # 명령어 절차를 통한 전체 어댑터. 동작 검증 완료.

GitHub Copilot

완전

전체 어댑터: dwp-* 명령어는 AGENTS.md와 # 절차를 통해 실행됩니다. 설치 검증 완료.

Gemini

완전

AGENTS.md와 # 명령어 절차를 통한 전체 어댑터. 설치 검증 완료.

OpenCode

완전

오픈 소스. AGENTS.md를 기본으로 읽고 # 명령어로 dwp-*를 실행합니다. 설치 검증 완료.

Windsurf

완전

규칙과 # 명령어 절차가 Deep Work Plan 전체 루프를 구동합니다. 설치 검증 완료.

Cline

완전

오픈 소스. Markdown 규칙과 # 명령어가 모든 dwp-* 단계를 실행합니다. 설치 검증 완료.

Antigravity

완전

Markdown 명령어 절차를 갖춘 전체 어댑터. 설치 검증 완료.

스택

중요한 스택을 위한 추론 프리셋.

이것은 템플릿이 아니라 추론 보조 자료입니다. 온보딩은 리포지토리의 실제 매니페스트를 읽고 스택별로 적응합니다 — 프리셋을 맹목적으로 복사하지 않습니다. 모노레포는 모듈별 문서를 받습니다.

  • Django DRF · Poetry
  • FastAPI Pydantic · Poetry
  • Vue Vite · TypeScript
  • React Next · Vite · TS
  • Astro Svelte/React · MDX
  • TypeScript · Node Express · Fastify
  • TypeScript · Lambda Serverless · SAM
  • Go Modules · stdlib
  • Rust Cargo · 2021+
  • Generic 모든 스택

두 가지 아키타입

개별 리포지토리, 또는 오케스트레이터 허브.

온보딩은 아키타입에 따라 갈립니다. 대부분의 리포지토리는 개별 리포지토리입니다. 허브는 여러 리포지토리에 걸쳐 하위 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 라이선스로 공개했습니다.

— Dailybot 엔지니어링 팀
Dailybot 알아보기

리포지토리를 AI-first로 만드세요

에이전트에게 깊은 작업을 맡기세요.

에이전트에게 한 줄을 건네 /init.md를 가리키면 리포지토리가 AI-first가 됩니다. 스킬을 설치하고, 스택을 추론하고, 완전한 AGENTS.md 계층을 커밋합니다. 거기서부터 수 시간 동안 자율적으로 실행되는 Deep Work Plan을 생성하고 실행합니다.

에이전트와 개발자용

MIT 라이선스 · 텔레메트리 없음 · 산출물은 gitignore된 .dwp/ 폴더로.