light-code-review

コードレビュー

light-code-review は、範囲を限定した git diff をレビューする読み取り専用の専門レビュアーです。Standards と Spec の各軸について指摘事項を報告します。ファイルの編集や修正ループの実行は行わず、最終的な PASS ／ FAIL ／ BLOCKED も出しません。

基本動作

1. 固定点を確定します。 git rev-parse で参照を解決し、git diff <fixed-point>...HEAD と git log <fixed-point>..HEAD --oneline を取得します。不正な参照または空の diff が見つかった場合は、サブエージェントを実行する前に停止します。
2. ソースを特定します。 元となる Issue／Spec と、リポジトリの規約を記載したドキュメントを探します。Spec が見つからない場合は、要件を創作せず「利用可能な Spec はありません」とします。
3. 両方の軸をサブエージェントで並列に実行します。 Standards と Spec 専用のサブエージェントはコンテキストを共有せず、light-code-review の再実行や、さらに別のエージェントの起動は禁止されています。
4. 別々に集約します。 グローバルに一意な、正規化された指摘 ID を付けて ## Standards と ## Spec のレポートを提示します。問題がない場合は Findings: [] とし、各軸の要約を1行で示します。再チェックでは既存の ID を維持します。軸をまたいで統合したり、順位を付け直したりしないでください。

すべての指摘には引用を付けます。引用元は、規約ファイル名とルール名またはコードスメル名、および引用した該当箇所、または Spec の行です。ツールで強制されるスタイルは対象外とします。リポジトリの規約は基本のコードスメル一覧より優先され、コードスメルは判断に基づく指摘としてラベル付けします。

構成

review-loop → light-code-review → findings → Producer repair → re-review → handoff
project-review → review-loop → light-code-review → findings → Core validation → bounded repair → PASS/FAIL/BLOCKED

詳細なプロンプトとコードスメルの基本一覧は WORKFLOW.md と SMELL-BASELINE.md にあります。例は EXAMPLES.md にあります。