agent-to-agent

エージェント間（A2A）通信プロトコル

A2A コーディネーターとして動作します。構造化されたメッセージの受け渡し、共有コンテキスト、正式な引き継ぎを通じて、複数の Claude Code エージェントが通信、協力し、作業を委任できるプロトコルレイヤーです。すべてのやり取りを、共有コンテキストファイル .a2a-context.json と Agent ツールを通じて調整します。

目次

• references/protocol.md — メッセージ形式、メッセージの種類、ライフサイクル、共有コンテキストのスキーマ、アトミックな読み取り・変更・書き込み、コンテキストサイズの管理。
• references/registry.md — エージェントの登録、機能の検出、組み込みエージェントのテンプレート。
• references/patterns.md — リクエスト／レスポンス、パイプライン、ファンアウト／ファンイン、会話、スーパーバイザー。
• references/handoff.md — 構造化された引き継ぎ、受け入れ、拒否、チェーンの追跡。
• references/error-handling.md — タイムアウト、拒否、デッドロックの検出、縮退、エスカレーションマトリクス。
• references/workflows.md — 実例（調査＋執筆、コード＋レビュー、営業＋技術）。
• references/operations.md — 調整コマンド、ベストプラクティス、監視、セキュリティ、初期化の詳細。

ワークフロー

1. 目標を理解します。複数のエージェントを使ってユーザーが何を達成したいのかを判断します。
2. チームを設計します。必要なエージェントを決め、references/registry.md のテンプレートを使用するか、カスタム仕様を作成します。
3. パターンを選びます。references/patterns.md からパイプライン、ファンアウト／ファンイン、会話、スーパーバイザーを選択します。順序が重要な場合はパイプラインを、サブタスクが独立している場合はファンアウトを優先します。
4. 初期化します。プロジェクトのルートを特定します。.a2a-context.json が存在する場合は読み込んで現在の状態を報告し、存在しない場合は references/operations.md のテンプレートから作成します。references/registry.md に従って、すべてのエージェントを agents セクションに登録します。
5. 実行します。選択したパターンに従い、Agent ツールを使ってエージェントにタスクを割り当てます。各エージェントへのプロンプトには、役割、コンテキスト、タスク、出力先、プロトコル、制約を明記します（references/operations.md を参照）。並列処理を行う場合は、1 回の応答で複数の Agent ツール呼び出しを実行します。
6. 引き継ぎを調整します。エージェントがタスクを引き継ぐ際は、完全な引き継ぎペイロードと ACK を要求し、タスクの chain に追記します。references/handoff.md に従います。
7. 監視して復旧します。.a2a-context.json を読み込んで進捗を追跡します。タイムアウト、拒否、デッドロック、失敗が発生した場合は、references/error-handling.md の手順とエスカレーションマトリクスを適用します。ユーザーにエスカレーションする前に、再試行は最大 3 回までとします。
8. 提示します。すべてのエージェントの調査結果を conclusions セクションにまとめ、最終出力を提示します。

基本ルール

• .a2a-context.json を唯一の信頼できる情報源として扱います。作業前に読み込み、変更後はファイル全体を書き戻します。references/protocol.md のアトミックな読み取り・変更・書き込み手順に従います。
• エージェント間のすべてのメッセージを、references/protocol.md のスキーマに準拠させます。
• 各エージェントは、自分のセクションと共有の conclusions への書き込みに限定します。タスクの割り当ての変更はコーディネーターに限定します。
• .a2a-context.json に秘密情報を書き込んではいけません。機密データは Agent プロンプトを通じてメモリ内で渡し、このファイルを .gitignore に追加します。
• すべての失敗について、明示的な ERROR メッセージを要求します。エラーを黙って無視してはいけません。ファイルが 50KB を超えた場合は、コンテキストの要約を実行します。

最小例：2 エージェントのパイプライン

User: "Research the top 5 AI frameworks and write a comparison article."

Coordinator:
1. Create .a2a-context.json
2. Register: researcher, writer
3. Dispatch researcher: "Search for top 5 AI frameworks, compare features, performance, ecosystem"
4. Read researcher's findings from shared context
5. Dispatch writer: "Using the research findings, write a 1200-word comparison article"
6. Read writer's draft from shared context
7. Present the final article to the user