Erros comuns e como evitá-los
Já vimos permissões, sandboxing e self-review antes do push. Esta lição encerra o módulo com cinco erros que se repetem para qualquer pessoa que trabalha com um agente de código — não porque o agente é 'ruim', mas porque cada um deles se esconde exatamente onde é fácil pular. Os cinco pontos: um rel
Antes da decolagem, um piloto passa item por item por uma checklist em vez de confiar que o motor 'parece estar bem' — cada item recebe sua própria verificação, porque um relatório geral pode esconder uma falha pequena e perigosa.
- confiança cega no resultado do agente
- Aceitar um relatório em linguagem natural como "mudei em todos os 14 lugares" como fato verificado, sem checar você mesmo se a descrição corresponde ao diff real em todos os pontos.
- vazio de contexto
- Quando falta ao agente um arquivo ou fato relevante do repositório, ele presume algo razoável com base no que viu — e essa suposição pode estar errada sem que ninguém perceba.
- prompt injection a partir de conteúdo lido
- Uma instrução escondida dentro de um texto externo que o agente só deveria resumir ou ler (um ticket, uma página, um README) — arriscado porque o agente pode tratá-la como se tivesse vindo do usuário.
- um segredo que permanece no histórico do git
- Uma chave ou senha que entrou em um commit e ficou visível para qualquer pessoa com acesso ao repositório — apagar a linha em um commit posterior não a remove do histórico do git, então a própria chave precisa ser rotacionada.
- revisão de diff direcionada por risco
- Quando um diff é grande demais para ler linha por linha, você verifica primeiro e individualmente os arquivos mais sensíveis (segurança, autenticação, rate-limiting), em vez de confiar que 'é só um rename mecânico'.