370033e907
* test(phase-dir): add red test for k015 prefix-drift in plan-milestone-gaps and import workflows (#3298) Asserts that: - plan-milestone-gaps.md step 8 does not use bare {NN}-{name} mkdir pattern - plan-milestone-gaps.md step 8 uses phase.add or expected_phase_dir - import.md plan_convert does not use bare {NN}-{slug} mkdir pattern - import.md plan_convert uses expected_phase_dir from init.phase-op These 5 tests are RED until the fix lands. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * fix(phase-dir): add projectCode prefix to phase-dir construction in plan-milestone-gaps and import workflows (#3298) Both plan-milestone-gaps.md step 8 and import.md plan_convert step were constructing phase directories using raw {NN}-{name}/{NN}-{slug} template patterns, bypassing the project_code prefix from .planning/config.json. Fix: both steps now call `gsd-sdk query init.phase-op <N>` and consume the `expected_phase_dir` field (which includes the `<CODE>-<NN>-<slug>` prefix when project_code is set), matching the pattern already established by PR #3292 for /gsd-discuss-phase and /gsd-plan-phase. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * fix(phase-dir): apply project_code prefix to backlog phase dir in add-backlog workflow (k015 sibling, #3298) Sibling k015 audit found a third drift site: add-backlog.md step 4 was constructing the 999.x backlog phase directory using raw ${NEXT}-${SLUG} without applying the project_code prefix from .planning/config.json. Fix: read project_code via `gsd-sdk query config-get project_code --raw` and prepend `${CODE}-` when set, matching the pattern used by phase.insert (which already applies project_code to decimal phases in phase.cjs line 736). Also extends bug-3298 regression test to cover this third site. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * chore(changeset): add changeset for #3298 phase-dir prefix drift fix Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * chore(changeset): set pr: 3306 in changeset for #3298; resolve stash conflict in live-command-registry.cjs The conflict was cosmetic (string concat → template literals) introduced by accidental git stash during test verification. Taking the newer template-literal form throughout. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> --------- Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
91 lines
2.6 KiB
Markdown
91 lines
2.6 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
|
|
|
|
Apply the `project_code` prefix (if set in `.planning/config.json`) so the backlog directory name is consistent with all other phase-creation paths:
|
|
|
|
```bash
|
|
SLUG=$(gsd-sdk query generate-slug "$ARGUMENTS" --raw)
|
|
PROJECT_CODE=$(gsd-sdk query config-get project_code --raw 2>/dev/null || echo "")
|
|
PREFIX=$([ -n "$PROJECT_CODE" ] && echo "${PROJECT_CODE}-" || echo "")
|
|
PHASE_DIR=".planning/phases/${PREFIX}${NEXT}-${SLUG}"
|
|
mkdir -p "${PHASE_DIR}"
|
|
touch "${PHASE_DIR}/.gitkeep"
|
|
```
|
|
|
|
## Step 5: Commit
|
|
|
|
```bash
|
|
gsd-sdk query commit "docs: add backlog item ${NEXT} — ${ARGUMENTS}" --files .planning/ROADMAP.md "${PHASE_DIR}/.gitkeep"
|
|
```
|
|
|
|
## Step 6: Report
|
|
|
|
```
|
|
## 📋 Backlog Item Added
|
|
|
|
Phase {NEXT}: {description}
|
|
Directory: {PHASE_DIR}/
|
|
|
|
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>
|