shine-review-backlog

Backlog review automation extracts descriptions, context, and dates from ROADMAP.md to evaluate entries, promoting selected items into the next active milestone while relocating associated artifacts. It updates the roadmap file and generates a summary report to reflect the workflow changes.

Moving backlog items into a project roadmap involves auditing accumulated entries, validating their context and dates, and relocating valid artifacts into the active milestone sequence. The process maintains ROADMAP.md by updating both backlog and milestone sections systematically.

Backlog promotion requires access to the repository structure under .planning and the ROADMAP.md file to function. It uses shine-tools to rename phases and relocate artifacts, ensuring the project planning workflow operates within the established directory framework.

Handling invalid or stale entries during a backlog audit involves reviewing each item's extracted context and dates to determine validity. The workflow filters out outdated entries, ensuring only appropriate items are promoted to milestones while maintaining a clean roadmap.

Relocating research artifacts when promoting backlog items is supported by the workflow. It moves associated context and research files alongside the promoted entries, ensuring all relevant artifacts are correctly positioned within the active milestone directory structure.

The best way to update ROADMAP.md after promotion is through automated roadmap updates that modify both backlog and active milestone sections. The workflow generates a summary report detailing the promoted items and artifact relocations for project tracking.