에이전트 및 개발자 표면

개발자와 AI 에이전트를 위한 Deep Work Plan

deepworkplan.com은 페이지와 함께 기계 판독 가능한 표면을 제공합니다. OpenAPI로 기술된 에이전트 API, 스테이트리스 MCP 서버, 17개 언어의 모든 페이지를 담은 네이티브 Markdown 미러, 그리고 설치 가능한 DWP 스킬입니다. 이 페이지의 모든 것은 라이브로 공개되어 있고 무료입니다 — 가입할 것이 전혀 없습니다.

설계부터 무인증

생성할 API 키도, OAuth 절차도, 프로덕션과 분리된 샌드박스도 없습니다 — 프로덕션 표면 자체가 샌드박스입니다. 이는 방법론의 의도적인 속성입니다. 에이전트는 "영업 문의" 양식을 작성할 수 없기에, 이 사이트는 그런 것을 절대 요구하지 않습니다.

읽기 전용

모든 작업은 안전하고 캐시 가능한 GET입니다 — POST를 사용하는 MCP 엔드포인트가 유일한 예외입니다. 어디에도 쓰기 작업, 업로드, 상태 변경은 존재하지 않습니다.

API 키 불필요

등록도, 토큰도, 속도 제한 티어도 없습니다. 익명 접근이 문서화된 계약이며, /auth.md와 OAuth 디스커버리 스텁에 선언되어 있습니다.

무료 및 오픈 소스

사이트 콘텐츠와 DWP 스킬은 MIT 라이선스입니다. 허락을 구하지 않고 상업적·비상업적 작업에 사용할 수 있습니다.

머신 퍼스트

/api 경로의 구조화된 JSON 오류, Markdown 404 복구 본문, RFC 9727 API 카탈로그, ARD 역량 매니페스트 — 에이전트 소비를 위해 구축되었습니다.

스킬로 계획하고 실행하기

