Cds Add Backlog

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.

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

``bash cat .planning/ROADMAP.md ``

1. Find next backlog number:

``bash NEXT=$(node "$HOME/.claude/cds-workflow/bin/gsd-tools.cjs" phase next-decimal 999 --raw) `` If no 999.x phases exist, start at 999.1.

1. Create the phase directory:

``bash SLUG=$(node "$HOME/.claude/cds-workflow/bin/gsd-tools.cjs" generate-slug "$ARGUMENTS" --raw) mkdir -p ".planning/phases/${NEXT}-${SLUG}" touch ".planning/phases/${NEXT}-${SLUG}/.gitkeep" ``

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

```markdown ## Backlog

### Phase {NEXT}: {description} (BACKLOG)

Goal: [Captured for future planning] Requirements: TBD Plans: 0 plans

Plans:

• [ ] TBD (promote with /cds-review-backlog when ready)

```

1. Commit:

``bash node "$HOME/.claude/cds-workflow/bin/gsd-tools.cjs" commit "docs: add backlog item ${NEXT} — ${ARGUMENTS}" --files .planning/ROADMAP.md ".planning/phases/${NEXT}-${SLUG}/.gitkeep" ``

1. Report:

``` ## 📋 Backlog Item Added

Phase {NEXT}: {description} Directory: .planning/phases/{NEXT}-{slug}/

This item lives in the backlog parking lot. Use /cds-discuss-phase {NEXT} to explore it further. Use /cds-review-backlog to promote items to active milestone. ```

• 999.x numbering keeps backlog items out of the active phase sequence
• Phase directories are created immediately, so /cds-discuss-phase and /cds-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

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: Enakoneschniy
• Source: Enakoneschniy/claude-dev-stack
• License: MIT

Install and usage instructions live in the source repository linked above.