gsd-review-backlog

Review backlog phase items and promote or remove them in the project roadmap.

Updated Feb 18, 2026
One-click install
npx skills add https://github.com/jjchambers80/judgesdirectory --skill gsd-review-backlog-jjchambers80
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gsd-review-backlog
Source: https://github.com/jjchambers80/judgesdirectory/tree/main/.github/skills/gsd-review-backlog
Command: npx skills add https://github.com/jjchambers80/judgesdirectory --skill gsd-review-backlog-jjchambers80

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Backlog items accumulate in the 999.x phase range of a GSD-planned project and become stale or forgotten. This Skill reviews each backlog entry, shows its accumulated context, and lets you promote items into the active milestone sequence or delete obsolete ones, keeping ROADMAP.md accurate. ## Core Features & Use Cases - Backlog Inventory: Lists all 999.x phase directories with their descriptions, CONTEXT.md and RESEARCH.md artifacts, and creation dates. - Interactive Triage: Presents each item with Promote, Keep, or Remove options so you decide the fate of every backlog entry. - Automatic Promotion: Assigns the next sequential phase number, renames the directory, migrates artifacts, and updates ROADMAP.md with dependency fields. - Use Case: After several planning sessions, your .planning/phases directory has five 999.x backlog items. Run this Skill to promote two ready items into the active milestone and delete three outdated ones, then commit the roadmap update. ## Quick Start Ask the assistant to review the project backlog and promote or remove items from the roadmap.

Frequently Asked Questions about gsd-review-backlog

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

FAQPage Schema
How do I promote a backlog item to an active phase?▼

Run the backlog review, choose Promote for the item, and the Skill assigns the next sequential phase number via gsd-tools.cjs, renames the 999.x directory, moves its artifacts, and updates ROADMAP.md with a Depends on field.

How do I remove stale backlog entries from ROADMAP.md?▼

During the review, select Remove for the stale item. The Skill deletes the phase directory and removes its entry from the Backlog section of ROADMAP.md, then commits the change.

What happens to CONTEXT.md and RESEARCH.md when promoting a backlog item?▼

Accumulated artifacts such as CONTEXT.md and RESEARCH.md are moved into the newly numbered phase directory during promotion, so prior research and context are preserved.

Does the backlog review commit changes automatically?▼

Yes. After promotions and removals, it runs gsd-tools.cjs commit with a summary message covering ROADMAP.md, recording how many items were promoted and removed.

What if there are no backlog items in the project?▼

The Skill checks for 999.x phase directories first and reports that no backlog items were found, ending the workflow without modifying ROADMAP.md.