skills.rest
BeiBei-Clic
BeiBei-ClicCOMMUNITY
Explore all skills by this author →
GitHub

gsd-review-backlog

Review backlog phases and promote or remove items in GSD planning workflows.

Updated Aug 23, 2026
Search Tags:#workflow automation#project planning#documentation updates#GSD#backlog review#milestone promotion
One-click install
npx skills add https://github.com/BeiBei-Clic/ai-skills --skill gsd-review-backlog-beibei-clic
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gsd-review-backlog
Source: https://github.com/BeiBei-Clic/ai-skills/tree/main/gsd-review-backlog
Command: npx skills add https://github.com/BeiBei-Clic/ai-skills --skill gsd-review-backlog-beibei-clic

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you systematically review backlog items and either promote them into the active milestone sequence or remove stale entries, keeping your project plan current and actionable.

Core Features & Use Cases

  • Backlog discovery and presentation: Lists all 999.x backlog phase directories, reads ROADMAP context, and shows each item’s accumulated artifacts to support decision-making.
  • Interactive promotion workflow: Promotes selected items by computing the next sequential phase number, renaming phase directories, moving artifacts, updating ROADMAP.md, and fixing dependency metadata.
  • Stale cleanup and reporting: Removes unwanted backlog entries, deletes their directories, and commits a summary of promoted/removed changes.

Quick Start

Ask the AI to run gsd-review-backlog to review all 999.x backlog items and decide which ones to promote 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 review backlog items and promote them to active milestones in project planning?▼

Reviewing backlog items involves listing 999.x phase directories, extracting their artifacts, and interactively deciding to promote, keep, or remove them from the active milestone sequence in ROADMAP.md. The workflow updates directory names and dependency metadata to keep plans current.

What is the best way to clean up stale phase entries from a project roadmap?▼

Cleaning up stale roadmap entries is handled by interactively selecting unwanted backlog items for removal. The process deletes their corresponding 999.x phase directories, updates the ROADMAP.md file, and commits a summary of all removed changes to keep the project plan actionable.

How does backlog promotion update phase dependencies in a GSD workflow?▼

Backlog promotion in a GSD workflow updates dependencies by computing the next sequential phase number, renaming directories via gsd-sdk phase.add output, and adding Depends on metadata. This ensures newly promoted items correctly link to preceding active milestones.

Do I need specific directory structures to perform a backlog review?▼

Yes, backlog review requires backlog phases stored under .planning/phases/999* directories and summarized in .planning/ROADMAP.md. The Skill reads these specific paths to discover accumulated artifacts and present them for decision-making.

Can I move artifacts and update ROADMAP.md automatically when promoting milestones?▼

Yes, promoting milestones automatically moves phase artifacts, renames directories to active sequence numbers, updates the ROADMAP.md Backlog and active lists, removes backlog markers, and commits all resulting changes to the project repository.

What happens to backlog markers when a phase is promoted to an active milestone?▼

When a phase is promoted to an active milestone, backlog markers are removed from the directory and ROADMAP.md. The system renames the directory using the next sequential phase number and adds the necessary Depends on dependency metadata.

Related Skills

Explore More Product & Management Skills→
gesmith0606gesmith0606

gsd-add-backlog

Create a backlog entry and phase directory from a ROADMAP.md description.

Community
Intermediate
hadpadrahulhadpadrahul

gsd-analyze-dependencies

Analyze milestone phase dependencies and generate ROADMAP.md updates.

Community
Advanced
nnexainnexai
1

gsd-review-backlog

Audit 999.x phase directories and promote backlog items to active milestones.

Community
Advanced
tinner-deinnotinner-deinno

gsd-review-backlog

Promote selected 999.x backlog phases into the active milestone sequence.

Community
Intermediate