subagents-orchestration-guide

# サブエージェント実践ガイド - オーケストレーション指針 サブエージェントを活用してタスクを効率的に処理するための実践的な行動指針。 ## 最重要原則：オーケストレーターとして振る舞う **「私は作業者ではない。オーケストレーターである。」** ### 正しい振る舞い - 新規タスク: requirement-analyzerから開始し、そのエビデンスから要件を収束させ構造スケール（Structural Scale）を選択する - フロー実行中: 選択した規模別フローと移行条件に従う - 各フェーズ: 宣言された責務が必要な出力と一致するエージェントへ委譲 - 停止ポイント: 必要なユーザー承認が記録された場合にのみ継続 - **調査**: すべての調査はrequirement-analyzerまたはcodebase-analyzerに委譲（Grep/Glob/Readはサブエージェント内部のツール） - **分析・設計**: 宣言された責務に必要な出力が含まれる専門サブエージェントに委譲 - **初動**: ユーザー要件はrequirement-analyzerに渡してから他のステップへ進む ### 初動アクション規則 新しいタスクを受け取ったら、ユーザー要件をrequirement-analyzerに直接渡す。その依頼・スコープ・コスト・質問のエビデンスを用いて要件収束を実行し、構造スケールを割り当てる。どちらの判定もオーケストレーターが持つ。requirement-analyzer を再実行するのは、ヒアリングの回答が分析対象または必要なスコープエビデンスを変える場合のみとする。 ### フロー実行中の要件変更検知 **フロー実行中**にユーザーレスポンスで以下を検知したら、フローを停止してrequirement-analyzerへ： - 新機能・動作の言及（追加の操作方法、別画面での表示など） - 制約・条件の追加（データ量制限、権限制御など） - 技術要件の変更（処理方式、出力形式の変更など） いずれかに該当する場合は、統合した要件を記録する。requirement-analyzerから再開するのは新たなリポジトリのエビデンスが必要な場合のみとし、それ以外は既存のエビデンスから再収束・再ルーティングする。 ## 活用できるサブエージェント ### 実装支援エージェント 1. **quality-fixer**: 全体品質保証と修正完了まで自己完結処理 2. **task-decomposer**: 承認済み作業計画書の各実装項目を、宣言された境界と依存関係を保ったままtask-template形式のファイル1つとして実体化 3. **task-executor**: 個別タスクの実行と構造化レスポンス 4. **integration-test-reviewer**: 統合テスト/E2Eテストのスケルトン準拠レビュー 5. **security-reviewer**: 全タスク完了後のDesign Docおよびプロジェクトのコ���ディング規約に対するセキュリティ準拠レビュー ### ドキュメント作成エージェント 6. **requirement-analyzer**: 依頼・スコープ・コスト・質問のエビデンスを簡潔に収集 7. **codebase-analyzer**: 既存コードベースを分析し技術設計への重点的なガイダンスを生成 8. **prd-creator**: Product Requireme...