위의 API는 에이전트가 이 사이트를 읽을 수 있게 해줍니다. DWP 스킬은 에이전트가 방법론을 실행할 수 있게 해주는 것입니다 — 리포지토리에 한 번 설치하면 라우터와 아홉 개의 하위 스킬이 함께 제공되며, 슬래시 명령으로 호출됩니다(또는 이름으로 호출합니다. 슬래시를 가로채는 에이전트는 대부분 대신 #을 사용합니다. 예: #dwp-execute).

두 가지 독립적인 선택: 형식, 그리고 원하는 검토의 정도

모든 계획은 각 축에서 하나의 값을 선택합니다. 이 두 축은 서로 독립적입니다 — Lite 계획도 trust로 실행할 수 있고, Full 계획도 guided로 실행할 수 있으며, 어느 쪽이든 형식을 바꾸지 않고 나중에 모드를 전환할 수 있습니다.

Lite

작업 기록은 계획의 README 안에, 안정적인 #task-N 앵커 뒤에 인라인으로 존재합니다 — 별도의 작업 파일은 없습니다. 범위가 작고 한정된 작업을 위해 만들어졌습니다: 하나의 관심사를, 대략 한 번의 작업 시간에. 그럼에도 완전한 계획입니다: 안정적인 작업 ID, Touched Surface, 인수 기준, 검증 게이트, 그리고 Final Review를 갖추고 있으며, 축소된 스케치가 아닙니다.

Full

N.task_<slug>.md 아래에 작업마다 하나의 파일을 둡니다. 몇 시간에서 며칠에 걸친 장기 작업이나, 계획에 작업 간 실제 의존성이 있을 때를 위한 것입니다. 간결한 기록만으로는 부족해지면 Lite 계획은 나중에 /dwp-refine promote로 Full로 승격할 수 있습니다 — 승격은 완료된 작업을 다시 실행하지 않습니다.

Guided (default)

dwp-create는 목표를 분석하고 분해하여, 검토 가능한 계획을 구체화합니다 — 이미 실제로 실행 가능한 계획이며, 버릴 수 있는 초안이 아닙니다 — 그런 다음 묻습니다: 그대로 유지할지, Lite를 Full로 승격할지, 편집할지, 아니면 중단할지. 실제 제품 작업이 시작되기 전에 사람이 루프 안에 머뭅니다. 처음 몇 번이나, 위험 부담이 더 큰 작업에 권장됩니다.

Trust (or auto)

마지막 단어로 trust(또는 auto)를 붙이면 — 예: /dwp-create <goal> trust — 에이전트는 검토 단계를 건너뛰고, 사전 승인된 계획을 구체화하여 실행 명령을 곧바로 반환합니다. 흐름을 신뢰하게 된 후의 파워 유저용 지름길입니다. 모든 결정과 게이트는 여전히 기록되며, 다만 확인을 위해 멈추지 않을 뿐입니다.

아홉 개의 하위 스킬

각 하위 스킬은 스킬을 설치한 리포지토리 내부에서 슬래시 명령으로 호출됩니다 — 이 웹사이트를 대상으로 하지 않습니다. 각각의 전체 레퍼런스는 키트 카탈로그에 있습니다.

아홉 개의 하위 스킬
`/dwp-create <goal>`	목표를 계획으로 바꿉니다 — 기본은 Lite, 더 큰 작업에는 Full, 어느 모드든 위 표를 따릅니다.
`/dwp-execute`	기존 계획을 작업 단위로 실행합니다: 계획 전체를 읽고, 각 작업을 순서대로 실행하고, 게이트를 검증하고, 진행 상황을 업데이트합니다.
`/dwp-refine`	완료된 작업과 그 기록된 증거를 보존하면서 기존 계획의 작업을 추가, 제거, 또는 재정렬합니다.
`/dwp-resume`	계획 자체의 파일에서 상태를 재구성하고, 중단된 계획을 첫 번째 미완료 작업부터 이어갑니다.
`/dwp-status`	계획의 진행 상황 — 완료, 진행 중, 대기 중인 작업 — 을 아무것도 변경하지 않고 보고합니다.
`/dwp-verify`	리포지토리가 AI-first인지, 그 계획들이 올바른 형식을 갖추었는지를 기계적으로 확인합니다. 아무것도 바꾸지 않으며, 통과 또는 실패만 보고합니다.
`/deepworkplan-onboard`	리포지토리를 AI-first로 만듭니다: 그 스택에 대해 추론한 다음, 적응된 AGENTS.md, docs/, .agents/, 그리고 gitignore된 .dwp/를 생성합니다.
`/skill-create, /agent-create`	작성자용 하위 스킬입니다: 리포지토리 자체의 키트를 키웁니다 — 반복 가능한 절차를 위한 재사용 가능한 스킬이나, 자체 모델과 도구를 가진 반복되는 역할을 위한 에이전트입니다.
`/dwp-upgrade`	더 새로운 공개 스킬 릴리스가 있는지 확인하고, 명시적 승인 후에만 그것을 설치하고 온보딩을 새로 다시 실행합니다 — .dwp/ 아래의 진행 중인 모든 계획은 그대로 유지됩니다.

실행하는 두 가지 방법

같은 스킬, 같은 아홉 개의 명령 — 도구가 아니라 작업의 규모와 위험 부담에 따라 형식과 검토 모드가 달라집니다.

작고 한정된 수정 — Lite, trust

하나의 관심사를, 대략 한 번의 작업 시간에, 위험 부담은 낮게: 검토 단계를 건너뛰고 에이전트가 Lite 계획을 곧바로 구체화하고 실행하게 합니다.

터미널 — 슬래시 명령

# A small, bounded fix: skip the review round, run it directly.
/dwp-create fix the flaky checkout test trust
/dwp-execute

장기적인 작업 — Full, guided

작업 간 실제 의존성이 있거나 위험 부담이 더 클 때: 실제 제품 작업이 시작되기 전에 제안된 계획을 검토하고, 목표에 필요하다면 Full로 승격한 다음, 필요에 따라 세션을 넘나들며 실행하고 재개합니다.

터미널 — 슬래시 명령

# Long-horizon work with real stakes: review before anything runs.
/dwp-create migrate the billing service to the new payments API
# ...review the proposed plan, then:
/dwp-execute
# ...interrupted? pick up again, even in a fresh session:
/dwp-resume

모든 계획의 결과물 — 매니페스트, 진행 로그, 작업 기록, 게이트 증거 — 은 리포지토리 자체 안의 gitignore된 .dwp/ 디렉터리 아래에 있습니다. deepworkplan.com으로 전송되거나 저장되는 것은 전혀 없습니다. 이 스킬은 어떠한 네트워크 호출도 하지 않습니다.

엔드포인트

에이전트 API의 핵심 엔드포인트입니다. 완전하고 타입이 지정된 스펙 — 모든 작업, 매개변수, 응답 스키마 — 은 OpenAPI 문서에 있습니다.

엔드포인트
`GET`	`/openapi.json`	전체 에이전트 API의 OpenAPI 3.1 스펙입니다.
`GET`	`/llms.txt`	엄선된 LLM 안내 인덱스 — 에이전트에게 권장되는 진입점입니다.
`GET`	`/init.md`	정식 DWP 채택 프롬프트(모든 리포지토리를 AI-first로 만듭니다).
`GET`	`/{page}.md`	모든 페이지를 네이티브 소스 Markdown으로 — 17개 언어 모두(예: /es/developers.md).
`GET`	`/api/health.json`	스펙과 이 포털로 연결되는 정적 헬스 마커입니다.
`GET`	`/api/v1/index.json`	v1 제품군의 버전 관리 카탈로그: 엔드포인트 경로, 사이트 버전, 스펙 링크.
`GET`	`/api/v1/sections.json`	타입이 지정된 JSON 사이트맵 — 각 섹션의 이름, 경로, 설명.
`GET`	`/api/v1/pages.json`	모든 언어의 Markdown 엔드포인트를 언어 코드별로 묶은 목록.
`GET`	`/api/v1/health.json`	버전 관리 상태 표시 — /api/health.json의 v1 미러.
`POST`	`/api/mcp`	MCP 서버(Streamable HTTP, 스테이트리스): initialize, ping, tools/list, tools/call.
`GET`	`/.well-known/ai-catalog.json`	ARD 역량 매니페스트 — robots.txt에 선언된 agentmap입니다.

알 수 없는 /api/* 경로는 해결 힌트를 포함한 구조화된 JSON 오류를 반환하며, HTML 오류 페이지는 결코 반환하지 않습니다.

버전 관리와 지원 중단

버전 관리 JSON 제품군은 /api/v1/ 아래에 있습니다(index, sections, pages, health). 버전이 없는 정규 경로(/llms.txt, /{page}.md, /api/mcp)도 같은 v1 계약에 속합니다. 호환성을 깨는 변경은 새로운 /api/v{N+1}/ 제품군으로만 출시되며 v1 내부에서는 절대 이루어지지 않습니다. 엔드포인트가 지원 중단되면 응답은 Deprecation: true와 제거 최소 180일 전의 Sunset 날짜를 담고, Link 헤더가 후속 경로를 가리킵니다.

요청 제한

/api/* 응답은 RFC 9331 요청 제한 헤더(RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset, RateLimit-Policy)를 담아 에이전트가 실시간으로 스스로 속도를 조절할 수 있으며, 429 응답에는 Retry-After가 추가됩니다. 적용은 엣지에서 최선(best-effort)으로 이루어지고(방문자당 60초에 120 요청), 접근은 익명으로 유지됩니다: 키도, 등록도, 등급도 없습니다.

MCP 서버

Streamable HTTP 위의 스테이트리스 Model Context Protocol 서버입니다. 세 가지 읽기 전용 도구: get_init_prompt, list_site_sections, read_page. 프로토콜 버전 2025-03-26과 2025-06-18을 지원하며 세션은 필요하지 않습니다.

터미널 — HTTP를 통한 JSON-RPC

# 1. Initialize (no session needed — the server is stateless)
curl -s https://deepworkplan.com/api/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize",
       "params":{"protocolVersion":"2025-06-18","capabilities":{},
                 "clientInfo":{"name":"curl","version":"1.0"}}}'

# 2. Discover the tools
curl -s https://deepworkplan.com/api/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

# 3. Call one — read any page as source Markdown
curl -s https://deepworkplan.com/api/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call",
       "params":{"name":"read_page","arguments":{"path":"/init"}}}'

MCP 매니페스트는 /.well-known/mcp.json에, 서버 카드는 /.well-known/mcp/server-card.json에 있습니다. Claude, ChatGPT, 그리고 모든 MCP 클라이언트가 이 도구들을 네이티브로 호출할 수 있습니다.

에이전트를 위한 Markdown

렌더링되는 모든 페이지는 HTML 변환이 아니라 네이티브 소스 Markdown으로 게시됩니다. URL 접미사로 Markdown을 명시적으로 요청하거나, 어떤 페이지에서든 HTTP 콘텐츠 협상을 통해 요청하세요.

터미널 — 콘텐츠 협상

# Ask for Markdown on any URL (content negotiation)
curl -s https://deepworkplan.com/methodology \
  -H 'Accept: text/markdown'

# Or fetch the .md mirror directly — every page has one, in every language
curl -s https://deepworkplan.com/es/developers.md

콘텐츠 협상은 사이트가 렌더링에 사용하는 것과 동일한 소스 Markdown을, 요청한 URL의 언어로 반환합니다.

키트 설치

Deep Work Plan 스킬의 공식 설치 경로입니다 — /init 엔드포인트가 에이전트에게 주는 것과 같은 명령입니다. skills 호환 코딩 에이전트(Claude Code, Cursor, Codex, Gemini 등)라면 무엇이든 작동합니다.

터미널 — skills CLI와 공식 CLI

# 1. Install the DWP skill — same command the /init endpoint gives agents
npx skills add DailybotHQ/deepworkplan-skill@latest

# 2. Official CLI — zero-dependency client over this API (Node >= 18),
#    prepared in the site repo's cli/ directory pending npm publication
deepworkplan init
deepworkplan read /es/developers

스킬은 리포지토리 내 .agents/skills/deepworkplan/에 벤더되므로, 리포지토리를 다루는 모든 에이전트가 같은 방법론을 공유합니다. 공식 deepworkplan CLI(동일한 API 위의 의존성 없는 클라이언트 — init, sections, read, open, mcp)는 npm 발행을 준비해 두었고, 출시 전까지 사이트 리포지토리의 cli/ 디렉터리에 있습니다.

기계 판독 가능 리소스

에이전트를 향하게 하세요

가장 빠른 길은 여전히 한 줄입니다. 어떤 코딩 에이전트에게든 /init 프롬프트를 건네면 스킬을 설치하고, 리포지토리를 온보딩하고, 깊은 작업을 완료하기 시작합니다.

/init 프롬프트 열기 방법론 읽기