Stats
Actions
Tags
Help us improve
Share bugs, ideas, or general feedback.
From mercadona-user-story-toolkit
Designs structured user research in 6 blocks (Purpose, Plan, Criteria, Analysis, Conclusions, Next Steps) using JTBD framework and Mom Test/Field Study. Accepts PRD input; outputs JTBDs. Triggers: interview prep, note analysis, gap detection.
npx claudepluginhub josemerca/mercadona-user-story-toolkitHow this skill is triggered — by the user, by Claude, or both
Slash command
/mercadona-user-story-toolkit:research-from-prdThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Pieza central del pipeline →Stories. Asiste al usuario en estructurar el research como un proceso de descubrimiento riguroso: 6 bloques que garantizan que pasamos del problema a JTBDs con evidencia real, sin saltar pasos ni inventar conclusiones.
Researches open questions via parallel subagents on prior art, constraints, competitors. Categorizes queries, synthesizes findings, updates PRDs. Ideal before tech planning.
Designs complete user interview research packages including brief, screener, guide, and analysis framework for discovery, switch, contextual inquiry, and evaluative interviews.
Guides product discovery through 10 phases to produce a structured PRD with Mermaid wireframes, journeys, and architecture diagrams. Use for idea validation, PRD creation, or product shaping.
Share bugs, ideas, or general feedback.
Pieza central del pipeline →Stories. Asiste al usuario en estructurar el research como un proceso de descubrimiento riguroso: 6 bloques que garantizan que pasamos del problema a JTBDs con evidencia real, sin saltar pasos ni inventar conclusiones.
Modo copiloto: Esta skill diseña y propone planes de research, pero NO sustituye el research real. Las conclusiones se basan en evidencia recogida por el usuario, NUNCA inventada. Si el usuario no ha hecho entrevistas, el output son planes y guías de entrevista — no JTBDs inventados. Ver shared-config.md §Filosofía del Plugin.
Tres capas: Proceso (6 bloques) + Lente (JTBD: foco en el TRABAJO, 3 dimensiones F/E/S) + Técnica (Mom Test + Field Study). El JTBD no es un paso — es la lente que atraviesa TODO.
Ver SKILL-reference.md §1 para diagrama completo, tabla comparativa por bloque y antipatrón clave.
Flujo: prd-quality-guard → Preparación → B1 Propósito → B2 Plan → B3 Criterios → [Ejecución] → B4 Análisis → B5 Conclusiones → B6 Next Steps → jtbd-to-stories → quality-coach.
Ver SKILL-reference.md §2 para diagrama completo del pipeline.
Cuándo ejecutar: SIEMPRE, como primer paso antes de los 6 bloques.
references/gap-detection-prd.md(Críticos × 10) + (Mayores × 5) + (Menores × 2) + (Refinamiento × 1). Cálculo determinista: python3 scripts/gap_score.py --criticos=<N> --mayores=<N> --menores=<N> --refinamiento=<N>Si el PRD viene de /from-gsd y el proyecto GSD tiene phases/N/RESEARCH.md, esa evidencia se incorpora al inventario. Pasar al comando --evidence-from=.planning/phases/N/RESEARCH.md para evitar duplicar entrevistas ya hechas.
Gaps de proceso/contexto (EAC del PRD) → resolver con stakeholder/PM. Gaps de producto/usuario (EFC y Discovery del PRD) → SON el foco del research. Gaps críticos BLOQUEAN hasta resolverse.
Ver SKILL-reference.md §15 para output template de Preparación y tabla completa de gaps vs resolución.
Objetivo: Definir qué queremos entender y en qué contexto real. Delimitar el problema.
Regla: El propósito SIEMPRE se formula en términos del TRABAJO que el usuario intenta lograr.
Elementos: Job Performer (de EAC) + Proceso real (de EAC) + Foco (gaps) + Delimitación (de Exclusiones del PRD).
Output: Propósito (1-2 párrafos) + Job Performer + Proceso + Foco + Delimitación.
Ver SKILL-reference.md §16 para antipatrones del propósito. §4 para template completo.
Objetivo: Diseñar plan dual: observación conductual (lo que HACEN) + entrevista actitudinal (lo que PIENSAN).
Referencia: references/prd-to-interview-mapping.md
Observación valida si lo que el usuario DICE coincide con lo que HACE. Workarounds = señal más fuerte de job mal servido.
Elementos: Qué observar (comportamientos, workarounds) | Dónde (entorno real) | Cómo registrar (hechos vs interpretaciones) | Duración (30-60 min silenciosa).
Ver SKILL-reference.md §17 para template completo del plan de observación con checklist de campo.
Referencia: references/mom-test-principles.md
Modo Descubrir (Discovery vacío/parcial): Warm-up (3-5min) → Su vida/JTBD (10-12min) → Comportamiento actual (8-10min) → Deep dive gaps (8-10min) → Cierre (3min).
Modo Validar (Discovery con JTBDs): Warm-up (3min) → Su vida (8-10min) → Validación JTBD (8-10min) → Exploración abierta (5-8min) → Cierre (3min).
Regla anti-sesgo (Modo Validar): El guión NUNCA debe mencionar, sugerir ni insinuar los JTBDs del Discovery. Si un JTBD NO se confirma, es un hallazgo VALIOSO.
Ver SKILL-reference.md §18 para mapeo PRD→Preguntas y justificación del método.
Output: Plan de observación + Guión de entrevista + Justificación (método, perfil, muestra).
Ver SKILL-reference.md §5 para template completo.
Objetivo: Convertir el propósito en 2-4 preguntas verificables como METRO del research.
Regla: Criterios orientados a componentes JTBD (trigger, struggle, desired outcome, motivaciones F/E/S).
Estructura: Criterio [N]: [Pregunta] + Componente JTBD + Cómo verificar + Umbral mínimo. Reglas: CR-1 Max 4 | CR-2 Mapea a JTBD | CR-3 Umbral claro | CR-4 Verificable | CR-5 Anti-scope-creep.
Output: Tabla criterios + regla anti-scope-creep.
Ver SKILL-reference.md §19 para ejemplos y reglas. §6 para template.
La skill asiste durante la ejecución proporcionando guías para observación y entrevistas.
Guía de observación: Workarounds = señal más fuerte de job mal servido. Copiar datos a mano = herramienta no sirve el job. Post-its = proceso no autoexplicativo. Pide ayuda = job complejo/social. Alterna 3+ herramientas = fragmentación.
Ver SKILL-reference.md §20 para tabla completa de señales observación→JTBD.
Guía de entrevista (Mom Test): 1) Habla de su vida, no del producto. 2) Pregunta por específicos del pasado. 3) Habla menos, escucha más. Referencia: references/mom-test-principles.md.
Ver SKILL-reference.md §7 para template completo de notas de campo.
Objetivo: Procesar evidencia separando hechos de interpretaciones, por criterio de éxito. JTBDs emergen como SÍNTESIS del análisis.
Referencia: references/analysis-to-jtbd.md
Observaciones = HECHOS recogidos en campo. Aprendizajes = INTERPRETACIONES en clave JTBD. Mezclarlos es el error más común y más peligroso del research.
Ver SKILL-reference.md §21 para templates de observaciones, aprendizajes, fichas JTBD y validación cruzada.
Output: Análisis por criterio + Evaluación cobertura + Inventario JTBDs con fichas + Validación cruzada con PRD.
Objetivo: Síntesis ejecutiva — alguien que no estuvo "se entera de la peli" en 2 minutos.
Reglas: CON-1 NO info nueva | CON-2 Max 2-4 bullets | CON-3 JTBDs = pieza central | CON-4 Qué del PRD se confirmó/no | CON-5 Tono informar, no recomendar.
Output: Síntesis ejecutiva (4 bullets: conclusión principal, JTBDs, validación PRD, confianza) + tabla resumen JTBDs.
Ver SKILL-reference.md §8 para template completo.
Objetivo: Decidir qué hacer después. Dos caminos: más research o pasar a Explore.
PROHIBIDO proponer soluciones. Discovery descubre PROBLEMA. Explore diseña SOLUCIÓN.
¿Todos los criterios cubiertos?
SI → ¿Todos JTBDs confianza alta? → SI: Pasar a Explore
→ NO: Explore con advertencias
NO → Más research focalizado en criterios no cubiertos
Output: Decisión + evaluación criterios + JTBDs listos o research adicional necesario.
Ver SKILL-reference.md §9 para template completo.
Primaria (criterios B3): 100% = entregar | 75%+ = advertencias | 50-74% = más research | <50% = bloquear.
Secundaria: Research Gap Score (references/gap-detection-research.md) — cobertura 7 componentes, calidad evidencia, cruce con PRD.
3 dimensiones: Cada JTBD necesita F/E/S con evidencia; si "Inferida" en todos → más research.
La skill no ejecuta todo de golpe. Pausa en momentos clave para compartir avances y permitir redirigir.
CHECKPOINT Post-Preparación + B1: Comunicar Gap Score, gaps principales, modo research, propósito. Preguntar: "¿Estamos alineados? ¿Procedo al plan?"
CHECKPOINT Post-Plan (B2 y B3): Comunicar plan (observación + entrevista), perfil, muestra, criterios de éxito. Preguntar: "¿Publico completo, revisamos, o ajustamos?"
CHECKPOINT Post-Análisis (B4): Comunicar cobertura criterios, JTBDs descubiertos. Preguntar: "¿Criterios cubiertos? ¿Procedo a conclusiones?"
Ver SKILL-reference.md §22 para templates completos de los 3 checkpoints.
Input: Preguntas + PRD de contexto.
Proceso: Leer references/mom-test-principles.md, evaluar cada pregunta contra Mom Test + contexto del PRD. Detectar: leading, pide opinión, futuro, cerrada, lenguaje del PRD, sesgo confirmación. Proponer alternativas.
Output: Tabla (original | problema | alternativa) + cobertura criterios.
Input: Notas de campo + PRD.
Ref: references/analysis-to-jtbd.md.
Proceso: 1) Por sesión: separar hechos/interpretaciones, filtrar bad data, extraer quotes, identificar workarounds. 2) Organizar por criterio B3. 3) Cruzar con PRD (Farolas, Penumbras, problemas nuevos). 4) Sintetizar JTBDs. 5) Quality Gate.
Output: Bloque 4 completo.
Fichero local, URL pública, o pegado directo en el chat. La skill no asume ninguna herramienta concreta de almacenamiento.
Ver SKILL-reference.md: §10 señales calidad | §11 cheatsheet JTBD+Mom Test | §12 antipatrones | §13 comandos | §14 changelog
references/gap-detection-prd.md — Gaps del PRDreferences/gap-detection-research.md — Gaps de evidencia researchreferences/prd-to-interview-mapping.md — Mapeo PRD → preguntasreferences/mom-test-principles.md — Mom Test + moderaciónreferences/analysis-to-jtbd.md — Observaciones → JTBDsscripts/gap_score.py, no calcularlo en el LLM.