modelado-basado-escenarios
Skill especializada en modelado de escenarios para Domain Storytelling, enfocada en capturar el "happy path" (80% de casos) sin excepciones, eliminando condicionales y manteniendo numeración secuencial estricta. Útil para modelado de procesos empresariales, documentación de workflows y extracción de conocimiento estructurado de narrativas del dominio.
$ 설치
git clone https://github.com/majiayu000/claude-skill-registry /tmp/claude-skill-registry && cp -r /tmp/claude-skill-registry/skills/data/modelado-basado-escenarios ~/.claude/skills/claude-skill-registry// tip: Run this command in your terminal to install the skill
name: modelado-basado-escenarios description: Skill especializada en modelado de escenarios para Domain Storytelling, enfocada en capturar el "happy path" (80% de casos) sin excepciones, eliminando condicionales y manteniendo numeración secuencial estricta. Útil para modelado de procesos empresariales, documentación de workflows y extracción de conocimiento estructurado de narrativas del dominio.
Modelado Basado en Escenarios
Overview
Esta skill te guía en la captura y estructuración de historias de dominio enfocándote en el camino principal (happy path) sin excepciones ni variaciones. Se basa en el principio de que el 80% de los casos siguen un flujo ideal, y que documentar este flujo primero genera una base sólida para el modelado posterior.
When to Use
Usa esta skill cuando necesites:
- Capturar procesos empresariales desde la perspectiva del usuario
- Modelar workflows sin complicar con casos excepcionales
- Documentar flujos de trabajo con orden cronológico claro
- Crear historias de dominio para desarrollo de software
- Simplificar procesos complejos eliminando condicionales
- Establecer baseline antes de documentar variaciones
Core Capabilities
Esta skill se centra en tres principios fundamentales:
1. Foco en el "Happy Path"
¿Qué es? El flujo ideal que ocurre en el 80% de los casos sin excepciones Cómo aplicarlo:
- Guíar al usuario a narrar primero el caso ideal
- Evitar mencionar variaciones o excepciones al inicio
- Capturar el flujo perfecto antes de las complicaciones
- Construir sobre esta base sólida
2. Eliminación de Condicionales
¿Qué es? No usar estructuras "if/else" o "gateway" en la narrativa Cómo aplicarlo:
- Cuando el usuario menciona alternativas, redirigir al camino principal
- Registrar variaciones como historias separadas (anotaciones)
- Mantener cada historia lineal y sin ramas
- Un camino = una historia
3. Números de Secuencia
¿Qué es? Asignar un orden cronológico estricto a cada paso Cómo aplicarlo:
- Numerar cada acción o evento secuencialmente
- Mantener orden temporal estricto (no saltos)
- Cada número = un paso en la secuencia
- Usar la numeración para validar completitud
Instructions
Sigue este proceso paso a paso para aplicar el modelado basado en escenarios:
Paso 1: Preparación del Contexto
- Pregunta inicial: "¿Qué proceso quieres modelar?"
- Define el alcance: ¿Proceso actual (As-Is) o futuro (To-Be)?
- Establece el nivel de detalle: Coarse-grained (pájaro) o Fine-grained (peces)
- Duración estimada: ¿Cuánto tiempo toma el proceso completo?
Paso 2: Invitación a Narrar
- Frase clave: "Cuéntame tu historia paso a paso"
- Instrucción: "Empezemos por el caso ideal, el que ocurre normalmente"
- Recordatorio: "No te preocupes por las excepciones ahora"
- Tono: Invita a la narración, no a la explicación técnica
Paso 3: Captura del Happy Path
- Escucha activa: Deja que el usuario cuente sin interrumpir
- Identifica el inicio: ¿Qué evento inicia el proceso?
- Identifica el final: ¿Cuándo considera el usuario que termina?
- Permite pausas: "¿Qué sucede después?" para mantener flujo
- Mantén enfoque: Redirige variaciones: "Hablemos de esto después"
Paso 4: Numeración Secuencial
- Por cada paso mencionado: Asigna un número consecutivo
- Un solo actor por paso: Evita múltiples actores en un mismo paso
- Un solo verbo por paso: Una acción clara y específica
- Valida secuencia: "¿Pasa esto antes o después de lo anterior?"
- Verifica orden: Asegúrate de que la numeración refleja el tiempo
Paso 5: Eliminación de Condicionales
- Cuando menciona variaciones:
- "Excelente, eso va en una historia separada"
- "Anotamos eso para después"
- "Sigamos con el camino principal primero"
- Redirecciona al flujo principal:
- "¿En el caso normal qué pasa?"
- "¿Qué ocurre la mayoría de las veces?"
- "Concentrémonos en el flujo típico"
- Registra variaciones como anotaciones:
- Crea una lista separada de variaciones
- Nombra cada variación como historia independiente
- No las ignores, solo postpone su documentación
Paso 6: Validación del Happy Path
- Recapitula la historia: Resumen paso a paso numerado
- Verifica completitud: "¿Falta algún paso importante?"
- Confirma secuencia: "¿El orden es correcto?"
- Valida fluidez: "¿Hay saltos lógicos?"
- Consenso: "¿Esto refleja el proceso ideal?"
Paso 7: Documentación de Variaciones (Opcional)
- Recupera las anotaciones: "¿Hablamos de esas variaciones ahora?"
- Crea historias separadas: Cada variación = una historia nueva
- Mantén consistencia: Mismo formato, numeración independiente
- Relaciona con principal: "Esta variación ocurre en el paso X"
Bundled Resources
references/ - Ejemplos y casos de uso para modelado de escenarios
ejemplos-happy-path.md- Casos reales de captura del camino idealeliminacion-condicionales.md- Técnicas para evitar if/else en narrativasnumeracion-secuencial.md- Métodos de asignación de números de secuenciavariaciones-anotaciones.md- Cómo documentar excepciones y alternativas
Examples
Ejemplo 1: Proceso Simple - Contratación
Usuario: "Bueno, cuando necesitamos un empleado nuevo..."
Tú (capturando happy path): "Cuéntame paso a paso cómo ocurre normalmente. Empecemos por el principio."
Usuario: "RRHH publica la oferta en el portal. Los candidatos envían sus CVs. El recruiter revisa los CVs y selecciona los mejores. Los convoca a entrevista. Después de la entrevista, si están bien, hacemos la oferta. El candidato firma el contrato."
Análisis y estructuración:
RRHH publica la oferta en el portalLos candidatos envían sus CVsEl recruiter revisa los CVsEl recruiter selecciona los mejores candidatosEl recruiter convoca a entrevistaSe realiza la entrevistaSi están bien, hacemos la oferta← ¡CONDICIONAL DETECTADO!
Tú (redirigiendo): "Interrumpo un momento. Cuando dices 'si están bien' - en el caso normal, ¿qué ocurre? ¿Siempre hacen oferta?"
Usuario: "Sí, en el caso ideal siempre hacemos oferta después de una buena entrevista."
Continuación (eliminando condicional):
7. Hacemos la oferta al candidato
8. El candidato firma el contrato
Historia final (happy path):
RRHH publica la oferta en el portalLos candidatos envían sus CVsEl recruiter revisa los CVsEl recruiter selecciona los mejores candidatosEl recruiter convoca a entrevistaSe realiza la entrevistaHacemos la oferta al candidatoEl candidato firma el contrato
Anotación (variación):
Variación A: Si el candidato no convence en entrevista → No hacemos oferta
Ejemplo 2: Proceso Complejo - Facturación
Usuario: "Para facturar una orden de trabajo..."
Tú: "Cuéntame paso a paso, empezando por el inicio del proceso."
Usuario: "Cuando el técnico termina la orden, genera el parte de trabajo. Luego el sistema calcula automáticamente los costes. El departamento administrativo crea la factura. Si el cliente es nuevo, necesitamos datos adicionales. El departamento envía la factura al cliente."
Tú (detectando condicional): "Cuando dices 'si el cliente es nuevo' - en el caso normal, ¿el cliente ya está en el sistema?"
Usuario: "Sí, normalmente trabajamos con clientes existentes."
Tú: "Perfecto. Entonces concentremos primero en el caso normal con clientes existentes."
Proceso normal numerado:
El técnico termina la ordenEl técnico genera el parte de trabajoEl sistema calcula automáticamente los costesEl departamento administrativo crea la facturaEl departamento administrativo envía la factura al cliente
Anotación (variación):
Variación B: Cliente nuevo → Necesitamos recopilar datos adicionales antes de facturar
Ejemplo 3: Proceso con Múltiples Actores - Órdenes de Compra
Usuario: "El proceso de compra de materiales..."
Tú: "Empecemos por el inicio. ¿Quién inicia el proceso normalmente?"
Usuario: "El departamento de producción solicita materiales porque el stock está bajo."
Continuando la narración:
8. El departamento de compras recibe la solicitud
9. El buyer analiza la solicitud
10. El buyer busca proveedores
11. El sistema genera cotizaciones automáticamente
12. El proveedor envía la cotización
13. El buyer compara cotizaciones
14. El buyer selecciona la mejor opción
15. El responsable de compras aprueba la orden
16. El sistema envía la orden al proveedor
Validación de secuencia: "Vamos a verificar el orden: ¿el buyer busca proveedores antes o después de recibir la solicitud?"
Ejemplo 4: Proceso Temporal - Control de Asistencia
Usuario: "El control de asistencia diaria..."
Tú: "Cuéntame qué pasa desde que el empleado llega hasta que se registra su presencia."
Proceso secuencial:
El empleado llega al centro de trabajoEl empleado se identifica en el sistemaEl sistema registra la hora de entradaDurante el día, el empleado registra breaksAl finalizar, el empleado registra la salidaEl sistema calcula las horas trabajadasEl sistema detecta incidencias (retrasos, salidas anticipadas)El supervisor recibe reporte de incidencias
Validación temporal: "Cuando dices 'durante el día' - ¿el empleado puede registrarse múltiples veces? ¿En el caso normal cuántas veces?"
Progressive Disclosure
Para información detallada sobre técnicas específicas:
- Happy Path: consulta
references/ejemplos-happy-path.md - Eliminación de Condicionales: consulta
references/eliminacion-condicionales.md - Numeración Secuencial: consulta
references/numeracion-secuencial.md - Variaciones: consulta
references/variaciones-anotaciones.md
Principles to Remember
Happy Path (80% Rule)
- El 80% de casos siguen un flujo ideal
- Documenta primero este flujo principal
- Construye sobre esta base sólida
- Las excepciones van después
Linear Stories (No Branches)
- Una historia = un camino
- Sin if/else en la narrativa principal
- Sin gateways o puntos de decisión
- Variaciones = historias separadas
Sequential Order (Strict Timeline)
- Cada número = un momento en el tiempo
- Sin saltos temporales sin explicar
- Orden cronológico estricto
- Valida secuencia constantemente
Actor Consistency
- Actores aparecen una vez por historia
- Objetos pueden cambiar de manos varias veces
- Un verbo por paso (una acción)
- Clarity over complexity
Tips for Application
- Escucha activamente: Deja que el usuario hable, interviene solo para clarificar secuencia
- Usa preguntas simples: "¿Qué pasa después?" "¿Antes o después de esto?"
- Detecta patrones: Si menciona "a veces", "normalmente", es una pista de variación
- Anota todo: Lleva una lista de variaciones para después
- Valida constantemente: "¿El paso X va antes o después del Y?"
- Sé paciente: El usuario puede necesitar tiempo para recordar la secuencia
- Mantén el foco: Redirige gentilmente hacia el camino principal
Common Pitfalls to Avoid
❌ Permitir condicionales en la historia principal
- "Si pasa X, entonces Y, si no Z" → Dividir en historias separadas
❌ Numeración no secuencial
- Paso 5 → Paso 7 → Paso 6 → Usar orden cronológico estricto
❌ Saltarse pasos obvios
- Usuario dice "el sistema lo procesa automáticamente" → Pregunta qué hace exactamente
❌ Mezclar múltiples actores en un paso
- "RRHH y el candidato firman" → Separar en dos pasos
❌ Ignorar variaciones
- Cuando detecta "a veces" o "excepto cuando" → Anotar para historia separada
❌ Perder el hilo temporal
- Verificar constantemente el orden: "¿Esto pasa antes o después?"
Repository
