source-command-gsd-review-backlog

Use this skill when the user asks to run the migrated source command gsd-review-backlog.

Command Template

<objective> Review all 999.x backlog items and optionally promote them into the active milestone sequence or remove stale entries. </objective>

<process>

1. List backlog items:

``bash ls -d .planning/phases/999* 2>/dev/null || echo "No backlog items found" ``

1. Read ROADMAP.md and extract all 999.x phase entries:

``bash cat .planning/ROADMAP.md `` Show each backlog item with its description, any accumulated context (CONTEXT.md, RESEARCH.md), and creation date.

1. Present the list to the user via AskUserQuestion:

- For each backlog item, show: phase number, description, accumulated artifacts - Options per item: Promote (move to active), Keep (leave in backlog), Remove (delete)

1. For items to PROMOTE:

- Find the next sequential phase number in the active milestone - Rename the directory from 999.x-slug to {newnum}-slug: ``bash NEWNUM=$(gsd-sdk query phase.add "${DESCRIPTION}" --raw) ` - Move accumulated artifacts to the new phase directory - Update ROADMAP.md: move the entry from ## Backlog section to the active phase list - Remove (BACKLOG) marker - Add appropriate Depends on:` field

1. For items to REMOVE:

- Delete the phase directory - Remove the entry from ROADMAP.md ## Backlog section

1. Commit changes:

``bash gsd-sdk query commit "docs: review backlog — promoted N, removed M" .planning/ROADMAP.md ``

1. Report summary:

``` ## 📋 Backlog Review Complete

Promoted: {list of promoted items with new phase numbers} Kept: {list of items remaining in backlog} Removed: {list of deleted items} ```

</process>