gsd-review-backlog

Reviews .planning/phases 999.x backlog items and promotes, keeps, or removes them, updating ROADMAP.md and committing changes.

Updated Jan 25, 2026
One-click install
npx skills add https://github.com/MINT-IA/MINT --skill gsd-review-backlog-mint-ia
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-review-backlog
Source: https://github.com/MINT-IA/MINT/tree/main/.claude/skills/gsd-review-backlog
Command: npx skills add https://github.com/MINT-IA/MINT --skill gsd-review-backlog-mint-ia

SYSTEM DOCUMENTATION & REQUIREMENTS

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.

Frequently Asked Questions about gsd-review-backlog

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

FAQPage Schema
How do I automate moving backlog items into active milestones in a git repository?

To automate backlog triage, this Skill reviews 999.x phase directories and promotes or removes items by renaming directories, updating ROADMAP.md, and committing changes directly to your git repository.

What is the best way to triage 999.x backlog phases stored in .planning/phases?

Triage of 999.x backlog phases is handled by listing .planning/phases entries, consolidating context and research artifacts, and presenting interactive Promote, Keep, or Remove decisions for each item.

How does backlog promotion update ROADMAP.md and assign new phase numbers?

Backlog promotion updates ROADMAP.md by removing the BACKLOG marker and adding dependencies, while gsd-tools allocates new phase numbers and renames phase directories before committing the changes.

Do I need gsd-tools to manage repository milestones and ROADMAP.md updates?

Yes, gsd-tools is required to allocate new phase numbers during the promotion workflow, enabling the Skill to rename phase directories, update ROADMAP.md, and commit milestone changes.

Can I review accumulated context and research files before promoting backlog phases?

Yes, you can review accumulated files like CONTEXT.md and RESEARCH.md during the interactive triage process, which surfaces these artifacts to inform your Promote, Keep, or Remove decisions.

What happens to obsolete backlog items during repository roadmap maintenance?

Obsolete backlog items can be removed during the interactive triage process, cleaning up stale 999.x phase directories and updating the ROADMAP.md to maintain an accurate project roadmap.