Agent Orchestration

🚀 エージェントオーケストレーション

複数のAIエージェントがメモリを共有し、タスクを調整し、IDEやCLIツールを横断して効果的に協力できるようにするモデルコンテキストプロトコル（MCP）サーバーです。

🚀 クイックスタート

インストールは必要ありません！ npx を使用してください。

任意のIDE/CLI (AGENTS.md)

# プロジェクトに移動
cd /path/to/your/project

# AGENTS.md で初期化
npx agent-orchestration init

これにより、任意のAIコーディングエージェントで動作する完全なオーケストレーション指示を含む AGENTS.md が作成されます。

Cursor IDE

# プロジェクトに移動
cd /path/to/your/project

# Cursor 用に初期化 (.cursor/rules/ をコピー)
npx agent-orchestration init-cursor

これにより、Cursor固有のルールが含まれた .cursor/rules/ がコピーされます。

✨ 主な機能

解決する問題

複数のAIエージェントを実行する際、以下のような重要な協調上の課題に直面します。

1. ターン認識の欠如 - エージェントは自身の行動ターンかどうかを知らず、競合状態を引き起こします。
2. ファイルベースの予測 - エージェントは共有メモリではなくファイルから状態を予測するため、古いデータを読み取ることがあります。
3. コンテキストドリフト - 並列実行されるエージェントがコードベースに対して一貫性のない理解を形成します。
4. エージェント発見の欠如 - エージェントは同じプロジェクトで作業している他のエージェントを認識できません。
5. 重複作業 - 複数のエージェントが同時に同じタスクを試みることがあります。
6. 競合する編集 - 協調なしでは、エージェントが互いの変更を上書きしてしまいます。

解決策

このMCPサーバーは以下の機能を提供します。

• 共有メモリ - エージェントはコンテキスト、決定、および調査結果を保存および取得できます。
• タスクキュー - 依存関係を持つターンベースのタスク実行。
• エージェント発見 - エージェントは誰が同じプロジェクトで作業しているかを確認できます。
• リソースロック - ファイルまたはリソースへの同時アクセスを防止します。
• 協調ステータス - オーケストレーションの状態をリアルタイムで可視化します。
• 自動コンテキスト同期 - activeContext.md を自動的に更新して簡単に参照できるようにします。

互換性

MCPまたは AGENTS.md をサポートする任意のAIコーディングエージェントと互換性があります。

• OpenAI Codex
• Google Jules
• Cursor
• Aider
• Windsurf
• VS Code Copilot
• GitHub Copilot Coding Agent
• Devin
• その他多数！

📦 インストール

CLIコマンド

npx agent-orchestration init           # AGENTS.md を作成 (任意のAIエージェントで動作)
npx agent-orchestration init-cursor    # Cursor IDE 用にセットアップ (.cursor/rules/)
npx agent-orchestration serve          # MCPサーバーを実行
npx agent-orchestration help           # ヘルプを表示

MCPサーバーのセットアップ

MCP設定（例：Cursorの場合は ~/.cursor/mcp.json）に追加してください。

{
  "mcpServers": {
    "agent-orchestration": {
      "command": "npx",
      "args": ["-y", "agent-orchestration", "serve"],
      "env": {
        "MCP_ORCH_SYNC_CONTEXT": "true"
      }
    }
  }
}

サーバーは自動的に現在の作業ディレクトリをプロジェクトルートとして使用します。

セッションの開始

bootstrap ツールを使用して開始します。

bootstrap

これにより、あなたを登録し、現在の焦点、保留中のタスク、および最近の決定を表示します。

💻 使用例

推奨ワークフロー

メインオーケストレーターエージェント

1. bootstrap                          # セッションを開始
2. memory_set current_focus "..."     # プロジェクトの焦点を設定
3. task_create "Feature X"            # タスクを作成
4. task_create "Feature Y"
5. coordination_status                # 進行状況を監視

サブエージェント (特定の作業用に生成)

