Gsd Review Backlog

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 Augment tools when executing GSD workflows:

• launch-process for running commands (terminal operations)
• str-replace-editor for editing existing files
• view for reading files and listing directories
• save-file for creating new files
• grep for searching code (or use MCP servers for advanced search)
• web-search, web-fetch for web queries
• add_tasks, view_tasklist, update_tasks for task management

D. Subagent Spawning

When the workflow needs to spawn a subagent:

• Use the built-in subagent spawning capability
• Define agent prompts in .augment/agents/ directory

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=$(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

5. For items to REMOVE:

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

6. Commit changes:

   gsd-sdk query 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}