Como escrever prompts que realmente entregam features

A estrutura de cinco partes por trás de cada prompt da nossa biblioteca — e os critérios de aceitação que impedem o agente de improvisar.

A maioria dos builds falhos com IA não são falhas do modelo. São falhas de briefing: um pedido sem escopo, sem restrições e sem definição de pronto. Esta é a estrutura que usamos em todo prompt da biblioteca.

1. Contexto antes de instrução

Nomeie o produto, o público e a única ação que o usuário deve tomar. Duas frases bastam, e isso remove uma categoria inteira de saída genérica.

2. Escopo, declarado como fronteira

Diga o que construir e, igualmente importante, o que não tocar. 'Não adicione rotas que eu não pedi' economiza mais tempo do que qualquer frase inteligente.

3. Estrutura como lista ordenada

Numere as seções ou passos. Listas ordenadas sobrevivem a conversas longas muito melhor que parágrafos, e dão algo para apontar quando o resultado desvia.

4. Regras que codificam seu gosto

Restrições de design, regras de dados, regras de segurança. É aqui que seus padrões vivem: 'apenas tokens semânticos', 'row-level security em toda tabela', 'nada de dados mock no build final'.

5. Critérios de aceitação

Termine com as verificações que você vai realmente rodar: funciona em 360px, acessível no teclado, typecheck passa, estados vazios existem. Um agente que recebeu uma definição de pronto costuma cumpri-la.

O loop de revisão

Peça um fluxo, revise, depois peça o próximo. Corridas longas sem supervisão parecem eficientes e são a forma mais confiável de produzir algo que você terá que jogar fora.