roadmap-narrative

# machine-translated to es from skills/roadmap-narrative/SKILL.md — review: pending. Native fixes welcome via PR.name: roadmap-narrativedescription: "Transforma una lista de iniciativas priorizadas en una narrativa de roadmap estratégico convincente. Utiliza esta skill cuando se te pida redactar una narrativa de roadmap, explicar la hoja de ruta del producto a stakeholders no técnicos, conectar elementos del roadmap a objetivos empresariales, o producir una historia de roadmap compartible con ejecutivos. Produce una narrativa temática con contexto estratégico, arco de progresión trimestral, un resumen ejecutivo y una sección de 'qué no está en el roadmap'."

Skill de Narrativa de Roadmap

Convierte una lista clasificada de iniciativas de producto en una narrativa clara y estratégica que conecte elementos individuales con objetivos empresariales y comunique una dirección de producto coherente.

Lee desde / Escribe en el Brain

Si existe un professional-brain (brain/), fundamenta en él en lugar de volver a preguntar lo que ya sabes:

• Lee primero: knowledge/strategy.md (la dirección a la que debe escalonarse la narrativa), decisions/ prioritarios, y entities/ de características. Ejecuta python3 ../professional-brain/scripts/brain_query.py ./brain "<tema de roadmap>" y mantén la etiqueta de procedencia de cada hecho a través del documento.
• 📥 Proponer al Brain: después de producir, propón registrar las decisiones de secuenciación/prioridad en decisions/ y actualizar las entities/ de características relevantes, cada una etiquetada con procedencia. Muéstralas, obtén un sí, luego escribe con ../professional-brain/scripts/brain_write.py … --commit (append-only, dry-run por defecto).

Trabajar desde un brief

A menudo recibirás un brief corto (unos pocos temas, una audiencia) sin una lista completa de iniciativas u OKRs. Siempre entrega la narrativa completa de todas formas — no te detengas para hacer preguntas ni dejes placeholders entre corchetes como [Nombre del Tema]. Donde falte detalle, infiere temas, iniciativas y métricas específicas y realistas del brief y el dominio, y marca cualquier hecho o número inferido como (asumido — confirma). Completa cada sección con contenido concreto, no brackets de plantilla.

Inputs (infiere cualquiera que no se proporcione — etiqueta suposiciones)

• Lista de iniciativas priorizadas (con cronogramas aproximados o trimestres)
• OKRs o prioridades estratégicas de la empresa (para conectar el roadmap con objetivos empresariales)
• Audiencia (all-hands, junta directiva, inversores, equipo de ventas — cambia tono y profundidad)
• Elementos explícitamente NO en el roadmap (opcional pero fortalece credibilidad)

Proceso

1. Revisa la lista de iniciativas priorizadas y OKRs empresariales proporcionados
2. Identifica 2-3 temas estratégicos que agrupen naturalmente las iniciativas
3. Para cada tema, articula: el problema que aborda, el cliente al que sirve, la métrica que mueve
4. Redacta una narrativa a nivel trimestral que muestre progresión — ¿cómo H1 prepara H2?
5. Redacta un resumen ejecutivo (máximo 3-4 oraciones) que stakeholders no técnicos puedan repetir
6. Valida — Confirma que cada iniciativa se asigna a un tema. Si una iniciativa está huérfana, o crea un tema o señálala como brecha narrativa a abordar

Estructura del Output

Roadmap de Producto: [Trimestre/Semestre/Año]

Contexto Estratégico: [1 párrafo: momento de mercado, desafío clave, nuestra respuesta]

Tema 1: [Nombre del Tema]

• Justificación estratégica
• Iniciativas incluidas
• Métrica primaria impactada
• Dependencias

[Repite para cada tema]

Qué No Está en el Roadmap (y Por Qué): [2-3 elementos con justificación — demuestra disciplina estratégica, no solo priorización]

Resumen Ejecutivo (compartible): [3-4 oraciones que podrían compartirse en una actualización all-hands o de junta directiva]

Directrices de Tono

• Escribe para un CFO, no para un ingeniero
• Lidera con resultados para el cliente, no características
• Sé honesto sobre qué NO está en el roadmap y por qué

Cronograma, dibujado

Cuando los temas tienen una secuencia o fechas, también renderiza el roadmap como un gráfico Gantt de Mermaid para que la forma del plan sea visible (se renderiza en vivo en el playground; con fechas ISO reales también exporta a un calendar .ics). Usa section por tema/trimestre y marca checkpoints clave como milestones.

gantt
    title Roadmap
    dateFormat YYYY-MM-DD
    section Tema 1
        Iniciativa      :2026-07-01, 30d
        Checkpoint      :milestone, 2026-07-31, 0d
    section Tema 2
        Iniciativa      :2026-08-01, 45d

Verificaciones de Calidad

• Cada iniciativa en el input se asigna a un tema estratégico
• El resumen ejecutivo puede estar de pie solo y ser repetido correctamente después de una lectura
• La narrativa de progresión muestra enlaces causales entre trimestres (no solo listado cronológico)
• La sección "qué no está en el roadmap" incluye al menos 2 elementos con justificación clara
• El lenguaje es libre de jerga técnica — probado preguntando: "¿podría un CFO repetir esto?"

Anti-Patrones

• No produzcas una lista de características con fechas y la llames narrativa — cada iniciativa debe conectarse a un tema estratégico
• No omitas la sección "qué no está en el roadmap" — sin ella, la narrativa carece de disciplina estratégica
• No escribas la progresión como lista cronológica — muestra enlaces causales entre trimestres (Q1 habilita Q2 porque…)
• No escribas el resumen ejecutivo al final y lo trates como un resumen — escríbelo como la versión que stakeholders repetirán
• No dejes iniciativas huérfanas sin tema — o crea un tema o señala explícitamente la brecha