Todo mundo que já usou ChatGPT ou Claude pelo menos uma vez sabe a sensação: você digita o que quer, recebe algo que "quase" serve, tenta reformular, fica na metade do caminho. O problema quase nunca é a IA, é o prompt. Prompt engineering não é jargão de programador. É a habilidade de comunicar de forma precisa o que você precisa, para que a IA entenda o contexto, a tarefa e as restrições antes de responder.
Nos projetos que construo com Claude Code, o prompt é tão importante quanto o código. Uma instrução mal estruturada produz um agente que "funciona" mas que precisa de supervisão constante. Uma instrução bem construída produz um agente que resolve o problema com mínima intervenção humana.
Os 4 elementos de todo prompt eficiente
1. Contexto, quem você é e qual o cenário
A IA não sabe nada sobre você antes de você contar. "Sou advogado trabalhista, atendo principalmente pequenas empresas, e preciso...". Esse cabeçalho muda tudo. Sem ele, a IA responde para um usuário genérico, o que significa que a resposta será genérica também. Com o contexto certo, ela calibra tom, nível técnico, exemplos e prioridades.
2. Tarefa, o que exatamente você quer
Seja específico. "Escreva sobre marketing" é uma tarefa vaga. "Escreva um email de follow-up de 150 palavras para um lead que assistiu ao webinar mas não comprou, foco em quebrar a objeção de preço, tom direto e sem enrolar" é uma tarefa que a IA consegue executar bem. A especificidade do pedido determina a qualidade da entrega.
3. Restrições, o que não pode aparecer
Tão importante quanto dizer o que quer é dizer o que não quer. Sem jargão técnico. Sem linguagem corporativa. Sem usar a palavra "sinergia". Sem mais de 3 parágrafos. Sem citar concorrentes. Restrições parecem limitar a IA, mas na prática a tornam mais útil, porque eliminam o que você teria que editar de qualquer forma.
4. Formato de saída, como você quer receber
Defina como a resposta deve ser entregue. Lista com marcadores. Tabela com colunas X e Y. Três opções numeradas. Email em HTML. JSON com os campos: nome, cargo, empresa, observação. Quanto mais claro o formato esperado, menos retrabalho na hora de usar o resultado.
O template que uso em todos os projetos
CONTEXTO: [quem é, qual o cenário, qual o problema] TAREFA: [o que deve ser feito, com qual objetivo] RESTRIÇÕES: [o que não pode aparecer, limites de tamanho, tom] FORMATO: [como a saída deve ser entregue]
Exemplos práticos por área
Para gestão e documentos internos
"CONTEXTO: Sou gestor de uma distribuidora com 15 funcionários. Precisamos de uma política de uso de celular durante o horário de trabalho. TAREFA: Escreva uma política clara e objetiva. RESTRIÇÕES: Máximo 1 página A4, linguagem acessível, sem juridiquês. FORMATO: Texto corrido com subtítulos, pronto para colar no manual interno."
Para copy e marketing
"CONTEXTO: Curso online de culinária vegana para iniciantes, público feminino de 30-50 anos, preço R$ 197. TAREFA: Escreva 3 variações de headline para a landing page. RESTRIÇÕES: Sem clichês como 'transforme sua vida', foco em praticidade, não em ideologia. FORMATO: Cada headline em uma linha, sem explicação adicional."
Para análise de dados e relatórios
"CONTEXTO: Gerente comercial com dados de vendas dos últimos 90 dias (vou colar abaixo). TAREFA: Identifique os 3 principais padrões e 2 oportunidades que os dados sugerem. RESTRIÇÕES: Sem análise óbvia, foco no que não é imediato. FORMATO: Bullet points, máx. 10 linhas."
O erro mais comum, e mais fácil de corrigir
O erro número um é tratar o prompt como uma mensagem casual. "Me ajuda com um texto aqui?", isso funciona para uma conversa informal, não para um sistema de automação ou para uma tarefa crítica de negócio. Prompt engineering é redação técnica: quanto mais preciso o input, mais preciso o output.
A boa notícia é que essa habilidade se desenvolve rápido. Depois de escrever 20-30 prompts estruturados, você começa a fazer isso naturalmente, e a diferença nos resultados é imediata e mensurável.
Como escalar, System Prompts e contexto permanente
Quando uso Claude Code em projetos de automação, o prompt não é só uma instrução, é o system prompt do agente. Nele, documento tudo: quem é o agente, qual o seu papel, quais as regras que nunca pode quebrar, quais os formatos de resposta esperados. Esse system prompt é escrito uma vez e funciona em todas as interações subsequentes, garantindo consistência sem precisar repetir o contexto a cada vez.
“O prompt é o contrato com a IA. Quanto mais claro o contrato, menos margem para interpretação errada, e mais previsível o resultado.”
Thiago Amarante