Capítulo 2 · 11 min de leitura · prévia · out/2026
O PRD passo a passo
O coração do guia: o plano que transforma um prompt e uma esperança em contexto antes do código.
Existe um jeito de abrir uma ferramenta de vibecoding que quase garante o fracasso: chegar com um prompt e uma esperança. A ideia na cabeça, a descrição improvisada, o “faz um sistema pra controlar os equipamentos do meu setor”. A ferramenta vai obedecer. Vai nascer algo que funciona na superfície e está furado por baixo, porque foi construído sem o contexto que tornaria a construção correta. Esse tipo de defeito tem nome técnico e uma propriedade cruel: é exponencialmente mais caro de consertar do que de prevenir.
A prevenção é um documento. Chama-se PRD (Product Requirements Document, documento de requisitos do produto), e a sigla assusta mais do que deveria: é uma conversa honesta com você mesmo, por escrito, antes da primeira tela. Quem chega à ferramenta com um PRD não chega com um prompt e uma esperança. Chega com um plano que é, ele mesmo, o contexto que faltava.
Um aviso antes de começar: você vai gastar mais tempo neste documento do que gostaria. Isso não é defeito do processo; é o processo. Cada hora aqui economiza dias de remendo depois, e remendo em cima de remendo é o roteiro documentado dos aplicativos que morreram em uma semana.
O PRD deste guia tem sete seções. Percorra na ordem, porque cada uma alimenta a seguinte.
2.1 · A dor
Comece pelo problema, nunca pela solução. Parece óbvio e é o passo em que a maioria tropeça, porque quase todo mundo chega com a solução pronta na cabeça (“preciso de uma planilha online”, “quero um app de agendamento”) e trata o problema como formalidade.
Responda por escrito, com fatos e não com adjetivos:
- Quem sofre? Nomes de papéis, não abstrações. “As analistas do administrativo”, não “a equipe”.
- O que exatamente acontece hoje? Descreva a cena, do início ao fim, como ela ocorre de verdade.
- O que isso custa? Em tempo, em retrabalho, em risco, em dinheiro. Número sempre que houver; estimativa honesta quando não houver.
- O que já foi tentado? E por que não resolveu.
Regra de ouro desta seção: marque cada afirmação como evidência (você viu, mediu, tem registro) ou hipótese (você acha, ouviu dizer, supõe). Não é burocracia. É o antídoto contra construir rápido a coisa errada, que é o desperdício número um de quem constrói sem plano. Hipótese não é proibida; hipótese não declarada é.
Teste de qualidade: leia sua descrição da dor e pergunte “há alguma solução escondida aqui?”. “O problema é que não temos um sistema de reservas” não é um problema; é uma solução disfarçada. O problema é o que acontece porque não existe controle: o equipamento que some, a hora perdida procurando, a reunião que começa sem o projetor.
2.2 · Usuários e papéis
Agora as pessoas. Todo sistema, por menor que seja, tem mais de um tipo de usuário, e confundi-los na especificação é a origem de metade dos problemas de segurança.
- Quem usa no dia a dia? O papel principal e o que ele pode fazer.
- Quem administra? Quem cadastra, corrige, exclui, vê tudo.
- Quem nunca pode ver o quê? Esta pergunta parece paranoica num sistema de empréstimo de projetores. Responda mesmo assim, sempre, porque é aqui que nasce a segurança do seu sistema: definida no papel, antes de existir código. A seção 3 deste guia (o checklist de segurança) só funciona se esta pergunta tiver sido respondida agora.
Se você respondeu “todo mundo pode ver tudo”, escreva isso explicitamente. Decisão registrada é diferente de pergunta esquecida.
2.3 · A jornada
Antes de pensar em qualquer tela, escreva o caminho que o usuário percorre de ponta a ponta, em passos numerados, do gatilho (“Ana precisa de um projetor para quinta-feira”) até o desfecho (“o projetor volta para o armário e o registro se encerra”).
A jornada manda no sistema; nunca o contrário. Se um passo da jornada não tem correspondente no que você vai construir, ou o passo sobra ou o sistema falta. E escreva também o caminho infeliz: o que acontece quando o equipamento não volta, quando duas pessoas querem o mesmo item, quando alguém erra o cadastro. Sistemas quebram nos caminhos infelizes, e a IA só constrói o que você descreveu.
2.4 · O corte forçado
Liste tudo o que o sistema poderia fazer. Agora vem a parte dolorosa, e ela tem números: classifique cada item como Must (sem isso o sistema não prova o conceito), Should (importante, aguenta esperar) ou Could (seria bom). O corte é forçado: os Must não podem passar de 40% da lista. Should fica em torno de 30%, e Could é o resto, se sobrar fôlego.
Se os seus Must passam de 40%, você ainda não decidiu o que é essencial; está adiando a decisão para dentro da construção, onde ela custa caro. A pergunta que resolve o empate: o que, do essencial, prova o conceito de ponta a ponta com o menor número de partes móveis?
E declare os non-goals: o que este sistema explicitamente NÃO vai fazer nesta versão. Por escrito. Non-goal não é o que você esqueceu de incluir; é o que você decidiu deixar de fora e quer conseguir provar que decidiu. É a sua defesa contra o “já que está fazendo, aproveita e adiciona” que mata primeiros sistemas.
Nada do que caiu para Should e Could vira lixo: vira o roadmap da segunda versão, com nome e endereço (seção 2.7).
2.5 · Requisitos com critérios verificáveis
Cada Must vira uma frase testável. “O sistema deve ser fácil de usar” não é requisito; é desejo. Requisito tem critério de pronto embutido, verificável por alguém que não é você:
- Fraco: “controlar os empréstimos”
- Verificável: “ao registrar um empréstimo, o item fica indisponível para reserva até a devolução; tentar reservar item emprestado exibe quem o tem e a data prevista de devolução”
O teste: uma pessoa de fora, lendo só o requisito, consegue dizer se está pronto ou não? Se precisa te perguntar o que você quis dizer, reescreva. Este é o trecho do PRD que a IA mais agradece, porque cada critério verificável é contexto que ela não vai precisar adivinhar (e IA que adivinha, adivinha errado com confiança).
2.6 · Segurança na especificação
A regra inteira em uma frase: segurança se negocia no plano, não se remenda no conserto. Três compromissos entram por escrito no PRD, e os três serão cobrados pelo checklist da seção 3 antes de qualquer dado real:
- Papéis de acesso definidos (herdados da seção 2.2): quem vê o quê, quem edita o quê, escrito antes da primeira tela.
- Dados fictícios até a aprovação. O protótipo roda com dados inventados, e isso é decisão de projeto, não limitação: o sistema ainda não provou que merece os dados de verdade. Nome real de pessoa, e-mail real, qualquer dado do seu empregador: nada disso entra antes do checkpoint.
- Requisitos sensíveis com critério verificável. Se um requisito envolve quem pode ver o quê, ele ganha critério de teste como qualquer outro (“usuário comum não acessa o painel de administração; a tentativa exibe erro e é registrada”).
Se o seu sistema toca dado pessoal de verdade em qualquer hipótese futura, escreva isso no PRD agora, na seção de riscos, junto com a decisão de quem precisará aprovar esse passo. Num protótipo, a resposta certa para “posso usar dados reais?” é não. Depois, é “não, até que alguém com mandato diga sim”.
2.7 · O que fica de fora desta volta
A última seção é o roadmap honesto: a lista dos Should e Could com uma linha de contexto cada, mais os non-goals. Duas funções: proteger o escopo desta versão (quando alguém pedir “aproveita e adiciona”, a resposta está documentada) e baratear a próxima volta, porque a segunda versão começa com um plano que a primeira já deixou meio pronto.
O PRD preenchido de ponta a ponta (exemplo)
PRD · Controle de Empréstimo de Equipamentos · v1 Autora: Ana, analista administrativa (a dona da dor)
1 · A dor. O setor mantém 14 equipamentos compartilhados (projetores, notebooks, caixas de som) num armário com caderno de registro. O caderno depende de quem lembra de preencher. [EVIDÊNCIA] Em julho, 3 dos 14 itens ficaram uma semana sem paradeiro conhecido; localizar um projetor consome em média 25 minutos de busca por corredor (medido em 9 ocorrências registradas por mim entre 01/07 e 31/07). [HIPÓTESE] Estimo 6 horas/mês do setor perdidas nisso. Já tentado: planilha compartilhada (2024, abandonada em 3 semanas porque ninguém atualizava na hora da retirada) e etiquetas com nome do responsável (não resolve reserva futura). O custo real não é o equipamento; é a reunião que começa atrasada.
2 · Usuários e papéis. Colaborador (busca item, vê disponibilidade, registra retirada e devolução, vê com quem está cada item); Administradora, eu (cadastra e desativa itens, corrige registros, vê histórico completo). Quem nunca vê o quê: não há dado sensível no sistema, e ele fica assim por design (non-goal nº 3). Todos os colaboradores logados veem tudo; quem não está logado não vê nada.
3 · Jornada (feliz).
- Ana precisa de projetor para quinta 14h
- abre o sistema, filtra “projetor”, vê os disponíveis na data
- reserva com data de retirada e devolução
- quinta 13h50, retira e confirma a retirada em um toque
- sexta, devolve e confirma a devolução
- o item volta ao estoque disponível.
(Infeliz A) item não devolvido na data: o sistema marca “atrasado” e mostra o responsável a todos. (Infeliz B) duas pessoas, mesmo item, mesma data: quem reservou primeiro leva; o segundo vê alternativas disponíveis.
4 · Corte forçado. Listei 12 funcionalidades.
| Must (4 = 33%) | Should (4) | Could (4) |
|---|---|---|
| cadastro de itens | notificação de atraso | leitura de QR code no armário |
| reserva por período | histórico por pessoa | integração com calendário |
| retirada/devolução em um toque | relatório mensal | avaliação de estado do item |
| painel “onde está cada item” | foto do item | fila de espera |
Non-goals desta versão: não gerencia manutenção; não controla compras; não guarda nenhum dado pessoal além de nome e e-mail corporativo do usuário logado; não integra com nenhum sistema corporativo.
5 · Requisitos verificáveis (Must).
- R1: cadastrar item com nome, categoria e status leva menos de 1 minuto; item desativado some da busca mas mantém histórico.
- R2: reserva exige período com início e fim; item reservado não aparece como disponível no período; conflito exibe o responsável e a data de devolução.
- R3: retirada e devolução se confirmam em no máximo 2 toques a partir da tela inicial.
- R4: o painel responde “onde está o item X?” em uma única tela, sem cliques adicionais.
6 · Segurança. Papéis conforme seção 2. Protótipo roda com 14 itens fictícios e 5 usuários inventados até o checkpoint. Requisito sensível R5: usuário não logado não vê nenhuma tela além do login; colaborador não acessa funções de administradora (testável: tentar a URL do admin logado como colaborador exibe erro). Sem dado pessoal por design; se um dia houver, aprovação prévia da segurança da informação.
7 · Fora desta volta. Os 8 itens de Should e Could acima, nesta ordem de apetite: notificação de atraso primeiro (ataca a dor residual), QR code por último (charme, não dor).
Biblioteca de prompts · a elaboração assistida
O PRD melhora muito quando uma IA faz o papel de entrevistadora cética antes de você escrever. Use estes prompts numa conversa com a IA de sua preferência, ANTES de abrir a ferramenta de construção. Copie, cole, responda com honestidade.
Prompt 1 · A entrevista que escava a dor
“Você é um entrevistador experiente em descoberta de produto. Vou descrever um problema do meu trabalho. Sua tarefa: me entrevistar, uma pergunta por vez, até o problema estar claro. Escave: quem sofre, o que acontece exatamente, o que custa, o que já foi tentado. Se eu te der uma solução em vez de um problema, aponte e me traga de volta ao problema. No final, escreva um Problem Statement de um parágrafo e liste separadamente o que eu afirmei com evidência e o que é hipótese minha.”
Prompt 2 · O confronto
“Aqui está meu Problem Statement e minha lista de funcionalidades. Faça o papel de cético construtivo: quais das minhas afirmações são hipóteses disfarçadas de fatos? Que solução mais simples que a minha resolveria 80% da dor? O que alguém já deve ter tentado antes de mim, e por que teria falhado?”
Prompt 3 · O corte
“Aqui está minha lista de funcionalidades. Ajude a classificar em Must, Should e Could com uma restrição inegociável: Must não pode passar de 40% dos itens. Para cada candidato a Must, pergunte: sem isso, o sistema prova o conceito de ponta a ponta? Proponha também 3 non-goals que eu deveria declarar por escrito.”
Prompt 4 · O tradutor de requisitos
“Transforme cada item Must abaixo em um requisito com critério verificável: uma frase que uma pessoa de fora consiga testar e responder ‘pronto’ ou ‘não pronto’ sem me perguntar nada. Aponte os itens em que eu descrevi um desejo em vez de um comportamento observável.”
Prompt 5 · A revisão final do PRD
“Aqui está meu PRD completo. Revise como um engenheiro sênior que vai receber este documento: o que está ambíguo? Que decisão eu empurrei para a construção em vez de tomar agora? Que pergunta um construtor faria no primeiro dia que este documento não responde? Não elogie; aponte furos.”