Ir para o conteúdo
Arara Code

Guias e comparativos

Depurar código com IA: como achar bugs mais rápido

Para depurar com IA, entregue ao agente uma reprodução mínima, a mensagem de erro completa e o comportamento esperado, e peça hipóteses que possam ser testadas uma a uma. O agente acelera a busca, mas a causa só está confirmada quando um teste ou um log a comprova.

Arara Code

Publicado pelo projeto Arara Code com base na documentação oficial citada.

Comece pela reprodução e pelo contexto certo

Depuração é o processo de encontrar e corrigir a causa de um defeito. O agente trabalha melhor com os passos que reproduzem o erro, a versão das dependências e o stack trace completo, sem cortes.

Informe o resultado esperado e o obtido. "Não funciona" obriga o modelo a adivinhar; "retorna 500 ao enviar o formulário com o campo vazio" aponta para a validação.

Wikipedia: Debugging

Peça hipóteses, não correções imediatas

Peça duas ou três hipóteses ordenadas por probabilidade, cada uma com um jeito de verificar: um log, um breakpoint ou um teste que falha. Isso evita correções que apenas escondem o sintoma.

A técnica do rubber duck debugging, explicar o problema em voz alta, funciona com o agente, porque escrever o raciocínio expõe suposições erradas.

Wikipedia: Rubber duck debugging

Isole o commit com git bisect

O git bisect usa busca binária no histórico para achar o commit que introduziu um bug. Com N commits entre uma versão boa e uma ruim, bastam cerca de log2(N) testes.

O agente pode escrever o script de teste que devolve sucesso ou falha e rodar git bisect run, deixando a busca automática. Revise o script antes de executar.

Git: documentação do git bisect

Depuração com agentes no Arara Code

No Arara Code, o agente lê o terminal integrado, executa o teste que falha e propõe a correção como diff. Você aprova cada comando e confere a mudança.

Depois de corrigir, peça um teste de regressão que falhe antes da correção e passe depois. O teste documenta o bug e impede que ele volte.

Repositório do Arara Code no GitHub

Fontes e leitura complementar

Ler em Markdown

Continue explorando

Dê espaço à sua próxima ideia.

Conheça o Arara Code no seu próprio projeto. Comece pelo instalador e revise as mudanças que seu assistente fizer.