stakeholder-roadmap-generator

Generates stakeholder-facing ROADMAP.md from capabilities.yaml and PRD.md inputs.

Updated Jun 4, 2026
One-click install
npx skills add https://github.com/Kohlex/autopilot-plugin --skill stakeholder-roadmap-generator
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: stakeholder-roadmap-generator
Source: https://github.com/Kohlex/autopilot-plugin/tree/main/skills/stakeholder-roadmap-generator
Command: npx skills add https://github.com/Kohlex/autopilot-plugin --skill stakeholder-roadmap-generator

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill automates the creation of stakeholder-facing ROADMAP.md documents from a product's capability graph, ensuring a consistent, lifecycle-spanning decimal-id roadmap.

Core Features & Use Cases

  • Reads the authoritative input: <product>/.planning/capabilities.yaml, <product>/.planning/PRD.md, and optional <product>/.planning/ARCHITECTURE.md to assemble a stable, top-down roadmap with phase-based sections (Prototype, MVP, Blue-sky).
  • Emits <product>/.planning/PRODUCT/ROADMAP.md with a decimal-outline, stable IDs, and a footer that reflects the tech stack and dependencies for stakeholders.
  • Supports regeneration on-demand (via /stakeholder-roadmap-generator) and preserves previous IDs to maintain contracts across regenerations.

Quick Start

Run the stakeholder-roadmap-generator for a product to generate ROADMAP.md from its capabilities and PRD.

Frequently Asked Questions about stakeholder-roadmap-generator

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate a stakeholder roadmap from a capabilities.yaml file?

To generate a stakeholder roadmap, the tool reads your capabilities.yaml and PRD.md to assemble a top-down ROADMAP.md with phase-based sections. It applies stable decimal IDs and topological ordering to produce a readable document for stakeholders.

When do I need to use topological ordering for a product roadmap?

Topological ordering is needed when your roadmap must reflect dependency chains across capabilities before presentation. It ensures the generated ROADMAP.md sequences phases correctly, preventing stakeholders from viewing disconnected or out-of-order product milestones.

Can I regenerate a ROADMAP.md without breaking existing stakeholder contracts?

Yes, you can regenerate the ROADMAP.md on-demand while preserving previous decimal IDs. This maintains stable contracts across regenerations, ensuring stakeholders reference consistent milestone identifiers even when capability inputs change.

What PRD and architecture inputs are required to automate roadmap generation?

Roadmap generation requires a capabilities.yaml and a PRD.md as authoritative inputs, while an optional ARCHITECTURE.md provides supplementary context. These files assemble the top-down roadmap and render a footer reflecting the tech stack and dependencies.

Does this approach work for any product or only specific tech stacks?

This approach works for any product that maintains a capabilities.yaml and PRD.md in its planning directory. It is tech-stack agnostic, rendering the ROADMAP.md footer to reflect specific dependencies dynamically based on the provided inputs.

Why do my roadmap milestones lose their IDs when I update the PRD?

Roadmap milestone IDs typically shift when updates lack a stable decimal-id enforcement mechanism. This generator applies stable decimal IDs and topological ordering during regeneration, preserving previous identifiers to maintain stakeholder contracts.