Goal
Producir un PRD.md listo para alimentar diseño técnico o implementación, recorriendo una
sección a la vez junto al usuario. A diferencia de la skill generar-prd (light, una sola
pasada), esta skill:
- Entrevista antes de escribir cada sección — no asume, no rellena con placeholders.
- Presenta alternativas con trade-offs en las secciones donde hay una decisión real (cómo enmarcar el problema, cómo definir éxito, qué entra en alcance, etc.).
- Marca supuestos del agente con
<!-- REVISAR: ... -->para que el humano los valide durante la revisión. - Escribe
PRD.mdal final, después de que las 8 secciones estén validadas — no antes.
El output es un PRD que el usuario puede defender, no un draft opaco que tenga que reescribir.
Activation Contract
Usar esta skill cuando el usuario pida explícitamente un PRD guiado, paso a paso, o cuando
arranque con frases como "armemos un PRD", "quiero definir bien este producto antes de
codear", "necesito un spec de producto conversado". Si el usuario solo quiere un draft rápido
para arrancar, usar la skill light generar-prd.
Hard Rules
- Recorrer las 8 secciones en el orden del template. No saltear secciones, no reordenarlas.
- Antes de escribir cada sección, esperar la respuesta del usuario. Una sección escrita sin input del usuario es un failure mode de esta skill — equivale a volver al modo light.
- No inventar el problema, el usuario o el outcome. Si el usuario no los tiene claros, ayudar a descubrirlos con preguntas — nunca asumirlos.
- Marcar toda suposición del agente con
<!-- REVISAR: ... -->inline. El PRD debe ser revisable, no presentable como terminado. - Las alternativas deben ser realmente viables for the project in question — not textbook options that dismiss the decision without presenting it.
- Si el usuario cierra la conversación a mitad de flujo, guardar progreso parcial en
PRD.mdcon las secciones validadas y el resto marcado como<!-- PENDIENTE -->.
Decision Gates
| Situación | Acción |
|---|---|
| Usuario pide un draft rápido | Usar generar-prd (light), no esta skill |
| Usuario tiene idea pero no problema claro | Saltar a la sección Problema y ayudar a descubrirlo con preguntas, no avanzar a la siguiente |
| Usuario tiene todo claro y quiere ir rápido | Aceptar respuestas cortas — no obligar a expandir si la respuesta es suficiente |
| Sección con decisión real (problema, éxito, alcance) | Presentar 2-3 alternativas con trade-offs antes de aceptar la respuesta |
| Sección con captura (supuestos, casos borde) | 1-2 preguntas de profundización, sin alternativas |
| Usuario ya tiene un PRD y quiere revisarlo | No usar esta skill — pedirle que abra PRD.md existente y revisarlo juntos sección por sección |
Workflow
Antes de empezar, confirmar que el usuario quiere el flujo conversacional. Si confirma, recorrer las 8 secciones en orden, una por turno. Para cada sección:
- Abrir: enunciar por qué importa esa sección en 1 línea, sin tutorial.
- Profundizar: 1-3 preguntas concretas. Si la sección tiene decisión real, presentar
2-3 alternativas con trade-offs antes de la pregunta. Ver guía en
references/secciones-guia.md. - Validar: confirmar que entendiste (1 línea parafraseando) y preguntar si quiere ajustar antes de cerrar.
- Cerrar: registrar la respuesta y avanzar a la siguiente sección. No acumular — el PRD se va construyendo en la cabeza del usuario a medida que avanza.
Las 8 secciones, en orden, con el tipo de interacción esperado:
| # | Sección | Tipo | Alternativas? |
|---|---|---|---|
| 1 | Problema | Decisión real (encuadre) | Sí |
| 2 | Usuario objetivo | Decisión real (segmento) | Sí |
| 3 | Objetivo / resultado esperado | Decisión real (outcome vs output) | Sí |
| 4 | Alcance | Decisión real (frontera) | Sí |
| 5 | No alcance | Captura con anti-patrones | No |
| 6 | Criterios de éxito | Decisión real (qué medir) | Sí |
| 7 | Casos borde | Captura | No |
| 8 | Supuestos y riesgos | Captura | No |
Cuando las 8 secciones estén validadas:
- Ensamblar
PRD.mdusandoassets/prd-template.md— copiar el template tal cual, sin modificar estructura ni títulos. - Llenar cada sección con la respuesta validada. Si quedó algún supuesto implícito del
agente, marcarlo con
<!-- REVISAR: ... -->. - Escribir a disco en
PRD.md(root del proyecto), salvo que el usuario indique otra ruta. - Cerrar con un recordatorio: el PRD es un borrador estructurado — la revisión real (ambigüedades, números, bordes) sigue siendo del humano.
Quality Gate
Antes de cerrar, verificar silenciosamente:
- Las 8 secciones están presentes. Ninguna vacía — al menos un bullet/idea aunque sea mínima.
- "No alcance" tiene al menos una exclusión explícita (no "todo lo no mencionado arriba").
- Los criterios de éxito son verificables, no adjetivos sin ancla medible.
- Toda suposición del agente está marcada con
<!-- REVISAR: ... -->. - Si se cerró antes de completar todas las secciones, las restantes están marcadas
<!-- PENDIENTE -->en el archivo.
References
assets/prd-template.md— template literal, no modificar. Idéntico al degenerar-prd.references/secciones-guia.md— guía de profundización por sección: preguntas concretas, alternativas con trade-offs, anti-patrones y ejemplos de respuestas buenas vs malas.