Jota Oliveira
Voltar ao blog

Mentoria

Ensine o agente de código a localizar o bug antes de editar

Três folhas de papel em pé atrás de uma lente coral que destaca um desnível na linha da folha verde.

Antes de pedir a um agente de código que corrija um bug, peça que localize o trecho suspeito e mostre a evidência. Um mapa do repositório pode ajudar quando a dificuldade é descobrir quais arquivos ou funções examinar. Na mentoria, essa primeira entrega dá à pessoa aprendiz algo concreto para conferir antes de aceitar uma mudança.

Em 5 de novembro de 2026, Melika Sepidband e colegas divulgaram um pré-print que comparou o Claude Code com Haiku 4.5 em quatro conjuntos de tarefas. O agente podia usar buscas e leituras comuns ou consultar também uma de cinco representações do repositório, como um mapa de quais funções chamam quais.

Nos 152 casos de localização de falhas no kernel Linux, a proporção de vezes em que o arquivo de referência apareceu entre os dez primeiros candidatos subiu de 71,7% com busca comum para 75,7% a 82,9% com os mapas. O consumo de tokens caiu de 25% a 39%, mas as execuções levaram mais tempo. Em outro conjunto de tarefas, que exigia uma correção, as taxas de resolução ficaram próximas às da busca comum. Os autores testaram uma configuração principal de agente e modelo, com uma execução por caso em cada condição.

Faça o exercício em duas rodadas

Imagine que, em um projeto de treino, o relatório semanal some quando a segunda-feira é feriado. Na primeira rodada, passe ao agente o sintoma e um caso que reproduz a falha. Peça os arquivos e funções mais prováveis, a ligação entre eles e uma hipótese que possa ser testada. Mantenha essa rodada em modo de leitura. Se o caminho atravessar vários módulos, use um mapa de chamadas para orientar a busca e confira no código os vínculos que o agente apontou.

Na segunda rodada, confirme onde o comportamento esperado diverge do real. No exemplo fictício, se o filtro descartar a semana inteira ao receber um feriado, combine um teste que falhe por esse motivo e outro que preserve o resultado em uma semana comum. Só então peça uma alteração pequena e revise a diferença.

Escolha um bug já resolvido em um repositório de treino e refaça apenas a primeira rodada sem consultar a correção. Compare a evidência apresentada com o histórico do projeto. Para montar o exercício, veja como definir o que precisa ser revisado ao delegar código e transformar um projeto em prova de aprendizagem.

Continue a leitura

Aprendiz de papel ajusta uma curva coral em uma pequena pista sobre base amarela, com uma bola pronta para testar o caminho até a saída.

Hackathon com IA: transforme o projeto em uma prova de aprendizagem

Para aprender em um hackathon com IA, escolha uma mudança pequena, explique o efeito esperado e guarde o teste que demonstra o resultado.

Ler artigo
Professora de papel consulta uma pasta com registros de conversa e entrega um caderno amarelo de prática a um aluno.

Professores: use o resumo do Gemini Notebook para orientar o feedback

Para professores, os novos resumos do Gemini Notebook ajudam a localizar dúvidas dos alunos; conferir as conversas e o trabalho realizado orienta um feedback mais útil.

Ler artigo