gsd-review-backlog

Review ROADMAP.md backlog items and promote or remove them.

1|Updated Apr 7, 2026
One-click install
npx skills add https://github.com/TruCol270/salty-pickle --skill gsd-review-backlog-trucol270
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-review-backlog
Source: https://github.com/TruCol270/salty-pickle/tree/main/.claude-skills/gsd-review-backlog
Command: npx skills add https://github.com/TruCol270/salty-pickle --skill gsd-review-backlog-trucol270

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Backlog management often becomes unwieldy as items pile up and priorities shift. This Skill automates the process of reviewing backlog items (e.g., 999.x phases) and deciding whether to promote them into the active milestone sequence or remove stale entries to keep the roadmap aligned with current priorities.

Core Features & Use Cases

  • Automated backlog assessment: enumerate backlog entries and display related artifacts (CONTEXT.md, RESEARCH.md) and creation dates when available.
  • Promotion and cleanup: rename promoted backlog directories to the next phase, relocate associated artifacts, and update ROADMAP.md with the new active entry; remove backlog markers as needed.
  • Audit and reporting: generate a concise summary of actions taken and commit all changes to ensure traceability.

Quick Start

Review backlog items and promote or remove them to align with the current 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 backlog items into an active milestone sequence?

Promote backlog items by reading ROADMAP.md, extracting 999.x phase entries, and renaming their directories to the next active phase number. The workflow relocates associated artifacts, updates the roadmap, and commits changes to align priorities.

What is the best way to clean up stale entries in a project backlog?

Clean up stale backlog entries by reviewing 999.x phase items in ROADMAP.md and selecting entries to remove. The process deletes outdated directories, updates the roadmap file, and commits all modifications with a concise summary report.

Does backlog review work with existing context and research files?

Backlog review integrates existing context by displaying CONTEXT.md and RESEARCH.md files alongside extracted 999.x phase items. It accumulates this related context when available to inform promote, keep, or delete decisions.

How do I automate renaming directories when promoting a backlog phase?

Automate directory renaming by selecting a backlog item for promotion, which triggers the Skill to rename the 999.x directory to the next phase number. It then relocates artifacts and updates ROADMAP.md automatically.

Can I track changes when promoting or deleting roadmap backlog items?

Track changes through an automated audit and reporting step that commits all modifications after promoting or deleting backlog items. It generates a concise summary report of actions taken to ensure full traceability.

When should I review my 999.x backlog phases instead of active milestones?

Review 999.x backlog phases when accumulated entries pile up and priorities shift, requiring assessment before integration into the active milestone sequence. This keeps the roadmap aligned with current project goals.