5.0 KiB
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 <idea>
To capture a todo: /gsd-add-todo <task>
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)
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:
pi-gsd-tools roadmap add-phase "{next_available_number}" "{idea_text}" --raw
Then remove the 999.x placeholder:
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:
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)
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}
<success_criteria>
- 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 </success_criteria>