deepworkplan

DeepWorkPlan — 方法論スキル（ルーター）

モデルも重要ですが、コンテキストはそれ以上に重要です。DeepWorkPlan スキルは、あらゆるリポジトリを、コンテキスト、ガードレール、永続的な計画を備えた構造化環境へと変え、あらゆるコーディングエージェントが短期または長期の作業を確実に実行できるようにします。リポジトリを「AI ファースト」にし（AGENTS.md + docs/ + モジュールごとのドキュメント + .agents/（.claude → .agents および .cursor → .agents のシンボリックリンクを含む））、構造化された Deep Work Plans を実行します。範囲が限定された作業には Lite プラン、長期の作業には Full タスクファイルプランを使います。AI エージェントがタスクごとにプランを作成、調整、実行し、中断したところから再開します。すべてのプラン出力は、リポジトリのルートにある Git の追跡対象外の .dwp/ ディレクトリ（.dwp/plans/）に保存されます。

信頼できる情報源：https://deepworkplan.com。ライセンス：MIT。

まずはこちら（初回実行）

このスキルは、それだけで使えるエントリーポイントです。開発者が https://deepworkplan.com/init.md からアクセスした場合でも、 このスキルをインストールした場合でも、セットアップ手順は同じです。 ここにすべて含まれているため、ネットワークは必要ありません。

リポジトリがまだ AI ファーストでない場合 — ルートに AGENTS.md がなく、 .agents/ ディレクトリもない場合 — 開発者の依頼が曖昧（「セットアップして」、 「このリポジトリを AI ファーストにして」、または単なるインストール）であっても、 最初に推奨するのはオンボーディングです。他のルートへ振り分ける前に：

1. 標準をローカルで読む。 spec/（v5 のベースと v6 の拡張）および shared/adaptation.md を読みます。 最優先のルールは REASON, do not copy-paste（考えて適応し、コピー＆ペーストしない）です。 このスキルは再利用可能なエンジンです。作成するものはテンプレートではなく、 このリポジトリに合わせて調整する必要があります。
2. オンボーディングを実行する。 onboard/SKILL.md を読み、実行します。 これは非破壊的です。既存の AGENTS.md、docs/、.agents/、または CLAUDE.md を検出して、上書きではなく整合させ、何かを置き換える前には 開発者に確認します。結果として、AGENTS.md + CLAUDE.md のシンボリックリンク、 根拠に基づいた docs/ ツリー、モジュールごとのドキュメント、.agents/ キット、 および Git の追跡対象外の .dwp/ が作成され、リポジトリがエージェントの 実行基盤になります。
3. 適合状況を検証する。 verify/SKILL.md を読み、実行して、 リポジトリが標準を満たすようになったことを客観的に確認します （実際に使えるコマンドを含む AGENTS.md、.agents/ カタログ、 Git の追跡対象外の .dwp/ など）。
4. その後、計画して実行する。 実行基盤が整ったら、Deep Work Plans （以下を参照）を作成して実行します。これは、エージェントが何時間も自律的に 実行できる、長期的で、ゲート付きの、中断後に再開可能な作業です。

リポジトリはすでに AI ファーストだが、その実行基盤がこのスキルより古い場合 — AGENTS.md / .agents/ は存在するものの、DWP standard: の来歴行がない、 来歴行が以前のシリーズ（2.x、4.x、5.x。spec/V6_LIFECYCLE.md を参照）のもの、 docs/TESTING_GUIDE.md に標準で必要なスコープ指定付き実行とマッピングの内容が 欠けている、またはエージェントルールに spec/DOCUMENTATION_STANDARD.md §2.3.1 で 説明されている作業原則が欠けている（同等の表現でも可）場合 — 他のルートへ振り分ける 前に、対象を絞った実行基盤のアップグレードを提案します。 古くなっている点を一行で伝えてから、onboard/SKILL.md を upgrade モード（Phase 0）で実行します。このモードでは、不足または古くなった部分 のみを整合させ、手書きのセクション、カスタムスキル、進行中のプランはそのままにし、 2 回目の実行では変更を加えません。開発者が代わりにスキル自体を最新にしたい （より新しい公開バージョンを使いたい、または初期化を最初から最後までやり直したい） 場合は、upgrade/SKILL.md へ振り分けます。このスキルは 最新の公開タグを確認し、明示的な同意があった場合にのみダウンロードして、新規初期化として オンボーディングを再実行します。.dwp/ のプランは決して移行されません。 進行中のプランには記録済みのライフサイクルが保持されます。プランの移行は、 独立した明示的な refine migrate 操作です。開発者が断った場合は、通常どおり 意図に応じて振り分けます。

