開発者と AI エージェントのための Deep Work Plan

スキルで計画し、実行する

上記の API はエージェントがこのサイトを読み取ることを可能にします。DWP スキルは、エージェントが方法論を実行することを可能にするものです——リポジトリに一度インストールすれば、ルーターと九つのサブスキルが提供され、スラッシュコマンドとして(または名前で、スラッシュを傍受するエージェントの場合はほとんどが代わりに # を使います。例:#dwp-execute)呼び出せます。

二つの独立した選択:形式と、どれだけレビューを求めるか

すべての計画は、それぞれの軸から一つの値を選びます。この二つの軸は独立しています——Lite の計画で trust を実行することも、Full の計画で guided を実行することもでき、どちらも形式を変えずに後からモードを切り替えられます。

九つのサブスキル

各サブスキルは、スキルをインストールしたリポジトリの内部でスラッシュコマンドとして呼び出されます——このウェブサイトに対してではありません。それぞれの完全なリファレンスはキットカタログにあります。

実行する二つの方法

同じスキル、同じ九つのコマンド——変わるのはツールではなく、作業の規模とリスクに応じた形式とレビューモードです。

# 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

すべての計画の出力——マニフェスト、進捗ログ、タスク記録、ゲートの証拠——は、リポジトリ自体の中にある gitignore された .dwp/ ディレクトリの下に置かれます。deepworkplan.com に送信されたり保存されたりすることは一切なく、このスキルはネットワーク呼び出しを一切行いません。

エンドポイント

エージェント 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 と、削除の少なくとも 180 日前を示す Sunset 日付を伴い、Link ヘッダーが後継を指します。

レート制限

/api/* のレスポンスは RFC 9331 のレート制限ヘッダー——RateLimit-Limit、RateLimit-Remaining、RateLimit-Reset、RateLimit-Policy——を伴うため、エージェントはリアルタイムに自分のペースを調整できます。429 レスポンスには Retry-After が追加されます。実施はエッジでのベストエフォート（訪問者あたり 60 秒につき 120 リクエスト）で、アクセスは匿名のままです：キーも登録も階層もありません。

MCP サーバー

Streamable HTTP 上のステートレスな Model Context Protocol サーバーです。読み取り専用の 3 つのツール: 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

レンダリングされるすべてのページは、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 など）で動作します。

# 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/ ディレクトリにあります。

機械可読リソース

• ▸ 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 プロンプトを渡せば、スキルをインストールし、リポジトリをオンボードし、ディープワークを完了させ始めます。