# branch-orchestra

> マルチブランチ並列開発オーケストレーター。複数のClaude Codeインスタンスを部下として管理し、並列でタスクを実行させる。自然言語で指示を出し、進捗管理・評価・マージを行う。

- Author: gatherpro
- Repository: gatherpro/branch-orchestra
- Version: 20260125144407
- Stars: 0
- Forks: 0
- Last Updated: 2026-02-06
- Source: https://github.com/gatherpro/branch-orchestra
- Web: https://mule.run/skillshub/@@gatherpro/branch-orchestra~branch-orchestra:20260125144407

---

---
name: branch-orchestra
description: マルチブランチ並列開発オーケストレーター。複数のClaude Codeインスタンスを部下として管理し、並列でタスクを実行させる。自然言語で指示を出し、進捗管理・評価・マージを行う。
---

# Branch Orchestra - 並列開発オーケストレーター

git worktreeを使って複数のClaude Codeを並列で動かし、あなたが指揮者として管理します。

## 前提条件

- tmuxセッション内で実行必須
- Gitリポジトリ内で実行

tmux外の場合:
```
tmux new-session -s dev
claude
```

## スクリプト

```
~/.claude/skills/branch-orchestra/scripts/orchestra.sh
```

## 自然言語 → コマンド変換

### 作成

| ユーザーの言い方 | 実行コマンド |
|----------------|-------------|
| 「3つ作って」「3人用意して」 | `orchestra.sh create 3` |
| 「タスク用に2つ」 | `orchestra.sh create 2 task` |

### 指示

| ユーザーの言い方 | 実行コマンド |
|----------------|-------------|
| 「1番にAPI作らせて」 | `orchestra.sh send 1 "APIを実装して"` |
| 「1番にAPI、2番にフロント、3番にテスト」 | `orchestra.sh assign 1 "API" 2 "フロント" 3 "テスト"` |
| 「2番にCodexレビューさせて」 | `orchestra.sh send 2 "/with-codex レビューして"` |
| 「全員にテスト書かせて」 | `orchestra.sh broadcast "テスト書いて"` |

### 確認

| ユーザーの言い方 | 実行コマンド |
|----------------|-------------|
| 「1番見せて」「1番どう？」 | `orchestra.sh show 1` |
| 「一覧」「誰がいる？」 | `orchestra.sh list` |
| 「1番にフォーカス」 | `orchestra.sh focus 1` |

### 終了

| ユーザーの言い方 | 実行コマンド |
|----------------|-------------|
| 「終わり」「閉じて」 | `orchestra.sh close` |
| 「ブランチも消して」 | `orchestra.sh close-all` |

## 使用例

### 1. 作成

ユーザー: 「3つ作って」

```bash
~/.claude/skills/branch-orchestra/scripts/orchestra.sh create 3
```

結果:
```
repo/           ← 元のリポジトリ (main)
worker-1/       ← feature/worker-1 + Claude起動
worker-2/       ← feature/worker-2 + Claude起動
worker-3/       ← feature/worker-3 + Claude起動
```

応答: 「3つのworkerを作成しました。何をさせますか？」

### 2. 指示

ユーザー: 「1番にAPI、2番にフロント、3番にテスト」

```bash
~/.claude/skills/branch-orchestra/scripts/orchestra.sh send 1 "APIのCRUDエンドポイントを実装してください"
~/.claude/skills/branch-orchestra/scripts/orchestra.sh send 2 "フロントエンドのユーザー一覧画面を作ってください"
~/.claude/skills/branch-orchestra/scripts/orchestra.sh send 3 "テストを書いてください"
```

### 3. 確認

ユーザー: 「1番どんな感じ？」

```bash
~/.claude/skills/branch-orchestra/scripts/orchestra.sh show 1
```

取得した出力を要約して報告。

### 4. Codexレビュー

ユーザー: 「2番にCodexレビューさせて」

```bash
~/.claude/skills/branch-orchestra/scripts/orchestra.sh send 2 "/with-codex このブランチの変更をレビューして"
```

### 5. 終了

ユーザー: 「終わり」

```bash
~/.claude/skills/branch-orchestra/scripts/orchestra.sh close
```

## 構造

```
~/.claude/orchestra/
├── workers.txt      # worker情報 (index|pane_id|path|branch)
├── repo_root        # 元リポジトリのパス
└── base_branch      # 元のブランチ名
```

## 注意

- 最大5 workers
- 各workerは独立したgit worktree（並列作業が安全）
- マージは手動で実施
- with-codexは各workerから直接使用可能