Deep Work Plan для розробників і AI-агентів

Плануйте та виконуйте за допомогою skill

API вище дозволяє агенту читати цей сайт. Skill DWP — це те, що дозволяє агенту виконувати методологію: встановіть її один раз у репозиторії, і вона принесе роутер плюс дев’ять sub-skills, які викликаються як слеш-команди (або за назвою — для агентів, що перехоплюють слеш, більшість використовує # замість цього, наприклад #dwp-execute).

Два незалежні вибори: формат і скільки рев’ю ви хочете

Кожен план обирає одне значення для кожної осі. Вони незалежні — план Lite може працювати в trust, план Full може працювати в guided, і будь-який з них може перемкнути режим пізніше, не змінюючи формат.

Дев’ять sub-skills

Кожна sub-skill викликається як слеш-команда всередині репозиторію, що встановив skill, — не проти цього сайту. Повний опис кожної живе в каталозі кіта.

Два способи запустити це

Та сама skill, ті самі дев’ять команд — формат і режим рев’ю змінюються разом із розміром і ставками роботи, а не з інструментом.

# 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

Вивід кожного плану — маніфест, лог прогресу, записи завдань, докази gate — живе під ігнорованою git директорією .dwp/ у самому репозиторії. Нічого не надсилається на deepworkplan.com і не зберігається ним; skill взагалі не робить мережевих викликів.

Кінцеві точки

Основні кінцеві точки агентного API. Повна типізована специфікація — кожна операція, параметр і схема відповіді — живе в документі OpenAPI.

Невідомі шляхи /api/* повертають структуровану JSON-помилку з підказкою вирішення, а не HTML-сторінку помилки.

Версіонування та виведення з експлуатації

Версіоноване JSON-сімейство живе під /api/v1/ — index, sections, pages і health — а канонічні шляхи без версії (/llms.txt, /{page}.md, /api/mcp) належать до того ж контракту v1. Зміни, що ламають сумісність, виходять лише в новому сімействі /api/v{N+1}/ і ніколи всередині v1. Коли кінцеву точку виводять з експлуатації, її відповіді несуть Deprecation: true і дату Sunset щонайменше за 180 днів до вилучення, а заголовок Link указує на наступника.

Ліміти запитів

Відповіді на /api/* несуть заголовки лімітів RFC 9331 — RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset і RateLimit-Policy — щоб агенти могли самостійно регулювати темп у реальному часі; відповідь 429 додає Retry-After. Застосування — best-effort на мережевому краю (120 запитів за 60 секунд на відвідувача), а доступ залишається анонімним: без ключів, без реєстрації, без рівнів.

MCP-сервер

Безстановий сервер Model Context Protocol через Streamable HTTP. Три інструменти лише для читання: get_init_prompt, list_site_sections і read_page. Підтримуються версії протоколу 2025-03-26 і 2025-06-18; сесія не потрібна.

# 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 для агентів

Кожна відрендерена сторінка публікується як нативний вихідний Markdown — не конвертація з HTML. Запитуйте Markdown явно через суфікс URL або через узгодження вмісту 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 та інші).

# 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

Навичка вбудовується (vendoring) у .agents/skills/deepworkplan/ всередині вашого репозиторію, тож кожен агент, що торкається репозиторію, ділить ту саму методологію. Офіційна консольна утиліта deepworkplan CLI — клієнт без залежностей поверх того самого API (init, sections, read, open, mcp) — підготовлена до публікації в npm і до виходу живе в каталозі cli/ репозиторія сайту.

Машиночитні ресурси

• ▸ Специфікація OpenAPI (/openapi.json)
• ▸ Декларація доступу й авторизації агентів (/auth.md)
• ▸ Каталог API, RFC 9727 (/.well-known/api-catalog)
• ▸ Маніфест MCP (/.well-known/mcp.json)
• ▸ Контакт безпеки (/.well-known/security.txt)
• ▸ Дескриптор репозиторію сайту (/.well-known/dwp.json)

Скеровуйте на це агента

Найшвидший шлях і досі один рядок: дайте будь-якому агенту для коду промт /init — і він установить навичку, онбордить ваш репозиторій і почне завершувати глибоку роботу.