/debug-team

デバッグ調査チーム

前提: Agent Teams が有効であること（CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS: "1"）。無効な場合はユーザーに設定を案内する。

概要

$ARGUMENTS の問題について、複数の調査員が異なる仮説を並行で検証し、互いの理論に反証し合う科学的討論を行うことで根本原因を特定する。

1 人で調査すると最初に見つけた仮説にアンカリングバイアスがかかる。独立した調査 + 相互反証で、生き残った理論がより正確な原因である可能性が高くなる。

実行フロー

Phase 1: 症状の整理（Lead とユーザー）

チーム作成の前に、問題の情報を整理する:

• 症状: 何が起きているか
• 再現手順: どうすれば再現するか
• 影響範囲: どこで発生するか
• 発生頻度: 常に/時々/特定条件で
• 最近の変更: 直近で変更したコード

Issue 番号がある場合は gh issue view で詳細を取得する。エラーログがある場合は関連箇所を抽出する。

Phase 2: 仮説の立案（Lead とユーザー）

症状から考えられる仮説を 3 つ立てる。仮説は互いに独立していること。ユーザーに提示して追加・修正を確認する。

Phase 3: Agent Team 作成と調査開始

delegate mode を推奨: ユーザーに Shift+Tab での delegate mode 有効化を案内する。delegate mode では Lead がファイル編集等の直接作業を行えなくなり、チームメイトへの委譲が強制される。Lead は自ら調査を行わず、チームメイトへの指示・調整・統合に専念する。

タスクリストの作成

チームメイトを spawn する前に、共有タスクリストを作成する。各 Investigator に 5-6 個のタスクを割り当てる。

タスク設計の指針（Investigator ごと）:

• 仮説に関連するコードの特定
• 関連するログ・設定・テストの調査
• 仮説を支持する証拠の収集
• 仮説に反する証拠の収集（確証バイアス対策）
• 他の Investigator の結果への反論/補強
• 最終的な結論と修正案の Lead への報告

ファイル競合の回避

全 Investigator は読み取り専用で調査を行うこと。コードの編集は一切行わない。修正は調査完了後に別途対応する。

Investigator の spawn

3 人の Investigator を spawn する。プロジェクトコンテキスト（CLAUDE.md、MCP サーバー、スキル等）は自動で読み込まれるため、spawn プロンプトには問題の情報と担当仮説だけを簡潔に渡す。

spawn プロンプトのテンプレート（各 Investigator で仮説部分を差し替え）:

「$ARGUMENTS」の問題を調査してください。

あなたの担当仮説: [仮説の内容]

コードベースを調査し、この仮説を支持する証拠と反する証拠の両方を集めてください。
他の調査員が別の仮説を検証しています。彼らの発見に対して、自分の調査結果から積極的に反論や補強を行ってください。
確証バイアスに注意し、反する証拠も必ず探すこと。証拠なしに結論を出さないこと。

調査結果は Lead に報告してください: 仮説の妥当性（HIGH/MEDIUM/LOW）、発見した証拠、推定される根本原因、修正案。

チームの運営

チームメイトは共有タスクリストから自律的にタスクをクレームして進める。Lead は以下に専念する:

• Investigator の進捗を監視する
• 行き詰まっている場合は追加情報やヒントを提供する
• 科学的討論を促す: 各 Investigator は他の仮説を積極的に反証しようとする。生き残った理論が最も有力
• チームメイトの作業完了を待つ。Lead が自ら調査を始めない
• 合意が形成されたら、各自の最終結論を Lead に報告するよう依頼する

Phase 4: 結論のまとめと報告

Lead がチームメイトの調査結果を統合し、結論を判定する:

• 合意あり: 全員が同じ仮説に収束 → 根本原因を確定し修正案を提示
• 有力候補あり: 2 人以上が同じ仮説を支持 → 有力な原因として提示し追加検証を提案
• 不一致: 合意なし → 調査結果を整理してユーザーに報告し追加情報を依頼

Phase 5: クリーンアップと次のステップ

以下の順序で確実にクリーンアップすること:

1. 全 Investigator に shutdown_request を送信する
2. 全員が停止したことを確認する
3. TeamDelete でチームリソースをクリーンアップする
4. ユーザーに結論を報告し、次のステップを提案する:

修正を実装しますか？
- Yes → `/dev-core:tdd [修正内容]` で TDD サイクルを実行
- No → 調査結果を Issue にコメントとして追記

注意事項

• コンテキストの分離: チームメイトは Lead の会話履歴を引き継がない。spawn プロンプトに問題の症状・再現手順・仮説を十分に含めること
• 読み取り専用: 全 Investigator はコード読み取りのみ。コード編集は一切行わない
• タスク状態の確認: チームメイトがタスク完了をマークし忘れることがある。タスクが止まっているように見える場合は確認すること
• セッション復元不可: /resume でチームメイトは復元されない。再開が必要な場合は新しくチームを作成する
• 1 セッション 1 チーム: 同時に複数のチームは管理できない