orchex 0.1.0__tar.gz

orchex-0.1.0/.gitignore

@@ -0,0 +1,50 @@
+# OS
+.DS_Store
+Thumbs.db
+
+# Editor
+*.swp
+*.swo
+*~
+
+# Test
+pytest-of-*/
+
+# Python
+__pycache__/
+*.pyc
+*.pyo
+*.egg-info/
+dist/
+build/
+.venv/
+venv/
+env/
+
+# Environment / Secrets
+.env
+.env.local
+
+# Logs
+*.log
+
+# Claude Code
+.claude/docs/
+.claude/logs/
+.claude/state/
+.claude/checkpoints/
+.claude/Plans.md
+.claude/.mcp-proxy.pid
+
+# sync-orchestra.py により packages/ から自動同期（SessionStart で再生成）
+.claude/agents/
+.claude/skills/
+.claude/rules/
+.claude/config/
+
+# Project-specific
+docs/*
+!docs/specs/
+
+# CocoIndex local search index
+.cocoindex_code/

orchex-0.1.0/CLAUDE.md

@@ -0,0 +1,34 @@
+# AI Orchestra
+
+マルチエージェント協調フレームワーク。詳細は `README.md` を参照。
+
+## 構成
+
+packages/ 配下がメインのソースコード:
+- core/              — 共通基盤（hooks・rules）
+- agent-routing/     — エージェント定義・ルーティング hooks・config
+- cli-logging/       — CLI ログ・checkpointing
+- codex-suggestions/ — Codex 相談提案・rules
+- gemini-suggestions/— Gemini リサーチ提案・rules
+- quality-gates/     — 品質ゲート・review/tdd スキル
+- route-audit/       — ルーティング監査
+- tmux-monitor/      — tmux 監視
+
+管理:
+- scripts/           — orchestra-manager.py, sync-orchestra.py
+- templates/         — テンプレート
+
+## References
+
+作業前に以下を確認すること（上から優先）:
+
+1. `packages/agent-routing/config/cli-tools.yaml` — CLI モデル名・フラグ設定
+2. `packages/agent-routing/rules/orchestra-usage.md` — エージェント・ワークフロー全体
+
+## Gotchas
+
+- `.claudeignore` は AI Orchestra が自動生成する。直接編集しないこと
+  - プロジェクト固有パターンは `.claudeignore.local` に記載
+  - SessionStart で ベース + `.claudeignore.local` がマージ生成される
+- `packages/` 内の hooks は `$AI_ORCHESTRA_DIR` 経由で直接参照される（`git pull` で即反映）
+- agents/skills/rules は SessionStart の `sync-orchestra.py` で `.claude/` に差分同期される

orchex-0.1.0/PKG-INFO

@@ -0,0 +1,276 @@
+Metadata-Version: 2.4
+Name: orchex
+Version: 0.1.0
+Summary: Multi-agent orchestration framework for Claude Code + Codex CLI + Gemini CLI
+License-Expression: MIT
+Requires-Python: >=3.12
+Requires-Dist: pyyaml>=6.0
+Provides-Extra: dev
+Requires-Dist: pytest-cov>=6.0; extra == 'dev'
+Requires-Dist: pytest>=9.0; extra == 'dev'
+Requires-Dist: ruff>=0.9; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# AI Orchestra
+
+Claude Code用のマルチエージェントオーケストレーションシステム
+
+## 構成
+
+```
+ai-orchestra/
+├── packages/         # パッケージ（hooks・scripts・agents・skills・rules・config）— 詳細は packages/README.md
+│   ├── core/              # 共通基盤ライブラリ + coding-principles / config-loading ルール
+│   ├── agent-routing/     # 25 エージェント定義 + ルーティング hooks + orchestra-usage ルール
+│   ├── cli-logging/       # Codex/Gemini CLI ログ記録 + checkpointing スキル
+│   ├── codex-suggestions/ # Codex 相談提案 + codex-delegation ルール + codex-system スキル
+│   ├── gemini-suggestions/# Gemini リサーチ提案 + gemini-delegation ルール + gemini-system スキル
+│   ├── quality-gates/     # 品質ゲート + review/tdd/simplify/release-readiness (+ design-tracker)
+│   ├── route-audit/       # ルーティング監査・KPIレポート
+│   ├── issue-workflow/    # GitHub Issue 起票 + 計画→実装→テスト→レビューの開発フロー
+│   ├── cocoindex/         # cocoindex MCP サーバーの自動プロビジョニング
+│   └── tmux-monitor/      # tmux サブエージェント監視
+├── scripts/          # 管理CLI
+├── templates/        # テンプレート（エージェント・スキル・プロジェクト）
+├── tests/            # Python 単体テスト
+├── docs/             # ドキュメント（設計・マイグレーション等）
+├── taskfiles/        # Task CLI 用タスク定義
+└── Taskfile.yml      # メインタスクファイル
+```
+
+## エージェント一覧
+
+### コア
+- `planner` - タスク分解・マイルストーン策定
+- `researcher` - リサーチ・ドキュメント解析
+
+### 要件・仕様
+- `requirements` - 要件抽出・NFR整理
+- `spec-writer` - 仕様書生成
+
+### 設計
+- `architect` - アーキテクチャ設計・技術選定
+- `api-designer` - API/IF設計
+- `data-modeler` - データモデリング・スキーマ設計
+- `auth-designer` - 認証認可設計
+
+### 実装
+- `frontend-dev` - React/Next.js/TypeScript
+- `backend-python-dev` - Python API
+- `backend-go-dev` - Go API
+
+### AI/ML
+- `ai-architect` - AIアーキテクチャ・モデル選定
+- `ai-dev` - AI機能実装
+- `prompt-engineer` - プロンプト設計
+- `rag-engineer` - RAG実装
+
+### テスト・デバッグ
+- `debugger` - バグ原因分析
+- `tester` - テスト戦略・実装
+
+### レビュー（実装）
+- `code-reviewer` - コード品質
+- `security-reviewer` - セキュリティ
+- `performance-reviewer` - パフォーマンス
+
+### レビュー（設計・仕様）
+- `spec-reviewer` - 仕様整合性
+- `architecture-reviewer` - アーキテクチャ妥当性
+- `ux-reviewer` - UX・アクセシビリティ
+
+### ドキュメント
+- `docs-writer` - 技術文書・手順書
+
+### ユーティリティ
+- `general-purpose` - 汎用タスク・Codex/Gemini委譲
+
+---
+
+## セットアップ
+
+### 1. リポジトリをクローン
+
+```bash
+git clone https://github.com/yoshihiko555/ai-orchestra.git ~/ai-orchestra
+```
+
+### 2. セットアップ（推奨）
+
+```bash
+# チームメンバー向け: 最低限のパッケージを一括インストール
+python3 ~/ai-orchestra/scripts/orchestra-manager.py setup essential --project /path/to/project
+
+# 管理者・開発者向け: 全パッケージを一括インストール
+python3 ~/ai-orchestra/scripts/orchestra-manager.py setup all --project /path/to/project
+
+# 事前確認（dry-run）
+python3 ~/ai-orchestra/scripts/orchestra-manager.py setup essential --project /path/to/project --dry-run
+```
+
+プリセットは `presets.json` で定義されています:
+- **essential** — core, route-audit, quality-gates
+- **all** — 全パッケージ
+
+### 2b. 個別インストール
+
+```bash
+# 個別にパッケージをインストールする場合
+python3 ~/ai-orchestra/scripts/orchestra-manager.py install core --project /path/to/project
+python3 ~/ai-orchestra/scripts/orchestra-manager.py install tmux-monitor --project /path/to/project
+```
+
+orchestra-manager が内部で以下を実行:
+1. `~/.claude/settings.json` に `env.AI_ORCHESTRA_DIR` を設定
+2. `.claude/orchestra.json` にパッケージ情報を記録
+3. `.claude/settings.local.json` に hooks を登録（`$AI_ORCHESTRA_DIR/packages/...` 参照）
+4. `sync-orchestra.py` の SessionStart hook を登録（初回のみ）
+5. skills/agents/rules の初回同期を実行
+
+### セットアップ完了条件
+
+以下をすべて満たしたらセットアップ完了です:
+
+- `~/.claude/settings.json` に `env.AI_ORCHESTRA_DIR` が設定されている
+- `.claude/settings.local.json` に AI Orchestra の hooks が登録されている
+- `.claude/orchestra.json` が存在し、インストール済みパッケージが記録されている
+- Claude Code 次回起動時に SessionStart hook が走り `.claude/` 配下へ差分同期される
+
+### 3. 管理スクリプト
+
+| スクリプト | 用途 |
+|-----------|------|
+| `orchestra-manager.py` | パッケージのインストール・管理 |
+| `sync-orchestra.py` | SessionStart 時の自動同期 |
+| `analyze-cli-usage.py` | Codex/Gemini の使用状況分析 |
+
+### 3b. ログ仕様
+
+- 全ログの役割・参照先は `docs/specs/logging.md` を参照
+
+### 4. パッケージ管理コマンド
+
+```bash
+# プリセットで一括セットアップ
+python3 ~/ai-orchestra/scripts/orchestra-manager.py setup essential --project .
+python3 ~/ai-orchestra/scripts/orchestra-manager.py setup all --project .
+
+# パッケージ一覧
+python3 ~/ai-orchestra/scripts/orchestra-manager.py list
+
+# プロジェクトでの導入状況
+python3 ~/ai-orchestra/scripts/orchestra-manager.py status --project .
+
+# インストール / アンインストール
+python3 ~/ai-orchestra/scripts/orchestra-manager.py install <package> --project .
+python3 ~/ai-orchestra/scripts/orchestra-manager.py uninstall <package> --project .
+
+# 一時的な有効化 / 無効化（hooks の登録/解除のみ）
+python3 ~/ai-orchestra/scripts/orchestra-manager.py enable <package> --project .
+python3 ~/ai-orchestra/scripts/orchestra-manager.py disable <package> --project .
+
+# パッケージ内スクリプトの一覧表示
+python3 ~/ai-orchestra/scripts/orchestra-manager.py scripts
+python3 ~/ai-orchestra/scripts/orchestra-manager.py scripts --package route-audit
+
+# パッケージ内スクリプトの実行（-- 以降はスクリプトにパススルー）
+python3 ~/ai-orchestra/scripts/orchestra-manager.py run route-audit dashboard
+python3 ~/ai-orchestra/scripts/orchestra-manager.py run route-audit log-viewer --project /path/to/project -- --last 10
+
+# dry-run（変更内容を表示のみ）
+python3 ~/ai-orchestra/scripts/orchestra-manager.py setup essential --project . --dry-run
+python3 ~/ai-orchestra/scripts/orchestra-manager.py install <package> --project . --dry-run
+```
+
+---
+
+## 更新フロー
+
+| 変更内容 | 操作 |
+|---------|------|
+| Hook スクリプト修正 | `git pull` のみ（即反映） |
+| Skills/Agents/Rules 修正 | `git pull`（次回 Claude Code 起動時に自動同期） |
+| 新フックイベント追加 | `git pull` + `install` 再実行 |
+| CLI スクリプト修正 | `git pull` のみ（即反映） |
+
+---
+
+## .claudeignore の管理
+
+- `.claudeignore` は AI Orchestra が自動生成するため直接編集しないでください
+- プロジェクト固有の除外パターンは `.claudeignore.local` に記載
+- SessionStart 時に ベース + `.claudeignore.local` がマージ生成されます
+
+## .gitignore の管理
+
+- `orchestra-manager.py init` 実行時に `.gitignore` へ AI Orchestra 用 block を追加/更新します
+- 対象: `.claude/docs/`, `.claude/logs/`, `.claude/state/`, `.claude/checkpoints/`, `.claude/Plans.md`
+
+---
+
+## 使い方
+
+### エージェントの呼び出し
+
+```
+Task(subagent_type="planner", prompt="このタスクを分解して")
+Task(subagent_type="code-reviewer", prompt="このコードをレビューして")
+```
+
+### スキル一覧
+
+| スキル | 用途 |
+|--------|------|
+| `/review` | コード・セキュリティ・設計レビュー（並列実行対応） |
+| `/startproject` | マルチエージェント協調で新規開発を開始 |
+| `/codex-system` | `cli-tools.yaml` に基づく Codex 利用ガイド（config-driven） |
+| `/gemini-system` | Gemini CLI でのリサーチ・マルチモーダル処理 |
+| `/checkpointing` | セッションコンテキストの保存・復元 |
+| `/design-tracker` | 設計記録スキル（現運用は `CLAUDE.md`/`Plans.md`/ADR/docs を優先） |
+| `/plan` | 実装計画の策定 |
+| `/simplify` | コードの簡素化 |
+| `/tdd` | テスト駆動開発ワークフロー |
+
+### レビュースキル
+
+```
+/review              # 全レビュアー並列実行
+/review code         # コードレビューのみ
+/review security     # セキュリティレビューのみ
+/review impl         # 実装系レビュー
+/review design       # 設計系レビュー
+```
+
+---
+
+## アーキテクチャ
+
+```
+Claude Code (Orchestrator)
+    │
+    ├── Codex CLI    # `cli-tools.yaml` の設定に応じて利用（役割は config-driven）
+    ├── Gemini CLI   # `cli-tools.yaml` の設定に応じて利用（役割は config-driven）
+    │
+    ├── $AI_ORCHESTRA_DIR/packages/
+    │   ├── core/               # 共通ユーティリティ
+    │   ├── cli-logging/        # CLI 呼び出しログ
+    │   ├── codex-suggestions/  # Codex 相談提案
+    │   ├── gemini-suggestions/ # Gemini リサーチ提案
+    │   ├── quality-gates/      # 品質ゲート
+    │   ├── route-audit/        # ルーティング監査
+    │   ├── issue-workflow/     # GitHub Issue 開発フロー
+    │   ├── cocoindex/          # MCP サーバー自動プロビジョニング
+    │   └── tmux-monitor/       # tmux リアルタイム監視
+    │
+    └── 25 Specialized Agents
+        ├── Planning: planner, researcher, requirements
+        ├── Design: architect, api-designer, data-modeler, auth-designer, spec-writer
+        ├── Implementation: frontend-dev, backend-*-dev, ai-*, debugger, tester
+        └── Review: code-reviewer, security-reviewer, performance-reviewer, ...
+```
+
+### 仕組み
+
+- **Hooks**: `$AI_ORCHESTRA_DIR` 環境変数で直接参照（シンボリックリンク不要）
+- **Skills/Agents/Rules**: SessionStart hook (`sync-orchestra.py`) で `$AI_ORCHESTRA_DIR` から `.claude/` に差分コピー
+- **CLI Scripts**: `$AI_ORCHESTRA_DIR/packages/{pkg}/scripts/` を直接実行

orchex-0.1.0/README.md

@@ -0,0 +1,263 @@
+# AI Orchestra
+
+Claude Code用のマルチエージェントオーケストレーションシステム
+
+## 構成
+
+```
+ai-orchestra/
+├── packages/         # パッケージ（hooks・scripts・agents・skills・rules・config）— 詳細は packages/README.md
+│   ├── core/              # 共通基盤ライブラリ + coding-principles / config-loading ルール
+│   ├── agent-routing/     # 25 エージェント定義 + ルーティング hooks + orchestra-usage ルール
+│   ├── cli-logging/       # Codex/Gemini CLI ログ記録 + checkpointing スキル
+│   ├── codex-suggestions/ # Codex 相談提案 + codex-delegation ルール + codex-system スキル
+│   ├── gemini-suggestions/# Gemini リサーチ提案 + gemini-delegation ルール + gemini-system スキル
+│   ├── quality-gates/     # 品質ゲート + review/tdd/simplify/release-readiness (+ design-tracker)
+│   ├── route-audit/       # ルーティング監査・KPIレポート
+│   ├── issue-workflow/    # GitHub Issue 起票 + 計画→実装→テスト→レビューの開発フロー
+│   ├── cocoindex/         # cocoindex MCP サーバーの自動プロビジョニング
+│   └── tmux-monitor/      # tmux サブエージェント監視
+├── scripts/          # 管理CLI
+├── templates/        # テンプレート（エージェント・スキル・プロジェクト）
+├── tests/            # Python 単体テスト
+├── docs/             # ドキュメント（設計・マイグレーション等）
+├── taskfiles/        # Task CLI 用タスク定義
+└── Taskfile.yml      # メインタスクファイル
+```
+
+## エージェント一覧
+
+### コア
+- `planner` - タスク分解・マイルストーン策定
+- `researcher` - リサーチ・ドキュメント解析
+
+### 要件・仕様
+- `requirements` - 要件抽出・NFR整理
+- `spec-writer` - 仕様書生成
+
+### 設計
+- `architect` - アーキテクチャ設計・技術選定
+- `api-designer` - API/IF設計
+- `data-modeler` - データモデリング・スキーマ設計
+- `auth-designer` - 認証認可設計
+
+### 実装
+- `frontend-dev` - React/Next.js/TypeScript
+- `backend-python-dev` - Python API
+- `backend-go-dev` - Go API
+
+### AI/ML
+- `ai-architect` - AIアーキテクチャ・モデル選定
+- `ai-dev` - AI機能実装
+- `prompt-engineer` - プロンプト設計
+- `rag-engineer` - RAG実装
+
+### テスト・デバッグ
+- `debugger` - バグ原因分析
+- `tester` - テスト戦略・実装
+
+### レビュー（実装）
+- `code-reviewer` - コード品質
+- `security-reviewer` - セキュリティ
+- `performance-reviewer` - パフォーマンス
+
+### レビュー（設計・仕様）
+- `spec-reviewer` - 仕様整合性
+- `architecture-reviewer` - アーキテクチャ妥当性
+- `ux-reviewer` - UX・アクセシビリティ
+
+### ドキュメント
+- `docs-writer` - 技術文書・手順書
+
+### ユーティリティ
+- `general-purpose` - 汎用タスク・Codex/Gemini委譲
+
+---
+
+## セットアップ
+
+### 1. リポジトリをクローン
+
+```bash
+git clone https://github.com/yoshihiko555/ai-orchestra.git ~/ai-orchestra
+```
+
+### 2. セットアップ（推奨）
+
+```bash
+# チームメンバー向け: 最低限のパッケージを一括インストール
+python3 ~/ai-orchestra/scripts/orchestra-manager.py setup essential --project /path/to/project
+
+# 管理者・開発者向け: 全パッケージを一括インストール
+python3 ~/ai-orchestra/scripts/orchestra-manager.py setup all --project /path/to/project
+
+# 事前確認（dry-run）
+python3 ~/ai-orchestra/scripts/orchestra-manager.py setup essential --project /path/to/project --dry-run
+```
+
+プリセットは `presets.json` で定義されています:
+- **essential** — core, route-audit, quality-gates
+- **all** — 全パッケージ
+
+### 2b. 個別インストール
+
+```bash
+# 個別にパッケージをインストールする場合
+python3 ~/ai-orchestra/scripts/orchestra-manager.py install core --project /path/to/project
+python3 ~/ai-orchestra/scripts/orchestra-manager.py install tmux-monitor --project /path/to/project
+```
+
+orchestra-manager が内部で以下を実行:
+1. `~/.claude/settings.json` に `env.AI_ORCHESTRA_DIR` を設定
+2. `.claude/orchestra.json` にパッケージ情報を記録
+3. `.claude/settings.local.json` に hooks を登録（`$AI_ORCHESTRA_DIR/packages/...` 参照）
+4. `sync-orchestra.py` の SessionStart hook を登録（初回のみ）
+5. skills/agents/rules の初回同期を実行
+
+### セットアップ完了条件
+
+以下をすべて満たしたらセットアップ完了です:
+
+- `~/.claude/settings.json` に `env.AI_ORCHESTRA_DIR` が設定されている
+- `.claude/settings.local.json` に AI Orchestra の hooks が登録されている
+- `.claude/orchestra.json` が存在し、インストール済みパッケージが記録されている
+- Claude Code 次回起動時に SessionStart hook が走り `.claude/` 配下へ差分同期される
+
+### 3. 管理スクリプト
+
+| スクリプト | 用途 |
+|-----------|------|
+| `orchestra-manager.py` | パッケージのインストール・管理 |
+| `sync-orchestra.py` | SessionStart 時の自動同期 |
+| `analyze-cli-usage.py` | Codex/Gemini の使用状況分析 |
+
+### 3b. ログ仕様
+
+- 全ログの役割・参照先は `docs/specs/logging.md` を参照
+
+### 4. パッケージ管理コマンド
+
+```bash
+# プリセットで一括セットアップ
+python3 ~/ai-orchestra/scripts/orchestra-manager.py setup essential --project .
+python3 ~/ai-orchestra/scripts/orchestra-manager.py setup all --project .
+
+# パッケージ一覧
+python3 ~/ai-orchestra/scripts/orchestra-manager.py list
+
+# プロジェクトでの導入状況
+python3 ~/ai-orchestra/scripts/orchestra-manager.py status --project .
+
+# インストール / アンインストール
+python3 ~/ai-orchestra/scripts/orchestra-manager.py install <package> --project .
+python3 ~/ai-orchestra/scripts/orchestra-manager.py uninstall <package> --project .
+
+# 一時的な有効化 / 無効化（hooks の登録/解除のみ）
+python3 ~/ai-orchestra/scripts/orchestra-manager.py enable <package> --project .
+python3 ~/ai-orchestra/scripts/orchestra-manager.py disable <package> --project .
+
+# パッケージ内スクリプトの一覧表示
+python3 ~/ai-orchestra/scripts/orchestra-manager.py scripts
+python3 ~/ai-orchestra/scripts/orchestra-manager.py scripts --package route-audit
+
+# パッケージ内スクリプトの実行（-- 以降はスクリプトにパススルー）
+python3 ~/ai-orchestra/scripts/orchestra-manager.py run route-audit dashboard
+python3 ~/ai-orchestra/scripts/orchestra-manager.py run route-audit log-viewer --project /path/to/project -- --last 10
+
+# dry-run（変更内容を表示のみ）
+python3 ~/ai-orchestra/scripts/orchestra-manager.py setup essential --project . --dry-run
+python3 ~/ai-orchestra/scripts/orchestra-manager.py install <package> --project . --dry-run
+```
+
+---
+
+## 更新フロー
+
+| 変更内容 | 操作 |
+|---------|------|
+| Hook スクリプト修正 | `git pull` のみ（即反映） |
+| Skills/Agents/Rules 修正 | `git pull`（次回 Claude Code 起動時に自動同期） |
+| 新フックイベント追加 | `git pull` + `install` 再実行 |
+| CLI スクリプト修正 | `git pull` のみ（即反映） |
+
+---
+
+## .claudeignore の管理
+
+- `.claudeignore` は AI Orchestra が自動生成するため直接編集しないでください
+- プロジェクト固有の除外パターンは `.claudeignore.local` に記載
+- SessionStart 時に ベース + `.claudeignore.local` がマージ生成されます
+
+## .gitignore の管理
+
+- `orchestra-manager.py init` 実行時に `.gitignore` へ AI Orchestra 用 block を追加/更新します
+- 対象: `.claude/docs/`, `.claude/logs/`, `.claude/state/`, `.claude/checkpoints/`, `.claude/Plans.md`
+
+---
+
+## 使い方
+
+### エージェントの呼び出し
+
+```
+Task(subagent_type="planner", prompt="このタスクを分解して")
+Task(subagent_type="code-reviewer", prompt="このコードをレビューして")
+```
+
+### スキル一覧
+
+| スキル | 用途 |
+|--------|------|
+| `/review` | コード・セキュリティ・設計レビュー（並列実行対応） |
+| `/startproject` | マルチエージェント協調で新規開発を開始 |
+| `/codex-system` | `cli-tools.yaml` に基づく Codex 利用ガイド（config-driven） |
+| `/gemini-system` | Gemini CLI でのリサーチ・マルチモーダル処理 |
+| `/checkpointing` | セッションコンテキストの保存・復元 |
+| `/design-tracker` | 設計記録スキル（現運用は `CLAUDE.md`/`Plans.md`/ADR/docs を優先） |
+| `/plan` | 実装計画の策定 |
+| `/simplify` | コードの簡素化 |
+| `/tdd` | テスト駆動開発ワークフロー |
+
+### レビュースキル
+
+```
+/review              # 全レビュアー並列実行
+/review code         # コードレビューのみ
+/review security     # セキュリティレビューのみ
+/review impl         # 実装系レビュー
+/review design       # 設計系レビュー
+```
+
+---
+
+## アーキテクチャ
+
+```
+Claude Code (Orchestrator)
+    │
+    ├── Codex CLI    # `cli-tools.yaml` の設定に応じて利用（役割は config-driven）
+    ├── Gemini CLI   # `cli-tools.yaml` の設定に応じて利用（役割は config-driven）
+    │
+    ├── $AI_ORCHESTRA_DIR/packages/
+    │   ├── core/               # 共通ユーティリティ
+    │   ├── cli-logging/        # CLI 呼び出しログ
+    │   ├── codex-suggestions/  # Codex 相談提案
+    │   ├── gemini-suggestions/ # Gemini リサーチ提案
+    │   ├── quality-gates/      # 品質ゲート
+    │   ├── route-audit/        # ルーティング監査
+    │   ├── issue-workflow/     # GitHub Issue 開発フロー
+    │   ├── cocoindex/          # MCP サーバー自動プロビジョニング
+    │   └── tmux-monitor/       # tmux リアルタイム監視
+    │
+    └── 25 Specialized Agents
+        ├── Planning: planner, researcher, requirements
+        ├── Design: architect, api-designer, data-modeler, auth-designer, spec-writer
+        ├── Implementation: frontend-dev, backend-*-dev, ai-*, debugger, tester
+        └── Review: code-reviewer, security-reviewer, performance-reviewer, ...
+```
+
+### 仕組み
+
+- **Hooks**: `$AI_ORCHESTRA_DIR` 環境変数で直接参照（シンボリックリンク不要）
+- **Skills/Agents/Rules**: SessionStart hook (`sync-orchestra.py`) で `$AI_ORCHESTRA_DIR` から `.claude/` に差分コピー
+- **CLI Scripts**: `$AI_ORCHESTRA_DIR/packages/{pkg}/scripts/` を直接実行

orchex-0.1.0/ai_orchestra/__init__.py

@@ -0,0 +1,3 @@
+"""AI Orchestra — Multi-agent orchestration framework for Claude Code."""
+
+__version__ = "0.1.0"

orchex-0.1.0/ai_orchestra/cli.py

@@ -0,0 +1,64 @@
+#!/usr/bin/env python3
+"""AI Orchestra CLI entry point.
+
+uv tool install / pipx install 経由でインストールされた場合の
+`ai-orchestra` コマンドのエントリポイント。
+内部で scripts/orchestra-manager.py の main() に委譲する。
+"""
+
+import importlib.util
+import sys
+from pathlib import Path
+
+
+def get_orchestra_dir() -> Path:
+    """AI Orchestra のルートディレクトリを解決する。
+
+    解決順序:
+    1. インストール済みパッケージ（force-include で packages/ が同梱されている場合）
+    2. リポジトリ直下（開発モード / editable install）
+    """
+    pkg_dir = Path(__file__).resolve().parent  # ai_orchestra/
+
+    # インストール済みパッケージ: ai_orchestra/packages/ が存在する
+    if (pkg_dir / "packages").is_dir():
+        return pkg_dir
+
+    # 開発モード: ai_orchestra/../packages/ （リポジトリルート）
+    repo_root = pkg_dir.parent
+    if (repo_root / "packages").is_dir():
+        return repo_root
+
+    # フォールバック: 環境変数
+    import os
+
+    env_dir = os.environ.get("AI_ORCHESTRA_DIR", "")
+    if env_dir and Path(env_dir).is_dir():
+        return Path(env_dir)
+
+    print("エラー: AI Orchestra ディレクトリが見つかりません", file=sys.stderr)
+    sys.exit(1)
+
+
+def main() -> None:
+    """orchestra-manager.py の main() を呼び出す。"""
+    orchestra_dir = get_orchestra_dir()
+    script_path = orchestra_dir / "scripts" / "orchestra-manager.py"
+
+    if not script_path.exists():
+        print(f"エラー: {script_path} が見つかりません", file=sys.stderr)
+        sys.exit(1)
+
+    # orchestra-manager.py を動的にロードして main() を呼び出す
+    spec = importlib.util.spec_from_file_location("orchestra_manager", script_path)
+    if spec is None or spec.loader is None:
+        print(f"エラー: {script_path} をロードできません", file=sys.stderr)
+        sys.exit(1)
+
+    mod = importlib.util.module_from_spec(spec)
+    spec.loader.exec_module(mod)
+    mod.main()
+
+
+if __name__ == "__main__":
+    main()