AIマルチエージェント組織構築 — 開発ログ

2026-03-07

  • プロジェクト開始
  • 海外事例リサーチ完了(ファイルベース協調、Claude Code Agent Teams、MCP/A2A/SAMEP)
  • NotebookLMでレポート・スライド生成完了
  • /project /cc コマンド実装・VPSデプロイ完了
  • Agent Manager協業フロー設計完了
  • プロジェクト化してAgent Managerで継続作業開始
  • CDP → Claude Code拡張への自動メッセージ注入テスト成功
  • 09_AgentSync/ ディレクトリ構築(inbox/reports/status/shared_context)
  • multi_ide_client.py に Claude Code CDP メソッド4種追加
  • report_collector.py 新規作成(報告回収ポーラー)
  • agent_coordinator.py 拡張(dispatch_to_claude_code, review_and_feedback, chain_tasks)
  • 統合テスト完了(全4テスト合格)

2026-03-07 (Session 2 — Claude Code実装)

背景・経緯

  • Antigravity ↔ Claude Code 間の双方向通信方式を検討
  • 6方式(ファイルベース / CLI subprocess / Hooks / WebSocket / CDP / MCP)を比較分析
  • MCP共有サーバー方式が最適と判断(両者がネイティブ対応、型安全、拡張性最高)
  • マスタープロンプトの「将来の拡張性・継続性を最優先」の原則に合致

実装内容: agent-bus MCPサーバー

担当: Claude Code(MCPはAnthropic製プロトコルのため最も精通)

成果物

C:\ai_work\agent-bus-mcp\
├── server.py           # MCPサーバー本体(12ツール)
├── requirements.txt    # 依存パッケージ (mcp>=1.26.0, pydantic>=2.0.0)
└── README.md           # 運用ドキュメント

実装した12ツール

カテゴリツール名機能
タスク系dispatch_task指定エージェントにタスク投入
タスク系receive_task自分宛タスクを1件取得
タスク系list_tasks未処理タスク一覧
報告系submit_report完了報告を提出
報告系get_reports報告一覧取得
報告系acknowledge_report報告を確認済みに移動
ステータスupdate_statusエージェント状態更新
ステータスget_all_status全エージェント状態一覧
コンテキストshare_contextエージェント間共有情報書き込み
コンテキストget_shared_context共有情報読み取り
ユーティリティsystem_healthヘルスチェック
ユーティリティemergency_stop緊急停止

アーキテクチャ

  • 永続化層: 既存の 09_AgentSync/ をそのまま使用(新規ストレージなし)
  • 安全装置: 金銭・削除関連キーワードで自動ブロック(承認ゲート)
  • 全操作を C:\ai_work\logs\agent_bus.log に記録(ログ強制)

テスト結果

  • 全13テスト(12ツール + 安全装置)合格
  • dispatch_taskreceive_tasksubmit_reportacknowledge_report の一連フロー動作確認済み
  • ファイルの原子的書き込み (atomic_write) による安全な読み書き確認済み

設定変更

  • Claude Code側: ~/.claude/settings.json にagent-bus MCPエントリ追加済み
  • Antigravity側: mcp_config.json への追加が必要(Antigravity自身が実施)

将来拡張性

  • OpenClaw/ナナ等のリモートエージェント → SSE MCPモードまたはHTTPブリッジ経由で接続可能
  • 新エージェント追加時、サーバー側コード変更不要(MCP設定追加のみ)

残課題

  • Antigravity側でmcp_config.jsonにagent-bus追加
  • 実際の双方向通信テスト(Antigravity→dispatch_task→Claude Code→submit_report)
  • Claude Code Hooksとの連携(タスク完了時の自動報告)
  • SSEモード対応(リモートエージェント接続用)