Habilidade de Escrita de PRD (PRD Writer Skill)
Empacota o pensamento central do gerente de produto em um fluxo de trabalho executável: primeiro valide a direção, depois entregue em duas versões (Conceitual → Final); diagnóstico de três perspectivas (Usuário / Negócio / Técnica); preenche proativamente lacunas de interação, estado, dados e texto.
Estrutura de Arquivos
| Arquivo | Propósito |
|---|---|
SKILL.md (este arquivo) | Controle de acesso, modos, caminho de entrega, ordem de execução |
references/read-first.md | Leia antes de escrever, julgamento de modo, isenção da Etapa Zero |
references/diagnosis-guide.md | Diagnóstico de três perspectivas e forma do produto |
references/concept-template.md | Template da primeira versão: Documento Conceitual |
references/prd-template.md | Template da segunda versão: PRD Final (com Portão MVP) |
references/diagram-handoff.md | Mermaid vs diagram-generator |
references/product-type-appendix.md | Suplemento §7 para B2B / ToC / Site de Marketing etc. |
references/review-checklist.md | Itens de revisão para o Modo B |
references/review-output-template.md | Template do relatório de revisão para o Modo B |
references/example-prd.md | Exemplo de formato e granularidade |
references/self-check.md | Autoverificação pós-escrita |
Habilidades Relacionadas: Quando a entrada do usuário for HTML exportado do Axure ou reversão de um site online, use primeiro prototype-to-prd para fazer o levantamento, depois siga o Modo A desta habilidade para escrever a versão conceitual/final (os templates reutilizam os references/ deste diretório).
Antes de escrever o documento: Leia o arquivo references/ correspondente ao modo, depois comece a escrever.
Modo de Entrega: Quando não declarado, esta habilidade usa o modo "Padrão" (consulte "Modo de Entrega" no README; pode-se usar "Modo Rápido" para reduzir ou "Modo Estrito" para aumentar o rigor).
0. Modo de Entrega e Caminho Rápido
| Modo | Versão Conceitual | Confirmação MVP | self-check |
|---|---|---|---|
| Padrão (padrão desta habilidade) | Dois arquivos por padrão; se o usuário disser "Modo Rápido / Escrever PRD Direto / Pular Versão Conceitual" → Caminho Rápido (arquivo único) | Usa a Versão Conceitual ou os itens 🔴 da árvore de funcionalidades §4, sem confirmação oral separada | Marcar todos os itens |
| Rápido | Pular; arquivo único docs/YYYY-MM-DD-<tema>-PRD.md, com um breve resumo em ## Parte 1 · Alinhamento Conceitual | Expandir todos os itens 🔴 da §4 por padrão | Apenas itens de fluxo P0 |
| Estrito | Deve ser -conceitual.md e o usuário deve confirmar explicitamente | Confirmar oralmente N MVPs antes de escrever a §5 | Marcar todos os itens |
Gatilhos para Caminho Rápido / Redução de Modo (quando o modo Padrão é o padrão): modo rápido, escrever PRD direto, pular versão conceitual, gerar rascunho final primeiro, PRD em arquivo único.
Ordem de Execução (Controle de Acesso)
Mensagem do usuário
→ 1. read-first.md (ler docs/ e o arquivo @ do usuário)
→ 2. Etapa Zero (quando não há entrada; veja isenção abaixo)
→ 3. Identificar Modo A / B / C
→ 4. Ler template conforme o modo e escrever em docs/
→ 5. self-check.md
1. Antes de Iniciar: Leia o Material Existente
Obrigatório seguir references/read-first.md: escanear docs/, extrair fontes verdadeiras, perguntar apenas sobre lacunas, julgar o modo.
Isenção da Etapa Zero (pular perguntas iniciais e ir direto para o modo):
| Condição | Entrar em |
|---|---|
| O usuário @ / fornece um PRD completo, pedindo revisão ou melhoria | Modo B |
| O usuário especifica "apenas adicionar / apenas modificar um módulo" e já forneceu o documento | Modo C |
| Material já lido e suficiente para julgar direção e modo | Modo correspondente |
2. Etapa Zero: Adequação para esta Habilidade
Não é uma ferramenta de brainstorming; adequada para usuários que já têm uma ideia básica. Se
read-firstjá foi executado e a informação é suficiente → pule esta etapa.
Se não houver entrada utilizável, primeiro pergunte:
Antes de começarmos, você pode me contar qual é a ideia principal deste produto/funcionalidade? Mesmo que sejam apenas uma ou duas frases — que problema você quer resolver e como pretende resolvê-lo?
| Resposta do Usuário | Julgamento | Ação |
|---|---|---|
| Consegue dizer "qual problema de quem, resolvido de que forma" | ✅ | Entrar na Etapa 1 do Modo A |
| Vago mas com direção, por exemplo, "criar um app de controle de gastos" | ⚠️ | Perguntar para esclarecer a lógica central |
| Sem direção alguma, por exemplo, "me ajude a pensar em um app para fazer" | ❌ | Orientar gentilmente o usuário a pensar primeiro na dor, não escrever PRD ainda |
3. Identificar Modo
| Situação do Usuário | Modo |
|---|---|
| Tem uma ideia, ainda sem documento | A: Do zero, gerar em duas versões |
| Já tem um documento, quer revisar/melhorar | B: Avaliação + Melhoria |
| Já tem um documento, quer adicionar ou detalhar | C: Fusão Incremental |
4. Entregáveis: Formato e Caminho
| Item | Regra |
|---|---|
| Formato | Markdown; o arquivo é a referência, o chat pode ser um resumo |
| Caminho | Diretório de trabalho docs/ (criar se não existir) |
| Versão Conceitual | docs/YYYY-MM-DD-<tema>-conceitual.md |
| Versão Final | docs/YYYY-MM-DD-<tema>-PRD.md; no início, uma linha linkando para o caminho da versão conceitual |
| Relatório de Revisão | docs/YYYY-MM-DD-<tema>-PRD-revisao.md (Modo B salva por padrão) |
| Estratégia de Divisão | Por padrão, arquivos separados; se o usuário insistir em arquivo único, use ## Parte 1 · Alinhamento Conceitual (Confirmado) / ## Parte 2 · Requisitos Finais |
Exportação para Word: Este pacote de habilidade de código aberto não inclui capacidade de exportação. A exportação de um PRD em Markdown para Word (
.docx) está disponível apenas para alunos pagantes do VibePM no pacote de recursos completo; a instalação independente usa Markdown como fonte de verdade de entrega.
Metadados no início do arquivo, estrutura de seções consulte concept-template.md, prd-template.md. Consulte example-prd.md para formato.
5. Modo A: Orientação do Zero
Primeira Etapa: Diagnóstico de Três Perspectivas
Siga references/diagnosis-guide.md: Usuário / Negócio / Desenvolvimento + forma do produto; 1–2 perguntas por vez.
- Modo Rápido: Se a direção já estiver clara, comprimir em 1 rodada de resumo, sem perguntar por perspectiva
- Padrão/Estrito: Após concluir, fazer resumo oral; Estrito requer confirmação do usuário antes de escrever a versão conceitual
Segunda Etapa: Versão Conceitual
- Caminho Rápido / Modo Rápido: Pular esta etapa, ir para a Terceira Etapa (em arquivo único, escrever um resumo de direção de 8–12 linhas no início do PRD)
- Padrão / Estrito: Seguir
references/concept-template.mde escrever em-conceitual.mdÚnico propósito: Alinhar a direção. Estrito: Não escrever a §5 final até que o usuário confirme explicitamente. "Mais ou menos" não é considerado confirmação no modo Estrito; no modo Padrão, se o usuário disser "pode continuar", pode prosseguir para a versão final.
Terceira Etapa: Versão Final
Seguir references/prd-template.md e escrever em -PRD.md.
- Portão MVP: Por padrão, expandir apenas os itens 🔴 da §5; Estrito confirmar oralmente N MVPs antes de escrever; Padrão/Rápido usar os itens 🔴 da árvore de funcionalidades §4 como referência, sem perguntar novamente
- Diagramas: Seguir
references/diagram-handoff.md(Mermaid simples embutido, diagram-generator para complexos) - §7: Seguir
references/product-type-appendix.mdpara acionar suplemento
6. Modo B: Avaliação + Melhoria
Read→review-checklist.md, item por item ✅ / ❌ / ⚠️- Seguir
review-output-template.mde escrever em-PRD-revisao.md(pode não salvar em arquivo se o usuário quiser apenas conclusão no chat) - Perguntar ao usuário: completar diretamente vs. modificar por conta própria e depois reavaliar
- Completar seguindo as regras do Modo C, marcando com
【Esta Atualização】
7. Modo C: Fusão Incremental
Princípio: Fundir sem sobrescrever, atualizar sem reescrever.
- Ler o documento existente (caminho ou colagem)
- Especificar claramente o escopo de adição/modificação
- Localizar as seções afetadas (geralmente: lista de funcionalidades, fluxo do usuário §3, §5, texto)
- Fundir nas posições correspondentes; listar conflitos para o usuário decidir
- Marcar todas as alterações com
【Esta Atualização】 - Verificar consistência do fluxo, §5, lista →
self-check.md
8. Princípios Gerais
- Por Fases: Estrito — versão conceitual não confirmada → não escrever detalhes da §5 final; modo Padrão/Caminho Rápido/Rápido podem mesclar
- Três Perspectivas: Rápido pode comprimir; Estrito requer respostas básicas para todas as três perspectivas
- Preencher Lacunas: Interação, estado, dados, texto para dupla audiência — preencher proativamente, não esperar o usuário perguntar
- Dupla Audiência: Especificações para desenvolvedor/IA vs. texto para usuário final, escrever separadamente
- Fundir sem Sobrescrever: Modo C não perde o texto original
[A Preencher]Não Inventar: Marcar claramente o escopo de impacto- Diagramas e Tabelas: Fluxo do usuário em Mermaid, tabela de estados, árvore de funcionalidades, wireframe ASCII (consulte
diagram-handoff) - Ler Antes de Escrever, MVP Primeiro: Consulte
read-first, Portão MVP emprd-template - Exportação para Word: Quando o usuário solicitar exportação para Word, explicar que esta funcionalidade está disponível apenas para alunos pagantes do VibePM no pacote de recursos completo; este pacote de código aberto não utiliza
export-word, entregando Markdown como fonte de verdade.
Após escrever, obrigatoriamente passar por references/self-check.md (no modo Rápido, marcar apenas os itens P0 de "Fluxo e Controle de Acesso" e "Versão Final").