無人実行では相違点を記録し、提案のために停止することはありません。
trust／auto または事前承認済みの計画のもとでは、その提案はすでに確認の承認が取り消されていることを意味します。したがって、質問するのではなく、作業者が確認できる場所に書き留めてください（計画フローでは README のメモと PROGRESS.md、それ以外の場合はそのフロー自体のレポート）。そして、意図に応じて振り分けてください。古いハーネスは、任意のツールが不足している場合（spec/AGENT_PROTOCOL.md §7.2）と同様に、記録すべき所見です。質問にしてはならず、黙って省略してもなりません。

AI ファースト化が部分的なリポジトリも、同じ分岐に進みます。 上記の分岐は明確なケースですが、実際のリポジトリは中間の状態にあります（.agents/ のない AGENTS.md、由来を示す行のない .agents/、テストガイドのないドキュメントなど）。ハーネスの一部はあるもののすべては揃っていないリポジトリは、新規ではなく古いハーネスがあるものとして扱います。不足分だけを追加する upgrade モードの onboard で調整してください。ハーネスの一部がすでにあるリポジトリで、最初から再オンボーディングしてはなりません。手書きの作業を上書きするおそれがあるのは、この方法だけです。

リポジトリがすでに最新の AI ファースト状態である場合、オンボーディングを省略し、意図に応じて黙って振り分けてください。検出や振り分けの判断を告げてはなりません（「このリポジトリはすでに AI ファーストです」／「create サブスキルに振り分けます」といった前置きは禁止です）。該当するサブスキルのフローをそのまま開始してください。

機能

これはルーターです。フロー自体は実行せず、開発者の意図を適切なサブスキルに振り分け、そのサブスキルの SKILL.md を読み、そこで実行するようエージェントに指示します。

信頼境界（書き込み範囲）

allowed-tools には、委譲先のサブスキルが必要とする書き込み可能な Edit、Write、Bash が含まれています。ルーター自体が行うのは、リポジトリツリー、ローカルの spec/、shared/、サブスキルのファイルを読み取ることだけです。書き込みは委譲先のサブスキル内で行われ、各サブスキルが独自の信頼境界を定めています。

• オンボーディングでは AGENTS.md、docs/、モジュールごとのドキュメント、.agents/ に書き込み、.gitignore に追記します。既存の内容を上書きせず、調整し、置き換えが必要な場合は事前に確認します。
• 作成／改善では、Git で無視される .dwp/ ディレクトリ内の計画成果物にのみ書き込みます。
• 実行／再開では、各タスクの検証を条件として、タスクの出力、進捗、タスクごとのコミットを書き込みます。シークレットをコミットすることはなく、開発者の指示なしにプッシュすることもありません。
• アドオンでは、開発者が提案を明示的に承諾した後に限り、固定され検証済みのインストール経路を通じて、インストールまたは設定を行います。

次の行為は禁止です。コアフローでのネットワーク呼び出し、認証情報の読み取りやコミット、事前確認なしのインストーラー実行、上記の対象範囲外への書き込み。保証の全容と実行可能な自己監査については、TRUST.md を参照してください。

---

エージェント向け — ルーティングルール

開発者が構造化された作業の計画、実行、管理、またはリポジトリの AI エージェント対応を望んでいる場合、以下に基づいて意図を特定し、該当するサブスキルの SKILL.md を読んで実行してください。直接回答してはいけません。各サブスキルに、手順の全体が記載されています。

開発者の発言…	ルーティング先
"create a plan", "plan this small fix", "organize this work", "new deep work plan", "/dwp-create"	作成 → create/SKILL.md を読む
"execute the plan", "run the plan", "/dwp-execute"	実行 → execute/SKILL.md を読む
"modify the plan", "change the scope", "/dwp-refine"	修正 → refine/SKILL.md を読む
"resume", "continue the interrupted plan", "/dwp-resume"	再開 → resume/SKILL.md を読む
"plan status", "what's left", "/dwp-status"	ステータス → status/SKILL.md を読む
"verify", "is this repo AI-first?", "check conformance", "/dwp-verify"	検証 → verify/SKILL.md を読む
"make this repo AI-first", "onboard this repo", "set up AGENTS.md + docs + .agents"	オンボーディング → onboard/SKILL.md を読む
"upgrade DWP", "update the skill", "is there a newer version?", "/dwp-upgrade"	アップグレード → upgrade/SKILL.md を読む
"create/update a skill or agent", "evolve the kit", "/skill-create", "/agent-create"	作成 → author/SKILL.md を読む

