Princípios a seguir ao corrigir código legado com agentes de IA de codificação
makedreamApril 25, 2026
0
Computing/Software
Comments (0)
Log in to leave a comment
No posts yet
makedreammakedreamLog in to leave a comment
No posts yet
Deixar que um agente circule livremente pelo seu computador é perigoso. Especialmente se você deixar chaves de API expostas em variáveis de ambiente, existe o risco de o agente imprimir acidentalmente as chaves nos logs ou enviá-las para fora. Utilize o 1Password CLI. É uma abordagem em que as chaves são carregadas na memória apenas temporariamente ao executar um comando.
Para evitar que o agente toque acidentalmente em arquivos essenciais, você deve isolar o sistema de arquivos. Crie um arquivo .cursorignore e remova da lista chaves SSH, artefatos de build e arquivos de configuração sensíveis. Simplesmente colocar esse arquivo na raiz do projeto reduz em 80% a chance de o agente modificar arquivos errados. Se possível, execute o agente dentro de um contêiner Docker. Essa é a maneira mais segura de impedir que o agente toque diretamente no sistema host.
Fazer com que o agente leia todo o projeto tornará os custos de API mensais insustentáveis. Especialmente deixar o agente ler pastas como node_modules ou .git é jogar dinheiro fora.
Envie apenas o código necessário para o agente. À medida que o tamanho do projeto aumenta, restringir o escopo de indexação torna-se essencial. Se estiver usando o Aider, verifique em tempo real quanto você está gastando com o comando /tokens. Arquivos que já foram processados devem ser removidos imediatamente do contexto com o comando /drop. Apenas com isso, é possível reduzir o consumo desnecessário de tokens em mais de 70%. Se você escolher um modelo que suporte o cache de contexto da Anthropic, poderá obter um desconto adicional de cerca de 75% para estruturas de código repetitivas, portanto, verifique sua fatura da API e mude o modelo.
O código legado tem dependências complexas, portanto, se você confiar cegamente no agente, o sistema inteiro será arruinado. Não peça para ele escrever código sem critério. Você precisa fornecer o contexto ao agente usando tags XML. Escreva claramente quais funções serão corrigidas e quais regras devem ser seguidas.
Não faça merge do código imediatamente. Primeiro, force o agente a apresentar um plano de modificação. Esse é um método em que o desenvolvedor deve aprovar o plano antes que ele escreva o código. O código modificado pelo agente deve ser testado em um ambiente de teste local. Se você enviar os logs de falha da CI diretamente de volta para o agente, ele corrigirá o erro por conta própria. Estudos mostram que, ao seguir esse processo, é possível corrigir erros com 84% de probabilidade sem intervenção adicional.
Se você quer verificar o quanto ficou mais rápido após introduzir o agente, esqueça a velocidade de escrita de código. O tempo de ciclo (cycle time) é a chave. Você deve medir o tempo total desde a escrita do código, revisão, correção até o deploy.
Primeiro, registre quantos dias levam desde o primeiro commit do projeto atual até o deploy real. Os erros cometidos repetidamente pelo agente devem ser compilados no arquivo AGENTS.md e mantidos como convenções de codificação. Se um módulo específico apresenta baixa qualidade de código gerado pela IA, o problema não é a IA, mas a estrutura do sistema. Verifique a taxa de retrabalho por PR semanalmente. Ferramentas são apenas ferramentas. Tratar o agente como um colega e ajustar a infraestrutura ao fluxo de trabalho da equipe é o que determina a competitividade da equipe de desenvolvimento.