Tom Boucher 81f9534b5a feat(adr-0002): command contract validation module + prose @-ref cleanup + workflow extraction ...

ADR-0002: commands/gsd/*.md contract now enforced at two layers:

LINT (scripts/lint-command-contract.cjs — new CI step):
- name: present, starts with gsd: or gsd-
- description: non-empty
- allowed-tools: non-empty, all entries canonical
- execution_context @-refs: resolve on disk, no trailing prose on same line
- handles both @~/ and $HOME/ path prefixes

TEST (tests/command-contract.test.cjs — 361 assertions):
- Behavioral contract for all 65 command files
- Replaces scattered coverage in enh-2790 + bug-3135
- Per-command per-rule test — one failure names the exact file + rule

CI (.github/workflows/test.yml):
- 'Lint — command contract (ADR-0002)' step added to lint-tests job

PROSE @-REF CLEANUP (39 command files, ~900 tokens/invocation recovered):
- Removed redundant @~/.claude/get-shit-done/... paths from <process> prose
- execution_context block is now the single authoritative load declaration
- Routing commands (sketch, spike, update, pause-work, etc.) keep routing
  instructions; only the inert path token is stripped

WORKFLOW EXTRACTION (debug.md + thread.md, ~15,000 chars / ~3,750 tokens):
- get-shit-done/workflows/debug.md: full process extracted from commands/gsd/debug.md
- get-shit-done/workflows/thread.md: full process extracted from commands/gsd/thread.md
- Command files reduced to frontmatter + objective + execution_context + context
- debug.md: 9,603 → 1,703 chars; thread.md: 7,868 → 585 chars

RENAME:
- get-shit-done/workflows/extract_learnings.md → extract-learnings.md
  (aligns with hyphen convention of all other workflow files)

DOCS:
- docs/INVENTORY.md: count 85→87, new rows, rename row, fix add-todo --backlog attribution
- docs/INVENTORY-MANIFEST.json: +debug.md +thread.md +extract-learnings.md -extract_learnings.md

Closes ADR-0002 implementation.

2026-05-05 15:18:13 -04:00

..

discuss-phase

fix: add explicit wait-for-subagent instructions in orchestration workflows (#2755)

2026-04-26 13:33:35 -04:00

execute-phase/steps

fix(#2772): only disable worktree isolation when planned paths touch submodules (#2779)

2026-04-27 12:31:32 -04:00

add-backlog.md

fix(#3135): restore workflows/add-backlog.md — capture --backlog had no workflow to load (#3147)

2026-05-05 15:02:38 -04:00

add-phase.md

fix(#2697): replace retired /gsd: prefix with /gsd- in all user-facing text (#2699)

2026-04-25 10:59:33 -04:00

add-tests.md

fix(#2697): replace retired /gsd: prefix with /gsd- in all user-facing text (#2699)

2026-04-25 10:59:33 -04:00

add-todo.md

feat(plan-phase): --research-phase flag + scrub stale slash-command refs (#3042, #3044) (#3045)

2026-05-02 23:12:50 -04:00

ai-integration-phase.md

fix(#3096): enforce sequential Steps 7+8 + Edit-only tool discipline in ai-integration-phase (#3143)

2026-05-05 15:02:23 -04:00

analyze-dependencies.md

fix(#2697): replace retired /gsd: prefix with /gsd- in all user-facing text (#2699)

2026-04-25 10:59:33 -04:00

audit-fix.md

fix: add explicit wait-for-subagent instructions in orchestration workflows (#2755)

2026-04-26 13:33:35 -04:00

audit-milestone.md

fix(workflows,docs): scrub stale /gsd-code-review-fix and /gsd-plan-milestone-gaps refs (#3029, #3034) (#3038)

2026-05-02 17:23:44 -04:00

audit-uat.md

fix(#2697): replace retired /gsd: prefix with /gsd- in all user-facing text (#2699)

2026-04-25 10:59:33 -04:00

autonomous.md

refactor(#2790): consolidate 86 gsd-* skills to 59 — fold flags, delete dead skills (#2824)

2026-04-30 00:43:47 -04:00

check-todos.md

feat(plan-phase): --research-phase flag + scrub stale slash-command refs (#3042, #3044) (#3045)

2026-05-02 23:12:50 -04:00

cleanup.md

fix(#2767): pass paths via --files to gsd-sdk query commit + lint guard (#2781)

2026-04-27 12:31:43 -04:00

code-review-fix.md

feat(plan-phase): --research-phase flag + scrub stale slash-command refs (#3042, #3044) (#3045)

2026-05-02 23:12:50 -04:00

code-review.md

feat(plan-phase): --research-phase flag + scrub stale slash-command refs (#3042, #3044) (#3045)

2026-05-02 23:12:50 -04:00

complete-milestone.md

fix(#2767): pass paths via --files to gsd-sdk query commit + lint guard (#2781)

2026-04-27 12:31:43 -04:00

debug.md

feat(adr-0002): command contract validation module + prose @-ref cleanup + workflow extraction

2026-05-05 15:18:13 -04:00

diagnose-issues.md

fix(#2767): pass paths via --files to gsd-sdk query commit + lint guard (#2781)

2026-04-27 12:31:43 -04:00

discovery-phase.md

feat(plan-phase): --research-phase flag + scrub stale slash-command refs (#3042, #3044) (#3045)

2026-05-02 23:12:50 -04:00

discuss-phase-assumptions.md

fix(#2767): pass paths via --files to gsd-sdk query commit + lint guard (#2781)

2026-04-27 12:31:43 -04:00

discuss-phase-power.md

fix(#2697): replace retired /gsd: prefix with /gsd- in all user-facing text (#2699)

2026-04-25 10:59:33 -04:00

discuss-phase.md

fix(workflows): make optional findings-skill probes non-fatal

2026-05-04 23:13:33 -04:00

do.md

fix(#2954): align help.md with post-#2824 skill consolidation (#2959)

2026-05-01 13:36:44 -04:00

docs-update.md

fix: add explicit wait-for-subagent instructions in orchestration workflows (#2755)

2026-04-26 13:33:35 -04:00

edit-phase.md

feat: add /gsd-edit-phase command to modify roadmap phases in place (#2753)

2026-04-26 13:33:52 -04:00

eval-review.md

fix(#2697): replace retired /gsd: prefix with /gsd- in all user-facing text (#2699)

2026-04-25 10:59:33 -04:00

execute-phase.md

fix(#3097, #3099): add cwd-drift sentinel + absolute-path guard to executor worktree protocol (#3144)

2026-05-05 15:02:26 -04:00

execute-plan.md

feat(workflows): atomic Write+commit ordering for SUMMARY.md (#2806) (#2939)

2026-05-01 09:32:21 -04:00

explore.md

fix(docs): replace stale /gsd-next references with /gsd-progress --next

2026-05-04 22:54:01 -04:00

extract-learnings.md

feat(adr-0002): command contract validation module + prose @-ref cleanup + workflow extraction

2026-05-05 15:18:13 -04:00

fast.md

fix(#2697): replace retired /gsd: prefix with /gsd- in all user-facing text (#2699)

2026-04-25 10:59:33 -04:00

forensics.md

fix(#2722): forensics gh commands pin --repo gsd-build/get-shit-done (#2723)

2026-04-25 16:47:55 -04:00

graduation.md

feat(workflows): close LEARNINGS.md consumption-and-graduation loop (#2490)

2026-04-20 18:21:35 -04:00

health.md

feat(#2792): namespace meta-skills + keyword-tag descriptions + context utilization guard (#2825)

2026-04-30 01:04:41 -04:00

help.md

fix(#3131): re-wire 4 orphaned workflows as flags on parent commands

2026-05-05 10:51:10 -04:00

import.md

fix(#2767): pass paths via --files to gsd-sdk query commit + lint guard (#2781)

2026-04-27 12:31:43 -04:00

inbox.md

fix(#2697): replace retired /gsd: prefix with /gsd- in all user-facing text (#2699)

2026-04-25 10:59:33 -04:00

ingest-docs.md

fix(#2851): replace bare gsd-tools invocations with absolute path (#2869)

2026-04-29 21:52:20 -04:00

insert-phase.md

fix(#2697): replace retired /gsd: prefix with /gsd- in all user-facing text (#2699)

2026-04-25 10:59:33 -04:00

list-phase-assumptions.md

fix(#2697): replace retired /gsd: prefix with /gsd- in all user-facing text (#2699)

2026-04-25 10:59:33 -04:00

list-workspaces.md

feat(plan-phase): --research-phase flag + scrub stale slash-command refs (#3042, #3044) (#3045)

2026-05-02 23:12:50 -04:00

manager.md

fix: add explicit wait-for-subagent instructions in orchestration workflows (#2755)

2026-04-26 13:33:35 -04:00

map-codebase.md

fix(#2767): pass paths via --files to gsd-sdk query commit + lint guard (#2781)

2026-04-27 12:31:43 -04:00

milestone-summary.md

fix(#2767): pass paths via --files to gsd-sdk query commit + lint guard (#2781)

2026-04-27 12:31:43 -04:00

new-milestone.md

fix(#2767): pass paths via --files to gsd-sdk query commit + lint guard (#2781)

2026-04-27 12:31:43 -04:00

new-project.md

fix(workflows): make optional findings-skill probes non-fatal

2026-05-04 23:13:33 -04:00

new-workspace.md

feat(plan-phase): --research-phase flag + scrub stale slash-command refs (#3042, #3044) (#3045)

2026-05-02 23:12:50 -04:00

next.md

fix(docs): replace stale /gsd-next references with /gsd-progress --next

2026-05-04 22:54:01 -04:00

node-repair.md

feat: add node repair operator for autonomous task failure recovery (#1016)

2026-03-12 11:35:45 -06:00

note.md

fix(#2697): replace retired /gsd: prefix with /gsd- in all user-facing text (#2699)

2026-04-25 10:59:33 -04:00

pause-work.md

fix(#2767): pass paths via --files to gsd-sdk query commit + lint guard (#2781)

2026-04-27 12:31:43 -04:00

plan-milestone-gaps.md

fix(#2767): pass paths via --files to gsd-sdk query commit + lint guard (#2781)

2026-04-27 12:31:43 -04:00

plan-phase.md

fix(workflows): make optional findings-skill probes non-fatal

2026-05-04 23:13:33 -04:00

plan-review-convergence.md

feat(#2306): plan-review-convergence v2 — CYCLE_SUMMARY contract, config gate, local model reviewers (#2718)

2026-04-25 14:18:34 -04:00

plant-seed.md

fix(#2767): pass paths via --files to gsd-sdk query commit + lint guard (#2781)

2026-04-27 12:31:43 -04:00

pr-branch.md

fix(#2697): replace retired /gsd: prefix with /gsd- in all user-facing text (#2699)

2026-04-25 10:59:33 -04:00

profile-user.md

fix(#2973): /gsd-profile-user writes dev-preferences.md to skills/, not legacy commands/gsd/ (#3003)

2026-05-02 00:29:45 -04:00

progress.md

fix(progress): remove stale list-phase-assumptions routing

2026-05-04 22:47:16 -04:00

quick.md

fix(sdk-guidance): point quick install hint and agent fallbacks to query-capable CLI

2026-05-04 23:18:41 -04:00

reapply-patches.md

fix(#2994): move verify-reapply-patches.cjs to get-shit-done/bin/ so it ships to user installs (#3000)

2026-05-02 00:29:34 -04:00

remove-phase.md

fix(#2767): pass paths via --files to gsd-sdk query commit + lint guard (#2781)

2026-04-27 12:31:43 -04:00

remove-workspace.md

fix(#2697): replace retired /gsd: prefix with /gsd- in all user-facing text (#2699)

2026-04-25 10:59:33 -04:00

resume-project.md

fix(resume): remove clear prefix from resume routing

2026-05-04 22:52:30 -04:00

review.md

fix(#2767): pass paths via --files to gsd-sdk query commit + lint guard (#2781)

2026-04-27 12:31:43 -04:00

scan.md

fix: add explicit wait-for-subagent instructions in orchestration workflows (#2755)

2026-04-26 13:33:35 -04:00

secure-phase.md

fix(#3120): add register_authored_at_plan_time guard — prevent rubber-stamping legacy phases (#3142)

2026-05-05 15:02:19 -04:00

session-report.md

fix(#2697): replace retired /gsd: prefix with /gsd- in all user-facing text (#2699)

2026-04-25 10:59:33 -04:00

settings-advanced.md

feat: extend RUNTIME_PROFILE_MAP to gemini/qwen/opencode/copilot + settings-advanced UI (#2754)

2026-04-26 13:33:54 -04:00

settings-integrations.md

fix(#2697): replace retired /gsd: prefix with /gsd- in all user-facing text (#2699)

2026-04-25 10:59:33 -04:00

settings.md

fix(#2950): update stale deleted-command references in workflow files (#2952)

2026-05-01 11:25:10 -04:00

ship.md

fix(#2767): pass paths via --files to gsd-sdk query commit + lint guard (#2781)

2026-04-27 12:31:43 -04:00

sketch-wrap-up.md

fix(#2767): pass paths via --files to gsd-sdk query commit + lint guard (#2781)

2026-04-27 12:31:43 -04:00

sketch.md

fix(#2949): wire sketch --wrap-up flag dispatch (#2953)

2026-05-01 11:06:24 -04:00

spec-phase.md

fix(#2697): replace retired /gsd: prefix with /gsd- in all user-facing text (#2699)

2026-04-25 10:59:33 -04:00

spike-wrap-up.md

fix(#2767): pass paths via --files to gsd-sdk query commit + lint guard (#2781)

2026-04-27 12:31:43 -04:00

spike.md

fix(#2950): update stale deleted-command references in workflow files (#2952)

2026-05-01 11:25:10 -04:00

stats.md

fix(#2697): replace retired /gsd: prefix with /gsd- in all user-facing text (#2699)

2026-04-25 10:59:33 -04:00

sync-skills.md

fix(#2697): replace retired /gsd: prefix with /gsd- in all user-facing text (#2699)

2026-04-25 10:59:33 -04:00

thread.md

feat(adr-0002): command contract validation module + prose @-ref cleanup + workflow extraction

2026-05-05 15:18:13 -04:00

transition.md

feat(plan-phase): --research-phase flag + scrub stale slash-command refs (#3042, #3044) (#3045)

2026-05-02 23:12:50 -04:00

ui-phase.md

fix(workflows): make optional findings-skill probes non-fatal

2026-05-04 23:13:33 -04:00

ui-review.md

fix(#2767): pass paths via --files to gsd-sdk query commit + lint guard (#2781)

2026-04-27 12:31:43 -04:00

ultraplan-phase.md

fix(#2697): replace retired /gsd: prefix with /gsd- in all user-facing text (#2699)

2026-04-25 10:59:33 -04:00

undo.md

fix(#2697): replace retired /gsd: prefix with /gsd- in all user-facing text (#2699)

2026-04-25 10:59:33 -04:00

update.md

fix(#3130): harden update.md npx invocations against cache-stale and token-routing failures (#3136)

2026-05-05 15:01:59 -04:00

validate-phase.md

fix: add explicit wait-for-subagent instructions in orchestration workflows (#2755)

2026-04-26 13:33:35 -04:00

verify-phase.md

feat: add gates ensuring discuss-phase decisions are translated to plans and verified (closes #2492) (#2611)

2026-04-23 00:26:53 -04:00

verify-work.md

fix(#2767): pass paths via --files to gsd-sdk query commit + lint guard (#2781)

2026-04-27 12:31:43 -04:00