Dar o contexto certo a um agente de código

Você pede um novo endpoint. O agente o produz: correto, testado, legível. Só que ele usa requests quando todo o projeto está em httpx, devolve um dicionário bruto onde suas outras doze rotas devolvem um schema Pydantic, e escreve as mensagens de erro em inglês em uma base inteiramente francófona. Você passa vinte minutos colocando esse código nos padrões da casa — vinte minutos que teria economizado escrevendo três linhas de contexto logo no início.

Esse é o erro de enquadramento mais frequente e o pior diagnosticado. Atribui-se o problema à ferramenta («ela não entende meu projeto»), quando ele é puramente informacional: um agente só enxerga o que entra na sua janela de contexto. Suas convenções não estão escritas em lugar nenhum, elas vivem na repetição de um padrão ao longo de dezenas de arquivos — algo que um humano absorve em uma semana de leitura e que uma máquina só consegue inferir se você mostrar os arquivos envolvidos. O reflexo oposto é igualmente custoso: mostrar tudo degrada a qualidade em vez de melhorá-la. A competência, aqui, consiste em escolher.