Dê Contexto Antes de Dar a Tarefa
A IA não consegue ver seu projeto como você vê. Ela não sabe a versão do seu , a estrutura dos seus arquivos, nem as convenções que você já estabeleceu. Quando você pula essa etapa, ela adivinha — e adivinha mal. Pior: ela adivinha com confiança, então a saída parece plausível até colidir com o seu código real.
Compare estes dois prompts para o mesmo pedido.
Add a function to validate emails.
This is a TypeScript backend using Express and Zod for validation.
We already validate inputs with Zod schemas in src/schemas/.
Add an email validation schema in that style. Emails must be
lowercase, max 254 chars, and reject disposable domains from
the existing BLOCKED_DOMAINS list in src/config.ts.
O primeiro produz um código genérico que pode usar uma regex que você não quer, em um estilo que não bate com o seu código. O segundo produz um código que você pode simplesmente colar. A regra: declare a stack, as convenções e as peças existentes que a IA deve reutilizar.
Um bom prompt empilha essas peças em ordem, de baixo para cima — contexto na base, o pedido em si perto do topo:
┌──────────────────────────────┐
│ EXAMPLES │ one input → output
├──────────────────────────────┤
│ CONSTRAINTS │ what NOT to do
├──────────────────────────────┤
│ EDGE CASES │ empty, invalid, errors
├──────────────────────────────┤
│ INPUTS / OUTPUTS │ types and shapes
├──────────────────────────────┤
│ GOAL │ one clear task
├──────────────────────────────┤
│ CONTEXT │ stack, files, patterns
└──────────────────────────────┘
foundation first ▲
Uma checklist mental útil antes de apertar enter: linguagem e framework (com versão, se importar), os arquivos ou módulos relevantes, os padrões já existentes no projeto, e quaisquer bibliotecas que a IA deveria preferir ou evitar. Você não precisa dos quatro itens toda vez — mas se a resposta mudasse dependendo de um deles, nomeie-o. Na dúvida, cole a assinatura, o tipo ou a configuração real com a qual o novo código precisa se encaixar. Algumas linhas de código existente ensinam mais sobre suas convenções à IA do que um parágrafo inteiro de descrição.