7つのAI CLIツールを協調させる次世代開発フレームワーク
Claude、Gemini、Amp、Qwen、Droid、Codex、Cursorの7つのAIを並列・順次実行で協調させ、高速かつ高品質な開発を実現します。ChatDevのロールベース協調とChain-of-Agentsの分割統治戦略を統合。
- YAML駆動設計: コード変更なしでAI役割分担・タイムアウトを変更可能
- Cursorマルチモデルフォールバック: AI失敗時にCursorが適切なモデルで代替（Gemini→gemini-3-pro等）
- Git Worktrees統合: ファイル競合なしの完全並列実行
- 13個のレビューシステム: 5AI個別 + 3コア + Claude専用2 + Codex/CodeRabbit + 統一IF + 自動ルーティング
- Lite Mode: 1-3 AIでも動作、段階的導入可能
- フォールトトレランス: Primary/Fallback機構で高可用性98%以上
┌─────────────────────────────────────────────────────────────┐
│ Strategic Layer │
│ Claude (CTO) + Gemini (CIO) + Amp (PM) │
├─────────────────────────────────────────────────────────────┤
│ Implementation Layer │
│ Qwen (高速プロトタイプ) + Droid (エンタープライズ品質) │
├─────────────────────────────────────────────────────────────┤
│ Integration Layer │
│ Codex (レビュー) + Cursor (統合) │
└─────────────────────────────────────────────────────────────┘
二大巨頭: Claude CLI（最高品質の戦略分析）+ Cursor CLI（マルチモデル対応の柔軟性）
以下のAI CLIツールをインストール：
| AI | 役割 | インストール |
|---|---|---|
| Claude | 戦略・アーキテクチャ | Claude Code |
| Gemini | Web検索・セキュリティ | Gemini CLI |
| Cursor | IDE統合・マルチモデル | Cursor CLI |
| Qwen | 高速プロトタイプ | Qwen Code |
| Droid | エンタープライズ品質 | Factory Droid |
| Codex | コードレビュー | Codex CLI |
| Amp | プロジェクト管理 | Amp |
# リポジトリをクローン
git clone https://github.com/CaCC-Lab/multi-ai-orchestrium
cd multi-ai-orchestrium
# 実行権限を付与
bash scripts/setup-permissions.sh
# AIツールの可用性確認
bash scripts/check-multi-ai-tools.sh# 統一エントリーポイント（推奨）- セキュリティ強化 & マイグレーション対応
bash run orchestrate
# v4.0 新構造（推奨）- 直接実行方式（セキュリティ強化）
bash engine/orchestration/orchestrate.sh
# セキュリティ推奨実装：パス検出による自動選択
if [ -f "engine/orchestration/orchestrate.sh" ]; then
bash engine/orchestration/orchestrate.sh
else
bash scripts/orchestrate/orchestrate-multi-ai.sh # フォールバック
fi
# 高速プロトタイプ（2-4分）- 統一エントリーポイント使用
bash run orchestrate multi-ai-speed-prototype "シンプルなAPIエンドポイント"
# フル開発ワークフロー（5-8分）- 統一エントリーポイント使用
bash run orchestrate multi-ai-full-orchestrate "ユーザー認証機能"
# エンタープライズ品質（15-20分）- 統一エントリーポイント使用
bash run orchestrate multi-ai-enterprise-quality "本番環境向け決済システム"
# 実装前ディスカッション - 統一エントリーポイント使用
bash run orchestrate multi-ai-discuss-before "マイクロサービス移行計画"
# 実装後レビュー - 統一エントリーポイント使用
bash run orchestrate multi-ai-review-after "プルリクエスト #123"# 統一エントリーポイント（推奨）- セキュリティ強化 & マイグレーション対応
bash run review dispatcher # 自動ルーティング
bash run review multi-ai --type security # 統一インターフェース（セキュリティ）
bash run review claude --commit abc123 # AI個別レビュー
# 自動ルーティング（Git diff解析で最適なレビューを選択）
bash engine/review/dispatcher.sh # v4.0新構造
bash scripts/review-dispatcher.sh # レガシー
# 統一インターフェース
bash engine/review/runners/multi-ai-review.sh --type security # v4.0
bash scripts/multi-ai-review.sh --type quality # レガシー
bash scripts/multi-ai-review.sh --type all
# AI個別レビュー（v4.0新構造）
bash engine/review/ai-specific/gemini-review.sh --commit abc123
bash engine/review/ai-specific/qwen-review.sh --commit abc123
bash engine/review/ai-specific/claude-review.sh --commit abc123
# AI個別レビュー（レガシー）
bash scripts/gemini-review.sh --commit abc123
bash scripts/qwen-review.sh --commit abc123
bash scripts/claude-review.sh --commit abc123# 統一エントリーポイント（推奨）- セキュリティ強化 & マイグレーション対応
bash run tdd
# v4.0新構造 - セキュリティ推奨実装
bash engine/tdd/tdd-orchestrator.sh
# セキュリティ推奨：パス検出による自動選択
if [ -f "engine/tdd/tdd-orchestrator.sh" ]; then
bash engine/tdd/tdd-orchestrator.sh
else
bash scripts/tdd/tdd-multi-ai.sh # フォールバック
fi
export TDD_PROFILE=balanced # classic_cycle, speed_first, quality_first
# TDDサイクル実行（統一エントリーポイント使用）
bash run tdd tdd-multi-ai-cycle "新機能"| フェーズ | テスト数 | 結果 | 主要ワークフロー |
|---|---|---|---|
| Phase 7 | 2/2 | ✅ PASS | tdd-multi-ai-cycle (19分), tdd-multi-ai-fast (12分) |
| Phase 11 | 5/5 | ✅ PASS | plan, red, green, refactor, review |
| Phase 12 | 3/3 | ✅ PASS | pair-multi-ai-driver, pair-multi-ai-navigator |
合計: 10/10 テスト成功 (100%)
全7AI不要。1つのAIからでも始められます。v4.0でengine/へ移行完了。
# 統一エントリーポイント（推奨）
bash run lite check # AI可用性チェック
bash run lite recommend # インストール推奨表示
bash run lite setup # セットアップウィザード
bash run lite orchestrate "task" # Lite Modeで実行
# v4.0新構造（直接実行）
bash engine/lite-mode/checker.sh check
bash engine/lite-mode/setup-wizard.sh
# レガシー（後方互換）
bash scripts/lite-mode/lite-mode-checker.sh| カテゴリ | テスト数 | 結果 |
|---|---|---|
| 構造テスト | 5/5 | ✅ PASS |
| 統合テスト | 4/4 | ✅ PASS |
| 関数テスト | 3/3 | ✅ PASS |
| JSON出力テスト | 3/3 | ✅ PASS |
| 後方互換テスト | 2/2 | ✅ PASS |
合計: 17/17 テスト成功 (100%)
7AIが独立したワークツリーで並列実行。ファイル競合なし。
export ENABLE_WORKTREES=true
source scripts/orchestrate/orchestrate-multi-ai.sh
multi-ai-speed-prototype "機能の説明"multi-ai-orchestrium/
├── cli/ # CLIレイヤー ★v4.0新規
│ ├── wrappers/ # AIラッパー（7ファイル）
│ ├── libs/ # CLI共通ライブラリ
│ └── utils/ # CLIユーティリティ
│
├── engine/ # エンジンレイヤー ★v4.0新規
│ ├── orchestration/ # オーケストレーション
│ │ ├── workflows/ # ワークフロー実装
│ │ └── orchestrate.sh # メインオーケストレーター
│ ├── review/ # レビューエンジン
│ │ ├── runners/ # 3コアレビュー
│ │ ├── ai-specific/ # AI個別レビュー（9ファイル）
│ │ └── dispatcher.sh # 自動ルーティング
│ ├── tdd/ # TDDエンジン
│ └── lite-mode/ # Lite Modeエンジン ★2025-12-01移行
│ ├── checker.sh # AI可用性チェッカー
│ ├── orchestrator.sh # Lite Modeオーケストレーター
│ └── setup-wizard.sh # セットアップウィザード
│
├── platform/ # プラットフォームレイヤー ★v4.0新規
│ ├── logging/ # 統一ロギングサービス
│ └── core/ # コアサービス
│
├── data/ # データレイヤー ★v4.0新規
│ ├── logs/reviews/{YYYYMMDD}/ # 日付優先ログ構造
│ └── cache/ # キャッシュ
│
├── config/ # 設定
│ ├── multi-ai-profiles.yaml # AI役割・タイムアウト設定
│ ├── review-profiles.yaml # レビュープロファイル
│ └── feature-flags.yaml # フィーチャーフラグ ★v4.0新規
│
├── bin/ # ⚠️ v5.0で廃止予定（→ cli/）
├── scripts/ # ⚠️ v5.0で廃止予定（→ engine/）
├── src/ # ⚠️ v5.0で廃止予定（→ platform/）
├── logs/ # ⚠️ v5.0で廃止予定（→ data/logs/）
│
├── tests/ # テスト
│ ├── unit/ # BATSユニットテスト
│ └── integration/ # 統合テスト
├── docs/ # ドキュメント
└── examples/ # サンプルコード
フィーチャーフラグによる段階的移行:
export ENABLE_NEW_LOG_STRUCTURE=true # 新ログ構造有効化
export ENABLE_NEW_CLI_LAYER=true # 新CLI層有効化
export ENABLE_NEW_ENGINE_LAYER=true # 新エンジン層有効化AI失敗時の自動フォールバック：
- 標準フォールバック: 設定されたフォールバックAIを試行
- Cursorモデルフォールバック: 最終手段としてCursorが適切なモデルで代替
| 失敗AI | Cursorモデル |
|---|---|
| Gemini | gemini-3-pro |
| Qwen | composer-1 |
| Amp | opus-4.5 |
| Droid | gpt-5.1-codex |
| Codex | gpt-5.1-codex-high |
profiles:
speed-first-7ai:
workflows:
multi-ai-speed-prototype:
phases:
- name: "Strategic Layer"
parallel:
- {ai: claude, role: architecture-design, timeout: 300}
- {ai: gemini, role: requirements-research, timeout: 300}
- {ai: amp, role: project-management, timeout: 300}
- name: "Implementation Layer"
parallel:
- {ai: qwen, role: fast-prototype, timeout: 300}
- {ai: droid, role: enterprise-implementation, timeout: 900}# 権限エラー
bash scripts/setup-permissions.sh
# タイムアウト延長
bash scripts/multi-ai-review.sh --timeout 1200
# ログディレクトリ作成（レガシー）
mkdir -p logs/{gemini,qwen,cursor,amp,droid,claude,codex}-reviews
# ログディレクトリ作成（v4.0新構造）
mkdir -p data/logs/reviews/$(date +%Y%m%d)/{claude,gemini,qwen,cursor,amp,droid,codex,coderabbit,multi-ai}- CLAUDE.md - Claude Code向け詳細ガイド
- AGENTS.md - タスク分類とエージェント設定
- CONTRIBUTING.md - 貢献ガイドライン
- CHANGELOG.md - 変更履歴
- docs/MIGRATION_V3_TO_V4.md - v3.x→v4.0マイグレーションガイド
- docs/REVIEW_ARCHITECTURE.md - レビューシステムアーキテクチャ
- docs/ALL_WORKFLOWS_COMPLETE_LIST.md - 全ワークフロー一覧
- RUN_SCRIPT_GUIDE.md - 統一エントリーポイント使用ガイド（NEW）
MIT License - 詳細は LICENSE を参照
v4.0アーキテクチャの代替実装として、セキュリティ強化とマイグレーション簡素化のための統一エントリーポイントが導入されました：
- セキュリティ向上:
sourceコマンドの代わりにbashによるサブシェル実行で、現在のシェル環境への不正な変数・関数注入を防止 - 単一インターフェース:
bash run {orchestrate|review|tdd}で全機能にアクセス可能 - マイグレーション支援: レガシーと新エンジンの両方をサポートし、段階的移行を容易に
- DRY原則準拠: 重複したスクリプト構造を解消し、保守性を向上
Version: v4.0 | Status: Production Ready | Last Updated: 2025-11-30