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

Планируйте и выполняйте с помощью 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 — и он установит навык, онбордит ваш репозиторий и начнёт завершать глубокую работу.