Como escrever um PRD para IA de código (com prompt)

O que é um PRD e por que ele ajuda a IA

PRD vem de product requirements document (documento de requisitos do produto): um texto curto que descreve que produto você quer, o que ele deve fazer e o que fica de fora. Em uma equipe, ele garante que todos entendam a mesma coisa antes de alguém escrever código.

O mesmo vale quando você trabalha com uma IA de código. Se você pede “um app de tarefas”, ela preenche cada lacuna com as próprias suposições. Um PRD claro reduz essas suposições, dá a você um critério para conferir o resultado e serve de referência toda vez que você começa uma nova conversa.

As seções que um PRD deve ter

• Objetivo: o problema que o produto resolve, em uma ou duas frases.
• Usuários: quem vai usá-lo e em que situação.
• Funções: o que ele deve fazer, por ordem de prioridade (indispensável, desejável, para depois).
• Telas ou fluxos: o que o usuário vê e faz, passo a passo.
• Regras e limites: o que nunca pode acontecer, como um usuário ver os dados de outro.
• Dados: quais informações são guardadas e quais campos são obrigatórios.
• Critérios de aceitação: como você vai conferir que cada função está pronta.
• Fora do escopo: o que você não vai construir nesta versão.

A seção mais útil e mais esquecida é a de “fora do escopo”. Sem ela, as ferramentas de IA costumam acrescentar funções que você nunca pediu.

Critérios de aceitação: a parte que você mais vai sentir

Um critério de aceitação é uma afirmação que dá para conferir com um sim ou um não. “O formulário é fácil de usar” não é um. “Se o e-mail não for válido, aparece uma mensagem de erro e o formulário não é enviado” é.

• Escreva cada um como uma situação e um resultado: “Dado X, quando Y, então Z.”
• Cubra também os casos de erro, não só o caminho feliz.
• Procure ter pelo menos dois ou três critérios por função importante.

Um prompt para redigir o PRD com IA

Você não precisa escrever o PRD do zero. Conte a ideia a uma IA e deixe que ela entreviste você. Depois, revise o resultado por conta própria: a IA propõe, mas as decisões são suas.

Atue como um gerente de produto com experiência em pequenos produtos digitais.

Quero escrever um PRD para esta ideia: [descreva o seu produto em duas ou três frases].

Usuário principal: [quem é].

Antes de escrever qualquer coisa, me faça as perguntas que precisar, uma de cada vez, até que o objetivo, as funções principais e o que fica fora do escopo estejam claros.

Quando tiver informações suficientes, redija o PRD com estas seções: objetivo, usuários, funções por prioridade, telas ou fluxos, regras e limites, dados, critérios de aceitação (no formato “dado, quando, então”) e fora do escopo.

Não invente requisitos que eu não tenha informado. Se algo estiver faltando, marque como “a definir”.

Como usar o PRD com uma ferramenta de código

Não cole um PRD longo esperando que tudo saia certo de primeira. Use-o como um mapa e construa por partes.

• Guarde o PRD como um arquivo no projeto para tê-lo sempre à mão.
• Peça primeiro um plano de construção em etapas e revise-o antes de gerar qualquer código.
• Implemente uma função por vez, com os respectivos critérios de aceitação.
• Ao terminar cada uma, confira os critérios um por um.
• Se mudar de ideia, atualize primeiro o PRD e só depois peça a alteração.

Este é o PRD do meu projeto:

[cole aqui o PRD]

Implemente somente esta função: [nome da função].

Ela deve cumprir estes critérios de aceitação: [lista de critérios].

Não acrescente nada do que está em “fora do escopo”. Quando terminar, explique quais arquivos você alterou e como posso conferir cada critério.

Erros comuns ao escrever um PRD

• Escrever desejos em vez de requisitos verificáveis (“deixe intuitivo”).
• Misturar ideias demais: um PRD, um produto, uma versão.
• Deixar as prioridades de fora, de modo que a IA trate tudo como igualmente importante.
• Esquecer os dados pessoais: se você guarda informações sobre usuários, decida o que mantém e por quê, e consulte em fontes oficiais as regras de proteção de dados que valem para você.
• Não atualizar o documento quando o projeto muda.

Do formulário ao PRD com um modelo

O modelo do PromptNow para PRDs de IA de código pergunta o seu produto, os usuários e as funções em um formulário e gera um prompt pronto para colar com a estrutura acima. Ele poupa você da página em branco, mas o conteúdo continua sendo seu e merece revisão.

Se você não tem certeza do que entra na primeira versão, comece pelo modelo para definir o MVP do seu app e use o resultado como base do PRD.