> ## Documentation Index
> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Personalizar o Code Review

> Ajuste o que o Code Review sinaliza nos seus pull requests com REVIEW.md e CLAUDE.md: recalibre a severidade, ignore caminhos, adicione verificações e veja qual cópia se aplica.

Você pode alterar o que o [Code Review](/docs/pt/code-review) sinaliza no seu repositório fazendo commit de instruções nele. É assim que você reduz o volume de nits, interrompe comentários em arquivos gerados ou adiciona uma regra com a qual sua equipe se importa. Coloque-as em um de dois arquivos:

* **`CLAUDE.md`**: [instruções do projeto](/docs/pt/memory) que o Claude Code lê para toda tarefa, incluindo revisões. O Code Review as lê como contexto do projeto e sinaliza alterações que as violam.
* **`REVIEW.md`**: instruções apenas para revisões. Use-o para dizer o que sua equipe quer que seja sinalizado, com qual severidade, e o que ignorar.

Adicione o `REVIEW.md` na raiz do seu repositório e faça o merge. Em seguida, [proteja seu branch padrão](#which-branch-review-md-is-read-from).

<Note>
  Para alterar o quão minuciosas são as revisões ou quando elas são executadas, peça a um Owner que altere o [nível de revisão](/docs/pt/code-review-setup#set-the-default-review-level) ou a [configuração **Review runs**](/docs/pt/code-review-setup#set-when-reviews-run).
</Note>

<h2 id="use-claude-md-for-project-wide-rules">
  Use o CLAUDE.md para regras de todo o projeto
</h2>

O Code Review lê os arquivos `CLAUDE.md` do seu repositório como contexto do projeto. Uma alteração que viola uma de suas regras se torna uma descoberta no [nível de severidade](/docs/pt/code-review-pull-requests#severity-levels) que for adequado ao problema.

Uma revisão lê o `CLAUDE.md` na raiz do seu repositório e os arquivos `CLAUDE.md` nos diretórios pais de cada arquivo alterado. O `CLAUDE.md` de um subdiretório é lido quando o pull request altera um arquivo sob esse caminho.

<h2 id="use-review-md-for-review-only-rules">
  Use o REVIEW\.md para regras exclusivas de revisão
</h2>

O `REVIEW.md` é um arquivo na raiz do seu repositório que adapta o Code Review ao seu repositório. Você também pode adicionar um `REVIEW.md` em um subdiretório para adicionar verificações para alterações sob esse caminho, além do arquivo raiz.

Os agentes que encontram problemas e os agentes que os verificam recebem seu conteúdo como as instruções de revisão do seu repositório, junto com as orientações de revisão padrão do Code Review. A etapa que escreve a revisão final o consulta antes de definir a severidade e escrever o resumo.

Este layout de exemplo tem um arquivo raiz e um arquivo de subdiretório:

```text theme={null}
your-repo/
├── REVIEW.md            # Root file
├── services/
│   └── billing/
│       └── REVIEW.md    # Adds checks for changes under services/billing/
└── src/
```

Antes de depender de um arquivo de subdiretório, proteja seu branch padrão e verifique [o que uma revisão lê para a configuração dos seus branches](#what-a-review-reads-for-each-branch-setup).

<Note>
  O serviço Code Review e o [comando `/code-review`](/docs/pt/code-review-local) local são duas ferramentas separadas, e elas leem arquivos diferentes. O serviço lê tanto o `CLAUDE.md` quanto o `REVIEW.md`. O comando `/code-review`, que você executa dentro de uma sessão do Claude Code na sua própria máquina, lê seus arquivos `CLAUDE.md` e não o `REVIEW.md`. Coloque as orientações que você quer aplicadas nos dois lugares no `CLAUDE.md`, e reserve o `REVIEW.md` para regras específicas da revisão de pull requests.
</Note>

<h3 id="example-review-md">
  Exemplo de REVIEW\.md
</h3>

Este `REVIEW.md` recalibra a severidade para um serviço de backend, limita os nits, ignora arquivos gerados e adiciona verificações específicas do repositório.

```markdown theme={null}
# Review instructions

## What Important means here

Reserve Important for findings that would break behavior, leak data,
or block a rollback: incorrect logic, unscoped database queries, PII
in logs or error messages, and migrations that aren't backward
compatible. 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
- Test-only code that intentionally violates production rules

## Always check

- New API routes have an integration test
- Log lines don't include email addresses, user IDs, or request bodies
- Database queries are scoped to the caller's tenant
```

<h3 id="choose-what-to-write-in-review-md">
  Escolha o que escrever no REVIEW\.md
</h3>

O `REVIEW.md` é Markdown de formato livre que altera o que uma revisão encontra e relata. Ele não altera o formato da revisão. Encontre o problema que você está observando e adicione uma instrução como a mostrada. O [exemplo](#example-review-md) usa as quatro primeiras.

* **As coisas erradas são marcadas como Important**: redefina o que 🔴 Important significa para o seu repositório. A calibração padrão tem como alvo código de produção, e um repositório de documentação, um repositório de configuração ou um protótipo pode querer uma definição muito mais restrita. Declare quais classes de descoberta são Important e quais são no máximo Nit. Você também pode escalar, por exemplo, tratando qualquer violação do `CLAUDE.md` como Important.
* **Nits demais**: limite quantos comentários 🟡 Nit uma única revisão publica. Um limite como "relate no máximo cinco nits" mantém as revisões acionáveis.
* **Comentários em arquivos gerados ou no que o CI já verifica**: liste caminhos e categorias de descoberta em que o Claude deve ignorar descobertas. Candidatos comuns são código gerado, lockfiles e dependências vendorizadas, junto com qualquer coisa que seu CI já impõe, como linting ou verificação ortográfica. Para caminhos que merecem alguma revisão, mas não um escrutínio completo, defina um padrão mais alto: "em `scripts/`, relate apenas se for quase certo e grave."
* **Uma regra da equipe não está sendo verificada**: adicione regras que você quer sinalizadas em todo pull request, como "novas rotas de API devem ter um teste de integração."
* **Descobertas que acabam se revelando erradas**: exija evidências antes que uma classe de descoberta seja publicada. Por exemplo, "afirmações sobre comportamento precisam de uma citação `file:line` no código-fonte, não de uma inferência a partir de nomes" reduz falsos positivos que, de outra forma, custariam ao autor uma ida e volta.

Algumas dessas instruções [precisam do arquivo raiz em um branch padrão protegido](#which-branch-review-md-is-read-from).

Mantenha no `REVIEW.md` apenas instruções que alteram o comportamento da revisão, e deixe o contexto geral do projeto no `CLAUDE.md`.

<h3 id="which-branch-review-md-is-read-from">
  De qual branch o REVIEW\.md é lido
</h3>

O Code Review lê o `REVIEW.md` do branch base do pull request ou do branch padrão, nunca das próprias alterações do pull request. Para alterar o comportamento da revisão, faça primeiro o merge da alteração no `REVIEW.md`.

Mantenha o `REVIEW.md` no seu branch padrão e proteja esse branch. Quando uma revisão lê a cópia em um branch padrão protegido, a primeira linha da tabela abaixo, ela respeita estas instruções do arquivo raiz:

* Reduzir a severidade de uma descoberta
* Excluir caminhos, arquivos ou classes de problema
* Limitar comentários de nit

<h4 id="what-counts-as-branch-protection">
  O que conta como proteção de branch
</h4>

O Code Review considera estas configurações como proteção:

* **Branch padrão**: uma regra clássica de proteção de branch ou um ruleset
* **Qualquer outro branch**: apenas um ruleset

Um ruleset conta quando restringe atualizações ou exige pull requests com pelo menos uma aprovação. Se ele exigir pull requests, também deve descartar essa aprovação em um novo push ou exigir que a aprovação venha após o último push.

<h4 id="what-a-review-reads-for-each-branch-setup">
  O que uma revisão lê para cada configuração de branch
</h4>

Encontre a situação do seu repositório na primeira coluna da tabela abaixo.

| Proteção de branch | Cópia lida | Arquivos lidos |
| :- | :- | :- |
| O branch padrão está protegido, e o pull request tem como alvo ele ou um branch que nenhum ruleset protege | Branch padrão | Arquivos raiz e de subdiretório |
| O pull request tem como alvo outro branch que um ruleset protege | Esse branch base | Arquivos raiz e de subdiretório |
| O branch padrão não está protegido, e o branch base não tem regra de proteção de nenhum tipo | Branch padrão | Arquivo raiz |
| O Code Review não consegue confirmar as configurações de proteção. Isso inclui um branch padrão desprotegido com um branch base que tem apenas uma regra clássica | Nenhuma | Nenhum |

Se a check run mencionar o `REVIEW.md`, consulte [A check run menciona o REVIEW.md](/docs/pt/code-review-troubleshooting#the-check-run-mentions-review-md).

<h2 id="related-resources">
  Recursos relacionados
</h2>

* [Code Review](/docs/pt/code-review): o que é o serviço e como uma revisão é executada
* [Ler e solicitar revisões em um pull request](/docs/pt/code-review-pull-requests#severity-levels): o que cada nível de severidade significa e como as descobertas aparecem
* [Configurar o Code Review](/docs/pt/code-review-setup): o nível de revisão e quando as revisões são executadas, definidos por um Owner
* [Revisar localmente com `/code-review`](/docs/pt/code-review-local): o comando `/code-review`, seus argumentos e níveis de esforço
* [Memória](/docs/pt/memory): como os arquivos `CLAUDE.md` funcionam em todo o Claude Code