Como escrever um bom pedido (prompt) para a IA criar um sistema

Em inglês, o que você escreve para a IA se chama prompt, e é esse termo que você vai ver em toda parte. Aqui vou usar pedido, porque é isso que é: um pedido de trabalho, como o que você faria a um colega. E, como com um colega, a qualidade do que volta depende muito da qualidade do que foi pedido.

Eu não sou programador. Toquei cerca de 18 projetos descrevendo o que eu queria pelo que aparece na tela, e é desse jeito que ensino aqui. Os exemplos usam a Gráfica Aurora, uma gráfica pequena que anota pedidos em caderno e perde prazos, e a Lúcia, do administrativo, que vai construir o painel sem programar.

O erro mais comum: falar a língua da IA

Quem começa costuma procurar termos técnicos que não domina, mistura conceitos e acaba pedindo uma solução errada. Você não precisa disso. Descreva o comportamento: o que você vê na tela, o que faz e o que esperava ver. Quem decide a solução técnica é o agente, a IA que trabalha dentro da pasta do projeto.

Compare duas frases:

• Técnica: “Cria uma tabela com chave estrangeira para os pedidos”.
• Comportamental: “Quero uma tela onde eu cadastre um pedido e depois veja a lista de todos os pedidos”.

A segunda diz o que a pessoa precisa. A primeira obriga a IA a adivinhar o motivo e ainda arrisca fixar uma escolha que você nem entende.

As quatro perguntas de todo bom pedido

Antes de enviar, confira se o seu texto responde a estas quatro:

1. Quem vai usar? A Lúcia, no administrativo.
2. O que a pessoa faz? Cadastra um pedido.
3. O que deve acontecer depois? O pedido aparece na lista.
4. Como saber que deu certo? Eu cadastro um pedido de teste e o vejo na lista.

A quarta é a mais esquecida e a mais útil. Ela já define como você vai conferir o trabalho.

Um detalhe que ajuda: diga também o que o sistema não deve fazer. “Não precisa de login por enquanto” ou “não mexa na tela de lista” evita que o agente gaste esforço onde você não quer e protege você de mudanças que ninguém pediu.

Exemplo 1: o cadastro

Pedido ruim: “Faz um sistema de pedidos pra gráfica.”

Falta tudo. Que dados? Quem usa? O que é um pedido? A IA vai inventar as respostas, e você só descobre depois.

Pedido melhor:

Quero um painel para a Gráfica Aurora anotar pedidos. Cada pedido tem cliente, serviço (por exemplo cartão de visita ou banner), quantidade e prazo de entrega. Quem usa é a Lúcia, do administrativo, que não programa. Antes de começar, me faça todas as perguntas que você precisa responder e diga qual opção você recomenda em cada uma.

Agora há contexto, dados e uma instrução para a IA perguntar antes de agir.

Exemplo 2: o status

Pedido ruim: “Muda o status.”

Pedido melhor:

Na lista de pedidos, cada pedido deve ter um status que pode ser Recebido, Em produção, Pronto ou Entregue. Quando a Lúcia clicar no status, ela escolhe o novo valor. Antes de mudar para Entregue, o sistema pede uma confirmação. Um pedido novo começa sempre como Recebido.

Ele descreve o comportamento exato, as opções e o que acontece em cada caso.

Exemplo 3: o erro na tela

Pedido ruim: “Está dando erro, arruma.”

Pedido melhor:

Quando eu cadastro um pedido com quantidade 500 e prazo de 20/12, ele salva, mas na lista o prazo aparece como "Invalid Date". Segue o print da lista. Não apareceu mensagem de erro. Corrija e depois me diga como testar com esse mesmo pedido.

Há o passo a passo do que foi feito, o que apareceu e o que se esperava. Com isso, a IA chega à causa muito mais rápido.

Cole o print e o erro do jeito que apareceu

Quando algo não funciona, a melhor informação é a que você já tem à frente. Tire um print e cole no pedido. Se aparecer uma mensagem de erro, copie o texto inteiro, sem resumir e sem traduzir. Mesmo que pareça incompreensível, cole cru, porque é nessa bagunça que a IA encontra a pista.

Um modelo que serve para quase todo problema:

Na tela de lista de pedidos, ao clicar em "Entregue" o status não muda. Segue o print da tela e a mensagem que apareceu, copiada na íntegra:

[cole aqui a mensagem]

Descubra a causa, me explique em uma frase e corrija. Depois me diga como eu confirmo que ficou certo.

Um pedido por vez, ou uma lista numerada

Pedido que mistura muita coisa gera resposta misturada. Há duas boas saídas.

Um pedido por vez funciona bem quando o assunto é novo ou delicado: peça uma coisa, confira, depois peça a próxima.

Uma lista numerada funciona quando os itens são pequenos e independentes. Numerar permite que você e o agente se refiram a cada ponto sem confusão (“o item 3 ficou errado”). Evite o meio-termo desorganizado, o parágrafo comprido com dez pedidos escondidos. É dali que os itens somem.

Peça as perguntas antes de começar

Se existe um único hábito para levar deste texto, é este. Em vez de deixar a IA preencher lacunas com suposições, mande que ela pergunte tudo o que a bloqueia, de uma vez, com opções e recomendação. Eu perdia muito tempo digitando “continua” porque a IA parava no meio. Resolvi com uma regra: perguntas primeiro, todas de uma vez, depois o plano, e depois do meu sim ao plano ela vai até o fim.

Antes de começar, me faça todas as perguntas que te impedem de seguir, numeradas, de uma vez. Em cada uma, dê as opções e diga qual você recomenda. Depois que eu responder, me mostre o plano; depois do meu sim ao plano, vá até o fim sem parar.

Um teste final para o seu pedido

Releia o que escreveu como se fosse a IA, sem saber nada do seu trabalho. Algum ponto ficou duvidoso? Então melhore o texto antes de enviar. O pedido bom quase sempre é só um pouco mais longo que o ruim, e meio minuto a mais escrevendo costuma poupar uma hora de ida e volta.

Um lembrete de honestidade: mesmo com pedido excelente, a IA erra. Quem confere é você.

Quer o método completo?

Este texto cobre um pedaço do que o guia “Equipe de IA sem programar” ensina, que é independente e não tem vínculo com a Anthropic. Ele reúne os pedidos prontos, o modelo de manual da equipe e um projeto passo a passo. Se quiser conhecer, o botão está logo abaixo.