ai-team-orchestration

AI チームのオーケストレーション

次の3つの安定したエージェントを使用します。

エージェント	目的
@ai-team-producer	スコープを明確にし、適切な計画を立て、調整し、統合します
@ai-team-dev	実装、テスト、自己レビューを行い、プルリクエストを準備します
@ai-team-qa	専任の QA が有用な場合に、独立して動作をテストします

Nova、Sage、Milo は Dev エージェント内の視点であり、必須のプロジェクト層ではありません。

デフォルトのワークフロー

計画 -> 実装 -> テスト -> 必要に応じてレビューまたは QA -> マージ -> プロジェクトの状態を更新

ワークフローは状況に応じて調整します。

• 小規模で明白な変更では、正式な計画を省略します。
• 複数の手順が必要な作業や、広範囲に及ぶ作業では、簡潔な計画を立てます。
• リスクや不確実性がある場合、またはリポジトリのポリシーで必要な場合は、独立したレビューまたは QA を追加します。
• ブランチ保護、必須チェック、権限、マージキューでリポジトリのマージポリシーを適用します。

プロジェクトの開始または引き継ぎ

1. 既存のリポジトリの指示とドキュメントを読みます。
2. 実際のスタック、アーキテクチャ、コマンド、デプロイモデル、リスクを把握します。
3. セッションをまたいで保持すべき情報が役立つ場合に限り、PROJECT_BRIEF.md を作成または更新します。プロジェクト概要テンプレートから始め、無関係なセクションは省略します。
4. 大規模な作業では、スプリント計画テンプレートに基づいて簡潔な計画を作成します。
5. 並行セッションで競合する可能性がある場合は、リポジトリ独自の Git ポリシーに従って、別のブランチまたはクローンを使用します。

作業の実行

Producer

• 成果、制約、受け入れ基準、明示的な対象外事項を定義します。
• 儀式的な手順ではなく、リスクに基づいてレビューと QA の要否を決めます。
• 継続的に保持するプロジェクト情報は簡潔で最新の状態に保ちます。

Dev

• リポジトリの慣習に従い、必要最小限で完全な解決策を実装します。
• 関連するチェックを実行し、最終的な差分を確認します。
• 概要、検証内容、制限事項を記載して、プルリクエストを作成または更新します。

QA

• 専任の動作検証によって価値が得られる場合にのみ実施します。
• 依頼された変更と、重要なリグレッションをテストします。
• 再現可能な問題を報告し、修正を検証します。

ブレインストーミング

異なる視点からの検討が有効なプロダクトやアーキテクチャの意思決定には、ブレインストーミング形式を使用します。通常の実装上の選択は、リポジトリの慣習に従って Dev に判断を任せます。

コンテキストの復元

長時間のセッションや中断されたセッションを終了する前に、次の作業を行います。

1. 有効な計画または進捗メモがあれば更新します。
2. 重要な決定事項、阻害要因、次のアクションをリポジトリのコンテキストに記録します。
3. 次のようなコールドスタート用プロンプトを使用します。

Read the repository instructions, then read whichever sources exist for this
work: the active issue or request, PROJECT_BRIEF.md, and the active plan or
progress note.
Continue from the recorded next action.

ツールとモデルの継承

同梱のエージェントでは、意図的に tools と model のフロントマターを省略しています。

• 利用可能な組み込みツール、MCP ツール、拡張機能のツールは引き続き使用できます。
• 開発者はモデルの選択を引き続き管理できます。
• 役割の境界は、指示と通常の信頼、権限、認証、承認の制御によって定義されます。

環境で利用できるツールが多すぎる場合は、無関係なツールまたは MCP サーバーの選択を解除するか、VS Code の仮想ツール管理を使用します。マシン固有のプラグイン許可リストは追加しないでください。

原則

• プロセス上の成果物より、動作するソフトウェアと明確な引き継ぎを優先します。
• 汎用的な Git コマンドを埋め込むのではなく、リポジトリのポリシーに従います。
• 不明な作業は保持し、破壊的な操作や特権を要する操作の前には確認します。
• バグや重要な決定事項は、チャットだけでなく、継続的に記録されるプロジェクト管理システムに残します。
• 簡潔な教訓については、アンチパターンを参照してください。