| name | us-to-prd |
| version | 1.0.1 |
| description | Converte User Stories brutas em um PRD estruturado com objetivo, escopo, restricoes e requisitos funcionais numerados. Use como etapa anterior ao create-prd quando a entrada for historias de usuario (formato "Como <persona>, quero <acao>, para <valor>"). Nao use para criar PRDs a partir do zero sem historias de usuario. |
User Stories para PRD
Procedimentos
Etapa 1: Receber e analisar as User Stories
- Confirmar que o contrato de carga base definido em
AGENTS.md foi cumprido.
- Coletar todas as User Stories fornecidas (formato livre ou "Como/Quero/Para").
- Identificar personas, acoes e valores de negocio em cada historia.
- Agrupar historias por tema ou modulo funcional.
- Listar ambiguidades e lacunas que precisam de esclarecimento antes de prosseguir.
Etapa 2: Derivar requisitos funcionais
- Converter cada historia em um ou mais requisitos funcionais (RF-nn).
- Numerar sequencialmente a partir de RF-01.
- Cada RF deve ser: atomico, testavel, sem detalhes de implementacao.
- Identificar criterios de aceite para cada RF.
Etapa 3: Estruturar o PRD
- Redigir as secoes: Objetivo, Escopo, Restricoes, Usuarios-alvo, Requisitos Funcionais.
- Adicionar secao de Requisitos Nao-Funcionais quando identificados nas historias.
- Incluir a lista original de User Stories como apendice para rastreabilidade.
- Salvar em
.specs/<slug-feature>/prd.md.
Etapa 4: Validar com o solicitante
- Apresentar o PRD gerado para revisao.
- Destacar suposicoes feitas na conversao de historias para requisitos.
- Aguardar aprovacao antes de prosseguir com
create-technical-specification.
Tratamento de Erros
- Se as historias forem incompletas ou contraditórias, listar os conflitos e perguntar antes de converter.
- Se uma historia nao tiver valor de negocio claro, marcar como
RF pendente e pedir esclarecimento.
- Nao inferir requisitos tecnicos (ex: "usar PostgreSQL") a partir de historias que nao mencionam tecnologia.
