Roadmap — Product Roadmap Generator
Generate a visual product roadmap from PRD phases and arch.md feature index.
Execution Steps
- Read PRD — Extract phases, features, priorities (P0/P1/P2), timelines
- Read arch.md — Feature index with current status (planned/in-progress/done)
- Read git log — Recent commits to detect progress since last roadmap update
- Generate roadmap — Organize by the requested view (quarter/month/sprint)
- Save —
docs/toolkit/roadmap.md(markdown) ordocs/toolkit/roadmap.html(visual)
Output Format
Markdown (default)
## Roadmap — [Product Name]
### Sprint 1 (Current)
- [x] Feature A — done
- [ ] Feature B — in progress (60%)
- [ ] Feature C — planned
### Sprint 2
- [ ] Feature D — P0
- [ ] Feature E — P1
### Backlog
- Feature F — P2
- Feature G — P2
HTML (if requested)
Timeline visualization with:
- Horizontal time axis (weeks/months/quarters)
- Feature cards positioned by phase
- Color coding by status (done/in-progress/planned)
- Dependencies shown as connecting lines
Update Mode
When run with update:
- Read existing roadmap
- Compare with current arch.md feature index
- Mark completed items, adjust timeline
- Flag features that slipped or changed scope
- Present diff to user for confirmation
Prerequisites
Check before running:
docs/PRD.mdmust exist — if missing: "Run/pm setupto create your PRD first."docs/arch.mdshould exist for feature index — if missing, build from PRD phases only
Important Rules
- Reflect reality — roadmap matches PRD + arch.md, not wishful thinking
- Flag slippage — if features are behind, say so clearly
- Keep it current — suggest running after each sprint/milestone
- Check existing first — read
docs/toolkit/roadmap.mdbefore generating. Update it, don't recreate from scratch. - Write only to docs/toolkit/ — never modify application code