Help us improve
Share bugs, ideas, or general feedback.
From mercadona-user-story-toolkit
Transforms GSD (Get Shit Done) planning artifacts into a synthetic PRD file, mapping sections from PROJECT.md, REQUIREMENTS.md, ROADMAP.md, and phase specs, while marking gaps GSD doesn't cover.
npx claudepluginhub josemerca/mercadona-user-story-toolkitHow this skill is triggered — by the user, by Claude, or both
Slash command
/mercadona-user-story-toolkit:gsd-to-prdThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Asiste al usuario en transformar los artefactos generados por GSD en un PRD sintético, marcando explícitamente los gaps que GSD no cubre.
Generates Product Requirements Document (PRD) by analyzing project README, documentation, structure, and metadata. Use for onboarding existing projects to Blueprint Development system.
Manages PRD lifecycle: applies naming conventions, maintains directory structure, enforces status transitions, links PRDs to tasks, runs quality checks, and automates archiving.
Generates Product Requirements Documents (PRDs) from initiative descriptions via analysis of user problems, success metrics, scope boundaries, and user stories. Useful for defining product scope and features.
Share bugs, ideas, or general feedback.
Asiste al usuario en transformar los artefactos generados por GSD en un PRD sintético, marcando explícitamente los gaps que GSD no cubre.
Filosofía: El PRD generado es fiel pero incompleto. GSD captura contexto, scope y fases con criterios de aceptación, pero NO captura métricas con baseline, citas cualitativas, o ROI. Esos gaps se marcan para que el PM los complete tras
/research.
┌─────────────────────────────────────────────────────────────────┐
│ │
│ GSD captura GSD NO captura │
│ ──────────── ───────────── │
│ │
│ ✅ Contexto del producto ❌ Métricas con baseline │
│ ✅ Requirements v1/v2 ❌ Citas de usuarios │
│ ✅ Out of scope ❌ ROI / aspectos financ. │
│ ✅ Fases con success criteria ❌ FAQs anticipadas │
│ ✅ Specs por fase ❌ Penumbras (cualitativo) │
│ ✅ Research previo (si lo hay) ❌ Farolas (cuantitativo) │
│ │
└─────────────────────────────────────────────────────────────────┘
GSD opera con principios falsables y testeables. el PRD opera con evidencia cualitativa y cuantitativa. El bridge respeta ambos: rellena lo que se puede mapear, marca lo que falta.
.planning/ (GSD)
│
▼
┌──────────────────────────────────────┐
│ 1. VALIDAR ARTEFACTOS │
│ - PROJECT.md (REQ) │
│ - REQUIREMENTS.md (REQ) │
│ - ROADMAP.md (REQ) │
│ - phases/N/SPEC.md (OPT) │
│ - phases/N/RESEARCH.md (OPT) │
└──────────────────────────────────────┘
│
▼
┌──────────────────────────────────────┐
│ 2. APLICAR MATRIZ DE MAPEO │
│ Ver references/mapping-table.md │
└──────────────────────────────────────┘
│
▼
┌──────────────────────────────────────┐
│ 3. RELLENAR SECCIONES MAPEABLES │
│ - 1.1 Problema (de PROJECT) │
│ - 1.4 Próximos pasos (de ROADMAP) │
│ - 2.1 Hipótesis (de SPEC.Goal) │
│ - 2.4 Dimensionamiento (ROADMAP) │
│ - 3.1 Discovery (RESEARCH si hay) │
│ - 3.2 Explore (Key Decisions) │
│ - 3.3 Funcionalidades (REQ + SPEC)│
│ - 3.4 Flujos (de SPEC si los hay) │
│ - 3.6 Exclusiones (REQ Out-Scope) │
└──────────────────────────────────────┘
│
▼
┌──────────────────────────────────────┐
│ 4. MARCAR GAPS EXPLÍCITOS │
│ - 1.2 Farolas → ⚠️ GAP │
│ - 1.3 Penumbras → ⚠️ GAP │
│ - 2.2 Aspectos financieros → ⚠️ │
│ - 2.3 Métricas baseline→target ⚠️│
│ - 3.5 FAQs → ⚠️ GAP │
└──────────────────────────────────────┘
│
▼
┌──────────────────────────────────────┐
│ 5. GENERAR prd-from-gsd.md │
│ - Header con metadata origen │
│ - 14 secciones (rellenas+gaps) │
│ - Footer con resumen+next steps │
└──────────────────────────────────────┘
│
▼
PRD sintético listo para /prd-quality-guard
# Default: .planning/ en el directorio actual
PLANNING_DIR="${1:-./.planning/}"
# Requeridos
test -f "$PLANNING_DIR/PROJECT.md" || exit "PROJECT.md no encontrado"
test -f "$PLANNING_DIR/REQUIREMENTS.md" || exit "REQUIREMENTS.md no encontrado"
test -f "$PLANNING_DIR/ROADMAP.md" || exit "ROADMAP.md no encontrado"
# Opcionales (enriquecen el PRD pero no son obligatorios)
ls "$PLANNING_DIR/phases/"*/SPEC.md 2>/dev/null
ls "$PLANNING_DIR/phases/"*/RESEARCH.md 2>/dev/null
test -f "$PLANNING_DIR/STATE.md" # solo informativo
Si falta un requerido → mensaje claro al usuario y stop.
Leer los ficheros completos. Para cada uno extraer las secciones canónicas:
PROJECT.md → secciones: ## What This Is, ## Core Value, ## Context, ## Constraints, ## Key Decisions
REQUIREMENTS.md → ## v1 Requirements, ## v2 Requirements, ## Out of Scope, ## Traceability
ROADMAP.md → ## Phases, ### Phase N (Goal, Success Criteria, Plans)
phases/N/SPEC.md → ## Goal, ## Background, ## Requirements, ## Boundaries, ## Acceptance Criteria
phases/N/RESEARCH.md → contenido completo (referencia, no se duplica)
Ver references/mapping-table.md para la tabla deterministica completa. Resumen:
| Sección PRD | Origen GSD primario | Fallback |
|---|---|---|
| 1.1 Problema | PROJECT.md "What This Is" + "Context" | — |
| 1.2 Farolas | ⚠️ GAP | (PM tras /research) |
| 1.3 Penumbras | ⚠️ GAP | (PM tras /research) |
| 1.4 Próximos pasos | ROADMAP fases pendientes | PROJECT.md "Active" |
| 2.1 Hipótesis | phases/1/SPEC.md "Goal" + "Background" | PROJECT.md "Core Value" |
| 2.2 Aspectos Financieros | ⚠️ GAP | (PM debe estimar) |
| 2.3 Métricas | ROADMAP "Success Criteria" (cualitativo) + ⚠️ GAP cuantitativo | — |
| 2.4 Dimensionamiento | ROADMAP fases + Plans count | — |
| 3.1 Discovery | phases/N/RESEARCH.md (si existe) | ⚠️ GAP si no hay |
| 3.2 Explore | PROJECT.md "Key Decisions" | ⚠️ GAP si vacío |
| 3.3 Funcionalidades | REQUIREMENTS v1 + phases/N/SPEC.Requirements | — |
| 3.4 Flujos de Usuario | phases/N/SPEC.md (si describe flujos) | ⚠️ GAP |
| 3.5 FAQs | ⚠️ GAP | (PM debe añadir) |
| 3.6 Exclusiones | REQUIREMENTS "Out of Scope" + SPEC "Out of scope" | — |
Usar la plantilla de references/prd-synthetic-template.md. Para cada sección:
> Origen: PROJECT.md §What This Is)⚠️ GAP con instrucciones claras de qué falta y cómo completarloFormato compact:
✓ PRD sintético generado: prd-from-gsd.md
Secciones rellenas desde GSD: [N]
Secciones marcadas como GAP: [M]
GAPs típicos a completar tras /research:
- 1.2 Farolas (cuantitativo)
- 1.3 Penumbras (cualitativo, citas)
- 2.2 Aspectos Financieros (ROI)
- 2.3 Métricas (baseline → target)
- 3.5 FAQs
Siguiente paso:
1. Revisar prd-from-gsd.md (en raíz del proyecto)
2. Ejecutar /prd-quality-guard prd-from-gsd.md
3. Si PASS → /research source_type=PRD
Nota: Los GAPs no impiden el quality gate, pero el score subirá
si los completas antes de research.
> Origen: ...).planning/phases/01-foo/, phases/02-bar/) se procesan en orden numéricoSTATE.md se lee pero solo se usa para añadir metadata "última fase ejecutada" al header del PRD