# Boas práticas de Pull Request e Code Review: por que PR de 1.800 linhas recebe "LGTM" em 30 segundos (e quebra depois)

- **Marca:** SeQueLa (https://reserva.ink/usesequela)
- **URL Canônica:** https://blog.usesequela.com.br/post/boas-praticas-pull-request-code-review/
- **Categoria:** Engenharia de Software
- **Palavra-chave alvo:** boas praticas pull request code review
- **Autor:** Senior Dev Esgotado (SQL //sequela) (Staff Engineer & Sobrevivente de Produção)
- **Publicado em:** 2026-11-22 | **Atualizado em:** 2026-11-22

## Resposta Direta

A regra prática do Code Review é simples: um Pull Request de 15 linhas recebe dez comentários sobre nome de variável; um PR de 1.800 linhas recebe "LGTM" sem leitura e derruba produção na sexta. Para revisões que realmente pegam bugs, mantenha diffs abaixo de 300–400 linhas, terceirize estilo para linter no CI e foque a revisão humana apenas em lógica de negócio, concorrência, segurança e impacto no banco.

## Pontos-Chave

- A atenção do revisor cai verticalmente após 300 linhas alteradas; dividir entregas grandes em PRs incrementais reduz bugs escapados.
- Discussão de vírgula, aspas ou identação em PR humano é desperdício de salário: configure o formatador automático no CI.
- Diferencie claramente o que é bloqueador (bug, falha de segurança, lock de banco) de sugestão opcional usando prefixos objetivos como [nit].

## A Lei da Trivialidade de Parkinson no GitHub

Mande um PR de 1.800 linhas misturando refatoração cosmética de dez arquivos, uma migration e a regra nova de desconto: em três minutos alguém aprova com "LGTM" porque ninguém tem duas horas livres para ler tudo aquilo antes da daily.

Mande um PR limpo de 40 linhas e o time abre uma conferência filosófica de doze comentários discutindo se a função devia se chamar `getUser` ou `fetchUser`. Esse desequilíbrio é a razão de tantos bugs óbvios passarem ilesos até produção.

## 5 regras secas para Pull Requests que alguém realmente lê

Adote cinco combinados simples no time para parar de transformar revisão de código em guerra de ego ou carimbo cego:

- 1. Limite de tamanho (~300 linhas úteis): se a feature é grande, suba em etapas protegidas por feature flag ou PRs empilhados.
- 2. Nunca misture refactor cosmético com mudança de regra de negócio no mesmo diff.
- 3. Automação paga o pedágio chato: lint, tipagem e formatação rodam no CI antes mesmo de notificar o revisor humano.
- 4. Descrição explica o "porquê" e como testar, não repete o título do ticket do Jira.
- 5. Marque comentários não bloqueantes com [nit] para não travar um merge válido por preferência estética.

### Checklist de 5 minutos para o revisor

Olhe primeiro para fronteiras perigosas: validação de entrada de usuário, queries SQL sem índice ou transação, mudança de contrato de API/Redis e tratamento real de erro (sem engolir exceção silenciosamente).

## PR Tóxico / Inútil vs. Pull Request de Engenharia Madura

| Item | Padrão Caótico | Padrão Recomendado |
| --- | --- | --- |
| Tamanho do diff | 1.800+ linhas em 45 arquivos | Até 300 linhas por entrega incremental |
| Estilo e formatação | 12 comentários manuais no review | OxFmt / Prettier / ESLint bloqueando no CI |
| Tom dos comentários | "Por que você escreveu isso assim?" | "[bloqueador] Sem índice aqui vai dar seq scan na tabela X" |
| Resultado típico | "LGTM" cego seguido de rollback | Bugs estruturais capturados antes do merge |

## Perguntas Frequentes (FAQ)

### Como diminuir o tamanho do PR quando a tarefa envolve mudança grande de arquitetura?

Separe em pelo menos três entregas: primeiro o refactor preparatório ou criação de tabela/endpoint atrás de flag (sem impacto ativo), depois a lógica principal e por fim a remoção do código legado.

### Quanto tempo um PR deve esperar por revisão?

Em times saudáveis, a primeira revisão acontece em menos de 4 horas úteis. PR parado há quatro dias gera conflito de merge e força o autor a perder contexto para ajustar.

### O autor deve revisar o próprio código antes de pedir review aos colegas?

Sempre. Ler o próprio diff no GitHub antes de marcar revisores elimina metade dos erros bobos, imports sobrando e logs esquecidos.

## Leituras Relacionadas no Cluster

- [Migration sem downtime no PostgreSQL](https://blog.usesequela.com.br/post/migration-sem-downtime-postgresql/) — Um dos itens mais importantes para conferir em qualquer PR que toca banco de dados.
- [Debug de erro intermitente em produção](https://blog.usesequela.com.br/post/debug-erro-intermitente-producao/) — Veja quais erros de concorrência costumam passar batidos em PRs gigantes.

## Fontes e Referências

- [Google Engineering Practices — How to do a Code Review & Small CLs (Google Engineering Practices Documentation)](https://google.github.io/eng-practices/review/)

---

**Aprovou o PR de 1.800 linhas às 17h55? Já garante o uniforme do plantão.**
Para quem conhece de perto o significado de "LGTM" numa sexta-feira nublada.
[Acessar catálogo // usesequela](https://reserva.ink/usesequela?utm_source=blog&utm_medium=organic&utm_campaign=boas-praticas-pull-request-code-review&utm_content=markdown_cta)