gsd-add-backlog

name: gsd-add-backlog description: "Add an idea to the backlog parking lot (999.x numbering)" argument-hint: "<description>" allowed-tools:

• Read
• Write
• Bash

1. Read ROADMAP.md to find existing backlog entries:

   cat .planning/ROADMAP.md
   

2. Find next backlog number:

   NEXT=$(node "$GSD_TOOLS" phase next-decimal 999 --raw)
   

   If no 999.x phases exist, start at 999.1.

3. Create the phase directory:

   SLUG=$(node "$GSD_TOOLS" generate-slug "$ARGUMENTS" --raw)
   mkdir -p ".planning/phases/${NEXT}-${SLUG}"
   touch ".planning/phases/${NEXT}-${SLUG}/.gitkeep"
   

4. Add to ROADMAP.md under a ## Backlog section. If the section doesn't exist, create it at the end:

   ## Backlog
   
   ### Phase {NEXT}: {description} (BACKLOG)
   
   **Goal:** [Captured for future planning]
   **Requirements:** TBD
   **Plans:** 0 plans
   
   Plans:
   - [ ] TBD (promote with /gsd-review-backlog when ready)
   

5. Commit:

   node "$GSD_TOOLS" commit "docs: add backlog item ${NEXT} — ${ARGUMENTS}" --files .planning/ROADMAP.md ".planning/phases/${NEXT}-${SLUG}/.gitkeep"
   

6. Report:

   ## 📋 Backlog Item Added
   
   Phase {NEXT}: {description}
   Directory: .planning/phases/{NEXT}-{slug}/
   
   This item lives in the backlog parking lot.
   Use /gsd-discuss-phase {NEXT} to explore it further.
   Use /gsd-review-backlog to promote items to active milestone.