---
name: setup-team
description: "タスクに応じたマルチエージェントチームを設計・構成する。Use when: 「エージェントチームを組んで」「複数エージェントで実行したい」「並列実行チームを設計して」「どのエージェントを使うか決めて」「チームでこのタスクを進めて」。1エージェントで完結する小タスクには不要。"
---

# Setup Team

タスクの規模・モードに応じて最適なマルチエージェントチームを設計し、各メンバーへの委譲準備を行うスキル。

## Common Rationalizations

| こう思ったら | 現実 |
|---|---|
| 「全部 implementer に任せれば速い」 | ロール分離がない実行は品質保証がない。チーム設計が速度を生む |
| 「チーム設計は時間がかかる」 | 役割が明確なほど各エージェントの出力品質が上がり、手戻りが減る |
| 「standard 以下でもチームを組む」 | ultra-light/light は 1 エージェントで完結。チーム設計はオーバーキル |

---

## ステップ 1: チームが必要か判定する

| モード | チーム設計 |
|--------|-----------|
| ultra-light / light | 不要。単一エージェントで完結 |
| standard | 実装 + レビューの 2 体が基本 |
| high-risk | 実装 + レビュー + テスト確認の 3 体以上 |
| critical | 全ロール（planner / implementer / reviewer / security-reviewer / test-reviewer）を配置 |

## ステップ 2: ロール定義を確認する

`plugin/plangate/rules/subagent-roles.md`（または `rules/subagent-roles.md`）に定義された 6 ロールを使用する。

| ロール | 責務 | 対応 subagent_type |
|--------|------|-------------------|
| planner | 要件分析・実行計画策定 | `Plan` または `plangate:spec-writer` |
| implementer | コード実装 | `plangate:implementer` または `implementation-agent` |
| reviewer | 設計・コード品質レビュー | `plangate:acceptance-tester` または `qa-reviewer` |
| security-reviewer | セキュリティ観点レビュー | `security-auditor` |
| test-reviewer | テスト品質・カバレッジ確認 | `test-engineer` |
| documentation-reviewer | ドキュメント整合性確認 | `documentation-writer` |

## ステップ 3: チーム構成を決定する

タスクの Work Breakdown（`plan.md`）を元にチームを設計する。

### 出力フォーマット

```yaml
team:
  - role: planner
    agent: plangate:spec-writer
    tasks: [TA-01]
    run_in_background: false

  - role: implementer
    agent: plangate:implementer
    tasks: [TA-02, TA-03]
    depends_on: [planner]
    run_in_background: true

  - role: reviewer
    agent: plangate:acceptance-tester
    tasks: [TA-04]
    depends_on: [implementer]
    run_in_background: false
```

## ステップ 4: 並列実行グループを特定する

`subagent-dispatch` スキルと連携して、依存関係グラフを生成する。

```
Phase A（並列可）: 依存関係のないタスク群 → run_in_background: true
Phase B（逐次）:  Phase A 完了後に実行するタスク群
```

## ステップ 5: 各エージェントへの委譲プロンプトを生成する

各エージェントへ渡すプロンプトに以下を含める。

```markdown
## 目的
{このエージェントが達成すべきゴール}

## 担当タスク
{Work Breakdown から割り当てられたタスク番号と内容}

## Allowed Context
{context-packager が生成した 6 要素: 対象ファイル / 仕様 / 既存テスト / 変更制約 / 実行コマンド / 禁止スコープ}

## 完了条件
{このエージェントの DONE 基準}

## 制約
- Allowed Context 外のファイルを変更しない
- 完了後に結果サマリを返す
```

## ステップ 6: キックオフする

並列実行可能なエージェントを同一メッセージで起動する。

```python
# Phase A: 並列起動（依存なし）
Agent(subagent_type="plangate:implementer", run_in_background=True, prompt="...")
Agent(subagent_type="plangate:implementer", run_in_background=True, prompt="...")

# Phase B: Phase A 完了後に逐次起動
Agent(subagent_type="plangate:acceptance-tester", run_in_background=False, prompt="...")
```

## 関連スキル

- `subagent-dispatch`: 依存関係グラフ生成と Allowed Context 付き dispatch
- `context-packager`: 各エージェントへ渡す Allowed Context を生成
- `codex-multi-agent`: Codex CLI を使う場合の並列エージェント実行