Code review
Em quase toda empresa, code review é rotina diária. É onde o conhecimento circula, onde o bug é pego mais barato e onde o seu jeito de trabalhar em equipe fica mais visível. Tenho skills de revisão automatizada para agentes de IA em My Skills; o roteiro abaixo é o mesmo que uso como revisor humano.
Como revisar
A ordem em que olho
- Entendi o objetivo? Se a descrição não diz, pergunte antes de ler código.
- A solução faz sentido? Abordagem errada se aponta antes de comentar nome de variável.
- Correção: casos de borda, nulos, concorrência, transação, retry, idempotência.
- Segurança: autorização por objeto, dado sensível em log, entrada sem validação. Ver Segurança.
- Testes: cobrem o comportamento novo? Quebrariam se o código estivesse errado?
- Legibilidade: nomes, tamanho das funções, código morto.
- Estilo: o que o formatador e o analisador não pegam. Se pegam, não comente.
Como escrever o comentário
- Pergunte em vez de afirmar quando não tem certeza: “o que acontece aqui se o pedido vier sem itens?”
- Explique o porquê: “prefiro
AsNoTrackingaqui porque é só leitura e a lista pode ter milhares de itens” ensina; “use AsNoTracking” só manda. - Diga o peso do comentário: bloqueante, sugestão ou detalhe. Muitos times usam prefixos como
nit:para o que não bloqueia. - Elogie o que está bom. Não por educação: para o autor saber o que repetir.
- Sobre o código, nunca sobre a pessoa. “Este método está difícil de seguir”, não “você escreveu confuso”.
O que não fazer
- Aprovar sem ler porque o PR é grande. Peça para dividir.
- Segurar o PR por gosto pessoal. Se não é bug, não é risco e não fere o padrão do time, é sugestão.
- Reescrever a solução do outro nos comentários. Se a abordagem toda está errada, converse por chamada.
- Deixar o PR esperando dias. Revisão rápida é parte do trabalho, não interrupção dele.
Como receber revisão
- PR pequeno e com boa descrição recebe revisão melhor e mais rápida. Ver Comunicação escrita.
- Revise o próprio PR antes de pedir revisão: metade dos comentários some.
- Comentário no código não é ataque. Responda a todos, mesmo que seja “feito” ou “prefiro manter porque X”.
- Discordou? Explique uma vez com argumento. Persistiu o impasse, decida por chamada ou com uma terceira pessoa; trinta comentários na mesma thread não convencem ninguém.
Automatize o que é mecânico
Formatação, estilo e regras simples não deveriam consumir atenção humana:
dotnet formatno pipeline..editorconfigcom as regras do time e analisadores (<AnalysisLevel>latest-recommended</AnalysisLevel>).<TreatWarningsAsErrors>true</TreatWarningsAsErrors>para o aviso não virar ruído ignorado.- Revisão por agente de IA como primeira passada, com um humano decidindo.
O que perguntam em entrevista
- O que você olha primeiro num code review.
- Como você dá um comentário sobre um problema sério sem desanimar o autor.
- Conte de uma vez em que discordou de um comentário recebido.
- Como você lida com um PR de 3.000 linhas.