plan-roadmap

Decompose markdown proposals into prioritized OpenSpec change candidates with a dependency DAG.

4|1|Updated Jan 16, 2026
One-click install
npx skills add https://github.com/jankneumann/agentic-coding-tools --skill plan-roadmap-jankneumann
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plan-roadmap
Source: https://github.com/jankneumann/agentic-coding-tools/tree/main/.agents/skills/plan-roadmap
Command: npx skills add https://github.com/jankneumann/agentic-coding-tools --skill plan-roadmap-jankneumann

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires anthropic, openai, google, and includes scripts (resource) components.

What problem does it solve?

Planning large software proposals manually is time‑consuming and error‑prone; this Skill automatically breaks down long markdown proposals into structured, prioritized OpenSpec change candidates with a clear dependency DAG.

Core Features & Use Cases

  • Structural Parsing: Detects capabilities, constraints, and phases using deterministic markdown analysis.
  • Size Validation: Merges undersized items and splits overly large ones to fit effort categories.
  • Dependency DAG: Generates an acyclic dependency graph, optionally enriched with LLM‑based inference.
  • Scaffolding: Optionally creates OpenSpec change directories for each approved item.
  • Use Case: Feed a feature proposal document to instantly receive a roadmap.yaml that can be version‑controlled and turned into actionable change tickets.

Quick Start

Use the plan-roadmap skill on the file 'feature-proposal.md' to generate a roadmap.yaml.

Frequently Asked Questions about plan-roadmap

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

FAQPage Schema
How do I turn a markdown proposal into a prioritized roadmap?

To turn a markdown proposal into a prioritized roadmap, apply the plan-roadmap skill to your feature specification document. It structurally parses capabilities and phases to generate an actionable roadmap.yaml file.

What is a dependency DAG in software roadmap generation?

A dependency DAG in software roadmap generation is an acyclic dependency graph mapping relationships between change candidates. It is optionally enriched with LLM-based inference to sequence OpenSpec proposal items.

How do I decompose a large feature specification into OpenSpec change candidates?

To decompose a large feature specification into OpenSpec change candidates, feed the markdown document to the skill. It validates sizes by merging undersized items and splitting overly large ones to fit effort categories.

Can I automatically scaffold OpenSpec change directories from a markdown file?

Yes, you can automatically scaffold OpenSpec change directories from a markdown file. The skill optionally creates change directories for each approved item during the roadmap generation process.

Does roadmap generation work with architectural proposals and design documents?

Roadmap generation works with architectural proposals and software design documents. It applies deterministic markdown analysis to detect constraints and phases for structured output.

What are the limitations of using automated LLM inference for dependency mapping?

A limitation of using LLM inference for dependency mapping is that it is optional and may require manual validation. The deterministic markdown analysis provides the baseline dependency DAG without relying on inferred relationships.