Claude Code でのサブエージェント設計

問題: 大きなコーディングタスクには複数種類の専門家が必要ですが、単一の Claude セッションにすべてをこなすよう求めると機能が低下し始めます。

すぐ使えるヒント: 複数の視点が必要なレビューにこのプロンプトを貼り付けてください：

Create sub-agents and analyze this from these perspectives:
- Senior engineer: Review architecture decisions
- Security expert: Identify vulnerabilities
- Performance reviewer: Find optimization opportunities

3つのスペシャリストによる読み込みが並列で、数分で返ってきます。

1つのコンテキストが失敗する理由

コードのレビュー、パフォーマンスのチューニング、セキュリティの確認を同じ息で Claude に依頼すると、答えが一般的になります。すべての角度が同じコンテキストウィンドウのスペースを取り合います。すべてが浅くなります。

サブエージェントは各視点に独自のコンテキストを与えることでこれを修正します。各エージェントは自分のレーンに留まり、独自のツールを選び、独自の方法で作業します。最終的に結果をまとめます。

Claude Code には2つの実行方法があります：

1. Task ツール: 組み込みツールが独立したサブエージェントを生成し、それぞれが独自のコンテキストウィンドウを持ちます。
2. 視点のプロンプト: 1回のパスで複数の専門家の視点を求める単一のプロンプト。

Task は真の並列作業を生成します。視点プロンプトは1つのセッション内でそれを模倣します。どちらの方法でも、分析品質が向上します。

1. 並列化できるタスクを見つける

サブエージェント分割に適した候補：

• 複数の角度からのコードレビュー
• 異なる技術にわたるリサーチ
• 異なるオーディエンス向けのドキュメントレビュー
• 異なるメトリクスにわたるパフォーマンス分析

直列の場合はサブエージェントをスキップ：

• 互いに依存するファイル編集
• 順次ビルドステップ
• データベースマイグレーション

2. スペシャリストロールを設計する

ドメインに合った視点を選んでください。役に立つプロンプトテンプレートをいくつか紹介します：

コード品質レビュー：

Analyze this codebase using sub-agents with these specialist roles:
- Factual reviewer: Check technical accuracy against documentation
- Senior engineer: Review architecture decisions and patterns
- Security expert: Identify vulnerabilities and attack vectors
- Consistency reviewer: Check coding standards compliance
- Redundancy checker: Find duplicate logic to consolidate

ユーザーエクスペリエンス分析：

Create sub-agents for UX review of this feature:
- Creative thinker: Suggest innovative interaction solutions
- Beginner user: Test ease of use and onboarding friction
- Designer: Evaluate visual hierarchy and spacing
- Marketing analyst: Assess conversion potential
- Accessibility auditor: Check WCAG compliance

3. 分析をオーケストレートする

各サブエージェントは独自のツールを選びます。セキュリティエージェントは脆弱性スキャナーに向かいます。パフォーマンスレビュアーはプロファイリングツールを取り込みます。アーキテクトは構造を見ます。1つのエージェントだけでは3つをすべて同じようにカバーできません。

安全な読み取りのためのプランモード

重要なコードにスペシャリストサブエージェントを解き放つ前に、プランモードに入ってください。Claude Code 内でShift+Tab を2回押します。これにより、実行中は読み取り専用が保たれます。

その後、多角度レビューを依頼します：

Use sub-agents to validate this API design from:
- Backend perspective: Data flow and scalability
- Frontend perspective: Consumption patterns and DX
- Security perspective: Authentication and authorization gaps

サブエージェントが独自に修正しようとする可能性がある場合に、プランモードがその価値を発揮します。

統合パターン

サブエージェントが完了したら、出力をまとめます：

1. 個別レポート: 各エージェントが独自の結果をまとめます。
2. 競合解決: 2つの推奨事項が矛盾するときに勝者を選びます。
3. 優先度ランキング: 影響度で修正をソートします。
4. アクションプラン: 実装手順を整理します。

よくあるミス

ミス: 小さなタスクにサブエージェントを生成する。

タイポ、1行のパッチ、クイックリネーム。調整のオーバーヘッドが得られる利益を消し去ります。エージェントをスキップしてください。

改善: 複雑で多面的な問題にスペシャリストチームを使いましょう：

Use sub-agents to redesign this authentication system:
- Security expert: Audit current vulnerabilities
- UX designer: Simplify the login flow
- Performance engineer: Optimize token handling

ミス: ほぼ同じロールを積み重ねる。

「セキュリティエキスパート、ペネトレーションテスター、脆弱性スキャナー、セキュリティアーキテクト」は同じ視点を4つの帽子で被っているだけです。

改善: 問題の異なる側面をカバーし、互いを侵さないロールを選んでください。

バックグラウンド実行

すべてのサブエージェントをバックグラウンドで実行できるようになりました。実行中に Ctrl+B を押してください：

You: Audit our authentication module for security issues
Claude: I'll spawn a sub-agent to analyze the auth module...
[Sub-agent starts]
You: [Press Ctrl+B]
You: While that runs, let's optimize the database queries...

バックグラウンド実行を /tasks で追跡してください。完了すると、メインエージェントを起こして結果を渡します。

ブロッキングスペシャリストが並列になります。完全な非同期カバレッジはバックグラウンドエージェントガイドにあります。

コスト削減効果

サブエージェントは Opus の料金を払わずに Claude Sonnet を拡張します。並列分析により Opus に近いレベルの出力が Sonnet の価格で得られます。

節約の源：

• 1つのセッションで複数の専門家の視点
• 並列作業が総実行時間を削減
• スペシャリストコンテキストが浅い一般的な読み込みを回避
• 単一のプレミアムモデルより優れた出力
• バックグラウンド実行が待機をなくす

ロールローテーション

長期プロジェクトでは、コンポーネント全体でスペシャリストのラインアップをローテーションします。

第1週 - コアアーキテクチャ：

Analyze the database design using sub-agents:
- Data architect: Schema optimization and normalization
- Security expert: Access control and encryption
- Performance optimizer: Query patterns and indexing

第2週 - API レイヤー：

Review API endpoints with these specialist sub-agents:
- Backend engineer: Implementation quality and patterns
- Documentation writer: API clarity and examples
- Integration specialist: Third-party compatibility

反復的な改善

サブエージェントは段階的なパスに自然に適合します：

1. 最初の確認では幅広い視点
2. 2回目はスペシャリストの深掘り
3. 3回目はユーザー中心のレビュー

結果はより完全で、よりユーザー中心になり、単独エージェントが見逃すものを捉えます。

サブエージェントが効果を発揮する場面

• アーキテクチャレビュー: 複数の技術的レンズを同時に
• ドキュメント監査: 異なるオーディエンスは異なるものを読む
• コード品質ゲート: 1回のパスで多くの品質次元
• プロダクト戦略: クロスファンクショナルな読み込み
• 競合分析: 異なる市場の角度

コードレビューから始めてください。「並列化への渇望」を感じたら戦略的な作業に広げてください。

次のステップ

• 実行パターン: 並列、順次、バックグラウンドのいつを選ぶか。
• 基盤: エージェントファンダメンタルズが基礎をカバーします。
• 実装: 専門的なシナリオのためのカスタムエージェント。
• 調整: 大規模なマルチエージェントプロジェクトのためのタスク分散。
• 最適化: 安全なサブエージェント実行のためのプランニングモード。
• コンテキスト管理: チーム全体で高い品質を維持する。

次のコードレビューで試してください。スペシャリスト分割は、初めて使ったときに気づくものです。