agent-teamlisted

# agent-team **Agent Teams** = 完全に独立した複数の Claude Code セッションを並列稼働させる Anthropic の実験的機能。 `subagent` が「軽量・結果サマリだけ返す」のに対し、Agent Team は **「複数の Claude が同時に長期間動き、teammate 同士で直接メッセージを交わし、shared task list で協調する」** という、もう一段重い仕組み。 token cost は線形に増える代わりに、相互依存のある大規模並列タスクで圧倒的な並列性を出せる (Anthropic 公式は 16 agent × 約 2000 session で 10 万行の Rust 製 C コンパイラを完成させた事例を公開)。 --- ## subagent との違い (重要な判断軸) | 観点 | subagent | Agent Team | |---|---|---| | **context** | 同セッション内で独立窓 (親はサマリのみ閲覧) | 完全に独立した別セッション | | **通信** | 親 ⇔ 子 のみ (子同士は通信不可) | teammate 同士で直接メッセージ可 | | **token cost** | 低 (子の context は親に流れない) | 高 (全 teammate 分が独立に走る) | | **寿命** | タスク 1 回で終わる | 長時間稼働・複数 turn | | **可視性** | 親は中身を見られない | split panes / Shift+Down で観察可 | | **編集の自由度** | 親と同じファイルを触ると競合する | teammate ごとにファイル/領域を所有 | | **適した規模** | 数分〜10 分 / 単発 | 数十分〜数時間 / 複合タスク | ### どちらを選ぶか - **subagent で十分**: 単発調査・レビュー・要約・並列 grep - **Agent Team が必要**: - 複数領域 (Canvas / PTY / Settings) を **同時に編集**したい - teammate 間で **設計を相談しながら** 進めたい - **長時間** (数時間規模) かかる作業を分担したい - 親が一人で見るには context が足りない規模 迷ったらまず subagent。Agent Team は「コストとオーバーヘッドの覚悟」が要る。 --- ## 有効化 実験的機能なので明示的に有効化が必要。 ```json // settings.json (project or user) { "env": { "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1" } } ``` `update-config` skill 経由で設定するのが安全。再起動が必要な場合あり。 --- ## 起動と運用 ### 起動 team lead (= 自分が今いる Claude) に自然言語で依頼すると、lead が teammate を spawn する: ``` PR #142 をレビューする agent team を組んで。3 人体制で: - security 観点 - performance 観点 - test coverage 観点 それぞれ独立に調査して、最後に findings を統