b136396610
Three new commands for managing ideas and cross-session context: /gsd:add-backlog <description> Adds a 999.x numbered backlog item to ROADMAP.md. Creates phase directory immediately so /gsd:discuss-phase and /gsd:plan-phase work on them. No dependencies, no sequencing — pure parking lot. /gsd:review-backlog Lists all 999.x items, lets user promote to active milestone, keep, or remove. Promotion renumbers to next sequential phase with proper deps. /gsd:thread [name | description] Three modes: - No args: list all threads with status - Existing name: resume thread, load context - New description: create thread from current conversation context Threads live in .planning/threads/ as lightweight markdown files with Goal, Context, References, and Next Steps sections. Design: - Self-contained command files, no core changes needed - 999.x numbering keeps backlog out of active sequence - Threads are independent of phases — cross-session knowledge stores - Both features compose with existing GSD commands Fixes #1005
62 lines
1.9 KiB
Markdown
62 lines
1.9 KiB
Markdown
---
|
|
name: gsd:review-backlog
|
|
description: Review and promote backlog items to active milestone
|
|
allowed-tools:
|
|
- Read
|
|
- Write
|
|
- Bash
|
|
---
|
|
|
|
<objective>
|
|
Review all 999.x backlog items and optionally promote them into the active
|
|
milestone sequence or remove stale entries.
|
|
</objective>
|
|
|
|
<process>
|
|
|
|
1. **List backlog items:**
|
|
```bash
|
|
ls -d .planning/phases/999* 2>/dev/null || echo "No backlog items found"
|
|
```
|
|
|
|
2. **Read ROADMAP.md** and extract all 999.x phase entries:
|
|
```bash
|
|
cat .planning/ROADMAP.md
|
|
```
|
|
Show each backlog item with its description, any accumulated context (CONTEXT.md, RESEARCH.md), and creation date.
|
|
|
|
3. **Present the list to the user** via AskUserQuestion:
|
|
- For each backlog item, show: phase number, description, accumulated artifacts
|
|
- Options per item: **Promote** (move to active), **Keep** (leave in backlog), **Remove** (delete)
|
|
|
|
4. **For items to PROMOTE:**
|
|
- Find the next sequential phase number in the active milestone
|
|
- Rename the directory from `999.x-slug` to `{new_num}-slug`:
|
|
```bash
|
|
NEW_NUM=$(node "$HOME/.claude/get-shit-done/bin/gsd-tools.cjs" phase add "${DESCRIPTION}" --raw)
|
|
```
|
|
- Move accumulated artifacts to the new phase directory
|
|
- Update ROADMAP.md: move the entry from `## Backlog` section to the active phase list
|
|
- Remove `(BACKLOG)` marker
|
|
- Add appropriate `**Depends on:**` field
|
|
|
|
5. **For items to REMOVE:**
|
|
- Delete the phase directory
|
|
- Remove the entry from ROADMAP.md `## Backlog` section
|
|
|
|
6. **Commit changes:**
|
|
```bash
|
|
node "$HOME/.claude/get-shit-done/bin/gsd-tools.cjs" commit "docs: review backlog — promoted N, removed M" --files .planning/ROADMAP.md
|
|
```
|
|
|
|
7. **Report summary:**
|
|
```
|
|
## 📋 Backlog Review Complete
|
|
|
|
Promoted: {list of promoted items with new phase numbers}
|
|
Kept: {list of items remaining in backlog}
|
|
Removed: {list of deleted items}
|
|
```
|
|
|
|
</process>
|