gsd-review-backlog

Review 999.x backlog phases and promote items into active milestones.

Updated Aug 15, 2025
One-click install
npx skills add https://github.com/gesmith0606/nfl_data_engineering --skill gsd-review-backlog-gesmith0606
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-review-backlog
Source: https://github.com/gesmith0606/nfl_data_engineering/tree/main/.claude/skills/gsd-review-backlog
Command: npx skills add https://github.com/gesmith0606/nfl_data_engineering --skill gsd-review-backlog-gesmith0606

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides a reproducible, auditable workflow to review large backlog phase items and either promote them into the active milestone sequence or remove stale entries, eliminating manual file edits and inconsistent roadmap state.

Core Features & Use Cases

  • Inventory and Context: Lists all .planning/phases/999* directories and surfaces ROADMAP.md entries along with associated artifacts such as CONTEXT.md and RESEARCH.md.
  • Promote or Remove: Promotes selected backlog phases by creating a new active phase number, moving artifacts, updating ROADMAP.md entries, and removing the backlog marker, or deletes stale backlog directories and their roadmap entries.
  • Commit & Report: Runs the repository's gsd-tools.cjs to add phases and commit the ROADMAP.md change, then summarizes promoted, kept, and removed items for auditing.

Quick Start

Run a guided backlog review to list all 999.x backlog phases and choose which items to promote, keep, or remove.

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 backlog phases into active milestones in my roadmap?

To promote backlog phases into active milestones, you can review your 999.x backlog directories and move selected artifacts into a new active phase number. This updates the ROADMAP.md and removes the backlog marker automatically.

What is the best way to clean up stale items in a planning roadmap?

Cleaning up stale items in a planning roadmap involves reviewing your backlog phase directories and deleting outdated entries. This removes both the directory and its corresponding ROADMAP.md entry to maintain a consistent project state.

How do I manage backlog phase directories using git and roadmap files?

Managing backlog phase directories involves reading phase artifacts like CONTEXT.md and RESEARCH.md, then renaming or deleting phase directories. A local CLI commits these ROADMAP.md changes to git for an auditable planning structure.

Can I use a CLI to automate backlog review and roadmap updates?

Yes, you can use a local CLI to automate backlog review by adding new phases and committing roadmap changes. It requires filesystem read/write access to move artifacts and update the roadmap state.

Do I need a specific directory structure to manage backlog phases and milestones?

Yes, managing backlog phases requires a specific structure using a .planning/ROADMAP.md file and 999.x backlog phase directories. This organization allows the system to accurately inventory items and promote them into active milestones.

What are the limitations of deleting directories during backlog phase management?

Deleting directories during backlog phase management requires care to avoid data loss, as removing stale backlog entries permanently deletes associated artifacts. The process removes both the directory and its roadmap entry without recovery options.