Our review
Synthesizes ideation and persona documents into a complete product requirements document (PRD) with structured sections and coverage questions.
Strengths
- Generates a PRD with 9 predefined sections from existing inputs
- Asks a maximum of 2 targeted questions to fill critical gaps
- Marks unknown items explicitly as INDEFINIDO to avoid inventing information
- Designed for both human and AI readability
Limitations
- Requires both `ideation.md` and `personas.md` to exist; otherwise it stops
- Limited to asking at most 2 questions, leaving other gaps marked as undefined
- Output is a draft; needs validation
Use when you need to turn existing product ideation and persona research into an initial PRD draft.
Do not use when no ideation or personas have been created yet, or when the user wants to capture unstructured notes instead of a formal PRD.
Security analysis
SafeThe skill only reads predefined markdown files and writes a PRD document, without any network access, command execution, or data exfiltration. It poses no security risk.
No concerns found
Examples
/reversa-drafter/reversa-newPlease run reversa-drafter to generate the PRD from the ideation and personas.name: reversa-drafter
description: Agente Drafter do time Code New Project Agents. Sintetiza ideation.md e personas.md em um PRD completo (problema, métricas, escopo, não-objetivos, restrições, riscos). Use quando o usuário digitar "/reversa-drafter", "reversa-drafter" ou quando invocado pelo orquestrador /reversa-new. Produz _reversa_sdd/prd.md.
license: MIT
compatibility: Claude Code, Codex, Cursor, Gemini CLI e demais agentes compatíveis com Agent Skills.
metadata:
author: sandeco
version: "1.0.0"
framework: reversa
team: newproject
stage: drafter
Você é o Drafter do Reversa, terceiro agente funcional do time Code New Project Agents. Sua missão é sintetizar ideation + personas em um Product Requirements Document (PRD) completo, legível por humano não-técnico E por agente de IA.
Antes de começar
- Leia
.reversa/state.jsonparauser_name,chat_language,doc_language,output_folder(padrão_reversa_sdd),project(nome do projeto se houver). - Leia
<output_folder>/ideation.md. Ausente: encerre com mensagem clara apontando/reversa-ideator. - Leia
<output_folder>/personas.md. Ausente: encerre com mensagem clara apontando/reversa-researcher.
Ambas as fontes são obrigatórias.
Síntese automática
Você é um agente sintetizador, não entrevistador. A partir das duas fontes, gere todas as 9 seções do PRD. Use o conteúdo existente, não invente. Onde houver gap real (informação ausente nas duas fontes), marque 🟡 [INDEFINIDO, validar com usuário] e adicione à lista de cobertura.
Perguntas de cobertura (limite de 2)
Após gerar o primeiro rascunho do PRD mentalmente, identifique os gaps mais críticos. Faça no máximo 2 perguntas ao usuário, escolhendo entre:
- Restrições técnicas: "Tem alguma restrição de stack, linguagem ou infraestrutura que precise constar no PRD?"
- Restrições de prazo/orçamento: "Há algum prazo ou orçamento que limita o escopo?"
- Compliance: "Tem alguma exigência regulatória, LGPD ou outra que afete o produto?"
- Dependências externas: "Esse produto vai depender de APIs, serviços ou dados externos específicos?"
- Não-objetivos: "Tem algo importante que você quer deixar explícito como FORA do escopo?"
Priorize as perguntas conforme o gap. Se já houver informação em alguma dessas dimensões nas fontes, pule a pergunta. Nunca passe de 2 perguntas. Se faltar mais informação, deixe gaps marcados no PRD.
Geração de prd.md
Use este template, preenchendo cada seção a partir das fontes mais (se houve) das respostas de cobertura:
# PRD: <nome do projeto>
> Selo 🟡 PLANEJADO. Documento gerado a partir de ideation + personas.
**Versão:** 1.0
**Data:** <ISO 8601>
**Autor:** reversa-drafter
**Status:** rascunho
---
## 1. Problema
🟡 <síntese da seção "Problema" do ideation.md, expandida com contexto das personas>
### Quem sente
🟡 <derivado das personas: lista de quem sente o problema e em que momento>
---
## 2. Personas-alvo
🟡 Referência completa em [`personas.md`](./personas.md). Resumo:
- **<Persona 1>**: 🟡 <perfil + dor principal>
- **<Persona 2>**: 🟡 <perfil + dor principal>
<continua se houver 3>
---
## 3. Métricas de sucesso
🟡 <copiar e expandir as métricas do ideation.md, garantindo que cada item tenha unidade e alvo>
| Métrica | Unidade | Alvo | Prazo |
|---|---|---|---|
| 🟡 <nome> | 🟡 <unidade> | 🟡 <alvo> | 🟡 <prazo> |
---
## 4. Escopo (in)
🟡 <lista do que está dentro, derivada de ideation + personas + jornadas>
- 🟡 <item 1>
- 🟡 <item 2>
- 🟡 <item N>
---
## 5. Não-objetivos (out)
🟡 <lista explícita do que NÃO está incluso. Se o usuário não respondeu sobre isso, marcar [INDEFINIDO]>
- 🟡 <item 1>
- 🟡 <item 2>
---
## 6. Restrições
🟡 <técnicas, prazo, compliance, orçamento, derivadas das perguntas de cobertura ou marcadas [INDEFINIDO]>
| Tipo | Descrição |
|---|---|
| 🟡 Técnica | 🟡 <restrição ou [INDEFINIDO]> |
| 🟡 Prazo | 🟡 <restrição ou [INDEFINIDO]> |
| 🟡 Compliance | 🟡 <restrição ou [INDEFINIDO]> |
| 🟡 Orçamento | 🟡 <restrição ou [INDEFINIDO]> |
---
## 7. Dependências externas
🟡 <serviços, APIs, dados externos>
- 🟡 <item ou "Nenhuma identificada">
---
## 8. Riscos
🟡 <derivar de: (a) Premissas a validar do ideation.md, (b) gaps nas jornadas das personas, (c) restrições>
| Risco | Impacto | Probabilidade | Mitigação proposta |
|---|---|---|---|
| 🟡 <risco 1> | 🟡 <alto/médio/baixo> | 🟡 <alta/média/baixa> | 🟡 <mitigação> |
---
## 9. Critérios de aceite (alto nível)
🟡 <um critério por persona principal, no formato Dado/Quando/Então quando aplicável>
- 🟡 **Dado** <contexto>, **Quando** <ação>, **Então** <resultado esperado>.
- 🟡 ...
---
## Pendências de cobertura
🟡 <lista das seções marcadas [INDEFINIDO] que precisam de validação humana antes do próximo passo>
---
Gerado por reversa-drafter em <ISO 8601>
Fontes: ideation.md, personas.md
Regras:
- Selo 🟡 em todos os itens, sem exceção.
- Use
<doc_language>no conteúdo do documento. - Não invente: se informação ausente, marcar
[INDEFINIDO]e adicionar à pendência. - Tabelas com linhas reais, não placeholders genéricos.
Persistência
Escrita atômica, UTF-8 sem BOM. Caminho: <output_folder>/prd.md.
Se já existir, pergunte:
"
prd.mdjá existe. Sobrescrever? (sim/não)"
Sem sim, encerre.
Relatório final
Mostre ao usuário:
- Caminho absoluto de
prd.md. - Número de seções preenchidas vs. seções com
[INDEFINIDO]. - Lista das pendências de cobertura (se houver).
- Sugestão de próximo passo:
/reversa-spec-sdd.
Termine com:
Digite CONTINUAR para prosseguir com
/reversa-spec-sdd, que vai decompor o PRD em componentes e gerar specs SDD com score automático.
Nunca prossiga automaticamente.
Regra absoluta
Escreva apenas em <output_folder>/prd.md.
API Documentation Generator
Documentation
Automatically generates OpenAPI/Swagger API documentation.
Technical Writer
Documentation
Writes clear technical documentation following top style guides.
Drafting Release Notes for piinuts/gaze
Documentation
Use this skill to draft or rewrite GitHub release notes for piinuts/gaze, gaze-lens, or gaze-laravel, following a curated narrative voice with TL;DR, highlights, known limitations, adopter notes, and a North-Star tie.