agent-team-organizer

name

agent-team-organizer

description

A skill for designing Claude Code agent team configurations. Use it proactively in situations such as: - When agent teams or multi-agent setups come up - When you want multi-angle verification such as architecture review, domain-expert review, or testing - When splitting and coordinating a large or complex task across multiple sessions - When asked how to use TeamCreate / SendMessage / TaskCreate Use it even when "agent team" is not explicitly stated, whenever quality verification or role division is being discussed.

エージェントチーム構成スキル

設計哲学

エージェントチームの主目的は並列化による時間短縮ではなく、別セッションでの再鑑による品質向上です。 同じ問題を異なる視点・役割で見ることで、単一セッションでは気づきにくい問題を発見できます。

並列実行が明示的に求められている場合はその目的に合わせた構成にしますが、 特に指定がない限り「品質・再鑑」のフレームで考えてください。

ヒアリングフロー

ユーザーとの対話を通じてチーム構成を決めていきます。以下の情報を引き出してください。

1. タスクと目的を理解する

• 何を達成したいのか
• 特に不安な点・確認したい品質観点は何か
• 現在の段階（設計中・実装済み・テスト前 など）

2. どんな再鑑が必要かを一緒に考える

役割は決め打ちせず、ユーザーのコンテキストに応じて候補を提示します。

例：システム開発の場合の役割候補

• アーキテクト：設計の妥当性・スケーラビリティ・技術的負債
• ドメインエキスパート：業務要件との整合性・ユースケースの網羅性
• セキュリティレビュワー：脆弱性・認証認可・データ保護
• パフォーマンスエンジニア：ボトルネック・クエリ最適化・スケーリング
• テスター：テスト戦略・境界値・エッジケース・回帰リスク
• デビルズアドボケイト：批判的検証・前提への挑戦・代替案の探索

例：ドキュメント・設計検討の場合

• 批判的レビュワー：論理の穴・抜け漏れを探す
• ユーザー視点レビュワー：実際の利用者視点での検証
• 実装担当者視点：実現可能性・実装コストの評価

ドメインを聞いて適切な候補を提示し、ユーザーと一緒に絞り込みます。

3. チームサイズの決定

• 推奨: 3〜5メンバー（公式ドキュメントの推奨値）
• 各メンバーに5〜6タスク程度が最適なバランス
• 役割が増えすぎると調整コストが増大するため、最小限の構成から始める

4. チーム名を提案する

タスクの目的を端的に表す英語のケバブケース名を提案します。

• 例：auth-security-review、db-design-validation、feature-payment-team
• 短く・内容が一目でわかる名前を推奨

アウトプット生成

チーム構成が固まったら、カレントディレクトリの .claude/agent-team-organizer/{チーム名}.md に出力します。

出力ファイルの構成

# チーム名

## 目的
（何を達成するためのチームか）

## チーム構成

| メンバー名 | 役割 | 担当観点 |
|-----------|------|---------|
| lead | チームリード | 全体調整・統合 |
| member-a | （役割名） | （観点） |
| member-b | （役割名） | （観点） |

## 各メンバーの責任範囲

### lead（チームリード）
- タスク管理と割り当て
- 各メンバーの知見の統合
- 最終的な判断・まとめ

### member-a（役割名）
- （担当する具体的な観点・チェック項目）

### member-b（役割名）
- （担当する具体的な観点・チェック項目）

## タスクリスト案

- [ ] （タスク1）
- [ ] （タスク2）
- [ ] ...

## 起動手順

### 前提条件
エージェントチーム機能を有効化してください。
`settings.json` に以下を追加：
json
{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

### チーム起動プロンプト例
（ユーザーがコピーして使えるプロンプト例）

## 注意事項
- セッション再開時にin-processメンバーは復元されません
- ネストされたチームは不可（リードのみがチーム管理可能）
- 1セッションにつき1チームまで

エージェントチームの仕組み（参考情報）

ユーザーが技術的な詳細を知りたい場合に補足します。

サブエージェントとの違い

	サブエージェント	エージェントチーム
コンテキスト	独自ウィンドウ・結果を呼び出し元に返す	独自ウィンドウ・完全独立
通信	メインエージェントにのみ報告	メンバー同士が直接メッセージ
調整	メインが全ての作業を管理	共有タスクリストで自己調整

主な制限事項

• /resume でin-processメンバーは復元されない
• タスクステータスが遅れることがある（手動更新が必要な場合も）
• シャットダウンに時間がかかることがある
• ネストされたチームは不可

メンバー間の通信

• 直接メッセージ: SendMessage ツールでメンバー同士が直接連絡できる（リードを経由しない）
• ブロードキャスト: 全メンバーへの一斉送信も可能（コストが増えるため多用は避ける）
• タスクリスト共有: 全員が同じタスクリストを参照し、空きタスクを自己割り当てできる

設定ファイルの場所

• チーム設定: ~/.claude/teams/{チーム名}/config.json
• タスクリスト: ~/.claude/tasks/{チーム名}/

対話のガイドライン

• まずユーザーのタスクを聞き、どんな品質観点が必要かを引き出してください
• 役割の候補を提示して一緒に絞り込む対話スタイルを基本としてください
• チーム構成が固まったら、出力ファイルを生成してください
• 出力後、起動プロンプト例もチャットに表示して即使えるようにしてください