template gratuito

PR review com agente de código

quando Claude Code, Codex ou outro agente precisa revisar um PR sem virar aprovador automático. Preencha com uma situação real, copie só os campos que servem e ignore o que ainda for grande demais para sua rotina.

Ver modelo na página Baixar arquivo simples Entender a decisão Ver série completa Orientar um agente

Antes de chamar o agente

Link do PR ou branch está claro.
Objetivo do PR está escrito em uma frase.
Linguagens, framework e comandos de teste estão disponíveis.
O agente deve revisar, não reescrever o PR inteiro.
Produção, deploy e merge estão bloqueados.

O que o agente deve procurar

Área	Pergunta
Segurança	existe segredo, SQL cru, permissão aberta, input sem validação?
Dados	migração, schema ou contrato mudou sem compatibilidade?
Testes	há teste para o comportamento novo e para o caso quebrado?
Escopo	o diff mexe em arquivo fora do objetivo?
UX/API	nomes, erros e estados vazios continuam claros?
Operação	logs, rollback e configuração estão pensados?

Formato de saída

Peça ao agente para responder assim:

1. Bloqueadores. 2. Problemas importantes. 3. Nits opcionais. 4. O que parece correto. 5. Comandos de verificação rodados ou que faltaram.

Não deixar o agente fazer

Não deixe o agente fazer merge, aprovar PR crítico sozinho, publicar release, editar segredo, empurrar commit sem diff revisado ou criar comentário agressivo em nome de alguém.

# Checklist de PR review com agente de código

## Antes de chamar o agente

- [ ] Link do PR ou branch está claro.
- [ ] Objetivo do PR está escrito em uma frase.
- [ ] Linguagens, framework e comandos de teste estão disponíveis.
- [ ] O agente deve revisar, não reescrever o PR inteiro.
- [ ] Produção, deploy e merge estão bloqueados.

## O que o agente deve procurar

| Área | Pergunta |
|---|---|
| Segurança | existe segredo, SQL cru, permissão aberta, input sem validação? |
| Dados | migração, schema ou contrato mudou sem compatibilidade? |
| Testes | há teste para o comportamento novo e para o caso quebrado? |
| Escopo | o diff mexe em arquivo fora do objetivo? |
| UX/API | nomes, erros e estados vazios continuam claros? |
| Operação | logs, rollback e configuração estão pensados? |

## Formato de saída

Peça ao agente para responder assim:

1. Bloqueadores.
2. Problemas importantes.
3. Nits opcionais.
4. O que parece correto.
5. Comandos de verificação rodados ou que faltaram.

## Não deixar o agente fazer

Não deixe o agente fazer merge, aprovar PR crítico sozinho, publicar release, editar segredo, empurrar commit sem diff revisado ou criar comentário agressivo em nome de alguém.