計画と既存作業の管理のどちらを意図しているのか曖昧な場合は、ルーティングする前に開発者に確認してください。

表のすべての行に適用される有効化ルール：

• 通常の直接編集が、黙って計画に変わることはありません。 「このバグを修正して」「この関数の名前を変更して」「READMEを更新して」といった依頼には直接対応します。Deep Work Planを開始するのは、開発者が計画を求めた場合（またはフローを明示的に選択した場合）に限られます。ルーティング表は、依頼されたフローに対応するものであり、介入の方針ではありません。
• trustはフローの選択基準ではありません。 trust / auto は、開発者が依頼したフロー内での無人継続を許可します。読み取り専用の依頼を実行に拡大することも、直接編集を計画に変えることもありません。
• ステータスと検証は読み取り専用です。 状況を報告するだけで、タスクを実行したりファイルを変更したりすることはありません。呼び出し方法にかかわらず、これは変わりません。
• 計画の生成形式は判定するものであり、推測してはいけません。 manifest.json のコントラクトポインター、contract.json、または contracts/ の改訂履歴を含む計画フォルダーは v6（コントラクト生成 v6 または v7、spec/V7_CONTRACT.md）です。作成と実行では、v6.md のループ（コントラクト、ジャーナル、スケジューラー、検証済みの完了）を通じて処理してください。それ以外は記録済みのv5ライフサイクルを維持し、黙って移行してはいけません。v6計画に遭遇したv5専用ランナーは、近似的な処理を行うのではなく、未サポートとして報告します。両方の世代を1つの .dwp/ 内で併用できます。
• スラッシュコマンドのないホストでも、フロー名を使って同じフローを実行できます。 サブスキルを #deepworkplan-create として呼び出すか、プレーンテキストで「run deepworkplan-create」と入力してください。フロー自体は、プレーンなファイルの読み取り、編集、シェルコマンドで構成されています（shared/troubleshooting.md §5に機能の代替手段が記載されています）。フローの検出はローカルで行われます。パックとリポジトリの .agents/ インデックスはディスク上にあり、ネットワークサービスを経由してルーティングされることはありません。

規範仕様（スキルに同梱）

正式な標準は spec/ にあります。維持されているv5の基本文書と、現在の4つのv6拡張が含まれています。標準をエージェントがネットワーク接続なしでローカルに読めるよう、スキルに同梱されています。onboard フローと shared/adaptation.md は、成果物を作成する際の標準としてこれを参照します。公開レンダリング版は https://deepworkplan.com/spec にあります。

すべてのサブスキルで使用する共有リソース

• shared/context.sh — リポジトリのルート、ブランチ、エージェントツールを検出し、.dwp/ の出力先を解決します。
• shared/dwp-paths.md — .dwp/ の出力規約（計画は .dwp/plans/ の下に配置）と、その上書き方法を説明します。
• shared/adaptation.md — コピー＆ペーストよりも推論を重視する原則と、2 種類のリポジトリの構成（個別リポジトリとオーケストレーターハブ）を説明します。
• shared/troubleshooting.md — すでに問題が発生している場合にのみ読みます。検出の失敗、古いインストール、テストコマンドの欠落、ホスト機能の非対応、状態の不整合が対象です。

アドオン — 必須のローカルレビューが 1 つ、オプトインが 7 つ

addons/ ディレクトリには、onboard がリポジトリに適用する内容が含まれています。すべてのリポジトリにパックと AI Diff Reviewer のローカルレビューが適用されます（2.3.0 以降のベースライン：フェーズ 7a でインストールされ、Final Review のたびに実行されます）。残りの 7 つはオプトインです。オプションのアドオンを 1 つも導入しなくても、リポジトリは完全に準拠できます。セットアップや更新の依頼があった場合、またはハーネスのアップグレード時に、オンボーディングではすべてのアドオンを検出し、使用中のアドオンをアップグレードして、適合するアドオンを提案します。