What problem does it solve?
Helps maintain the project roadmap by reviewing 999.x backlog phases and promoting or removing stale items, reducing manual file edits and inconsistent milestone tracking.
Core Features & Use Cases
- Backlog discovery: Lists all .planning/phases/999* entries and surfaces ROADMAP.md entries with associated artifacts and creation context.
- Interactive triage: Presents each backlog item for a Promote / Keep / Remove decision and shows accumulated files like CONTEXT.md and RESEARCH.md to inform choices.
- Promotion workflow: When promoted, obtains a new phase number via gsd-tools, renames and moves phase directories, updates ROADMAP.md (removing BACKLOG marker and adding Depends on), and commits the changes.
- Use Case: A maintainer preparing a release can quickly convert prioritized backlog items into active milestone phases and clean up obsolete entries.
Quick Start
Run a backlog review to list all 999.x phases, inspect each item's artifacts, and choose Promote, Keep, or Remove to update the repository and ROADMAP.md accordingly.