Jota Oliveira
Voltar ao blog

Automação

Agentes de código: defina o que precisa ser revisado

Duas mãos de papel passam uma pequena montagem modular teal sobre uma base amarela de inspeção, com uma peça coral separada ao lado.

Antes de delegar uma alteração a um agente de código, combine o comportamento esperado, os limites da mudança e a evidência que permitirá conferir a entrega. Esse acordo ajuda a transformar uma proposta pronta em algo que outra pessoa consegue revisar e assumir.

O Octoverse 2026, publicado pelo GitHub em 28 de outubro, informa que mais de 40% dos pull requests de setembro começaram com um rascunho de agente, ante 17% em março. Pull request é a proposta de alteração enviada para análise antes de entrar no projeto. O relatório considera os agentes que consegue detectar; a ausência desse sinal não prova ausência de IA.

Esses números mostram adoção na plataforma. Eles não demonstram que cada alteração funciona, nem estabelecem uma medida de qualidade para a sua equipe. Minha leitura prática é que vale preparar a revisão já no pedido, quando ainda é possível limitar o trabalho.

Combine uma entrega que alguém consiga conferir

Considere um exemplo fictício: uma ferramenta interna precisa impedir o cadastro de uma solicitação sem responsável. Em vez de pedir apenas “corrija o formulário”, descreva o resultado: o cadastro deve ser recusado sem esse campo e continuar funcionando quando ele estiver preenchido.

Delimite também o que pode mudar. A validação da solicitação participa da tarefa; uma reformulação geral do cadastro exige outra decisão. Se o agente encontrar uma dependência que amplia o escopo, peça que explique o problema antes de continuar. Isso evita misturar uma correção necessária com alterações difíceis de avaliar juntas.

Na entrega, peça uma explicação curta do caminho alterado e o registro das verificações executadas. O revisor deve conseguir reproduzir os dois casos, conferir se a regra também vale fora da tela e identificar qualquer teste que não pôde ser realizado. Um resultado ausente precisa aparecer como pendência.

Defina quem decide se a mudança entra no projeto. Para uma equipe pequena, pode ser a pessoa responsável pelo fluxo de solicitações, com apoio de quem conhece o código. A explicação do agente pode orientar essa análise, mas a conferência precisa usar o comportamento observado.

Esse exercício é uma proposta editorial, sem resultado de produtividade medido. Ele complementa definir a entrega antes de automatizar e medir a fila de integração.

Na próxima tarefa, escreva o comportamento esperado, o limite da mudança e quem vai conferir o resultado. Use esse pequeno acordo para decidir se a entrega está pronta ou se ainda precisa de trabalho.

Fonte: GitHub, Octoverse 2026, publicado em 28/10/2026 e consultado em 30/10/2026.

Continue a leitura

Documento de papel com um espaço quadrado vazio repousa em um suporte de teste amarelo, ao lado da peça teal que falta e de documentos completos.

Agentes de IA: teste dados incompletos antes de automatizar

Ao testar agentes de IA, inclua pedidos com dados incompletos e confira se a automação pede a informação que falta antes de agir.

Ler artigo
Lupa teal examina a última mensagem de uma correspondência de papel, ligada por um fio coral a uma etiqueta amarela de tarefa.

AI Inbox do Gmail: confira a conversa antes de assumir o prazo

O AI Inbox do Gmail sugere tarefas e destaca prazos em e-mails; conferir a conversa original ajuda a separar uma sugestão de um compromisso confirmado.

Ler artigo