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

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

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

核心となる洞察

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

サポートレベル

完全(文書化済み)— クラウドエージェントプラットフォームは AGENTS.md またはネイティブ指示を読み込み、ターミナルまたはコンテナ環境を通じてコマンドを実行します。

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

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

  1. 起動 — セッションが開始します(クロンスケジュール、CI イベント、またはユーザーアクションによってトリガーされます)。
  2. DWP 再開プロトコルを実行 — プランの README を読み込み、チェックポイントを特定し、journal.ndjson から ledger.py project を介して状態を再構築し、シームを検査し、スモークテストを実行します。DWP 仕様を参照してください。
  3. ブロック状態を確認する — state.json.blocked が設定されている場合、理由を報告し、実行せずに終了します。
  4. 次のアトミックタスクを実行する — 一タスク、そのバリデーションゲート全体を通過します。
  5. ジャーナルに記録 — ledger.py の各動詞(start、gate、complete)を介して journal.ndjson にイベントを追記します。ledger.py project は派生した state.json スナップショット投影をアトミックに更新します。従来の v5 プランでは直接の状態ファイル更新が維持されます。
  6. 終了する — セッションがクリーンに終了します。次のターンが更新された状態から再開します。

要件

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

備考

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