Definir o escopo de uma tarefa para um agente

“Melhore o tratamento de erros no módulo de pagamento.” Você executa, vai buscar um café e volta para um diff de 600 linhas: o agente envolveu quatorze chamadas em try/except, criou uma hierarquia caseira de cinco classes de exceção, adicionou uma biblioteca de retry e alterou o formato dos logs. Nada está errado linha a linha. Nada é aproveitável também, porque você não consegue nem validar nem rejeitar o conjunto: não existe nenhum critério que diga que está pronto e que deu certo. Você descarta tudo e pagou o preço integral da geração e da revisão por nada.

O problema não é o tamanho do prompt, é a ausência de uma condição de sucesso. Um agente otimiza em direção a um sinal; se você não der nenhum, ele recorre a “produzir algo que se pareça com o que foi pedido”, e esse é justamente o pior resultado: crível o bastante para não ser rejeitado de imediato, arbitrário o bastante para não ser confiável. Definir o escopo de uma tarefa é fornecer três coisas: um estado final observável, a maneira de observá-lo e os limites do que é permitido tocar. O resto — o tom, a gentileza, os “por favor” — não tem nenhum efeito mensurável.