review-loop

レビューループ

回数を限定したレビュー・修正・再レビューのループです。ルーターとして、意図を解析し、レビュアーを選び、ループを実行します。

1. 意図の解析

/review-loop の後に続く自然言語から、次の項目を判断します。

• 対象：計画か作業か？会話のコンテキスト、最近のアクティビティ、ユーザーの発言を確認します。
• レビュアー：ユーザー指定、またはあなたの判断で選びます。利用可能なレビュアー：code-reviewer、architect-reviewer、security-auditor、technical-editor、accessibility-tester、design-reviewer、codex-specialist。成果物の種類に合わせて選びます。
• ラウンド上限：デフォルトは3です。ユーザーが「thorough」と言った場合は5、「quick」と言った場合は1です。
• 重大度の基準：デフォルトはP2です（P0～P2を修正し、P3以上は記録します）。ユーザーが「strict」と言った場合はP1、「lenient」と言った場合はP3です。

曖昧な場合は、「計画と作業のどちらをレビューしますか？」と尋ねます。

2. 依頼

• 計画：Skill ツールを使って /plan-review を実行します。ラウンド上限を渡します。内部のP0ループはR1として数えます。
• 作業：Agent ツールを使ってレビュアーを割り当てます。重大度タグ付きの指摘（P0～P3）を依頼します。

タグのない指摘はP1として扱います。

3. ループ：修正、記録、再レビュー

各ラウンド（R1～R{cap}）で、次の処理を行います。

a. 重大度の基準に従って指摘をトリアージします（P0が最も重大で、P3が最も低重大度です）。

• 修正（基準より重大度が高いもの、つまりP番号が小さいもの：P0～P{gate}）：すぐに修正します。AGENTS.md に従い、Co-Authored-By トレーラーを付けて fix: address R{N} review findings というコミットを作成します。
• 記録（基準より重大度が低いもの、つまりP番号が大きいもの：P{gate+1}以上）：記録し、修正はしません。

b. 基準未満の指摘を記録します。

• 計画：計画ファイルに ### Deferred Findings (R{N}) セクションを追加します。
• 作業：gh issue create --label review-finding --title "R{N}: <summary>" を実行します。上限は1ラウンドあたり10件、全ラウンド合計で20件です。gh が利用できない場合は、.branch-context.md に追記します。

c. レビュアーの継続 — 修正を一切信用しません。各レビュアーが個別に基準以上の指摘なしと回答するまで、そのレビュアーはパネルに残ります。

• R1：全レビュアー
• R2以降：直前のラウンドで基準以上の指摘をしたレビュアーのみが再レビューします。
• 基準以上の指摘がなかったレビュアーは完了です。暗黙的に承認済みです。

d. 次の場合に終了します： すべてのレビュアーが個別に問題なしを確認した（収束した）、上限に達した、またはDROP判定となった場合。

e. 繰り返し発生する指摘： 同じ指摘が2ラウンド以上にわたって現れた場合、重大度を1段階上げます。重大度を上げた指摘がP0になり、上限に達しても修正されていない場合は、停止して人間に引き継ぎます。

4. 概要

Review Loop Summary
───────────────────────────────────────
Target:    <plan name or file description>
Rounds:    <N of cap>
Gate:      P<N>

│ Round │ P0 │ P1 │ P2 │ P3+ │ Fixed │ Recorded │
│───────│────│────│────│─────│───────│──────────│

Verdict: APPROVE | ESCALATE

APPROVE = 基準以上の指摘がすべて解決済みです。ESCALATE = 未解決の基準以上の指摘が残っているため、人間に引き継ぎます。

ガードレール

• 保護対象ファイルは変更しません（AGENTS.md を参照）。
• 上限は最大5ラウンドです。ユーザーがそれ以上を要求しても変わりません。注：「thorough」（5）はすでに最大です。
• 自動マージや自動承認は行いません。このループが出すのは判定であり、アクションではありません。
• プレーンテキストのみを出力します。複数のサーフェスで安全に使用できます。

失敗時の対応

• /plan-review を利用できない場合 → technical-editor と architect-reviewer を直接割り当てます。
• gh が認証されていない場合 → .branch-context.md に記録するか、リストを出力します。
• レビュアーがDROPを返した場合 → すぐに終了し、概要を出力します。
• 利用可能なレビュアーがいない場合 → 最低限のパネルとして code-reviewer を使用します。