SKILL.md
<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:
``bash 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:
``bash 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 {newnum}-slug: ``bash NEWNUM=$(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:
``bash 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} ```
</process>