Narrative arc design and transformation metodologia-storytelling for discovery deliverables. Use when structuring the overall narrative across deliverables, building scenario narratives, crafting transformation stories (current pain → decision → future state), or designing risk narratives and success reference stories.
From pmnpx claudepluginhub javimontano/mao-pm-apexThis skill is limited to using the following tools:
examples/README.mdexamples/sample-output.htmlexamples/sample-output.mdprompts/metaprompts.mdprompts/use-case-prompts.mdreferences/body-of-knowledge.mdreferences/knowledge-graph.mmdreferences/state-of-the-art.mdSearches, retrieves, and installs Agent Skills from prompts.chat registry using MCP tools like search_skills and get_skill. Activates for finding skills, browsing catalogs, or extending Claude.
Searches prompts.chat for AI prompt templates by keyword or category, retrieves by ID with variable handling, and improves prompts via AI. Use for discovering or enhancing prompts.
Designs and optimizes AI agent action spaces, tool definitions, observation formats, error recovery, and context for higher task completion rates.
Designs the narrative architecture that transforms raw analysis into compelling transformation stories. Owns story arcs across deliverables, scenario narratives, risk stories, and evidence-based transformation narratives.
Data informs. Stories transform. A technical finding is a data point. A finding wrapped in context, consequence, and a path to action is a story that moves people to act. Storytelling does not decorate data — it gives data the narrative structure so the reader remembers, understands, and acts.
$1 — Story type: transformation, scenario, risk, success, cross-deliverable (default: transformation)$2 — Audience: executive, technical, mixed (default: mixed)Parse from $ARGUMENTS.
00 Plan → "Nos comprometemos a descubrir la verdad del sistema"
01 Stakeholders → "Estas son las personas que viven con el sistema"
02 Brief → "El panorama en 3 minutos"
03 AS-IS → "La realidad técnica, sin adornos" ← TENSIÓN MÁXIMA
04 Flows → "Así fluye (o no fluye) el valor"
05 Scenarios → "Tres futuros posibles" ← PUNTO DE DECISIÓN
06 Roadmap → "El camino elegido, paso a paso"
07 Spec → "Lo que vamos a construir, exactamente"
08 Pitch → "Por qué actuar ahora" ← CALL TO ACTION
09 Handover → "Cómo empezar el lunes" ← RESOLUCIÓN
10 Hallazgos → "Lo que descubrimos, para quien decide"
11 Recomendac. → "Lo que recomendamos, y por qué"
12 IA Opport. → "Cómo la IA acelera la transformación"
Act 1: Current State (Pain)
├── Contextualize: "El equipo de [N] personas dedica [X]% de su tiempo a..."
├── Quantify: "[Y] incidentes/mes, [Z] horas de workaround"
└── Personalize: "El operador de turno debe..."
Act 2: Decision Point (Tension)
├── Fork: "Si no se actúa: [COI projection]"
├── Options: "Tres caminos posibles..."
└── Evidence: "Basado en [tags], recomendamos..."
Act 3: Future State (Resolution)
├── Vision: "En 12 meses, el equipo podrá..."
├── Metrics: "Time-to-market de [X] a [Y], disponibilidad de [A]% a [B]%"
└── First step: "Sprint 0 comienza con..."
Each scenario is a plausible future, not just a technical option:
Scenario [Name]:
"Imagine que en 18 meses..."
├── Vivid future: What daily work looks like
├── How we got here: Key decisions and investments
├── What we gained: Quantified benefits
├── What it cost: FTE-months, trade-offs
└── What we risked: Identified risks and mitigations
Pattern: Consequential Thinking
"Si [riesgo] se materializa → [impacto cuantificado] →
[cascada de consecuencias] → [punto de no retorno en N meses]"
Tone: Factual, not alarmist
❌ "El sistema colapsará"
✅ "Con la tendencia actual de [X] incidentes/mes creciendo [Y]%,
el equipo alcanzará capacidad de respuesta máxima en Q3,
requiriendo [Z] FTE adicionales para mantener SLAs"
Pattern: Industry Analogy
"[Empresa comparable en sector] enfrentó [dolor similar].
Con [enfoque seleccionado], logró [resultado cuantificado] en [plazo].
Nuestro escenario B sigue un patrón similar, adaptado a [contexto cliente]."
Source: metodologia-sector-intelligence skill provides benchmarks
| Technique | When to Use | Example |
|---|---|---|
| Contrast | Before/after, AS-IS vs TO-BE | "Hoy: 12 semanas. Mañana: 4 semanas." |
| Escalation | Building urgency | Finding → implication → cascade → crisis |
| Analogy | Making technical tangible | "Es como renovar una casa habitada" |
| Perspective | Multi-stakeholder | "Para el desarrollador... Para el PM... Para el CTO..." |
| Progression | Building the case | Evidence 1 + Evidence 2 + Evidence 3 = Conclusion |
| Callback | Cross-deliverable coherence | "Como vimos en 03_AS-IS § Acoplamiento..." |
Narrative threads that must be consistent across ALL deliverables:
| Thread | Introduced In | Resolved In |
|---|---|---|
| Technical debt cost | 03 AS-IS | 06 Roadmap, 08 Pitch |
| User pain | 01 Stakeholders, 04 Flows | 07 Spec, 09 Handover |
| Risk exposure | 03 AS-IS | 05 Scenarios, 08 Pitch |
| Value proposition | 05 Scenarios | 06 Roadmap, 08 Pitch |
| Transformation path | 05 Scenarios | 06 Roadmap, 09 Handover |
| Criterion | Check |
|---|---|
| Narrative arc present | Tension → Decision → Resolution visible |
| Evidence-grounded | No story without data; no data without story |
| Cross-references active | Callbacks to prior deliverables where relevant |
| Personalization present | At least one stakeholder perspective per major finding |
| Tone calibrated | Executive ≠ technical ≠ mixed |
| No orphan stories | Every narrative thread resolved by Pitch/Handover |
| Caso Borde | Estrategia de Manejo |
|---|---|
| Cliente sin analisis previo (discovery desde cero) | Construir narrativa exclusivamente desde analisis de codigo. Enmarcar como "el discovery revela lo que el codigo nos dice". Usar la ausencia de documentacion como tension narrativa. |
| AS-IS positivo (sistema en buen estado, caso raro) | Buscar tension en escalabilidad, costo de oportunidad, o presion competitiva. "El sistema funciona hoy, pero el crecimiento proyectado de X% lo llevara al limite en Y meses." |
| Multiples streams de transformacion en paralelo | Tejer narrativas paralelas con punto de resolucion compartido. Usar tecnica de "callback" entre streams. Crear timeline visual que muestre convergencia. |
| Audiencia hostil o esceptica al cambio | Liderar con datos incuestionables [CODIGO]. Evitar recomendaciones tempranas. Construir caso acumulativamente: evidencia 1 + 2 + 3 = conclusion inevitable. Incluir "devil's advocate" section. |
| Decision | Justificacion | Alternativa Descartada |
|---|---|---|
| Arco narrativo unico cross-deliverable (00-12) | Coherencia total: cada entregable avanza la historia. El stakeholder percibe un argumento acumulativo, no documentos aislados. | Entregables narrativamente independientes: pierden fuerza acumulativa; el lector no conecta hallazgos. |
| Tension como motor narrativo obligatorio | Sin conflicto no hay narrativa. La brecha entre estado actual y estado deseado es el motor que mueve al lector hacia la decision. | Narrativa descriptiva sin tension: informativa pero no accionable; no motiva decision. |
| Evidencia como ancla de toda historia | Diferencia storytelling de ficcion. El lector ejecutivo detecta narrativas sin sustento y pierde confianza. | Historias sin datos: percibidas como opinion; pierden credibilidad con audiencias tecnicas. |
| Perspectiva multi-stakeholder | Enriquece la narrativa mostrando como el mismo problema afecta a diferentes roles. Genera empatia cross-funcional. | Perspectiva unica: pierde a parte de la audiencia; no refleja complejidad organizacional. |
graph TD
subgraph Core["Core: Storytelling"]
ARC[Master Arc 00-12]
TRANS[Transformation Narrative]
SCENARIO[Scenario Narrative]
RISK[Risk Narrative]
end
subgraph Inputs["Inputs"]
TYPE[Story Type]
AUD[Audiencia]
FINDINGS[Hallazgos Tecnicos]
STAKEHOLDERS[Perspectivas Stakeholders]
end
subgraph Outputs["Outputs"]
MASTER[Cross-Deliverable Arc]
SCENE[Scenario Stories]
RISKN[Risk Narratives]
SUCCESS[Success Reference Stories]
end
subgraph Related["Related Skills"]
COPY[copywriting]
DATASTORY[data-storytelling]
EDITORIAL[editorial-director]
SECTOR[sector-intelligence]
end
TYPE --> ARC
AUD --> TRANS
FINDINGS --> SCENARIO
STAKEHOLDERS --> RISK
ARC --> MASTER
TRANS --> SCENE
SCENARIO --> SCENE
RISK --> RISKN
SECTOR --> SUCCESS
COPY --> Core
DATASTORY --> Core
EDITORIAL --> ARC
Filename: Narrative_{project}_{deliverable}_{WIP|Aprobado}.md
# Narrativa de Transformacion: {project}
## Acto 1: Estado Actual (Dolor)
### Contexto
{Equipo de [N] personas dedica [X]% de su tiempo a...}
### Cuantificacion
{[Y] incidentes/mes, [Z] horas de workaround}
### Perspectiva Humana
{El operador de turno debe... El desarrollador enfrenta...}
## Acto 2: Punto de Decision (Tension)
### Sin Accion
{Proyeccion COI: costo acumulado en N trimestres}
### Opciones
{3 caminos posibles con trade-offs}
### Evidencia
{Tags y datos que soportan la recomendacion}
## Acto 3: Estado Futuro (Resolucion)
### Vision
{En 12 meses, el equipo podra...}
### Metricas Objetivo
{Time-to-market de [X] a [Y], disponibilidad de [A]% a [B]%}
### Primer Paso
{Sprint 0 comienza con...}
Filename: Scenario_Narrative_{project}_{scenario}_{WIP|Aprobado}.md
# Escenario {Name}: {project}
## "Imagine que en 18 meses..."
{Descripcion vivida del futuro: como se ve el trabajo diario}
## Como Llegamos Aqui
{Decisiones clave e inversiones realizadas}
## Que Ganamos
| Beneficio | Metrica Actual | Metrica Proyectada | Evidencia |
|---|---|---|---|
## Que Costo
{FTE-meses, trade-offs explicitos, que se sacrifico}
## Que Arriesgamos
| Riesgo | Probabilidad | Impacto | Mitigacion |
|---|---|---|---|
{fase}_Narrative_{project}_{WIP|Aprobado}.html{fase}_storytelling_{cliente}_{WIP}.docx{fase}_storytelling_{cliente}_{WIP}.pptx{fase}_storytelling_{cliente}_{WIP}.xlsx| Dimension | Peso | Criterio |
|---|---|---|
| Trigger Accuracy | 10% | Se activa ante solicitudes de narrativa, arco de historia, transformation story, o scenario narrative |
| Completeness | 25% | Arco narrativo completo (tension -> decision -> resolucion), threads consistentes cross-deliverable, perspectiva multi-stakeholder |
| Clarity | 20% | Narrativa fluida; transiciones logicas entre actos; el lector entiende la progresion sin saltos |
| Robustness | 20% | Produce narrativas efectivas sin analisis previo, con AS-IS positivo, con audiencia esceptica |
| Efficiency | 10% | Genera estructura narrativa completa con parametros minimos (tipo + audiencia) |
| Value Density | 15% | Cada elemento narrativo aporta tension o resolucion; cero prosa decorativa sin funcion narrativa |
Umbral minimo: 7/10
metodologia-copywriting — Calidad de prosa y persuasion dentro de cada seccion narrativametodologia-data-storytelling — Interpretacion de metricas que alimenta la narrativametodologia-editorial-director — Coordinacion del arco maestro cross-entregablemetodologia-sector-intelligence — Benchmarks y analogias sectoriales para success reference stories