Como escrever bons prompts para o Claude

O prompt que mais me economizou tempo tem cinco linhas e eu levei meses para chegar nele. Antes, escrevia "analisa essa planilha" e recebia um parágrafo genérico. Hoje escrevo papel, tarefa, contexto, formato e um exemplo, e recebo a tabela que vai direto para o relatório. A diferença não está na ferramenta; está no pedido.

Este guia mostra a estrutura que uso, como iterar quando a resposta vem fraca, e os erros que continuo vendo em quem começa.

A estrutura em cinco partes

Papel: quem a IA é naquela tarefa ("você é um analista de mídia que escreve para o dono da empresa"). Tarefa: o verbo e o objeto ("compare o realizado com a meta e aponte os três maiores desvios"). Contexto: o material e as restrições (a planilha, o período, o que já foi tentado). Formato: como entregar (tabela com colunas X, Y, Z; depois um parágrafo de cinco linhas). Exemplo: uma amostra do resultado esperado, mesmo que curta.

Nem todo pedido precisa das cinco. Mas quando a resposta vem genérica, quase sempre falta contexto ou formato.

Contexto é o que mais falta

A IA não sabe o que você sabe. Ela não conhece seu cliente, não sabe que o mês passado teve promoção, não sabe que o campo "conversões" da planilha inclui leads desqualificados. Tudo que você deixa implícito vira chute. Antes de enviar, pergunte: alguém que não me conhece entenderia o que eu quero com este texto? Se não, a IA também não.

Exemplo vale mais que explicação

Um exemplo do resultado esperado, com o formato exato, reduz mais retrabalho do que três parágrafos descrevendo o formato. Para e-mails, cole um e-mail seu que ficou bom. Para relatórios, cole o relatório aprovado do mês passado. Para tabelas, mostre duas linhas preenchidas. O modelo copia a estrutura e você só corrige o conteúdo.

Mostre também o que não quer

"Não use frases como 'é importante ressaltar'; não sugira testes sem dado; não repita o título no primeiro parágrafo." Uma lista curta de proibições limpa a resposta mais do que qualquer instrução positiva.

Como iterar

Trate a primeira resposta como rascunho. Diga o que ficou bom e o que mudar, com precisão: "a tabela está certa; o parágrafo final está genérico, use os números da linha 3". Correções específicas resolvem em uma rodada; "melhora" gera outra versão igualmente vaga.

Quando a IA erra de forma estranha, pergunte por que fez aquilo. A resposta costuma apontar a frase ambígua do seu prompt, e você corrige na fonte.

Prompts que você repete viram outra coisa

Se um prompt é usado toda semana, ele não deveria ser digitado. Vira instrução de projeto (se é de um cliente), preferência na memória (se é seu) ou Skill (se é um processo com passos). O prompt escrito na hora é para o que é novo. O que é recorrente merece ficar salvo e evoluir a cada correção.

Pedir raciocínio e pedir formato

Para tarefas com várias etapas (cálculo, decisão com critérios, análise de causa), peça que a IA liste os passos e verifique cada um antes de responder. Para tarefas simples, não: só atrasa. Para saída que vai entrar em sistema ou planilha, mostre o formato exato e peça só ele ("responda só com a tabela, sem texto antes").

Combinar as duas coisas é comum: "primeiro liste os desvios com os números; depois, em três linhas, diga o que fazer". Separar claramente o que vem primeiro e o que vem depois evita a resposta que mistura tudo.

Erros que continuo vendo

Pedido de uma linha para tarefa complexa. Várias tarefas no mesmo pedido (traduzir, revisar e formatar de uma vez). Pedir resumo sem dizer o tamanho. Esperar que a IA adivinhe o público. Não colar o material e pedir análise "do que eu te mandei antes" em outra conversa. Não pedir formato e reclamar do formato. Todos têm a mesma cura: uma frase a mais dizendo para quem, em que formato, com que tamanho, com que material.

Perguntas frequentes

Fontes e método

• Guia de engenharia de prompt da Anthropic
• Arquivo próprio de prompts recorrentes, mantido desde 2024