## Backlog Review Context (pre-injected by WXP)
**Todos:**
**Roadmap:**
**State:**
---
Review accumulated backlog items (999.x phases and pending todos) and decide what to do with each: promote to a real phase, convert to a todo, discard, or keep.
This is the "inbox zero" command for ideas that were parked during active development.
**Step A: Extract backlog phases from roadmap.**
From `roadmap` JSON, find all phases where `phase_number` starts with `999` (backlog entries added via `/gsd-add-backlog`).
**Step B: Extract pending todos from todos data.**
From `todos-data` JSON, extract `todos` array with fields: `id`, `title`, `area`, `created`, `problem`.
**If both backlog phases and todos are empty:**
```
Nothing in the backlog. The queue is clear.
To capture an idea: /gsd-add-backlog
To capture a todo: /gsd-add-todo
```
Exit.
Display a combined inventory:
```
## Backlog Review
### 999.x Backlog Phases ({N} items)
| Phase | Idea | Added |
|-------|------|-------|
| 999.1 | {idea} | {date} |
| 999.2 | {idea} | {date} |
### Pending Todos ({M} items)
| # | Title | Area | Created |
|---|-------|------|---------|
| 1 | {title} | {area} | {date} |
| 2 | {title} | {area} | {date} |
**Total:** {N+M} items to review
```
Ask:
```
Options:
1. Review each item interactively (recommended)
2. Promote a specific backlog phase → real phase number
3. Work on a specific todo
4. Discard a backlog phase
5. Done (keep everything)
```
**If user chooses interactive review:**
For each backlog phase (999.x), present:
```
## Phase 999.{N}: {idea}
Options:
1. Promote to next available phase slot ← recommended if actionable
2. Convert to a todo (more granular)
3. Keep in backlog
4. Discard (remove from ROADMAP.md)
```
**Promote:** Remove the 999.x entry, add as a properly numbered phase at the end of the current milestone using:
```bash
pi-gsd-tools roadmap add-phase "{next_available_number}" "{idea_text}" --raw
```
Then remove the 999.x placeholder:
```bash
pi-gsd-tools roadmap remove-phase "999.{N}" --raw
```
**Convert to todo:** Create a todo file (see `/gsd-add-todo` workflow) and remove the 999.x phase entry.
**Discard:**
```bash
pi-gsd-tools roadmap remove-phase "999.{N}" --raw
```
For each pending todo, present:
```
## Todo: {title}
Area: {area}
Problem: {problem excerpt}
Options:
1. Work on this now → promote to current phase plan
2. Keep as todo
3. Promote to backlog phase
4. Mark done (won't be worked on)
```
After all reviews, commit any ROADMAP.md changes and completed todos:
```bash
pi-gsd-tools commit "docs: backlog review - promoted {X} items, discarded {Y}" --files .planning/ROADMAP.md .planning/todos/done/
```
Display summary:
```
## Backlog Review Complete
✓ Promoted: {list of promoted items}
✓ Converted: {list of todos created}
✓ Discarded: {count}
→ Kept: {count remaining}
{If phases promoted:}
Next: /gsd-plan-phase {new_phase_number}
```
- [ ] All 999.x backlog phases listed
- [ ] All pending todos listed
- [ ] Each item reviewed with a clear decision
- [ ] Promotions written to ROADMAP.md
- [ ] Discards removed from ROADMAP.md
- [ ] Changes committed to git
- [ ] User knows what's next