Roadmap Visualization Skill

Overview

Specialized skill for generating roadmap visualizations and planning artifacts. Enables product teams to create clear, stakeholder-appropriate roadmap views in various formats.

Capabilities

Roadmap Views

• Generate Now/Next/Later roadmap views
• Create timeline-based roadmap visualizations
• Build stakeholder-specific roadmap versions
• Create Gantt-style planning charts
• Generate dependency graphs
• Build resource allocation views

Output Formats

• Markdown tables and lists
• Mermaid diagram syntax
• CSV for spreadsheet import
• JSON for tool integration
• ASCII timeline visualizations

Customization

• Filter by theme, team, or priority
• Adjust time horizons
• Show/hide dependencies
• Customize detail levels per audience
• Apply confidence indicators

Target Processes

This skill integrates with the following processes:

• quarterly-roadmap.js - Primary roadmap planning and visualization
• product-vision-strategy.js - Strategic roadmap views
• stakeholder-alignment.js - Stakeholder-specific roadmap presentations
• product-council-review.js - Review-ready roadmap artifacts

Input Schema

{
  "type": "object",
  "properties": {
    "viewType": {
      "type": "string",
      "enum": ["now-next-later", "timeline", "gantt", "dependency", "resource"],
      "description": "Type of roadmap view to generate"
    },
    "initiatives": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": { "type": "string" },
          "name": { "type": "string" },
          "theme": { "type": "string" },
          "timeframe": { "type": "string" },
          "priority": { "type": "string" },
          "dependencies": { "type": "array", "items": { "type": "string" } },
          "team": { "type": "string" },
          "confidence": { "type": "string", "enum": ["high", "medium", "low"] }
        }
      }
    },
    "timeHorizon": {
      "type": "string",
      "description": "Time range for roadmap (e.g., 'Q1-Q4 2026')"
    },
    "audience": {
      "type": "string",
      "enum": ["executive", "engineering", "sales", "customer", "internal"],
      "description": "Target audience for roadmap view"
    },
    "outputFormat": {
      "type": "string",
      "enum": ["markdown", "mermaid", "csv", "json", "ascii"],
      "default": "markdown"
    }
  },
  "required": ["viewType", "initiatives"]
}

Output Schema

{
  "type": "object",
  "properties": {
    "visualization": {
      "type": "string",
      "description": "Rendered roadmap in requested format"
    },
    "summary": {
      "type": "object",
      "properties": {
        "totalInitiatives": { "type": "number" },
        "byTimeframe": { "type": "object" },
        "byTheme": { "type": "object" },
        "byPriority": { "type": "object" }
      }
    },
    "dependencies": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "from": { "type": "string" },
          "to": { "type": "string" },
          "type": { "type": "string" }
        }
      }
    },
    "riskFlags": {
      "type": "array",
      "items": { "type": "string" },
      "description": "Potential scheduling or dependency risks"
    }
  }
}

Usage Example

const roadmap = await executeSkill('roadmap-viz', {
  viewType: 'now-next-later',
  initiatives: [
    { id: 'init-1', name: 'Core Platform Upgrade', theme: 'Platform', timeframe: 'now', priority: 'P0' },
    { id: 'init-2', name: 'Mobile App Launch', theme: 'Growth', timeframe: 'next', priority: 'P1' },
    { id: 'init-3', name: 'AI Features', theme: 'Innovation', timeframe: 'later', priority: 'P2' }
  ],
  timeHorizon: 'Q1-Q4 2026',
  audience: 'executive',
  outputFormat: 'markdown'
});

Dependencies

• Visualization libraries
• Export format handlers