README

09_AgentSync — マルチエージェント通信バス

概要

親Antigravity（司令塔）と子エージェント（Claude Code, Agent Manager, A/B/C-space）間の 双方向通信を仲介するファイルベースの通信ディレクトリ。

ディレクトリ構造

09_AgentSync/
├── inbox/              # 親→子 タスク投入
│   ├── claude-code/    # Claude Code拡張向け
│   ├── agent-manager/  # Agent Manager経由のプロジェクト向け
│   └── workers/        # A/B/C-space向け
├── reports/            # 子→親 完了報告
│   ├── pending/        # 未読（新着報告）
│   └── processed/      # 処理済み
├── status/             # 各エージェントの現在状態
└── shared_context/     # エージェント間共有コンテキスト

報告JSONフォーマット

子エージェントが reports/pending/ に書き出すJSON:

{
  "task_id": "t-YYYYMMDD-HHMMSS-NNN",
  "worker": "エージェント名",
  "status": "completed | failed",
  "summary": "作業結果の要約（日本語）",
  "artifacts": ["作成・変更したファイルの絶対パスリスト"],
  "completed_at": "ISO 8601形式",
  "needs_review": false
}

ステータスJSONフォーマット

status/{agent-name}.json:

{
  "agent": "claude-code",
  "state": "idle | working | waiting_for_review",
  "current_task_id": null,
  "last_updated": "ISO 8601形式",
  "last_completed_task": "t-xxx"
}

運用ルール

1. タスク投入: 親が inbox/{target}/ にタスクJSONを配置
2. 報告書き出し: 子が reports/pending/ に報告JSONを書き出し
3. 回収: 親（または report_collector）が pending/ から読み取り → processed/ に移動
4. ステータス更新: 各エージェントが自身の status/ を随時更新
5. 既存互換: orchestrator_sys/reports/ への書き出しも引き続きサポート