Já aconteceu com você? Você pede "crie uma landing page para meu SaaS" e recebe meia página de HTML genérico, sem contexto do seu produto, sem cores, sem copy. O problema não é a IA: é que o pedido tinha quatro palavras e esperava um trabalho de quatro horas.
Prompt de alta performance é engenharia de especificação. Você está escrevendo o briefing que daria a um estagiário brilhante — só que ele não pode te interromper para perguntar. Tudo que importa precisa estar no texto.
A estrutura P.C.R.F.: Papel, Contexto, Restrições, Formato
Todos os prompts do nosso catálogo seguem (ou deveriam seguir) quatro blocos. Não é mágica — é o que separa pedido de especificação.
- Papel. Comece dizendo quem a IA deve ser: "Atue como um engenheiro sênior de front-end" muda o vocabulário, o nível de profundidade e os padrões que o modelo vai invocar. Sem papel, o modelo responde em modo "assistente genérico", que é o modo mais fraco.
- Contexto. O cenário concreto: qual produto, para quem, em qual stack, com quais limitações. "Meu app é um SaaS de finanças pessoais em Next.js 14 + Prisma" vale mais que dez parágrafos de conversa depois.
- Restrições. O que a IA não pode fazer costuma importar mais do que o que ela deve: "sem dependências novas", "sem placeholders vazios", "responda em pt-BR". Restrição é onde mora a qualidade — é o que impede a resposta de desviar para o caminho fácil.
- Formato de saída. Diga exatamente como quer receber: "código completo em um único arquivo .tsx", "tabela com colunas X, Y, Z", "resposta em 3 parágrafos". Formato explícito elimina a rodada de "pode formatar assim?".
Exemplo: do fraco ao forte
Vejam a diferença na prática. Pedido fraco:
Faça um script para raspar dados de um site.
Pedido estruturado (o mesmo problema, resolvido em uma passada):
"Atue como um engenheiro de automação sênior. Preciso de um script Python assíncrono com Playwright que extrai título, preço e link de produto das 3 primeiras páginas do site {{url_da_loja}}. Restrições: use apenas bibliotecas padrão + playwright; trate rate limit com espera exponencial; salve em CSV UTF-8 sem BOM. Entregue o código completo, comentado, pronto para rodar com python scraper.py."
O segundo prompt tem papel (engenheiro de automação), contexto (o que extrair, de onde), restrições (libs, rate limit, encoding) e formato (código completo executável). É exatamente a anatomia do nosso Script Python Assíncrono para Web Scraping com Playwright, que está no catálogo.
Variáveis: o que deixa o prompt reutilizável
Prompt bom é prompt que você usa de novo. Para isso, extraia tudo que muda entre usos em variáveis no formato {{nome_da_variavel}}. No exemplo acima, a URL da loja é a única coisa que varia — o resto é esqueleto fixo.
Duas regras práticas:
- Nomeie a variável pelo que ela é (
{{stack_tecnologica}}, não{{var1}}) — quem ler o prompt depois precisa entender sem legenda. - Máximo de 4–5 variáveis. Se você precisa de mais, provavelmente está escrevendo dois prompts diferentes em um só.
O erro que mata a maioria dos prompts: escopo aberto
"Crie um sistema de login" é uma sentença de morte para a qualidade. O modelo vai escolher por você: JWT ou sessão? OAuth? Recuperação de senha? E-mail de verificação? Cada decisão não tomada vira uma aposta — e apostas somadas viram resposta mediana.
A correção é fechar o escopo explicitamente, mesmo quando a escolha parece óbvia para você: "login com e-mail + senha, hash bcrypt, sessão em cookie httpOnly, sem OAuth nesta versão". Escrever as escolhas que você já fez custa 30 segundos e economiza três rodadas de ajuste.
Como testar se o seu prompt está pronto
- Teste do estagiário: alguém que não conhece seu projeto consegue executar o pedido sem perguntar nada?
- Teste da restrição: existe pelo menos uma coisa que a IA está proibida de fazer? Se não, adicione.
- Teste do formato: você sabe exatamente como a resposta vai se parecer antes de enviar?
Se passou nos três, o prompt está no nível dos que passam pela nossa curadoria. Se quiser ver os critérios completos, leia Como avaliar a qualidade de um prompt antes de usar.
Prompts do catálogo para estudar
A melhor forma de internalizar a estrutura é ler prompts que já funcionam. Comece por estes três, de complexidades diferentes:
- Snake (Cobrinha) Clássico em HTML5 — escopo fechado, saída única e testável.
- Boilerplate de API REST Fastify + Prisma + TypeScript — especificação longa com requisitos numerados.
- System Prompt: Code Reviewer Sênior com Foco em Segurança — papel e restrições como protagonistas.
Resumo do guia
Papel define o vocabulário, contexto define o cenário, restrições definem a qualidade e formato define a entrega. Variáveis tornam o prompt reutilizável; escopo aberto é o inimigo número um. Escreva como se o leitor não pudesse te interromper — porque ele não pode.
Perguntas frequentes
O que é a estrutura P.C.R.F.?
Papel, Contexto, Restrições e Formato: você diz quem a IA deve ser, qual é o mundo do problema, o que ela não pode fazer e como a saída deve chegar. É a estrutura que a curadoria do Prompt Salvo usa para aprovar prompts.
Como sei se meu prompt está pronto?
Rode duas vezes com entradas diferentes e compare. Se a saída muda de forma imprevisível, falta escopo ou critério de aceite — uma frase final do tipo 'considere pronto quando X'.
Preciso escrever prompts longos?
Não. Prompt longo sem restrição é só texto caro. O que aumenta a qualidade é restrição acionável: teto de tamanho, formato nomeado e critério de sucesso.