agent-team-driven-development

計画実行のためのエージェントチーム主導の開発

複雑な実装計画を実行するため、複数の専門チームメイトが並行して作業できるよう調整します。

エージェントチームとサブエージェント

作業者同士のコミュニケーションが必要かどうかに応じて選択します。

項目	サブエージェント	エージェントチーム
コミュニケーション	結果は呼び出し元にのみ返されます	チームメイト同士が直接メッセージを送れます
調整	メインエージェントがすべての作業を管理します	共有タスクリストを使って自律的に調整します
最適な用途	結果だけが重要な、範囲の明確なタスク	議論や協力が必要な複雑な作業
トークンコスト	低い	高い：各チームメイトは個別のインスタンスです

作業者間のコミュニケーションが不要な独立タスク（調査、検証、ファイル検索）には、サブエージェントを使用します。チームメイト間で知見を共有したり、互いの考えを検討したり、3 つ以上の並行作業を自主的に調整したりする必要がある場合は、エージェントチームを使用します。順次進めるタスクや相互依存性の高いタスクには、単一のセッションを使用します。

実行ワークフロー

1. 計画を分析する -- タスクの独立性、ファイルの競合、必要な役割（実装担当、レビュー担当、アーキテクト）を特定します
2. チームを起動する -- 各チームメイトにタスク、ファイルパス、制約、検証基準を提示します。チームメイトは会話の履歴を引き継ぎません。
3. 調整する -- 共有タスクリストで進捗を確認し、チームメイト間のコミュニケーションを促進します。委任モード（Shift+Tab）を使い、リードが調整に集中できるようにします
4. 検証してクリーンアップする -- 統合を検証し、テストを実行し、チームメイトを終了させ、リードを通じてチームのリソースをクリーンアップします

詳細なワークフローについては、./references/initiate-team-workflow.md と ./references/manage-team-workflow.md を参照してください。

役割

• 実装担当：割り当てられたファイルのコーディングタスクを実行し、TDD/BDD に従います。./references/implementer-role.md を参照してください。
• レビュー担当：品質、セキュリティ、計画への準拠を検証します。./references/reviewer-role.md を参照してください。
• アーキテクト：複数の領域にまたがる懸念事項を解決し、システム全体の一貫性を保ちます。./references/architect-role.md を参照してください。

重要な実践事項

• 編集の競合を防ぐため、チームメイトごとに担当ファイルを分けます
• 安定した処理量を保つため、チームメイトごとに 5～6 個のタスクを割り当てます
• ブロックされたタスクが自動的に待機するよう、タスクの依存関係を明示します
• 起動時のプロンプトに十分なコンテキスト（ファイルパス、目標、制約）を含めます
• タスク完了時に検証の証拠（テスト結果など）を提示するよう求めます
• 頻繁に進捗を確認します。監視されていないチームでは、作業が無駄になるおそれがあります

アーキテクチャ、機能、制限事項については、./references/official-documentation.md を参照してください。