1. claim_todo "Feature X"             # 登録とタスクの取得を一度に行う
2. lock_acquire "src/feature.ts"      # 編集前にファイルをロック
3. [作業を実行]
4. task_complete <task_id> "Done"     # タスクを完了とマーク
5. agent_unregister                   # クリーンアップ

📚 詳細ドキュメント

利用可能なツール

セッション管理

エージェント管理

共有メモリ

タスク管理

協調

メモリ名前空間

組織化のために以下の名前空間を使用します。

設定

環境変数

アーキテクチャ

┌─────────────────────────────────────────────────────────────┐
│                     IDE / CLI Tool                           │
├─────────────┬─────────────┬─────────────┬─────────────┬─────┤
│ Main Agent  │ Sub-Agent 1 │ Sub-Agent 2 │ Sub-Agent 3 │ ... │
└──────┬──────┴──────┬──────┴──────┬──────┴──────┬──────┴─────┘
       │             │             │             │
       └─────────────┴──────┬──────┴─────────────┘
                            │
                    ┌───────▼───────┐
                    │  MCP Server   │
                    │  (TypeScript) │
                    └───────┬───────┘
                            │
              ┌─────────────┼─────────────┐
              │             │             │
      ┌───────▼───┐ ┌───────▼───┐ ┌───────▼───┐
      │  Agents   │ │   Tasks   │ │  Memory   │
      │  Registry │ │   Queue   │ │   Store   │
      └───────────┘ └───────────┘ └───────────┘
              │             │             │
              └─────────────┼─────────────┘
                            │
                    ┌───────▼───────┐
                    │    SQLite     │
                    │  (per-project)│
                    └───────────────┘

AGENTS.md

このプロジェクトは AGENTS.md 形式に従っています。これは、60,000以上のオープンソースプロジェクトで使用されている、AIコーディングエージェントをガイドするためのシンプルなオープン形式です。

npx agent-orchestration init を実行すると、以下のエージェントと互換性のある AGENTS.md ファイルが作成されます。

• OpenAI Codex
• Google Jules
• Cursor
• Aider
• Windsurf
• VS Code Copilot
• その他多数！

トラブルシューティング

サーバーが起動しない場合

1. Node.js 18以上がインストールされていることを確認してください：node --version
2. MCP設定内のパスが正しいことを確認してください

データベースエラー

SQLiteデータベースは .agent-orchestration/ に自動的に作成されます。破損した場合は、以下のコマンドを実行してください。

rm -rf .agent-orchestration/

次回のサーバー起動時に再作成されます。

エージェントが互いに認識できない場合

• すべてのエージェントがMCP設定で同じ cwd を使用していることを確認してください
• agent_list を確認して登録されているエージェントを確認してください
• ハートビートが5分間ない場合、古いエージェントは自動的にクリーンアップされます

開発

前提条件

• Node.js 18以上
• npm

セットアップ

# リポジトリをクローン
git clone https://github.com/madebyaris/agent-orchestration.git
cd agent-orchestration

# 依存関係をインストール
npm install

# プロジェクトをビルド
npm run build

# ウォッチモード (変更時に再ビルド)
npm run dev

# ビルドをクリーンアップ
npm run clean && npm run build

ロードマップ

新機能を積極的に開発しています。これから予定されている機能は以下の通りです。

• [ ] 外部メモリ統合 - Mem0、Byteover などの外部メモリプロバイダーとの統合、および独自のメモリソリューション
• [ ] サブエージェントの知識強化 - メインエージェントとサブエージェント間の知識共有の制限を解消
• [ ] 調査優先ワークフロー - ゼロから構築する際、エージェントが最初に調査を行い、コーディング前にすべての要件を準備する
• [ ] エラーの適切な処理 - すべての操作でより良いエラー処理と回復機能を提供
• [ ] 自動ドキュメント生成 - 各サブエージェントとメインエージェントの相互作用から自動的にドキュメントを生成

機能リクエストがある場合は、問題を作成 してください！

作者

Aris Setiawan - madebyaris.com

• GitHub: @madebyaris
• リポジトリ: agent-orchestration

📄 ライセンス

MIT