jmochel/gsd-review-backlog

<cursor_skill_adapter>

A. Skill Invocation

• This skill is invoked when the user mentions gsd-review-backlog or describes a task matching this skill.
• Treat all user text after the skill mention as {{GSD_ARGS}}.
• If no arguments are present, treat {{GSD_ARGS}} as empty.

B. User Prompting

When the workflow needs user input, prompt the user conversationally:

• Present options as a numbered list in your response text
• Ask the user to reply with their choice
• For multi-select, ask for comma-separated numbers

C. Tool Usage

Use these Cursor tools when executing GSD workflows:

• Shell for running commands (terminal operations)
• StrReplace for editing existing files
• Read, Write, Glob, Grep, Task, WebSearch, WebFetch, TodoWrite as needed

D. Subagent Spawning

When the workflow needs to spawn a subagent:

• Use Task(subagent_type="generalPurpose", ...)
• The model parameter maps to Cursor's model options (e.g., "fast") </cursor_skill_adapter>

<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:

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

2. 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.

3. Present the list to the user via conversational prompting:

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

4. 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/jmochel/pers/viracocha/.cursor/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

5. For items to REMOVE:

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

6. Commit changes:

   node "/home/jmochel/pers/viracocha/.cursor/get-shit-done/bin/gsd-tools.cjs" commit "docs: review backlog — promoted N, removed M" --files .planning/ROADMAP.md
   

7. 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>