# REVIEW.md

> A file that tells Code Review what to flag and what to skip.

**Field:** Artificial Intelligence  
**Category:** Claude Code  
**Also known as:** REVIEW.md file, Code Review guidance file

## Think of it like

It is like a note to the teacher. It says what to mark and what to skip.

## Definition

REVIEW.md is a file at the root of a repository that tells Code Review what to look for. It can say what to flag, at what level, and which paths to skip, such as files a tool makes for you. Code Review reads it along with CLAUDE.md. A subfolder can have its own REVIEW.md that adds checks for the code under it. The local /code-review command does not read it.

## Example

Lucy's reviews keep flagging style nits in generated code. She adds REVIEW.md telling it to skip that folder, and the noise stops.

## Example code

```markdown
# Review rules
- Skip files under generated/
- Treat a missing auth check as Important
```

Two rules for this repository's reviews.

## Why it matters

Each team cares about its own things. This file is how a review learns what yours are.

## Common mistake

Thinking /code-review on your own computer reads it too. It does not. Only the Code Review service does.

## Three principles

- **At the root.** Of the repository.
- **Flag and skip.** What, and how serious.
- **Service only.** Not /code-review.

## Related terms

- [Claude Code Review](https://learn.benibix.com/term/ai/claude-code-review)
- [Code Review Severity Levels](https://learn.benibix.com/term/ai/code-review-severity)
- [CLAUDE.md](https://learn.benibix.com/term/ai/claude-md)

## Told apart from

- [REVIEW.md vs CLAUDE.md](https://learn.benibix.com/compare/review-md-vs-claude-md): People think REVIEW.md and CLAUDE.md do the same job, since Code Review reads both. They do not. CLAUDE.md tells Claude about the project, and every Claude Code session reads it. REVIEW.md tells Code Review what to flag and what to skip, and only that service reads it. The review command you run in a terminal reads CLAUDE.md but not REVIEW.md. So put review rules in REVIEW.md.

![A pull request goes to several agents. A check step drops wrong findings, and the rest come back as ranked comments.](https://learn.benibix.com/diagrams/ci-code-review.svg)

---

Source: https://learn.benibix.com/term/ai/review-md
Author: Behnia Zarei (a developer in Vienna, Austria, who builds and teaches data, AI and business intelligence at BENIBIX)
Publisher: BENIBIX Learn (https://learn.benibix.com/)
Last updated: 2026-11-19
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
