roadmap

Update and maintain markdown project roadmaps with milestones and item tables.

489|254|Updated Apr 5, 2026
One-click install
npx skills add https://github.com/me2resh/apexyard --skill roadmap-me2resh
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: roadmap
Source: https://github.com/me2resh/apexyard/tree/main/.claude/skills/roadmap
Command: npx skills add https://github.com/me2resh/apexyard --skill roadmap-me2resh

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Keeps product roadmaps from getting lost in chat or spreadsheets by maintaining a single, editable source of truth that can be shown, updated, and reprioritized safely.

Core Features & Use Cases

  • Single-file roadmap management: Reads, updates, and renders a project roadmap stored as markdown with milestones and item tables.
  • Milestone operations: Supports showing the full roadmap or a specific milestone, adding new items with stable IDs, removing items, reordering within a milestone, moving items between milestones, and closing items into Done.
  • Operational guardrails: Uses project-aware path resolution (supports split-portfolio mode) and confirms destructive actions like remove and reorder.

Real-world example: you want to track “OAuth login” across cycles, update its priority/status, and then close it into Done once shipped, all while keeping item IDs stable and the markdown formatting intact.

Quick Start

Run /roadmap add "OAuth login" Q3 P0 to add a prioritized milestone item to your project roadmap and update the roadmap file.

Frequently Asked Questions about roadmap

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

FAQPage Schema
How do I maintain a project roadmap in markdown without breaking the formatting?

You can manage a project roadmap in markdown by using this skill to read, add, remove, reorder, move, and close items within milestones, which preserves stable RM-NNN IDs and markdown table formatting.

What is the best way to prioritize and move project milestones stored in a single file?

Prioritizing project milestones involves reordering items within a milestone, moving items between milestones, and closing them into Done, all while confirming destructive actions and maintaining stable item IDs.

Can I mirror markdown roadmap items to GitHub issues?

Yes, GitHub issue mirroring is supported. The skill optionally mirrors roadmap items to GitHub issues while managing single-project contexts, allowing you to track items like OAuth login across cycles.

Does roadmap management work with split-portfolio project path resolution?

Yes, roadmap management supports split-portfolio mode through project-aware path resolution, ensuring the correct canonical markdown roadmap file is located and updated within single-project contexts.

How do I add a new item to a product roadmap milestone and assign it a priority?

You add a new item to a product roadmap milestone by running the add command with the item description, target milestone, and priority level, which assigns a stable RM-NNN ID and renders the updated markdown table.