shine-add-backlog

Add an idea to the backlog parking lot (999.x numbering)

<objective> Add a backlog item to the roadmap using 999.x numbering. Backlog items are unsequenced ideas that aren't ready for active planning — they live outside the normal phase sequence and accumulate context over time. </objective> <process>

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

    cat .planning/ROADMAP.md

  2. Find next backlog number:

    NEXT=$(node "$HOME/.claude/shine/bin/shine-tools.cjs" phase next-decimal 999 --raw)

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

  3. Create the phase directory:

    SLUG=$(node "$HOME/.claude/shine/bin/shine-tools.cjs" 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 /shine-review-backlog when ready)

  5. Commit:

    node "$HOME/.claude/shine/bin/shine-tools.cjs" 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 /shine-discuss-phase {NEXT} to explore it further.
Use /shine-review-backlog to promote items to active milestone.
</process> <notes> - 999.x numbering keeps backlog items out of the active phase sequence - Phase directories are created immediately, so /shine-discuss-phase and /shine-plan-phase work on them - No `Depends on:` field — backlog items are unsequenced by definition - Sparse numbering is fine (999.1, 999.3) — always uses next-decimal </notes>