はじめに
複数のAIエージェント [Antigravity / Claude Code / Codex など] を併用して開発を行う際、最大の課題となるのが[文脈の断絶]と[コンテキストの肥大化]です。各エージェントに同じ説明を何度も繰り返したり、長大な対話ログによって思考精度が低下したりする現象が頻発します。
本記事では、ローカルのナレッジベースツールである [Obsidian] のディレクトリ構造をAIエージェントたちの[共有脳 (Shared Memory)] として定義し、人間を介さずに非対話形式でバトンパスと知識の構造化を行うマルチエージェント連携アーキテクチャについて解説します。
1. 共有記憶フォルダ [10_AI_Brain] のディレクトリ構造
すべてのAIエージェントがアクセス可能な単一の共有領域として、Obsidian Vault 内に 10_AI_Brain ディレクトリを構築します。
10_AI_Brain/
├── 00_Dashboard/ # システム状態・アクティビティモニタ
├── 01_Inbox/ # 一時的な入力メモ・アイデア
├── 02_Agents/ # 各エージェント固有の作業ログ (Antigravity/ ClaudeCode/ Codex/)
├── 03_Shared_Memory/ # 全エージェント共通の絶対ルール (コーディング規約・PC環境)
├── 04_Handover/ # 非対話バトンパス用指示書 (To_ClaudeCode.md / To_Codex.md など)
├── 04_Knowledge/ # 知識データベース (Raw/ 一次資料, Wiki/ 構造化知見)
└── 05_Outputs/ # 最終完成成果物
この構造を定義することにより、エージェントは自分がどこに何を出力すべきかを迷うことなく判断できます。
2. 非対話式バトンパス (引き継ぎ) のメカニズム
従来のエージェント連携では、開発者がAエージェントの出力をコピーしてBエージェントに入力するという手動の仲介が必要でした。本アーキテクチャでは、04_Handover ディレクトリ内のファイルを介してAI同士が非対話で連携します。
引き継ぎノート (To_ClaudeCode.md) の記述例
# To Claude Code (引き継ぎ・タスクノート)
Antigravity から Claude Code への最新状況共有および引き継ぎ事項です。
## タスク内容
1. `C:\Projects\Gakubuchi-Locker` における額縁透明化コマンドの新規作成
2. 実装完了後、`ktlint` によるコードフォーマットの自動実行
3. 作業ログを `02_Agents/ClaudeCode/` に作成して報告すること
このように明確な引き継ぎ指示書をファイルとして出力することで、人間が介在することなくタスクが正確に伝達されます。
3. 一次資料 (Raw) から構造化知見 (Wiki) への自動更新フロー
開発中に各エージェントが得た知見やエラーログは、まず 04_Knowledge/Raw/ に一次資料として保存されます。その後、分析・整理を得意とするエージェントが内容を抽出し、04_Knowledge/Wiki/ の構造化ドキュメントへ自動的に統合します。
[Raw: 一次資料]
└─ oyasai-platform-repository.md (モノレポの構成ツリー・生のREADME)
↓ (AIエージェントによる抽出・集約)
[Wiki: 構造化知見]
├─ oyasai-server-overview.md (独自プラグイン一覧とアーキテクチャ概要)
└─ pc-maintenance-and-troubleshooting.md (トラブルシューティング集)
このプロセスにより、雑多な作業ログが散らかるのを防ぎ、常に最新かつ正確な知識ベースが維持されます。
4. 定期メンテナンスと死蔵メモのクリーンアップ (健康診断)
知識ベースは放置すると古い情報や重複メモが増加し、検索精度が低下します。全体指揮を担当するエージェント (Antigravity) は、定期的に以下のメンテナンス処理を自動実行します。
- 死蔵メモの抽出: 長期間参照されていない一時ファイルや完了済みタスクのクリーンアップ
- 不整合の修正: リンク切れやフォーマット違反の自動訂正
- ファイル命名規則の統一: ファイル名を原則 [kebab-case] (小文字＋ハイフン区切り) に自動変更
# Antigravityによる定期クリーンアップのイメージ
antigravity cleanup --target "10_AI_Brain/01_Inbox" --auto-archive
まとめ
ObsidianをAIエージェントたちの[共有脳 (10_AI_Brain)] として活用することで、以下のメリットが得られます。
- コンテキストの節約: 長大な会話履歴を保持し続ける必要がなくなり、必要なノートのみを高速に参照可能
- 非対話連動の実現: ファイルを読み書きするだけで、AIからAIへのタスク連携がスムーズに行われる
- 知識の自動蓄積: 日々の開発ログがそのまま整理されたナレッジベース (Wiki) に成長する
複数のAIツールを組み合わせた高度な開発環境の構築に、ぜひ本アーキテクチャを取り入れてみてください。