Metodologia Data Storytelling

Inputs

• $1 — Data context: metrics, scoring, financial, performance, coverage (default: metrics)
• $2 — Audience: executive, technical, mixed (default: mixed)

Parse from $ARGUMENTS.

Core Patterns

Pattern 1: Metrics-to-Meaning

Raw metric → Context → Comparison → Insight → Implication → Action

Example:
  Raw: "Deployment frequency: 1/month"
  Context: "El equipo despliega una vez al mes"
  Comparison: "vs. benchmark DORA de equipos elite: múltiples por día"
  Insight: "La brecha de 30x indica proceso manual o miedo al cambio"
  Implication: "Cada feature espera en promedio 15 días de cola antes de llegar a producción"
  Action: "Pipeline CI/CD automatizado puede cerrar la brecha a 1/semana en 3 sprints"

Pattern 2: Insight Extraction

Data point → Pattern → Anomaly → Significance → Recommendation

Steps:
1. Observe the data point: "8 de 12 módulos tienen cobertura >90%"
2. Detect the pattern: "Los módulos con alta cobertura comparten equipo senior"
3. Identify the anomaly: "Los 4 módulos sin cobertura son todos del equipo junior"
4. Interpret the significance: "No es un problema de herramientas, es de capacitación"
5. Recommend: "Pair programming cross-team + coverage gates en CI"

Pattern 3: Comparison Framing

Pattern 4: Magnitude Communication

Abstract → Concrete → Impactful

"40 FTE-meses"
  → "Equivalente a un equipo de 8 personas durante 5 meses"
  → "Es decir, todo el equipo backend dedicado exclusivamente
     desde enero hasta mayo, sin poder hacer nada más"

"99.5% disponibilidad"
  → "43 horas de downtime al año"
  → "Equivalente a casi 2 días completos sin servicio,
     probablemente concentrados en momentos de alta demanda"

"$2M de deuda técnica" → NEVER. Use FTE-month equivalents.

Scoring Matrix Narratives

When presenting scoring tables:

1. Lead with the pattern, not individual scores:
   "De las 6 dimensiones evaluadas, 2 están en rojo y comparten causa raíz:
    acoplamiento entre el módulo de autenticación y el core de negocio."

2. Highlight the anomalies:
   "La dimensión de seguridad sorprende en verde dado que el equipo
    no tiene un rol dedicado — evidencia de buenas prácticas orgánicas."

3. Connect to action:
   "Los 2 rojos se resuelven con el escenario B en Fase 1 (Q2);
    los 3 amarillos mejoran orgánicamente con la nueva arquitectura."

Dashboard Narrative Sequences

For multi-chart metodologia-storytelling (presentations, executive summaries):

Chart 1: The headline
  "Aquí estamos" — current state summary metric

Chart 2: The context
  "Así llegamos aquí" — trend or historical view

Chart 3: The comparison
  "Así estamos vs. donde deberíamos estar" — benchmark gap

Chart 4: The path
  "Así cerramos la brecha" — roadmap or scenario projection

Each chart builds on the previous. No standalone charts.

Semantic Density Rules

Output Configuration

• Language: Spanish (Latin American, business register — simple, clear, concise, direct)
• Attribution: Expert committee of the MetodologIA Discovery Framework
• Tagline: "Construido por profesionales, potenciado por la red agéntica de MetodologIA."

Validation Gate

Supuestos y Limites

• Las metricas de input ya estan calculadas; esta skill interpreta y contextualiza, no calcula.
• NUNCA presentar metricas sin contexto y comparacion.
• NUNCA usar valores monetarios para costos. Solo FTE-meses.
• Esta skill posee interpretacion de metricas y framing narrativo. NO posee diseno de visualizacion (eso es data-viz-storytelling) ni arco narrativo general (eso es storytelling).

Casos Borde

Decisiones y Trade-offs

Knowledge Graph

graph TD
    subgraph Core["Core: Data Storytelling"]
        M2M[Metrics-to-Meaning]
        INSIGHT[Insight Extraction]
        COMPARE[Comparison Framing]
        MAGNITUDE[Magnitude Communication]
    end

    subgraph Inputs["Inputs"]
        METRICS[Metricas Crudas]
        SCORES[Scoring Matrices]
        BENCHMARKS[Benchmarks]
        CONTEXT[Contexto de Negocio]
    end

    subgraph Outputs["Outputs"]
        NARRATIVE[Metric Narratives]
        DASHBOARD[Dashboard Sequences]
        SCORING_N[Scoring Narratives]
        PROJECTION[Projections]
    end

    subgraph Related["Related Skills"]
        STORY[storytelling]
        COPY[copywriting]
        DATAVIZ[data-viz-storytelling]
        TECHWRITE[technical-writing]
    end

    METRICS --> M2M
    SCORES --> INSIGHT
    BENCHMARKS --> COMPARE
    CONTEXT --> MAGNITUDE
    M2M --> NARRATIVE
    INSIGHT --> SCORING_N
    COMPARE --> DASHBOARD
    MAGNITUDE --> PROJECTION
    STORY --> Core
    COPY --> NARRATIVE
    Core --> DATAVIZ
    TECHWRITE --> METRICS

