Por que o prompt de uma linha não funciona?
"Crie um sistema de pedidos para a minha loja" gera um sistema de pedidos para uma loja qualquer. A IA preenche tudo o que você não disse com o caso mais comum, e o caso mais comum não é o seu. Depois, você gasta horas desfazendo suposições: campos que não existem, etapas que não são as suas, gente vendo o que não devia.
É por isso que, no meu curso, ninguém abre a ferramenta antes de escrever o PRD, o documento que diz à IA o que construir. Quem escreve o contexto decide o sistema; a IA só executa.
Quais são as cinco partes de uma boa especificação?
- Quem usa. Cada tipo de pessoa e o que ela pode ver e fazer. "Atendente registra; técnico vê só os dele; gerente vê tudo."
- O que cada pessoa faz. As ações, na ordem em que acontecem no dia a dia.
- Que dados o sistema guarda. Os campos de cada cadastro, com o que é obrigatório.
- Que regras não podem ser quebradas. Prazos, aprovações, limites de valor, o que acontece quando algo atrasa.
- Quando está pronto. Um teste concreto: "uma atendente registra um pedido e o técnico vê no celular, sem ajuda".
Como fica uma especificação de verdade?
Este é um portal de solicitações internas, do tipo que substitui o grupo de WhatsApp em que tudo se perde:
- Objetivo: registrar e acompanhar pedidos internos (compras, manutenção, TI) até a conclusão.
- Quem usa: colaborador (abre e acompanha os próprios pedidos), responsável da área (atende os pedidos da área), gestor (vê todos e o painel).
- Pedido: título, área, descrição, prioridade (baixa, média, alta), anexo opcional, solicitante, data de abertura, status.
- Status: Aberto, Em atendimento, Aguardando solicitante, Concluído.
- Regras: prioridade alta sem resposta em 24 horas aparece em vermelho no painel; só o responsável da área muda o status; ao concluir, o solicitante recebe um aviso.
- Painel do gestor: pedidos abertos por área e os atrasados no topo.
- Pronto quando: um colaborador abre um pedido, o responsável da área atende e conclui, e o gestor vê tudo no painel, sem ninguém explicar como.
Repare no que não está ali: cores, fonte, posição de botão. A IA resolve a aparência bem sozinha. O que ela não adivinha são as regras.
Como pedir ajustes depois da primeira versão?
- Uma mudança por pedido. Várias ao mesmo tempo quebram o que funcionava, e você não sabe qual foi.
- Diga o que viu e o que esperava. "Ao concluir, nada acontece; esperava que o solicitante recebesse um aviso."
- Descreva a regra, não o pixel. "Só o responsável da área pode mudar o status" vale mais do que "esconda o botão".
- Salve a versão que funciona antes de uma mudança grande.
Que erros de especificação custam mais caro?
- Esquecer as permissões. Sistema em que todo mundo vê tudo é o erro mais caro, e o mais comum.
- Escopo que não cabe numa página. Se não cabe, é mais de um sistema. Comece pelo menor.
- Usar dados reais no exemplo. Invente nomes e números. Veja o que pode entrar num prompt.
- Não definir o pronto. Sem um teste, o ajuste nunca acaba.
Outros tropeços de quem está começando estão em 7 erros de quem começa no vibe coding.
Como transformar uma conversa com a equipe em especificação?
A especificação não nasce no computador; nasce numa conversa de vinte minutos com quem vive o problema. Estas são as perguntas que eu faço, na ordem:
- Me conta o último dia em que isso deu errado. A resposta mostra o problema real, e não o imaginado.
- Quem mexe nisso hoje, e o que cada um faz? Aqui nascem os tipos de usuário.
- Onde a informação fica hoje? Planilha, caderno, WhatsApp: os campos já estão lá.
- O que nunca pode acontecer? Aqui nascem as regras.
- Como você saberia, na semana que vem, que o problema acabou? Aqui nasce o critério de pronto.
Grave a conversa com autorização, ou anote, e peça à IA para organizar as respostas nas cinco partes. Depois, leia em voz alta para quem respondeu. Se a pessoa disser "é isso", a especificação está pronta.
A especificação serve depois que o sistema está pronto?
Serve, e muito. Ela é o manual do sistema para quem chega na equipe, a base para cada ajuste e o seguro da empresa: se a plataforma mudar ou se for preciso reconstruir o sistema em outro lugar, uma especificação atualizada encurta semanas para horas. Por isso, a regra é atualizar a especificação a cada mudança aprovada, e guardá-la junto com as contas do sistema, no nome da empresa.
Perguntas frequentes
Posso pedir para a IA escrever a especificação?
Pode, e é um bom começo: conte o problema com as suas palavras e peça para a IA organizar nas cinco partes. Mas revise com cuidado, porque ela vai preencher as lacunas com o caso comum, e as regras da sua empresa só você conhece.
Qual é o tamanho ideal da especificação?
Uma página. Menos que isso costuma deixar as permissões e as regras de fora; mais que isso costuma ser mais de um sistema, que vale construir em partes.
Isso é o mesmo que engenharia de prompt?
É parente. Engenharia de prompt costuma falar de como perguntar; a especificação fala do que o sistema precisa fazer. Para construir software com IA, o segundo pesa muito mais que o primeiro.