Gsd Review Backlog

<objective>

Review all 999.x backlog items and optionally promote them into the active

milestone sequence or remove stale entries.

</objective>

<process>

• List backlog items:

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

• 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=$(node "$HOME/.claude/get-shit-done/bin/gsd-tools.cjs" 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:

   node "$HOME/.claude/get-shit-done/bin/gsd-tools.cjs" 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}

</process>