Skip to content
← すべての仕様ドキュメント

適合性

バージョン 1.0。状態: 安定。 この文書は、リポジトリが Deep Work Plan に適合している とはどういうことか、すなわち AI-first でエージェントが操縦できるとはどういうことかを定義します。キーワード MUST、MUST NOT、SHOULD、SHOULD NOT、MAY は、RFC 2119 に記述されたとおりに解釈されます。

適合性が存在するのは、「AI-first」が印象ではなく、客観的で確認可能な性質であるためです。リポジトリは以下の基準を満たすか、満たさないかのいずれかです。verify サブスキル（/dwp-verify）がそれらを機械的に確認します。

適合したリポジトリ

DWP に適合したリポジトリは、以下のすべてを満たさなければなりません（MUST）。すべての成果物は、その実際の言語、フレームワーク、コマンドに適応された、リポジトリのために推論されたものでなければなりません（MUST）。汎用のひな形、プレースホルダー、あるいは別のリポジトリからコピーされた内容は、基準を満たしません。

  1. ルートの AGENTS.md。 リポジトリは、(a) ドキュメントの索引、(b) リポジトリの必須ルール、(c) コマンドがこのリポジトリで実際に存在し実行可能な Quick Commands ブロックを含むルートの AGENTS.md を含まなければなりません（MUST）。プレースホルダーのコマンド（たとえば npm を使わないリポジトリでの npm test）は現れてはなりません（MUST NOT）。
  2. CLAUDE.md は AGENTS.md に解決される。 CLAUDE.md は存在し、AGENTS.md に解決されなければなりません（MUST）（シンボリックリンク、または単一の信頼できる情報源を保証する同等のもの）。両者は食い違ってはなりません（MUST NOT）。
  3. docs/ 階層。 リポジトリは、標準的なカテゴリ（アーキテクチャ、規約、テスト、開発コマンド、セキュリティ、エージェントのオンボーディング）を、実際のリポジトリ固有の内容でカバーする docs/ ディレクトリを含まなければなりません（MUST）。複雑なモジュールは独自の README.md を備えるべきです（SHOULD）。
  4. .agents/ 拠点。 リポジトリは、agents/、commands/、skills/ を備えた .agents/ ディレクトリと、ディスク上にあるものと一致する .agents/docs/ 配下のカタログを含まなければなりません（MUST）。dwp-* コマンドは、インストールされたスキルへの薄い委譲でなければなりません（MUST）。.claude パスは .agents に解決されなければなりません（MUST）。
  5. gitignore された .dwp/ 作業領域。 リポジトリは、plans/ と drafts/ を備えた .dwp/ ディレクトリを含まなければならず（MUST）、.dwp/ は gitignore されていなければなりません（MUST）。tmp/ スクラッチ領域は存在すべきであり（SHOULD）、gitignore されているべきです（SHOULD）。
  6. 方法論スキルが解決可能。 Deep Work Plan スキルは、リポジトリ内のエージェントがそのサブスキルを呼び出せるよう、インストールまたは参照されていなければなりません（MUST）。

リポジトリはアドオンがゼロでも完全に適合します。アドオン（devcontainer、Dailybot、dependency-upgrade）はオプトインであり、適合性のために必須であってはなりません（MUST NOT）。

よく形成された計画

.dwp/plans/ にある Deep Work Plan は、次のときによく形成されています。

  1. すべてのタスクは、明示的なスコープ、受け入れ基準、そして少なくとも一つの検証ゲート（客観的に合格または不合格になるコマンドやチェック）を宣言しなければなりません（MUST）。
  2. 計画は、作業が中断を生き延び、別のエージェントによって再開できるよう、進捗を永続化しなければなりません（MUST）。
  3. 計画は、二つの必須最終タスク、すなわち Skills & Agents Discovery と Executive Report を含まなければなりません（MUST）。
  4. タスクは、長期にわたる逸脱を防ぐため、実行の前に計画の目標へと改めて立ち返るべきです（SHOULD）。

適合性の検証

適合性は、目視ではなく機械的に検証されるべきです（SHOULD）。/dwp-verify を実行すると、上記の基準に照らした合否レポートが生成されます。すなわち、AGENTS.md の存在と実内容、CLAUDE.md の解決、docs/ のカテゴリ、.agents/ のカタログとディスクの一致、.dwp/ と tmp/ の gitignore 状態、そして計画については、すべてのタスクが受け入れ基準と検証ゲートを備えていることです。

リポジトリは、適合性が一度きり主張されるのではなく維持されるよう、オンボーディングのあと、そして各計画の完了のあとに再検証されるべきです（SHOULD）。