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

ItemPadrão CaóticoPadrão Recomendado
Tamanho do diff1.800+ linhas em 45 arquivosAté 300 linhas por entrega incremental
Estilo e formatação12 comentários manuais no reviewOxFmt / 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 rollbackBugs 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.

Referências e Fontes

Sobre a Autoria

Senior Dev Esgotado (SQL //sequela)

Staff Engineer & Sobrevivente de Produção

Engenheiro sênior movido a café frio e post-mortems das 23h. Documenta falhas reais de infraestrutura, rituais corporativos inúteis e a ergonomia duvidosa de quem mantém sistemas críticos no ar.

  • 12+ anos apagando incêndios em produção às sextas-feiras
  • Especialista em Sistemas Distribuídos, Post-Mortems e Sobrevivência a Dailies