msd-core/commands/gsd/review-backlog.md at fbfeffe6ba7d12b2be77f2b1e5935a4d6d9f47c7

Files

Tom Boucher b136396610 feat: add backlog parking lot and persistent context threads (#1005 )

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

2026-03-18 20:28:40 -04:00

1.9 KiB

Raw Blame History

name, description, allowed-tools

name

description

allowed-tools

gsd:review-backlog

Review and promote backlog items to active milestone

Read

Write

Bash

Review all 999.x backlog items and optionally promote them into the active milestone sequence or remove stale entries.

List backlog items:

ls -d .planning/phases/999* 2>/dev/null || echo "No backlog items found"

Read ROADMAP.md and extract all 999.x phase entries:
```
cat .planning/ROADMAP.md
```
Show each backlog item with its description, any accumulated context (CONTEXT.md, RESEARCH.md), and creation date.
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)
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:
```
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
For items to REMOVE:
- Delete the phase directory
- Remove the entry from ROADMAP.md ## Backlog section

Commit changes:

node "$HOME/.claude/get-shit-done/bin/gsd-tools.cjs" commit "docs: review backlog — promoted N, removed M" --files .planning/ROADMAP.md

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}

1.9 KiB Raw Blame History

1.9 KiB

Raw Blame History