Skip to content
← キットに戻る
Agent: Cloud agents Support: full

クラウドエージェントアダプター

クラウドおよびバックグラウンドエージェント — Claude Code リモートタスク、OpenAI Codex クラウド、Jules クラスのエージェント、およびそれに類する非同期実行環境 — は設計上エフェメラルです。セッションが開始し、一定の時間動作し、終了します。DWP はこの制約を特長に変えます。耐久性のある成果物を、セッションではなく計画にするのです。

核心となる洞察

リポジトリの .dwp/ ディレクトリが 耐久性のある仕様と状態レイヤー です。クラウドセッションは エフェメラルな実行者 です。計画はエグゼキューターに何をすべきかを伝え、state.json はどこから再開するかを伝えます。セッションがどのようなものであれ — 別のモデル、別のプロバイダー、新しいコンテナ — 計画はちょうど中断したところから正確に継続します。

サポートレベル

フル — リポジトリを読み込み、AGENTS.md に従い、シェルコマンドを実行できるクラウドエージェントであれば、プラットフォーム固有のアダプターなしで DWP をサポートします。

起動・再開・終了のループ

各クラウドエージェントターンは次のパターンに従います。

  1. 起動 — セッションが開始します(クロンスケジュール、CI イベント、またはユーザーアクションによってトリガーされます)。
  2. DWP 再開プロトコルを実行する — 計画の README を読み、チェックポイントを見つけ、state.json を Markdown と照合し、継ぎ目を確認し、スモークテストを実行します。DWP 仕様 を参照してください。
  3. ブロック状態を確認するstate.json.blocked が設定されている場合、理由を報告し、実行せずに終了します。
  4. 次のアトミックタスクを実行する — 一タスク、そのバリデーションゲート全体を通過します。
  5. 状態レイヤーを更新する — 新しいタスクステータス、ゲートレコード、アウトカムレコード、コミットハッシュで state.json をアトミックに上書きします。
  6. 終了する — セッションがクリーンに終了します。次のターンが更新された状態から再開します。

要件

  • 計画は機械可読な状態レイヤー(manifest.json + state.json)を MUST 携えなければなりません。これがなければ、エフェメラルセッションには再開位置を確実に特定する手段がありません。計画の状態 を参照してください。
  • 計画は、無人クラウドターンが実行される前に人間によって MUST 承認されなければなりません。計画の承認がコントロールポイントです。
  • エージェントは制限された権限のもとで動作します。スコープを拡大したり(MUST NOT)、計画が明示的に認可していない破壊的な操作を実行したり(MUST NOT)、現在のタスクの指示を超えて即興したりしてはなりません(MUST NOT)。エージェントプロトコル を参照してください。

備考

クラウドエージェントセッションは無人実行プロファイルの極端なケースです。セッションの継続性がゼロで、計画の耐久性が最大です。DWP の .dwp/ ディレクトリは、まさにこれを機能させるために設計されています。エージェントが作業の本体を開始、継続、完了するために必要なすべての状態が、どのセッションでも新鮮なチェックアウトから読み込めるプレーンな Markdown と JSON ファイルに存在します。