gsd-review-backlog

List backlog items:

_BACKLOG=( .planning/phases/999* )
if [ -e "${_BACKLOG[0]}" ]; then ls -d "${_BACKLOG[@]}"; else echo "No backlog items found"; fi

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

cat .planning/ROADMAP.md

Show each backlog item with its description, any accumulated context (CONTEXT.md, RESEARCH.md), and creation date.

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)

For items to PROMOTE:

• Find the next sequential phase number in the active milestone
• Rename the directory from 999.x-slug to {new_num}-slug:

  NEW_NUM=$(gsd-tools 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

For items to REMOVE:

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

Commit changes:

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

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}