prd-quality-guard

PRD Quality Guard v1.0 — Quality Gate para PRDs

Asiste al usuario en evaluar la calidad de un PRD y determinar si tiene la profundidad suficiente para pasar a research.

Modo copiloto: Esta skill diagnostica y señala gaps del PRD, pero NO completa ni reescribe secciones por el usuario. Propone preguntas para completar lo que falta. Ver shared-config.md §Filosofía del Plugin.

"Un buen PRD define con precisión el problema (EAC) y la dirección (EFC). El research valida si lo que creemos saber es cierto."

Principio Fundamental

┌──────────────────────────────────────────────────────────────────┐
│                                                                   │
│   EAC (Estado Actual Conocido)       EFC (Estado Futuro Conocido)│
│   ────────────────────────           ────────────────────────────│
│                                                                   │
│   ✅ Problema con evidencia          ✅ Hipótesis de solución     │
│   ✅ Farolas (datos cuantitativos)   ✅ Métricas medibles        │
│   ✅ Penumbras (observaciones)       ✅ Impacto dimensionado     │
│   ✅ Discovery realizado             ✅ Funcionalidades claras   │
│   ✅ FAQs / Exclusiones              ✅ Flujos de usuario        │
│                                                                   │
│   ❌ NO vagas ("necesitamos          ❌ NO métricas sin          │
│       mejorar...")                        baseline/target          │
│   ❌ NO soluciones en el problema    ❌ NO features sin usuario   │
│   ❌ NO adjetivos sin datos          ❌ NO scope sin exclusiones  │
│                                                                   │
└──────────────────────────────────────────────────────────────────┘

---

Ver SKILL-reference.md §S1 para estructura completa de secciones del PRD (14 secciones, tipos y contenido)

---

Flujo de Evaluación

PRD (fichero, URL o contenido pegado)
    │
    ▼
┌──────────────────────────────────────┐
│  1. CARGAR PRD                        │
│     - Leer fichero local (Read tool)  │
│     - Fetch URL pública (WebFetch)    │
│     - O contenido pegado por usuario  │
└──────────────────────────────────────┘
    │
    ▼
┌──────────────────────────────────────┐
│  2. INVENTARIO DE SECCIONES           │
│     - Escanear todas las secciones    │
│     - Marcar estado por sección       │
│     - Detectar secciones faltantes    │
└──────────────────────────────────────┘
    │
    ▼
┌──────────────────────────────────────┐
│  🗣️ CHECKPOINT 1: POST-INVENTARIO    │
│     Comunicar estado al usuario       │
│     Ofrecer opciones de continuación  │
└──────────────────────────────────────┘
    │
    ▼
┌──────────────────────────────────────┐
│  3. SCORING 3 DIMENSIONES             │
│     D1: Completitud EAC (0-10)        │
│     D2: Claridad EFC + Métricas       │
│     D3: Rigor Discovery + Scope       │
│     Global = Promedio(D1, D2, D3)     │
└──────────────────────────────────────┘
    │
    ▼
┌──────────────────────────────────────┐
│  4. DETECCIÓN ANTIPATRONES            │
│     AP-PRD-1 a AP-PRD-5              │
└──────────────────────────────────────┘
    │
    ▼
┌──────────────────────────────────────┐
│  5. GATE DECISION                     │
│     ≥7 → PASS (proceder a research)  │
│     5-6 → CONDICIONAL                │
│     <5 → FAIL                         │
│     D3 < 5 → FAIL automático         │
└──────────────────────────────────────┘
    │
    ▼
┌──────────────────────────────────────┐
│  6. REPORTE DE CALIDAD                │
│     Leer report-template-prd.md       │
│     Generar reporte completo          │
│     Incluir recomendaciones           │
└──────────────────────────────────────┘
    │
    ▼
GATE DECISION → PASS / CONDICIONAL / FAIL