Team Builder

# チームビルダー

オンデマンドでエージェントチームを閲覧・構成するためのインタラクティブメニュー。フラット構成またはドメインサブディレクトリで整理されたエージェントコレクションに対応する。

## 使用場面

* 複数のエージェントロール（markdownファイル）があり、あるタスクにどのエージェントを使うか選択したい場合
* 異なるドメインから（例えば、セキュリティ + SEO + アーキテクチャ）臨時チームを結成したい場合
* 決定する前に利用可能なエージェントを閲覧したい場合

## 前提条件

エージェントファイルはロール、プロンプト（アイデンティティ、ルール、ワークフロー、成果物）を含むmarkdownファイルである必要がある。最初の `# Heading` がエージェント名として使用され、最初の段落が説明として使用される。

フラット構成とサブディレクトリの両方のレイアウトをサポートする：

**サブディレクトリレイアウト** —— ドメインはフォルダー名から推論される：

```
agents/
├── engineering/
│   ├── security-engineer.md
│   └── software-architect.md
├── marketing/
│   └── seo-specialist.md
└── sales/
    └── discovery-coach.md
```

**フラットレイアウト** —— ドメインは共有のファイル名プレフィックスから推論される。2つ以上のファイルが同じプレフィックスを共有する場合、そのプレフィックスはドメインとみなされる。ユニークなプレフィックスを持つファイルは「General」カテゴリーに分類される。注意：アルゴリズムは最初の `-` で分割するため、複数単語のドメイン（例：`product-management`）にはサブディレクトリレイアウトを使用する：

```
agents/
├── engineering-security-engineer.md
├── engineering-software-architect.md
├── marketing-seo-specialist.md
├── marketing-content-strategist.md
├── sales-discovery-coach.md
└── sales-outbound-strategist.md
```

## 設定

エージェントディレクトリは順番に探索され、結果がマージされる：

1. `./agents/**/*.md` + `./agents/*.md` —— プロジェクトローカルのエージェント（両方の深さ）
2. `~/.claude/agents/**/*.md` + `~/.claude/agents/*.md` —— グローバルエージェント（両方の深さ）

すべての場所の結果がマージされ、エージェント名で重複排除される。同名の場合、プロジェクトローカルのエージェントがグローバルエージェントより優先される。ユーザーがカスタムパスを指定した場合、そのパスを代わりに使用する。

## 動作原理

### ステップ 1：利用可能なエージェントを発見する

上記の探索順序を使用してエージェントディレクトリでグローバル検索を実行する。READMEファイルを除外する。見つかった各ファイルに対して：