Freebuff na prática: ler código escrito por um agente antes de o integrar

Uma suite de testes verde não é uma revisão

Os testes verificam os casos em que alguém pensou. Um agente que muda comportamento pode deixar todos os testes verdes, porque apenas verificavam o comportamento antigo de forma vaga ou porque nada cobria aquele caminho. Verde prova que a alteração corre, não que está correta.

O mesmo vale para um resumo arrumado: a descrição do que o agente fez é uma afirmação do mesmo sistema que fez a alteração. Leia o diff, não a nota de capa, e trate os testes como um sinal entre vários.

Comece num estado limpo e reversível

Antes do primeiro prompt: faça commit ou guarde o trabalho, crie um ramo e saiba exatamente como voltar. Um agente com acesso ao terminal pode correr migrações, reescrever configuração e apagar ficheiros; um ponto de partida reversível transforma um acidente num incómodo.

Se a tarefa tocar em algo regulado ou confidencial, use uma cópia descartável do projeto e uma conversa sem segredos. Os termos e a documentação de dados do fornecedor decidem o que sai do seu equipamento: leia-os em vez de assumir a fronteira.

Leia o diff pela ordem em que dói

Uma alteração gerada e grande revê-se melhor numa ordem deliberada do que de cima para baixo.

• Pontos de entrada: rotas, handlers, permissões e tudo o que muda quem chega a quê.
• Dados: esquema, migrações, serialização e consultas, sobretudo o que apaga ou reescreve.
• Configuração: variáveis de ambiente, passos de build, CI e definições de deployment.
• O resto: nomes, estrutura, duplicação e os retoques cosméticos que fazem o diff parecer maior.

Depois leia os testes acrescentados e pergunte o que não cobrem. Um agente que escreveu código e teste pode gravar o mesmo mal-entendido duas vezes.

Dependências, segredos e as linhas que ninguém lê

As dependências novas são o risco mais silencioso de um patch gerado: um nome de pacote familiar, uma versão vinda do nada, um lockfile reescrito de ponta a ponta. Verifique o que foi acrescentado, porquê, e se o projeto já tinha algo que servisse.

Procure credenciais, tokens e URL internos que não deviam estar num commit, e confirme que o logging não imprime agora dados de clientes. São as linhas que se passam à frente — e exatamente aquelas em que um agente não tem razão para ser cuidadoso: otimiza para o pedido, não para o seu modelo de ameaça.

Quando deitar fora

Se o diff for maior do que a tarefa, se não conseguir explicar um bloco sem adivinhar, ou se a alteração resolver o sintoma em vez da causa, apague o ramo. Recomeçar com um pedido mais estreito custa menos do que manter código que ninguém entende.

A mesma regra vale para o seu prompt: a lista de revisão do nosso guia do Manus e os conselhos de estrutura do nosso guia do Prompt Cowboy encurtam ambos o diff. Para o produto, comece pela nossa visão geral do Freebuff, e a forma como tratamos as ligações de recomendação está na nossa declaração de afiliação.