gsd-review-backlog

Review 999.x backlog phase directories and promote or remove items via ROADMAP.md.

Updated May 21, 2026
One-click install
npx skills add https://github.com/jedmamosto/m-and-ms --skill gsd-review-backlog-jedmamosto
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-review-backlog
Source: https://github.com/jedmamosto/m-and-ms/tree/main/.agents/skills/gsd-review-backlog
Command: npx skills add https://github.com/jedmamosto/m-and-ms --skill gsd-review-backlog-jedmamosto

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you review a backlog of 999.x planning phases so outdated items don’t linger and promising work gets promoted into the active milestone sequence.

Core Features & Use Cases

  • Backlog Inventory & Inspection: Lists all 999.x phase directories and reads ROADMAP.md to display each item’s description, artifacts, and creation context.
  • Interactive Decision Workflow: Prompts you to promote, keep, or remove each backlog item based on its accumulated information.
  • Controlled Phase Promotion: Renumbers promoted phases into the next sequential active phase, moves artifacts, updates ROADMAP.md, adjusts markers, and sets dependency metadata.

Quick Start

Run the gsd review backlog skill to review all 999.x backlog items and promote the ones you approve into the active milestone, removing any stale entries.

Frequently Asked Questions about gsd-review-backlog

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

FAQPage Schema
How do I review and promote backlog phases in my project roadmap?

To review backlog phases, list all 999.x phase directories and read ROADMAP.md to inspect each item's description, artifacts, and context. You then interactively choose to promote, keep, or remove each backlog item based on its accumulated information.

What happens to phase numbers when promoting a backlog item into an active milestone?

Phase promotion renumbers the backlog item into the next sequential active phase. The process moves artifact directories, updates ROADMAP.md, adjusts markers, sets dependency metadata, and commits the changes through gsd-sdk to ensure consistency.

How do I clean up outdated planning phases from my project backlog?

Cleaning up outdated planning phases involves reviewing 999.x backlog directories and selectively removing stale entries. The review workflow reads ROADMAP.md to display context, allowing you to prune obsolete items and prevent them from lingering in your planning structure.

Do I need gsd-sdk to update ROADMAP.md during backlog maintenance?

Yes, gsd-sdk is required to commit changes during backlog maintenance. After performing phase renumbering, moving artifacts, and updating ROADMAP.md entries, the skill commits all modifications through gsd-sdk to maintain directory and roadmap consistency.

Can I inspect individual artifacts before deciding to promote or prune a backlog phase?

Yes, you can inspect artifacts before deciding. The backlog inventory process lists all 999.x phase directories, reads ROADMAP.md, and gathers per-item artifacts to display the creation context needed for promoting or removing each specific entry.