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.mdClaude 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

日本語で書く場合も、考え方は同じです。

サブフォルダの REVIEW.md

保護したブランチでは、サブフォルダにも REVIEW.md を置けます。その下の変更に対する確認項目を、根のファイルに足せます。

ただし、次の名前のフォルダの中や下に置いたものは効きません。名前は全体が一致したときだけで、大文字小文字は区別しません(Tests は対象で、integration-tests は対象外)。

これらの場所向けの確認項目は、根の 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. まず「重要」の定義と軽い指摘の上限だけを書く
  2. 1週間ほど動かし、多すぎた指摘の種類を「報告しないもの」へ足す
  3. 自社固有の確認項目を、1つずつ足す
  4. サブフォルダの決まりは、保護したブランチで効くか確かめてから増やす

まとめ

  1. 全作業の決まりは CLAUDE.md、レビューだけの決まりは REVIEW.md
  2. 重要の定義・軽い指摘の上限・報告しないもの・必ず見るものの4つから始める
  3. サブフォルダの REVIEW.md は保護したブランチで効くが、tests や vendor などでは効かない
  4. 手元の /code-review は CLAUDE.md だけを読む

出典:Customize Code Review(公式ドキュメント)

永上裕之

ユニコスクール株式会社 代表取締役。AIエージェント専門のスクール&コミュニティを運営しています。

この記事はAIを使って下書きし、著者が事実確認・加筆しています。ツールの機能や料金は変わることがあるため、最新の情報は各社の公式ページでご確認ください。

関連する記事