構造化ハンドオフプロトコル

サブエージェントに作業を委譲する場合、または別のエージェントからハンドオフを受け取る場合は、構造化ハンドオフ形式を使用する必要があります。

ハンドオフ JSON スキーマ

エージェント間の全てのメッセージは、以下のフィールドを含む JSON オブジェクトである必要があります:

{
  "context": "Brief project state — what has been done so far",
  "task": "Explicit instruction — what the receiving agent must do",
  "dependencies": ["list of prior outputs, memory keys, or file paths"],
  "expected_format": "Markdown | JSON | Code",
  "constraints": ["list of constraints or blockers"],
  "ecosystem_state": "omni-link digest summary if available",
  "summary": "Human-readable one-liner for the main session"
}

ルール

1. コンテキストなしで委譲してはいけません。 全てのハンドオフは、それまでの経過をまとめた context を含める必要があります。
2. 依存関係を暗黙的にしてはいけません。 エージェント B がエージェント A の出力を必要とする場合、dependencies に記載してください。
3. 必ず expected_format を含めてください — 受け取るエージェントが出力をどのように構造化するかを知ることができます。
4. 必ず summary を記載してください — これはメインセッションとユーザーが目にするものです。
5. 送信後、必ず CLAUDE.md の Shared Bulletin Board にハンドオフをプッシュしてください。

使用パターン

/handoff @specialist-name

直近の N ターンを分析し、構造化ハンドオフ JSON を生成して、
CLAUDE.md > Shared Bulletin Board に記載し、対象エージェントを呼び出します。

omni-link との統合

コード変更を伴うハンドオフを実行する場合:

• /scan を実行して、現在のエコシステムの状態を取得してください
• ダイジェストの関連部分を ecosystem_state に含めてください
• ハンドオフが API サーフェスの変更を伴う場合は、/impact を実行してください
• コントラクト不一致がある場合は、constraints に含めてください

ハンドオフの受け取り

構造化ハンドオフを受け取った場合:

1. JSON をパースする
2. メモリまたはファイルシステムから全ての dependencies を読み込む
3. expected_format に従い task を実行する
4. 独自のハンドオフ JSON を出力として生成する(次のエージェント、またはコーディネーターに戻す場合)
5. Shared Bulletin Board に完了ステータスを更新する