Prompt engineering para código: 7 padrões que funcionam de verdade

A maior parte do conteúdo sobre prompts para código é superstíção — fórmulas decoradas que ninguém testou. O que funciona é mais simples e mais chato: dar contexto suficiente e ser específico sobre o resultado esperado.

1. Diga o objetivo, não o passo a passo

Compare "crie uma função que recebe um array e retorna outro array filtrado" com "preciso mostrar só os pedidos pagos dos últimos 30 dias nesta listagem".

A segunda forma permite que o modelo perceba coisas que você não pensou — que talvez a filtragem deva ir para a query do banco, por exemplo. A primeira transforma a IA em digitadora.

2. Mostre o padrão em vez de descrevê-lo

Explicar sua convenção de código em texto é impreciso. Colar um arquivo parecido e dizer "siga este estilo" resolve em uma linha.

3. Diga o que NÃO fazer

Restrições são mais informativas que instruções. "Sem bibliotecas novas", "sem quebrar a assinatura desta função", "precisa rodar em PHP 8.0" eliminam de cara as respostas erradas.

4. Peça o plano antes do código

Para qualquer coisa que passe de um arquivo, peça primeiro a abordagem. Ler três parágrafos e discordar custa trinta segundos; revisar 400 linhas na direção errada custa a tarde.

Quanto maior a mudança, mais barato é alinhar antes de escrever.

5. Traga o erro completo

Stack trace inteiro, não a última linha. Versões. O que você já tentou. O que deveria acontecer. Metade dos diagnósticos ruins vem de contexto pela metade, não de limitação do modelo.

6. Itere em vez de reescrever o prompt

Quando a resposta chega perto mas não exata, o instinto é refazer o prompt do zero. Errado — você joga fora o contexto acumulado. Diga o que ajustar: "mantenha, mas troque o retorno por exceção".

7. Deixe o contexto escrito no projeto

Se você repete as mesmas instruções toda sessão, coloque num arquivo de contexto do repositório. Padrões do time, comandos de teste, decisões de arquitetura. Escreve uma vez e vale para sempre.

O que não faz diferença

Personas elaboradas, ameaças, promessas de gorjeta e pedidos de "pense passo a passo" em modelos que já raciocinam. Nada disso substitui contexto real.

A habilidade que importa não é formular prompts bonitos — é saber o que você quer com precisão suficiente para explicar. Isso sempre foi o trabalho.