Revisão de código por IA: mais contexto, menos bugs
A revisão de código costuma ser lenta e inconsistente: os diffs ficam em filas, e o feedback depende de quem está online.
A revisão de código por IA só ajuda quando o revisor tem contexto real da base de código.
A revisão de código por IA funciona melhor quando o revisor já tem acesso ao repositório completo, às mudanças recentes, aos testes e a um conjunto claro de regras. Com esse contexto, ela identifica problemas que um bot independente, analisando um único diff, jamais veria. A revisão é mais útil quando faz parte do mesmo sistema que gerou a mudança.
O que mudou na revisão de código
Agentes de programação não inventaram PRs longos, mas fizeram a lógica antiga da revisão deixar de funcionar mais rápido.
Desenvolvedores que trabalham com agentes de programação estão entregando mudanças maiores. Dados de milhões de sessões do Cursor mostram que as linhas adicionadas por PR (p75) aumentaram cerca de 2,5x na comparação anual. Mega PRs de mais de 1.000 linhas alteradas representam uma parcela crescente dos merges, com um salto claro em janeiro de 2026, à medida que agentes e modelos melhoraram. As sessões de agente também ficaram mais profundas: a média de chamadas a ferramentas por sessão subiu cerca de 30% em uma janela recente de dois meses. Mais código escrito por IA continua presente. As linhas de IA aceitas que ainda estavam presentes após 60 minutos subiram de aproximadamente 76% para 81% desde o início de 2026. As mudanças geradas por agente que chegam a commits sem uma etapa separada de aceitação manual do diff cresceram mais de 5x nesse período.
A capacidade de revisão humana não acompanhou nada disso. Há muito tempo, as orientações clássicas de revisão por pares tratam algumas centenas de linhas de leitura cuidadosa como a faixa em que a qualidade se mantém.
Revisão de código por IA é assim que você mantém um gate de qualidade quando o volume de mudanças supera o número de engenheiros sêniores que conseguem ler cada diff.
Mais do código em revisão foi escrito com assistência de IA. Humanos são bons em identificar "isso não corresponde à forma como construímos aqui". Eles são piores em analisar um patch grande, plausível e em grande parte correto de um agente para encontrar uma única falha sutil, e é aí que um revisor com contexto real do repositório ajuda. Escrever uma mudança grande e verificá-la são habilidades diferentes, e a revisão é essa verificação.
Perguntas antes de iniciar a revisão de código por IA
Se você está avaliando ferramentas de revisão de código por IA, analise estes conceitos primeiro.
O que é revisão de código por IA?
Revisão de código por IA é um tipo de software que lê uma alteração (geralmente uma PR, às vezes um diff local) e aponta bugs, regressões e riscos antes do merge. As versões realmente úteis analisam mais do que só as linhas alteradas. Elas consideram arquivos relacionados, testes, configurações e regras da equipe. As versões mais fracas apenas reescrevem o diff em texto corrido ou pegam no pé de comentários e nomes.
Em que isso é diferente de linting ou CI?
Linters e verificadores de tipo codificam regras que você já sabe escrever. O CI executa as verificações que você automatizou. A revisão por IA serve para o restante: erros de lógica, condições de corrida, falhas de autenticação, quebras algumas pastas adiante, documentação e comportamento desalinhados. Ela se sobrepõe ao CI. Não o substitui.
A revisão de código por IA substitui a revisão humana?
Não. Ela muda como os humanos gastam seu tempo. Apenas cerca de metade dos comentários de revisão feitos por humanos acaba levando a alguma alteração no mesmo PR. Culturas saudáveis de revisão incluem observações para corrigir depois e contexto informativo. Você quer eliminar bugs de alta confiança, passíveis de tratamento por máquina, para que as pessoas possam se concentrar em arquitetura, risco de produto e conhecimento tácito que o modelo ainda não tem.
O que torna a revisão por IA cheia de ruído?
O ruído vem de comentários que as pessoas não querem receber de um bot. Cobranças de estilo, observações vagas de "adicione testes" sem nenhum teste falhando e sugestões de reescrita que não identificam um bug fazem as pessoas ignorarem a revisão. Separe o que o modelo consegue identificar do que as pessoas realmente querem que ele sinalize. A revisão de código por IA deve sinalizar bugs reais, commits acidentais, problemas de performance e segurança, e pontos em que a documentação e o código divergem. Quando a Graphite restringiu suas revisões por IA a essa interseção, cerca de 52% dos comentários levaram a uma alteração no código (aproximadamente a mesma taxa dos revisores humanos), com votos negativos abaixo de 4%.
O que devemos medir?
Taxa de resolução: no momento do merge, o problema sinalizado foi realmente corrigido no código final? A taxa de resolução é mais importante que o volume de comentários.
Essa também é a métrica que usamos para melhorar o Bugbot: a taxa de resolução passou de 52% para mais de 70% em 40 experimentos, os bugs sinalizados por execução passaram de 0,4 para 0,7, e os bugs resolvidos por PR foram de aproximadamente 0,2 para cerca de 0,5, em mais de dois milhões de PRs revisados por mês. Em maio de 2026, a taxa de resolução no esforço padrão havia chegado a cerca de 80% dos bugs resolvidos até o momento do merge. Se sua taxa de resolução cair enquanto o volume de comentários sobe, o bot está gerando ruído.
O dashboard do Bugbot mostra em gráficos a taxa de resolução ao longo do tempo para cada repositório, juntamente com o volume de problemas encontrados e corrigidos, para que você possa ver se as revisões estão identificando problemas reais e se eles estão sendo corrigidos antes de ampliar o escopo dos comentários do bot.
Quando a revisão deve ser executada: localmente, no PR ou em ambos?
Em ambos, com funções diferentes. A revisão local (depois de uma tarefa do agente, antes do push) identifica problemas enquanto o contexto ainda está fresco e a thread ainda nem existe. A revisão de PR é o contrato da equipe: regras compartilhadas, histórico compartilhado e um gate compartilhado para merge. Verificações com foco em segurança podem rodar de um lado ou de outro, dependendo de como você entrega.
A ferramenta de revisão precisa estar no mesmo produto que o agente?
Você pode comprar uma ferramenta de revisão independente. Muitas equipes fazem isso. O custo é a troca de contexto e uma visão mais limitada de como o código foi produzido. Quando a revisão é executada no mesmo sistema que escreveu a alteração, ela já conhece os arquivos abertos, o mapa do repositório e as regras que você mantém ao lado do código. As correções podem incluir links diretos de volta para o editor ou iniciar um agente com o problema já carregado. Esse ciclo é difícil de reproduzir com uma solução adicionada à parte.
Como executar revisão de código por IA no Cursor
O fluxo do Cursor é: revisão local no editor, Bugbot na PR e, em seguida, um ciclo de correção que leva você de volta ao mesmo conjunto de ferramentas.
Local. Após o trabalho do agente, execute a Revisão do Agente. Você pode digitar /agent-review na entrada do agente, executá-la pela aba Controle de Código-Fonte para comparar as alterações locais com sua branch principal ou ativar revisões automáticas após cada commit. Antes de fazer push, você também pode executar localmente o Bugbot ou um Agente de Segurança usando as habilidades /review-bugbot e /review-security. É aqui que você resolve problemas óbvios enquanto a sessão ainda tem contexto.
Na PR. O Bugbot revisa PRs no GitHub, GitLab e Bitbucket. Defina as invariantes da equipe em .cursor/BUGBOT.md, além das regras da equipe e do repositório. As regras aprendidas (@cursor remember) incorporam feedback às execuções futuras. Acompanhe a taxa de resolução nas Automações do Bugbot antes de ampliar as categorias de comentários.
Ciclo de correção. Os problemas apontados aparecem na PR com links de volta para o Cursor (Corrigir no Cursor e Corrigir na Web). O Bugbot Autofix pode iniciar um Agente na nuvem para propor correções. Para segurança, os Agentes de Segurança do Cursor cobrem as duas funções: o Revisor de Segurança verifica PRs antes do merge, e o Scanner de vulnerabilidade analisa a base de código em repouso.
Comece. A documentação aborda toda a configuração: conectar seu repositório, escolher quais repositórios e pessoas acionam revisões, definir o nível de esforço e configurar .cursor/BUGBOT.md. Acompanhe em cursor.com/docs/bugbot.
Automatize o encaminhamento e a aprovação
Encontrar bugs não é todo o trabalho de revisão. Duas automações do Cursor cuidam das partes operacionais.
Aprove automaticamente alterações de baixo risco. Os Agentes de Aprovação avaliam o risco de cada PR e aprovam as que atendem ao critério definido por você. Um ajuste de texto ou uma atualização de configuração pode ser mesclado sem esperar por uma pessoa. Tudo que ultrapassa seu limite de risco fica retido. Os problemas apontados do Bugbot e do Agente de Segurança embasam essa decisão, para que uma alteração arriscada não seja aprovada sem análise.
Encaminhe para os revisores certos. Quando uma PR precisa de uma pessoa, os Agentes de Aprovação atribuem revisores com base na parte da base de código que ela afeta, usando políticas de encaminhamento por área definidas por você. A alteração vai para a equipe responsável por aquele código, em vez de uma fila compartilhada.
Mantenha a revisão perto do código
A revisão de código por IA é como as equipes mantêm um gate de qualidade enquanto os agentes aumentam o volume e a velocidade das mudanças. As versões que funcionam têm contexto do repositório, uma política de comentários restritiva e uma métrica que acompanha se os problemas apontados são corrigidos.
A revisão deve acontecer perto de onde o código foi produzido, com as mesmas regras e o mesmo fluxo de correção. Ative o Bugbot em um repositório movimentado, acompanhe a resolução em Automações do Bugbot por uma semana e só então decida quais categorias merecem mais volume.