Code ReviewのREVIEW.md|指摘の重さと対象を調整する

この記事の要点
- リポジトリに REVIEW.md を置くと、Code Review の指摘の重さ・件数・対象外・追加の確認項目を変えられる
- CLAUDE.md は全作業に使うプロジェクトの決まり、REVIEW.md はレビューだけの決まりと使い分ける
- サブフォルダの REVIEW.md は、保護したブランチで効く。tests や vendor などの名前のフォルダでは効かない
活用例:AI のコードレビューの指摘が多すぎる・重すぎる問題を、チームの基準に合わせて調整する
- 部署
- 開発・品質管理
- 使うもの
- Claude Code の Code Review と REVIEW.md・CLAUDE.md
- AIに任せる
- 決まりに沿った指摘と、対象外の見送り
- 人が決める
- 重要度の基準・対象外のファイル・追加の確認項目
AI のコードレビューを入れると、「細かい指摘が多すぎる」「自動生成のファイルにまで口を出す」といった悩みが出ます。
Code Review は、リポジトリにファイルを置くだけで、指摘の方針を変えられます。 この記事では、公式ドキュメント「Customize Code Review」(2026年11月16日確認)にもとづいて、2つのファイルの使い分けと書き方をまとめます。レビューの全体像は Claude Code の Code Review の記事を先にご覧ください。
結論:全体の決まりは CLAUDE.md、レビューだけの決まりは REVIEW.md
| ファイル | 役割 |
|---|---|
| CLAUDE.md | Claude Code があらゆる作業で読むプロジェクトの決まり。レビューも読み、違反を指摘する |
| REVIEW.md | レビューだけの指示。何を指摘し、どの重さにし、何を見送るか |
REVIEW.md はリポジトリの根に置いて、ブランチへ取り込みます。そのあと、既定のブランチを保護します。
CLAUDE.md の読まれ方
レビューは、リポジトリの根にある CLAUDE.md と、変更されたファイルの親のフォルダにある CLAUDE.md を読みます。サブフォルダの CLAUDE.md は、その下のファイルが変更されたときに読まれます。決まりに反する変更は、内容にふさわしい重さの指摘になります。
REVIEW.md の読まれ方
REVIEW.md は、自由な書式の Markdown です。指摘を見つける役と、確かめる役の両方が、Code Review の標準の指針とあわせて読みます。最後にまとめを書く段階も、重さを決める前にこれを参照します。レビューの形式(出力のかたち)は変えません。 変えるのは、何を見つけ、どう報告するかです。
書き方の例
公式の例は、バックエンドのサービス向けです。要点は4つに分かれています。
# Review instructions
## What Important means here
Reserve Important for findings that would break behavior, leak data,
or block a rollback. Style, naming, and refactoring suggestions are Nit at most.
## Cap the nits
Report at most five Nits per review.
## Do not report
- Anything CI already enforces: lint, formatting, type errors
- Generated files under src/gen/ and any *.lock file
## Always check
- New API routes have an integration test
- Log lines don't include email addresses, user IDs, or request bodies
日本語で書く場合も、考え方は同じです。
- 「重要」の定義:動作を壊す、データが漏れる、元に戻せなくなる指摘だけを重要にする。書き方や名前の好みは軽い指摘にとどめる
- 軽い指摘の上限:1回のレビューで5件までなど、数を決める
- 報告しないもの:すでに自動検査が見張っているもの、自動生成のファイル、わざと決まりを破っているテスト用のコード
- 必ず見るもの:新しい API に結合テストがあるか、ログに個人情報が入っていないか、など会社固有の確認項目
サブフォルダの REVIEW.md
保護したブランチでは、サブフォルダにも REVIEW.md を置けます。その下の変更に対する確認項目を、根のファイルに足せます。
ただし、次の名前のフォルダの中や下に置いたものは効きません。名前は全体が一致したときだけで、大文字小文字は区別しません(Tests は対象で、integration-tests は対象外)。
- テスト関連:test・tests・__tests__・fixtures・snapshots など
- 見本:example・examples・sample・demo など
- 自動生成:generated
- 外部のコード:vendor・third_party・node_modules・deps・contrib など
これらの場所向けの確認項目は、根の REVIEW.md か、一覧に入っていない親のフォルダに書きます。サブフォルダの REVIEW.md が変更の道筋で読まれる合計は、150,000バイトまでです。超えると、チェックの結果にその旨が出るので、短くします。
2つの道具の違いに注意
サービスとしての Code Review と、手元で実行する /code-review コマンドは別の道具で、読むファイルも違います。サービスは CLAUDE.md と REVIEW.md の両方を読みます。手元のコマンドは、CLAUDE.md だけを読みます。 手元で試すだけでは、REVIEW.md の効果は確かめられません。
レビューの深さと実行の時期は別の設定
指摘の中身は REVIEW.md ですが、レビューの深さや実行の時期は、管理者がリポジトリの設定で変えます(review level と Review runs)。REVIEW.md では変えられません。
会社での進め方の例
- まず「重要」の定義と軽い指摘の上限だけを書く
- 1週間ほど動かし、多すぎた指摘の種類を「報告しないもの」へ足す
- 自社固有の確認項目を、1つずつ足す
- サブフォルダの決まりは、保護したブランチで効くか確かめてから増やす
まとめ
- 全作業の決まりは CLAUDE.md、レビューだけの決まりは REVIEW.md
- 重要の定義・軽い指摘の上限・報告しないもの・必ず見るものの4つから始める
- サブフォルダの REVIEW.md は保護したブランチで効くが、tests や vendor などでは効かない
- 手元の /code-review は CLAUDE.md だけを読む
出典:Customize Code Review(公式ドキュメント)
この記事はAIを使って下書きし、著者が事実確認・加筆しています。ツールの機能や料金は変わることがあるため、最新の情報は各社の公式ページでご確認ください。


