Deep Work Plan dành cho nhà phát triển và AI agent

Lập kế hoạch và thực thi bằng skill

API ở trên cho phép agent đọc trang web này. Skill DWP là thứ cho phép agent chạy phương pháp luận — cài đặt một lần vào một repository và nó cung cấp một router cùng chín sub-skill, được gọi dưới dạng slash command (hoặc theo tên, đối với các agent chặn dấu gạch chéo — hầu hết dùng # thay thế, ví dụ #dwp-execute).

Hai lựa chọn độc lập: định dạng, và mức độ rà soát bạn muốn

Mỗi kế hoạch chọn một giá trị từ mỗi trục. Hai trục này độc lập với nhau — một kế hoạch Lite có thể chạy ở chế độ trust, một kế hoạch Full có thể chạy ở chế độ guided, và cả hai đều có thể chuyển chế độ sau này mà không cần đổi định dạng.

Chín sub-skill

Mỗi sub-skill được gọi dưới dạng một slash command bên trong repository đã cài đặt skill — không phải nhắm vào trang web này. Tài liệu tham khảo đầy đủ cho từng cái nằm trong danh mục kit.

Hai cách để chạy nó

Cùng một skill, cùng chín lệnh — định dạng và chế độ rà soát thay đổi theo quy mô và rủi ro của công việc, chứ không phải theo công cụ.

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

# 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

Đầu ra của mỗi kế hoạch — manifest, nhật ký tiến độ, bản ghi tác vụ, bằng chứng cổng — nằm trong một thư mục .dwp/ được gitignore, bên trong chính repository. Không có gì được gửi đến hay lưu trữ bởi deepworkplan.com; skill này hoàn toàn không thực hiện bất kỳ lệnh gọi mạng nào.

Các endpoint

Các endpoint cốt lõi của API agent. Đặc tả hoàn chỉnh, có kiểu — mọi thao tác, tham số và schema phản hồi — nằm trong tài liệu OpenAPI.

Các đường dẫn /api/* không xác định trả về lỗi JSON có cấu trúc kèm gợi ý giải quyết, không bao giờ trả về trang lỗi HTML.

Quản lý phiên bản và đánh dấu lỗi thời

Họ JSON có phiên bản nằm dưới /api/v1/ — index, sections, pages và health — và các đường dẫn chính thức không có phiên bản (/llms.txt, /{page}.md, /api/mcp) thuộc cùng hợp đồng v1. Các thay đổi phá vỡ tương thích chỉ xuất hiện trong họ /api/v{N+1}/ mới, không bao giờ trong v1. Khi một endpoint bị đánh dấu lỗi thời, phản hồi của nó mang Deprecation: true và ngày Sunset ít nhất 180 ngày trước khi gỡ bỏ, và header Link chỉ đến phần thay thế.

Giới hạn tốc độ

Phản hồi trên /api/* mang các header giới hạn tốc độ RFC 9331 — RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset và RateLimit-Policy — để agent có thể tự điều chỉnh tốc độ theo thời gian thực; phản hồi 429 bổ sung Retry-After. Việc áp dụng là tốt nhất có thể ở biên (120 yêu cầu mỗi 60 giây mỗi khách truy cập) và quyền truy cập vẫn ẩn danh: không khóa, không đăng ký, không phân tầng.

Máy chủ MCP

Máy chủ Model Context Protocol không trạng thái qua Streamable HTTP. Ba công cụ chỉ đọc: get_init_prompt, list_site_sections, và read_page. Hỗ trợ phiên bản giao thức 2025-03-26 và 2025-06-18; không cần phiên làm việc.

# 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"}}}'

Manifest MCP nằm tại /.well-known/mcp.json và thẻ máy chủ tại /.well-known/mcp/server-card.json. Claude, ChatGPT và bất kỳ client MCP nào cũng có thể gọi các công cụ này một cách tự nhiên.

Markdown dành cho agent

Mỗi trang được kết xuất đều được xuất bản dưới dạng Markdown nguồn gốc — không phải chuyển đổi từ HTML. Hãy yêu cầu Markdown một cách tường minh bằng hậu tố URL hoặc qua đàm phán nội dung HTTP trên bất kỳ trang nào.

# 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

Đàm phán nội dung trả về đúng phần Markdown nguồn mà trang web dùng để kết xuất, bằng ngôn ngữ của URL bạn yêu cầu.

Cài đặt bộ kit

Đường dẫn cài đặt chính thức cho skill Deep Work Plan — cùng một lệnh mà endpoint /init đưa cho agent. Nó hoạt động với bất kỳ coding agent tương thích skills nào (Claude Code, Cursor, Codex, Gemini và các agent khác).

# 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

Skill được vendor vào .agents/skills/deepworkplan/ bên trong repository của bạn, nên mọi agent chạm đến repo đều dùng chung một phương pháp luận. CLI chính thức deepworkplan — một ứng dụng khách không phụ thuộc trên cùng API này (init, sections, read, open, mcp) — đã sẵn sàng cho npm và nằm trong thư mục cli/ của repository trang web cho đến khi xuất bản.

Tài nguyên máy có thể đọc được

• ▸ Đặc tả OpenAPI (/openapi.json)
• ▸ Tuyên bố truy cập và xác thực agent (/auth.md)
• ▸ Danh mục API, RFC 9727 (/.well-known/api-catalog)
• ▸ Manifest MCP (/.well-known/mcp.json)
• ▸ Liên hệ bảo mật (/.well-known/security.txt)
• ▸ Bộ mô tả repo trang web (/.well-known/dwp.json)

Trỏ một agent vào nó

Con đường nhanh nhất vẫn là một dòng: đưa lời nhắc /init cho bất kỳ coding agent nào và nó sẽ cài skill, onboard repository của bạn, và bắt đầu hoàn thành deep work.