Output Templates

Template 1: Metrics Narrative Report (Markdown)

Filename: Data_Narrative_{project}_{dimension}_{WIP|Aprobado}.md

# Narrativa de Datos: {project} - {dimension}

## Headline
{Una metrica clave con contexto y comparacion en una linea}

## Estado Actual
| Metrica | Valor | Baseline | Benchmark | Gap | Tendencia |
|---|---|---|---|---|---|

## Interpretacion
{Parrafo denso: patron detectado + anomalia + significancia}

## Implicacion
{So what? Que significa para el negocio en terminos tangibles}

## Recomendacion
{Accion concreta que cierra el gap, con timeline estimado}

## Fuentes
| Dato | Tag de Evidencia | Confianza |
|---|---|---|

Template 3: HTML (bajo demanda)

• Filename: Data_Narrative_{project}_{dimension}_{WIP}.html
• Estructura: HTML self-contained branded (Design System MetodologIA v5). Dark-First Executive. Incluye tarjetas de métricas con semáforo, tabla comparativa interactiva y callouts de insight. WCAG AA, responsive, print-ready.

Template 4: DOCX (circulación formal)

• Filename: {fase}_{entregable}_{cliente}_{WIP}.docx
• Generado via python-docx con MetodologIA Design System v5. Portada con metadata del engagement, TOC automático, encabezados/pies de página con marca. Tablas con zebra striping, tipografía Poppins en headings (navy), Montserrat en cuerpo, acentos dorados. Para circulación formal y auditoría.

Template 5: XLSX (bajo demanda)

• Filename: {fase}_{entregable}_{cliente}_{WIP}.xlsx
• Via openpyxl con MetodologIA Design System v5. Headers con fondo navy y tipografía Poppins en blanco, conditional formatting por semáforo y tendencia de métrica, auto-filters en todas las columnas, valores directos sin fórmulas.

Template 6: PPTX (bajo demanda)

• Filename: {fase}_{entregable}_{cliente}_{WIP}.pptx
• Via python-pptx con MetodologIA Design System v5. Navy gradient slide master, Poppins titles, Montserrat body, gold accents. Máx 20 slides ejecutivo / 30 técnico. Speaker notes con referencias de evidencia.

Template 2: Scoring Matrix Narrative (Markdown)

Filename: Scoring_Narrative_{project}_{WIP|Aprobado}.md

# Scoring Narrative: {project}

## Patron General
{De las N dimensiones evaluadas, X estan en rojo y comparten causa raiz: ...}

## Scoring Matrix
| Dimension | Score | Semaforo | Evidencia Clave | Causa Raiz |
|---|---|---|---|---|

## Anomalias
{Dimensiones que sorprenden -- positiva o negativamente -- con explicacion}

## Conexion a Accion
{Los rojos se resuelven con [escenario] en [fase]; los amarillos mejoran con...}

## Proyeccion
{Si no se actua: tendencia de scores en N trimestres}

Evaluacion

Umbral minimo: 7/10

Cross-References

• metodologia-storytelling — Arco narrativo general que consume las narrativas de datos
• metodologia-copywriting — Prosa persuasiva que envuelve los insights de datos
• metodologia-data-viz-storytelling — Visualizaciones que representan las narrativas de datos
• metodologia-technical-writing — Precision documental de las metricas fuente

Edge Cases

• No benchmarks available: Use internal baseline or state explicitly: "Sin benchmark sectorial disponible; se usa linea base interna Q1 como referencia [SUPUESTO]".
• Conflicting metrics: Present the contradiction as a finding: "La cobertura alta (92%) contradice la tasa de incidentes (8/mes), sugiriendo tests que no cubren escenarios reales [INFERENCIA]".
• Sparse data: Acknowledge gaps: "Con [N] datos, la tendencia es indicativa, no concluyente".

Limits

• This skill owns metric interpretation and narrative framing. It does NOT own visualization design (that's metodologia-data-viz-storytelling) or overall narrative arc (that's metodologia-storytelling).
• NEVER present metrics without context and comparison.
• NEVER use currency values for costs. FTE-months only.