c2b3f02d41
* fix(#3121): implement commands verb in SDK native registry - Add commandsList handler — returns sorted JSON array of all registered verb strings; satisfies workstream-flag.md + agent tooling discoverability - Register ['commands', commandsList] in DECISION_ROUTING_STATIC_CATALOG - Add golden-policy exemption (SDK-only, no CJS mirror needed) - check.decision-coverage-plan/verify were already registered; commands was the remaining gap Closes #3121 * fix(#3135): restore workflows/add-backlog.md — capture --backlog had no workflow to load Root cause: PR #2824 consolidated add-backlog into gsd-capture --backlog and wired capture.md to delegate to workflows/add-backlog.md via execution_context. The workflow file was never created (same gap class as reapply-patches.md which was caught and fixed in the same PR). With no file to load, the agent had no implementation steps to follow when --backlog was invoked. Fix: - Restore get-shit-done/workflows/add-backlog.md with full process from deleted commands/gsd/add-backlog.md (phase.next-decimal, ROADMAP write, mkdir, commit) - Preserve #2280 ordering invariant: ROADMAP entry written before directory - Fix docs/INVENTORY.md: remove incorrect attribution of --backlog to add-todo.md, add add-backlog.md row, bump workflow count 84→85 - Update docs/INVENTORY-MANIFEST.json - Add regression test: every execution_context @-reference in commands/gsd/*.md must resolve to an existing workflow file on disk Closes #3135
86 lines
2.3 KiB
Markdown
86 lines
2.3 KiB
Markdown
# Add Backlog Item Workflow
|
|
|
|
Invoked by `/gsd-capture --backlog` (`commands/gsd/capture.md`).
|
|
|
|
Adds an idea to the ROADMAP.md backlog parking lot 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.
|
|
|
|
<process>
|
|
|
|
## Step 1: Read ROADMAP.md
|
|
|
|
Check for existing backlog entries:
|
|
|
|
```bash
|
|
cat .planning/ROADMAP.md
|
|
```
|
|
|
|
## Step 2: Find next backlog number
|
|
|
|
```bash
|
|
NEXT=$(gsd-sdk query phase.next-decimal 999 --raw)
|
|
```
|
|
|
|
If no 999.x phases exist yet, `phase.next-decimal` returns `999.1`. Sparse numbering
|
|
is fine (e.g. 999.1, 999.3) — always use `phase.next-decimal`, never guess.
|
|
|
|
## Step 3: Write ROADMAP entry
|
|
|
|
**Write the ROADMAP entry BEFORE creating the directory.** Directory existence is a
|
|
reliable indicator that the phase is already registered, which prevents false duplicate
|
|
detection in any hook that checks for existing 999.x directories (#2280).
|
|
|
|
Add under a `## Backlog` section. If the section doesn't exist, create it at the end
|
|
of ROADMAP.md:
|
|
|
|
```markdown
|
|
## Backlog
|
|
|
|
### Phase {NEXT}: {description} (BACKLOG)
|
|
|
|
**Goal:** [Captured for future planning]
|
|
**Requirements:** TBD
|
|
**Plans:** 0 plans
|
|
|
|
Plans:
|
|
- [ ] TBD (promote with /gsd-review-backlog when ready)
|
|
```
|
|
|
|
## Step 4: Create the phase directory
|
|
|
|
```bash
|
|
SLUG=$(gsd-sdk query generate-slug "$ARGUMENTS" --raw)
|
|
mkdir -p ".planning/phases/${NEXT}-${SLUG}"
|
|
touch ".planning/phases/${NEXT}-${SLUG}/.gitkeep"
|
|
```
|
|
|
|
## Step 5: Commit
|
|
|
|
```bash
|
|
gsd-sdk query commit "docs: add backlog item ${NEXT} — ${ARGUMENTS}" --files .planning/ROADMAP.md ".planning/phases/${NEXT}-${SLUG}/.gitkeep"
|
|
```
|
|
|
|
## Step 6: 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.
|
|
```
|
|
|
|
</process>
|
|
|
|
<notes>
|
|
- 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
|
|
- Promote backlog items to the active milestone with /gsd-review-backlog
|
|
</notes>
|