Revisor de Pull Requests com IA, Re-Review e Auditoria

O problema

Review de código de verdade é a diferença entre um engenheiro sênior e uma fábrica de features. Mas em time pequeno, reviews se acumulam: ninguém quer ser o gargalo, a fila cresce e PRs acabam mergeados com um emoji de joinha e zero feedback.

A pergunta interessante: um revisor de IA pode ser útil o suficiente para realmente pegar coisas, barato o suficiente para rodar em todo push e honesto o suficiente para saber quando escalar pra humano?

A abordagem

Um revisor que vive no bot de operações, não no CI:

Trigger por push — quando o `head_sha` da PR muda, o revisor acorda. Se o SHA novo bate com o último revisado, pula silencioso. Sem gasto duplo.

Router cost-managed — Claude Code CLI é o default (assinatura de custo fixo). O caminho via API da Anthropic é opt-in para casos de baixa latência e capado por orçamento diário hard em USD. Quando o orçamento zera, o revisor fila para o dia seguinte em vez de falhar ou gastar a mais em silêncio.

Classificador de severidade — toda finding é rated (block / nit / info). Só blocks geram review comments inline; nits viram um sumário único. A PR não afoga.

Re-review em novos commits — quando o dev faz push de novo, o revisor olha só o diff desde a última review, não a PR inteira. Rápido, barato e mantém contexto.

Auditoria + auto-resolve — quando uma PR é mergeada ou sofre rebase, o revisor revisita os próprios comentários. Comentários endereçados são resolvidos automaticamente; comentários dispensados são marcados como dismiss no log de auditoria.

Escalação humana — se o revisor está genuinamente em dúvida (segurança, migração de schema, operação irreversível), pinga o humano no Telegram com as linhas relevantes e espera.

O resultado

O revisor roda em todo push em toda PR no projeto inteiro. Falsos positivos são raros o suficiente para ser tolerável; falsos negativos pegam no segundo push. Gasto diário com Claude fica dentro do orçamento, cada centavo contabilizado.

Uma versão produtizada, standalone e fora do bot, torna o mesmo motor disponível como serviço para outros operadores.

Por que isso importa

A maioria das ferramentas de "AI code review" ou é barulhenta demais para levar a sério, ou cara demais para rodar em todo push. As restrições de design interessantes são: disciplina de custo, idempotência por push, gating de severidade e respeito ao humano como camada final de escalação. Resolve isso e você tem um revisor que o time efetivamente quer lendo o código deles.