Slash Command

/add-backlog

Adds an idea to the backlog parking lot (999.x numbering). Creates a phase directory, updates ROADMAP.md with a backlog entry, and commits the change.

automation

git-workflow

Popularity

Parent stars

Parent forks

Invocation

How this command is triggered — by the user, by Claude, or both

Slash command

/gsd:add-backlog <description>

Model invocable

No pre-commands

Configuration

Namespacegsd/

Tool Access

This command is limited to the following tools:

ReadWriteBash

Context Preview

The summary Claude sees in its command listing — used to decide when to auto-load this command

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

2. **Find next backlog number:**
   
   If no 999.x phases exist, start at 999.1.

3. **Create the phase directory:**
   

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

   

5. **Commit:**
   

6. **Report:**
   

</process>
...

Command Content

77 lines · ~544 tokens

Stats

LanguagePython

Parent stars7

Parent forks9

MaintenanceGood

Last CommitJun 29, 2026

Actions

View Source View Plugin View on GitHub View README

Tags

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.

Read ROADMAP.md to find existing backlog entries:
```
cat .planning/ROADMAP.md
```

Find next backlog number:

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

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

Create the phase directory:

SLUG=$(node "$HOME/.claude/get-shit-done/bin/gsd-tools.cjs" generate-slug "$ARGUMENTS")
mkdir -p ".planning/phases/${NEXT}-${SLUG}"
touch ".planning/phases/${NEXT}-${SLUG}/.gitkeep"

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)

Commit:

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

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.

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