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.