Review humano do PR gerado por agente é o limite de autonomia no chão de fábrica: o modelo sugere, a pessoa lê, o merge tem nome. Sem explicação do diff, o pull request é um pacote opaco. Agente no desenvolvimento de software acelera rascunho; não assina produção.

O anti-padrão é “lgtm” em patch de trezentas linhas geradas. O outro é recusar todo PR de agente por preconceito e empurrar o uso para o privado, sem pipeline. O meio é o mesmo review de colega, com atenção extra em contrato, teste e segredo.

O que o autor precisa trazer

  • resumo do que o agente fez versus o que o humano mudou;
  • testes que provam o comportamento — não só “compilei”;
  • nota se o prompt usou dado interno (e por que era permitido);
  • tamanho: PR pequeno. Agente adora patch enorme; o time recusa.

IA e agentes no desenvolvimento descreve o panorama. Este texto é o rito do merge. Limite de autonomia: o agente para aqui define o teto; o review é a fiscalização.

Custo de token também aparece: iterar no privado até o patch “ficar bonito” pode sair caro e ainda assim chegar podre. Custo de token no produto é o recorte de teto; no PR o teto é de atenção humana.

O que o revisor recusa de imediato

  • alteração de autorização ou de criptografia sem discussão prévia;
  • dependência nova sem pin;
  • migração de dado irreversível;
  • arquivo de secret;
  • “refatoração” fora do ticket.

Dois pares no mesmo laptop — como na capa — não é teatro: é o modo mais barato de calibrar o time na primeira semana de agente. Depois, async com o mesmo checklist.

Não afirmamos que review pega 100% dos defeitos. Afirmamos que merge sem leitura é processo inexistente. Prova antes da promessa.

Política de uma página no repo

  1. label de origem (agente / misto / humano);
  2. máximo de linhas ou de arquivos — acima disso, split;
  3. CI obrigatória (teste, secret scan);
  4. merge só com aprovação de quem não escreveu o prompt sozinho no mesmo papel de autor-revisor único, salvo acordo explícito em time de uma pessoa (e mesmo aí o checklist vale).

Time de uma pessoa ainda precisa do checklist. Autonomia de agente em repo solo é o incidente mais silencioso.

Como a Tech Coders faz review na fábrica

Na fábrica de software, PR de agente passa no sprint de 15 dias com o mesmo DoD: teste, review, pipeline. Não há merge automático de modelo. Sustentação 24×7 herda o histórico de quem mergeou. Resgate de projeto costuma achar exatamente o contrário: patch gerado na main.

Perguntas frequentes

Posso autoaprovar PR do meu agente?

Só se o time aceitou explicitamente o risco e o repo é de baixa criticidade. Em produto com usuário, não. O nome no merge é o controle.

Ferramenta de review de IA substitui o humano?

Substitui parte da nata de estilo. Não substitui entendimento de negócio nem recusa de autorização. Use como linter, não como aprovador.

Label de agente constrange?

Transparência constrange menos que incidente. Time maduro quer a label.

Quanto tempo a mais o review leva?

No começo, mais. Com PR pequeno e checklist, o extra cai. Patch enorme gerado “para ganhar tempo” é o que mais consome revisor — recuse o tamanho.