pi-gsd 2.0.22 → 2.0.23

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (52) hide show
  1. package/.gsd/harnesses/pi/get-shit-done/agents/gsd-codebase-mapper.md +13 -13
  2. package/.gsd/harnesses/pi/get-shit-done/agents/gsd-debugger.md +37 -37
  3. package/.gsd/harnesses/pi/get-shit-done/agents/gsd-executor.md +8 -8
  4. package/.gsd/harnesses/pi/get-shit-done/agents/gsd-nyquist-auditor.md +31 -31
  5. package/.gsd/harnesses/pi/get-shit-done/agents/gsd-phase-researcher.md +85 -85
  6. package/.gsd/harnesses/pi/get-shit-done/agents/gsd-plan-checker.md +32 -32
  7. package/.gsd/harnesses/pi/get-shit-done/agents/gsd-planner.md +108 -108
  8. package/.gsd/harnesses/pi/get-shit-done/agents/gsd-project-researcher.md +76 -76
  9. package/.gsd/harnesses/pi/get-shit-done/agents/gsd-research-synthesizer.md +16 -16
  10. package/.gsd/harnesses/pi/get-shit-done/agents/gsd-roadmapper.md +39 -39
  11. package/.gsd/harnesses/pi/get-shit-done/agents/gsd-ui-auditor.md +24 -24
  12. package/.gsd/harnesses/pi/get-shit-done/agents/gsd-ui-checker.md +21 -21
  13. package/.gsd/harnesses/pi/get-shit-done/agents/gsd-ui-researcher.md +35 -35
  14. package/.gsd/harnesses/pi/get-shit-done/agents/gsd-verifier.md +30 -30
  15. package/.gsd/harnesses/pi/get-shit-done/references/continuation-format.md +11 -11
  16. package/.gsd/harnesses/pi/get-shit-done/references/ui-brand.md +1 -1
  17. package/.gsd/harnesses/pi/get-shit-done/templates/DEBUG.md +4 -4
  18. package/.gsd/harnesses/pi/get-shit-done/templates/UAT.md +1 -1
  19. package/.gsd/harnesses/pi/get-shit-done/workflows/add-phase.md +36 -68
  20. package/.gsd/harnesses/pi/get-shit-done/workflows/audit-milestone.md +3 -3
  21. package/.gsd/harnesses/pi/get-shit-done/workflows/complete-milestone.md +1 -1
  22. package/.gsd/harnesses/pi/get-shit-done/workflows/discuss-phase-assumptions.md +1 -1
  23. package/.gsd/harnesses/pi/get-shit-done/workflows/discuss-phase.md +2 -2
  24. package/.gsd/harnesses/pi/get-shit-done/workflows/discuss-phase.md.bak +2 -2
  25. package/.gsd/harnesses/pi/get-shit-done/workflows/execute-phase.md +2 -2
  26. package/.gsd/harnesses/pi/get-shit-done/workflows/execute-phase.md.bak +2 -2
  27. package/.gsd/harnesses/pi/get-shit-done/workflows/execute-plan.md +1 -1
  28. package/.gsd/harnesses/pi/get-shit-done/workflows/help.md +5 -5
  29. package/.gsd/harnesses/pi/get-shit-done/workflows/insert-phase.md +1 -1
  30. package/.gsd/harnesses/pi/get-shit-done/workflows/map-codebase.md +1 -1
  31. package/.gsd/harnesses/pi/get-shit-done/workflows/new-milestone.md +1 -1
  32. package/.gsd/harnesses/pi/get-shit-done/workflows/new-milestone.md.bak +1 -1
  33. package/.gsd/harnesses/pi/get-shit-done/workflows/new-project.md +2 -2
  34. package/.gsd/harnesses/pi/get-shit-done/workflows/new-project.md.bak +2 -2
  35. package/.gsd/harnesses/pi/get-shit-done/workflows/plan-milestone-gaps.md +1 -1
  36. package/.gsd/harnesses/pi/get-shit-done/workflows/plan-phase.md +1 -1
  37. package/.gsd/harnesses/pi/get-shit-done/workflows/plan-phase.md.bak +1 -1
  38. package/.gsd/harnesses/pi/get-shit-done/workflows/progress.md +10 -10
  39. package/.gsd/harnesses/pi/get-shit-done/workflows/resume-project.md +2 -2
  40. package/.gsd/harnesses/pi/get-shit-done/workflows/settings.md +1 -1
  41. package/.gsd/harnesses/pi/get-shit-done/workflows/transition.md +3 -3
  42. package/.gsd/harnesses/pi/get-shit-done/workflows/ui-phase.md +1 -1
  43. package/.gsd/harnesses/pi/get-shit-done/workflows/ui-review.md +1 -1
  44. package/.gsd/harnesses/pi/get-shit-done/workflows/validate-phase.md +1 -1
  45. package/.gsd/harnesses/pi/get-shit-done/workflows/verify-work.md +1 -1
  46. package/.gsd/harnesses/pi/hooks/gsd-context-monitor.js +102 -102
  47. package/.gsd/harnesses/pi/hooks/gsd-statusline.js +2 -2
  48. package/.gsd/harnesses/pi/hooks/gsd-workflow-guard.js +65 -65
  49. package/README.md +1 -1
  50. package/dist/pi-gsd-hooks.js +33 -6
  51. package/dist/pi-gsd-tools.js +87 -76
  52. package/package.json +1 -1
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: gsd-plan-checker
3
- description: Verifies plans will achieve phase goal before execution. Goal-backward analysis of plan quality. Spawned by /gsd:plan-phase orchestrator.
3
+ description: Verifies plans will achieve phase goal before execution. Goal-backward analysis of plan quality. Spawned by /gsd-plan-phase orchestrator.
4
4
  tools: Read, Bash, Glob, Grep
5
5
  color: green
6
6
  ---
@@ -8,7 +8,7 @@ color: green
8
8
  <role>
9
9
  You are a GSD plan checker. Verify that plans WILL achieve the phase goal, not just that they look complete.
10
10
 
11
- Spawned by `/gsd:plan-phase` orchestrator (after planner creates PLAN.md) or re-verification (after planner revises).
11
+ Spawned by `/gsd-plan-phase` orchestrator (after planner creates PLAN.md) or re-verification (after planner revises).
12
12
 
13
13
  Goal-backward verification of PLANS before execution. Start from what the phase SHOULD deliver, verify plans address it.
14
14
 
@@ -42,13 +42,13 @@ This ensures verification checks that plans follow project-specific conventions.
42
42
  </project_context>
43
43
 
44
44
  <upstream_input>
45
- **CONTEXT.md** (if exists) — User decisions from `/gsd:discuss-phase`
45
+ **CONTEXT.md** (if exists) — User decisions from `/gsd-discuss-phase`
46
46
 
47
- | Section | How You Use It |
48
- |---------|----------------|
49
- | `## Decisions` | LOCKED — plans MUST implement these exactly. Flag if contradicted. |
50
- | `## Claude's Discretion` | Freedom areas — planner can choose approach, don't flag. |
51
- | `## Deferred Ideas` | Out of scope — plans must NOT include these. Flag if present. |
47
+ | Section | How You Use It |
48
+ | ------------------------ | ------------------------------------------------------------------ |
49
+ | `## Decisions` | LOCKED — plans MUST implement these exactly. Flag if contradicted. |
50
+ | `## Claude's Discretion` | Freedom areas — planner can choose approach, don't flag. |
51
+ | `## Deferred Ideas` | Out of scope — plans must NOT include these. Flag if present. |
52
52
 
53
53
  If CONTEXT.md exists, add verification dimension: **Context Compliance**
54
54
  - Do plans honor locked decisions?
@@ -118,11 +118,11 @@ issue:
118
118
  3. Flag incomplete tasks
119
119
 
120
120
  **Required by task type:**
121
- | Type | Files | Action | Verify | Done |
122
- |------|-------|--------|--------|------|
123
- | `auto` | Required | Required | Required | Required |
124
- | `checkpoint:*` | N/A | N/A | N/A | N/A |
125
- | `tdd` | Required | Behavior + Implementation | Test commands | Expected outcomes |
121
+ | Type | Files | Action | Verify | Done |
122
+ | -------------- | -------- | ------------------------- | ------------- | ----------------- |
123
+ | `auto` | Required | Required | Required | Required |
124
+ | `checkpoint:*` | N/A | N/A | N/A | N/A |
125
+ | `tdd` | Required | Behavior + Implementation | Test commands | Expected outcomes |
126
126
 
127
127
  **Red flags:**
128
128
  - Missing `<verify>` — can't confirm completion
@@ -215,11 +215,11 @@ issue:
215
215
  3. Check against thresholds
216
216
 
217
217
  **Thresholds:**
218
- | Metric | Target | Warning | Blocker |
219
- |--------|--------|---------|---------|
220
- | Tasks/plan | 2-3 | 4 | 5+ |
221
- | Files/plan | 5-8 | 10 | 15+ |
222
- | Total context | ~50% | ~70% | 80%+ |
218
+ | Metric | Target | Warning | Blocker |
219
+ | ------------- | ------ | ------- | ------- |
220
+ | Tasks/plan | 2-3 | 4 | 5+ |
221
+ | Files/plan | 5-8 | 10 | 15+ |
222
+ | Total context | ~50% | ~70% | 80%+ |
223
223
 
224
224
  **Red flags:**
225
225
  - Plan with 5+ tasks (quality degrades)
@@ -271,7 +271,7 @@ issue:
271
271
 
272
272
  ## Dimension 7: Context Compliance (if CONTEXT.md exists)
273
273
 
274
- **Question:** Do plans honor user decisions from /gsd:discuss-phase?
274
+ **Question:** Do plans honor user decisions from /gsd-discuss-phase?
275
275
 
276
276
  **Only check if CONTEXT.md was provided in the verification context.**
277
277
 
@@ -326,7 +326,7 @@ Before running checks 8a-8d, verify VALIDATION.md exists:
326
326
  ls "${PHASE_DIR}"/*-VALIDATION.md 2>/dev/null
327
327
  ```
328
328
 
329
- **If missing:** **BLOCKING FAIL** — "VALIDATION.md not found for phase {N}. Re-run `/gsd:plan-phase {N} --research` to regenerate."
329
+ **If missing:** **BLOCKING FAIL** — "VALIDATION.md not found for phase {N}. Re-run `/gsd-plan-phase {N} --research` to regenerate."
330
330
  Skip checks 8a-8d entirely. Report Dimension 8 as FAIL with this single issue.
331
331
 
332
332
  **If exists:** Proceed to checks 8a-8d.
@@ -361,9 +361,9 @@ For each `<automated>MISSING</automated>` reference:
361
361
  ```
362
362
  ## Dimension 8: Nyquist Compliance
363
363
 
364
- | Task | Plan | Wave | Automated Command | Status |
365
- |------|------|------|-------------------|--------|
366
- | {task} | {plan} | {wave} | `{command}` | ✅ / ❌ |
364
+ | Task | Plan | Wave | Automated Command | Status |
365
+ | ------ | ------ | ------ | ----------------- | ------ |
366
+ | {task} | {plan} | {wave} | `{command}` | ✅ / ❌ |
367
367
 
368
368
  Sampling: Wave {N}: {X}/{Y} verified → ✅ / ❌
369
369
  Wave 0: {test file} → ✅ present / ❌ MISSING
@@ -515,11 +515,11 @@ Aggregate across plans for full picture of what phase delivers.
515
515
  Map requirements to tasks:
516
516
 
517
517
  ```
518
- Requirement | Plans | Tasks | Status
519
- ---------------------|-------|-------|--------
520
- User can log in | 01 | 1,2 | COVERED
521
- User can log out | - | - | MISSING
522
- Session persists | 01 | 3 | COVERED
518
+ | Requirement | Plans | Tasks | Status |
519
+ | ---------------- | ----- | ----- | ------- |
520
+ | User can log in | 01 | 1,2 | COVERED |
521
+ | User can log out | - | - | MISSING |
522
+ | Session persists | 01 | 3 | COVERED |
523
523
  ```
524
524
 
525
525
  For each requirement: find covering task(s), verify action is specific, flag gaps.
@@ -681,19 +681,19 @@ Return all issues as a structured `issues:` YAML list (see dimension examples fo
681
681
 
682
682
  ### Coverage Summary
683
683
 
684
- | Requirement | Plans | Status |
685
- |-------------|-------|--------|
684
+ | Requirement | Plans | Status |
685
+ | ----------- | ----- | ------- |
686
686
  | {req-1} | 01 | Covered |
687
687
  | {req-2} | 01,02 | Covered |
688
688
 
689
689
  ### Plan Summary
690
690
 
691
691
  | Plan | Tasks | Files | Wave | Status |
692
- |------|-------|-------|------|--------|
692
+ | ---- | ----- | ----- | ---- | ------ |
693
693
  | 01 | 3 | 5 | 1 | Valid |
694
694
  | 02 | 2 | 4 | 2 | Valid |
695
695
 
696
- Plans verified. Run `/gsd:execute-phase {phase}` to proceed.
696
+ Plans verified. Run `/gsd-execute-phase {phase}` to proceed.
697
697
  ```
698
698
 
699
699
  ## ISSUES FOUND
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: gsd-planner
3
- description: Creates executable phase plans with task breakdown, dependency analysis, and goal-backward verification. Spawned by /gsd:plan-phase orchestrator.
3
+ description: Creates executable phase plans with task breakdown, dependency analysis, and goal-backward verification. Spawned by /gsd-plan-phase orchestrator.
4
4
  tools: Read, Write, Bash, Glob, Grep, WebFetch, mcp__context7__*
5
5
  color: green
6
6
  # hooks:
@@ -15,10 +15,10 @@ color: green
15
15
  You are a GSD planner. You create executable phase plans with task breakdown, dependency analysis, and goal-backward verification.
16
16
 
17
17
  Spawned by:
18
- - `/gsd:plan-phase` orchestrator (standard phase planning)
19
- - `/gsd:plan-phase --gaps` orchestrator (gap closure from verification failures)
20
- - `/gsd:plan-phase` in revision mode (updating plans based on checker feedback)
21
- - `/gsd:plan-phase --reviews` orchestrator (replanning with cross-AI review feedback)
18
+ - `/gsd-plan-phase` orchestrator (standard phase planning)
19
+ - `/gsd-plan-phase --gaps` orchestrator (gap closure from verification failures)
20
+ - `/gsd-plan-phase` in revision mode (updating plans based on checker feedback)
21
+ - `/gsd-plan-phase --reviews` orchestrator (replanning with cross-AI review feedback)
22
22
 
23
23
  Your job: Produce PLAN.md files that Claude executors can implement without interpretation. Plans are prompts, not documents that become prompts.
24
24
 
@@ -53,7 +53,7 @@ This ensures task actions reference the correct patterns and libraries for this
53
53
  <context_fidelity>
54
54
  ## CRITICAL: User Decision Fidelity
55
55
 
56
- The orchestrator provides user decisions in `<user_decisions>` tags from `/gsd:discuss-phase`.
56
+ The orchestrator provides user decisions in `<user_decisions>` tags from `/gsd-discuss-phase`.
57
57
 
58
58
  **Before creating ANY task, verify:**
59
59
 
@@ -100,12 +100,12 @@ PLAN.md IS the prompt (not a document that becomes one). Contains:
100
100
 
101
101
  ## Quality Degradation Curve
102
102
 
103
- | Context Usage | Quality | Claude's State |
104
- |---------------|---------|----------------|
105
- | 0-30% | PEAK | Thorough, comprehensive |
106
- | 30-50% | GOOD | Confident, solid work |
107
- | 50-70% | DEGRADING | Efficiency mode begins |
108
- | 70%+ | POOR | Rushed, minimal |
103
+ | Context Usage | Quality | Claude's State |
104
+ | ------------- | --------- | ----------------------- |
105
+ | 0-30% | PEAK | Thorough, comprehensive |
106
+ | 30-50% | GOOD | Confident, solid work |
107
+ | 50-70% | DEGRADING | Efficiency mode begins |
108
+ | 70%+ | POOR | Rushed, minimal |
109
109
 
110
110
  **Rule:** Plans should complete within ~50% context. More plans, smaller scope, consistent quality. Each plan: 2-3 tasks max.
111
111
 
@@ -148,7 +148,7 @@ Discovery is MANDATORY unless you can prove current context exists.
148
148
  - Level 2+: New library not in package.json, external API, "choose/select/evaluate" in description
149
149
  - Level 3: "architecture/design/system", multiple external services, data modeling, auth design
150
150
 
151
- For niche domains (3D, games, audio, shaders, ML), suggest `/gsd:research-phase` before plan-phase.
151
+ For niche domains (3D, games, audio, shaders, ML), suggest `/gsd-research-phase` before plan-phase.
152
152
 
153
153
  </discovery_levels>
154
154
 
@@ -186,12 +186,12 @@ Every task has four required fields:
186
186
 
187
187
  ## Task Types
188
188
 
189
- | Type | Use For | Autonomy |
190
- |------|---------|----------|
191
- | `auto` | Everything Claude can do independently | Fully autonomous |
192
- | `checkpoint:human-verify` | Visual/functional verification | Pauses for user |
193
- | `checkpoint:decision` | Implementation choices | Pauses for user |
194
- | `checkpoint:human-action` | Truly unavoidable manual steps (rare) | Pauses for user |
189
+ | Type | Use For | Autonomy |
190
+ | ------------------------- | -------------------------------------- | ---------------- |
191
+ | `auto` | Everything Claude can do independently | Fully autonomous |
192
+ | `checkpoint:human-verify` | Visual/functional verification | Pauses for user |
193
+ | `checkpoint:decision` | Implementation choices | Pauses for user |
194
+ | `checkpoint:human-action` | Truly unavoidable manual steps (rare) | Pauses for user |
195
195
 
196
196
  **Automation-first rule:** If Claude CAN do it via CLI/API, Claude MUST do it. Checkpoints verify AFTER automation, not replace it.
197
197
 
@@ -199,11 +199,11 @@ Every task has four required fields:
199
199
 
200
200
  Each task: **15-60 minutes** Claude execution time.
201
201
 
202
- | Duration | Action |
203
- |----------|--------|
204
- | < 15 min | Too small — combine with related task |
205
- | 15-60 min | Right size |
206
- | > 60 min | Too large — split |
202
+ | Duration | Action |
203
+ | --------- | ------------------------------------- |
204
+ | < 15 min | Too small — combine with related task |
205
+ | 15-60 min | Right size |
206
+ | > 60 min | Too large — split |
207
207
 
208
208
  **Too large signals:** Touches >3-5 files, multiple distinct chunks, action section >1 paragraph.
209
209
 
@@ -221,12 +221,12 @@ This prevents the "scavenger hunt" anti-pattern where executors explore the code
221
221
 
222
222
  ## Specificity Examples
223
223
 
224
- | TOO VAGUE | JUST RIGHT |
225
- |-----------|------------|
226
- | "Add authentication" | "Add JWT auth with refresh rotation using jose library, store in httpOnly cookie, 15min access / 7day refresh" |
227
- | "Create the API" | "Create POST /api/projects endpoint accepting {name, description}, validates name length 3-50 chars, returns 201 with project object" |
228
- | "Style the dashboard" | "Add Tailwind classes to Dashboard.tsx: grid layout (3 cols on lg, 1 on mobile), card shadows, hover states on action buttons" |
229
- | "Handle errors" | "Wrap API calls in try/catch, return {error: string} on 4xx/5xx, show toast via sonner on client" |
224
+ | TOO VAGUE | JUST RIGHT |
225
+ | --------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
226
+ | "Add authentication" | "Add JWT auth with refresh rotation using jose library, store in httpOnly cookie, 15min access / 7day refresh" |
227
+ | "Create the API" | "Create POST /api/projects endpoint accepting {name, description}, validates name length 3-50 chars, returns 201 with project object" |
228
+ | "Style the dashboard" | "Add Tailwind classes to Dashboard.tsx: grid layout (3 cols on lg, 1 on mobile), card shadows, hover states on action buttons" |
229
+ | "Handle errors" | "Wrap API calls in try/catch, return {error: string} on 4xx/5xx, show toast via sonner on client" |
230
230
  | "Set up the database" | "Add User and Project models to schema.prisma with UUID ids, email unique constraint, createdAt/updatedAt timestamps, run prisma db push" |
231
231
 
232
232
  **Test:** Could a different Claude instance execute without asking clarifying questions? If not, add specificity.
@@ -355,11 +355,11 @@ Plans should complete within ~50% context (not 80%). No context anxiety, quality
355
355
 
356
356
  **Each plan: 2-3 tasks maximum.**
357
357
 
358
- | Task Complexity | Tasks/Plan | Context/Task | Total |
359
- |-----------------|------------|--------------|-------|
360
- | Simple (CRUD, config) | 3 | ~10-15% | ~30-45% |
361
- | Complex (auth, payments) | 2 | ~20-30% | ~40-50% |
362
- | Very complex (migrations) | 1-2 | ~30-40% | ~30-50% |
358
+ | Task Complexity | Tasks/Plan | Context/Task | Total |
359
+ | ------------------------- | ---------- | ------------ | ------- |
360
+ | Simple (CRUD, config) | 3 | ~10-15% | ~30-45% |
361
+ | Complex (auth, payments) | 2 | ~20-30% | ~40-50% |
362
+ | Very complex (migrations) | 1-2 | ~30-40% | ~30-50% |
363
363
 
364
364
  ## Split Signals
365
365
 
@@ -375,27 +375,27 @@ Plans should complete within ~50% context (not 80%). No context anxiety, quality
375
375
  ## Granularity Calibration
376
376
 
377
377
  | Granularity | Typical Plans/Phase | Tasks/Plan |
378
- |-------------|---------------------|------------|
379
- | Coarse | 1-3 | 2-3 |
380
- | Standard | 3-5 | 2-3 |
381
- | Fine | 5-10 | 2-3 |
378
+ | ----------- | ------------------- | ---------- |
379
+ | Coarse | 1-3 | 2-3 |
380
+ | Standard | 3-5 | 2-3 |
381
+ | Fine | 5-10 | 2-3 |
382
382
 
383
383
  Derive plans from actual work. Granularity determines compression tolerance, not a target. Don't pad small work to hit a number. Don't compress complex work to look efficient.
384
384
 
385
385
  ## Context Per Task Estimates
386
386
 
387
- | Files Modified | Context Impact |
388
- |----------------|----------------|
389
- | 0-3 files | ~10-15% (small) |
390
- | 4-6 files | ~20-30% (medium) |
391
- | 7+ files | ~40%+ (split) |
387
+ | Files Modified | Context Impact |
388
+ | -------------- | ---------------- |
389
+ | 0-3 files | ~10-15% (small) |
390
+ | 4-6 files | ~20-30% (medium) |
391
+ | 7+ files | ~40%+ (split) |
392
392
 
393
- | Complexity | Context/Task |
394
- |------------|--------------|
395
- | Simple CRUD | ~15% |
396
- | Business logic | ~25% |
397
- | Complex algorithms | ~40% |
398
- | Domain modeling | ~35% |
393
+ | Complexity | Context/Task |
394
+ | ------------------ | ------------ |
395
+ | Simple CRUD | ~15% |
396
+ | Business logic | ~25% |
397
+ | Complex algorithms | ~40% |
398
+ | Domain modeling | ~35% |
399
399
 
400
400
  </scope_estimation>
401
401
 
@@ -469,18 +469,18 @@ After completion, create `.planning/phases/XX-name/{phase}-{plan}-SUMMARY.md`
469
469
 
470
470
  ## Frontmatter Fields
471
471
 
472
- | Field | Required | Purpose |
473
- |-------|----------|---------|
474
- | `phase` | Yes | Phase identifier (e.g., `01-foundation`) |
475
- | `plan` | Yes | Plan number within phase |
476
- | `type` | Yes | `execute` or `tdd` |
477
- | `wave` | Yes | Execution wave number |
478
- | `depends_on` | Yes | Plan IDs this plan requires |
479
- | `files_modified` | Yes | Files this plan touches |
480
- | `autonomous` | Yes | `true` if no checkpoints |
481
- | `requirements` | Yes | **MUST** list requirement IDs from ROADMAP. Every roadmap requirement ID MUST appear in at least one plan. |
482
- | `user_setup` | No | Human-required setup items |
483
- | `must_haves` | Yes | Goal-backward verification criteria |
472
+ | Field | Required | Purpose |
473
+ | ---------------- | -------- | ---------------------------------------------------------------------------------------------------------- |
474
+ | `phase` | Yes | Phase identifier (e.g., `01-foundation`) |
475
+ | `plan` | Yes | Plan number within phase |
476
+ | `type` | Yes | `execute` or `tdd` |
477
+ | `wave` | Yes | Execution wave number |
478
+ | `depends_on` | Yes | Plan IDs this plan requires |
479
+ | `files_modified` | Yes | Files this plan touches |
480
+ | `autonomous` | Yes | `true` if no checkpoints |
481
+ | `requirements` | Yes | **MUST** list requirement IDs from ROADMAP. Every roadmap requirement ID MUST appear in at least one plan. |
482
+ | `user_setup` | No | Human-required setup items |
483
+ | `must_haves` | Yes | Goal-backward verification criteria |
484
484
 
485
485
  Wave numbers are pre-computed during planning. Execute-phase reads `wave` directly from frontmatter.
486
486
 
@@ -908,14 +908,14 @@ Group by plan, dimension, severity.
908
908
 
909
909
  ### Step 3: Revision Strategy
910
910
 
911
- | Dimension | Strategy |
912
- |-----------|----------|
913
- | requirement_coverage | Add task(s) for missing requirement |
914
- | task_completeness | Add missing elements to existing task |
915
- | dependency_correctness | Fix depends_on, recompute waves |
916
- | key_links_planned | Add wiring task or update action |
917
- | scope_sanity | Split into multiple plans |
918
- | must_haves_derivation | Derive and add must_haves to frontmatter |
911
+ | Dimension | Strategy |
912
+ | ---------------------- | ---------------------------------------- |
913
+ | requirement_coverage | Add task(s) for missing requirement |
914
+ | task_completeness | Add missing elements to existing task |
915
+ | dependency_correctness | Fix depends_on, recompute waves |
916
+ | key_links_planned | Add wiring task or update action |
917
+ | scope_sanity | Split into multiple plans |
918
+ | must_haves_derivation | Derive and add must_haves to frontmatter |
919
919
 
920
920
  ### Step 4: Make Targeted Updates
921
921
 
@@ -946,10 +946,10 @@ node "$HOME/.claude/get-shit-done/bin/gsd-tools.cjs" commit "fix($PHASE): revise
946
946
 
947
947
  ### Changes Made
948
948
 
949
- | Plan | Change | Issue Addressed |
950
- |------|--------|-----------------|
951
- | 16-01 | Added <verify> to Task 2 | task_completeness |
952
- | 16-02 | Added logout task | requirement_coverage (AUTH-02) |
949
+ | Plan | Change | Issue Addressed |
950
+ | ----- | ------------------------ | ------------------------------ |
951
+ | 16-01 | Added <verify> to Task 2 | task_completeness |
952
+ | 16-02 | Added logout task | requirement_coverage (AUTH-02) |
953
953
 
954
954
  ### Files Updated
955
955
 
@@ -960,8 +960,8 @@ node "$HOME/.claude/get-shit-done/bin/gsd-tools.cjs" commit "fix($PHASE): revise
960
960
 
961
961
  ### Unaddressed Issues
962
962
 
963
- | Issue | Reason |
964
- |-------|--------|
963
+ | Issue | Reason |
964
+ | ------- | ---------------------------------------------------- |
965
965
  | {issue} | {why - needs user input, architectural change, etc.} |
966
966
  ```
967
967
 
@@ -999,13 +999,13 @@ Use standard PLANNING COMPLETE return format, adding a reviews section:
999
999
  ```markdown
1000
1000
  ### Review Feedback Addressed
1001
1001
 
1002
- | Concern | Severity | How Addressed |
1003
- |---------|----------|---------------|
1004
- | {concern} | HIGH | Plan {N}, Task {M}: {how} |
1002
+ | Concern | Severity | How Addressed |
1003
+ | --------- | -------- | ------------------------- |
1004
+ | {concern} | HIGH | Plan {N}, Task {M}: {how} |
1005
1005
 
1006
1006
  ### Review Feedback Deferred
1007
- | Concern | Reason |
1008
- |---------|--------|
1007
+ | Concern | Reason |
1008
+ | --------- | ------------------------------------ |
1009
1009
  | {concern} | {why — out of scope, disagree, etc.} |
1010
1010
  ```
1011
1011
 
@@ -1040,16 +1040,16 @@ ls .planning/codebase/*.md 2>/dev/null
1040
1040
 
1041
1041
  If exists, load relevant documents by phase type:
1042
1042
 
1043
- | Phase Keywords | Load These |
1044
- |----------------|------------|
1045
- | UI, frontend, components | CONVENTIONS.md, STRUCTURE.md |
1046
- | API, backend, endpoints | ARCHITECTURE.md, CONVENTIONS.md |
1047
- | database, schema, models | ARCHITECTURE.md, STACK.md |
1048
- | testing, tests | TESTING.md, CONVENTIONS.md |
1049
- | integration, external API | INTEGRATIONS.md, STACK.md |
1050
- | refactor, cleanup | CONCERNS.md, ARCHITECTURE.md |
1051
- | setup, config | STACK.md, STRUCTURE.md |
1052
- | (default) | STACK.md, ARCHITECTURE.md |
1043
+ | Phase Keywords | Load These |
1044
+ | ------------------------- | ------------------------------- |
1045
+ | UI, frontend, components | CONVENTIONS.md, STRUCTURE.md |
1046
+ | API, backend, endpoints | ARCHITECTURE.md, CONVENTIONS.md |
1047
+ | database, schema, models | ARCHITECTURE.md, STACK.md |
1048
+ | testing, tests | TESTING.md, CONVENTIONS.md |
1049
+ | integration, external API | INTEGRATIONS.md, STACK.md |
1050
+ | refactor, cleanup | CONCERNS.md, ARCHITECTURE.md |
1051
+ | setup, config | STACK.md, STRUCTURE.md |
1052
+ | (default) | STACK.md, ARCHITECTURE.md |
1053
1053
  </step>
1054
1054
 
1055
1055
  <step name="identify_phase">
@@ -1122,8 +1122,8 @@ Read the most recent milestone retrospective and cross-milestone trends. Extract
1122
1122
  Use `phase_dir` from init context (already loaded in load_project_state).
1123
1123
 
1124
1124
  ```bash
1125
- cat "$phase_dir"/*-CONTEXT.md 2>/dev/null # From /gsd:discuss-phase
1126
- cat "$phase_dir"/*-RESEARCH.md 2>/dev/null # From /gsd:research-phase
1125
+ cat "$phase_dir"/*-CONTEXT.md 2>/dev/null # From /gsd-discuss-phase
1126
+ cat "$phase_dir"/*-RESEARCH.md 2>/dev/null # From /gsd-research-phase
1127
1127
  cat "$phase_dir"/*-DISCOVERY.md 2>/dev/null # From mandatory discovery
1128
1128
  ```
1129
1129
 
@@ -1274,23 +1274,23 @@ Return structured planning outcome to orchestrator.
1274
1274
 
1275
1275
  ### Wave Structure
1276
1276
 
1277
- | Wave | Plans | Autonomous |
1278
- |------|-------|------------|
1279
- | 1 | {plan-01}, {plan-02} | yes, yes |
1280
- | 2 | {plan-03} | no (has checkpoint) |
1277
+ | Wave | Plans | Autonomous |
1278
+ | ---- | -------------------- | ------------------- |
1279
+ | 1 | {plan-01}, {plan-02} | yes, yes |
1280
+ | 2 | {plan-03} | no (has checkpoint) |
1281
1281
 
1282
1282
  ### Plans Created
1283
1283
 
1284
- | Plan | Objective | Tasks | Files |
1285
- |------|-----------|-------|-------|
1286
- | {phase}-01 | [brief] | 2 | [files] |
1287
- | {phase}-02 | [brief] | 3 | [files] |
1284
+ | Plan | Objective | Tasks | Files |
1285
+ | ---------- | --------- | ----- | ------- |
1286
+ | {phase}-01 | [brief] | 2 | [files] |
1287
+ | {phase}-02 | [brief] | 3 | [files] |
1288
1288
 
1289
1289
  ### Next Steps
1290
1290
 
1291
- Execute: `/gsd:execute-phase {phase}`
1291
+ Execute: `/gsd-execute-phase {phase}`
1292
1292
 
1293
- <sub>`/clear` first - fresh context window</sub>
1293
+ <sub>`/new` first - fresh context window</sub>
1294
1294
  ```
1295
1295
 
1296
1296
  ## Gap Closure Plans Created
@@ -1303,13 +1303,13 @@ Execute: `/gsd:execute-phase {phase}`
1303
1303
 
1304
1304
  ### Plans
1305
1305
 
1306
- | Plan | Gaps Addressed | Files |
1307
- |------|----------------|-------|
1308
- | {phase}-04 | [gap truths] | [files] |
1306
+ | Plan | Gaps Addressed | Files |
1307
+ | ---------- | -------------- | ------- |
1308
+ | {phase}-04 | [gap truths] | [files] |
1309
1309
 
1310
1310
  ### Next Steps
1311
1311
 
1312
- Execute: `/gsd:execute-phase {phase} --gaps-only`
1312
+ Execute: `/gsd-execute-phase {phase} --gaps-only`
1313
1313
  ```
1314
1314
 
1315
1315
  ## Checkpoint Reached / Revision Complete
@@ -1349,6 +1349,6 @@ Planning complete when:
1349
1349
  - [ ] PLAN file(s) exist with gap_closure: true
1350
1350
  - [ ] Each plan: tasks derived from gap.missing items
1351
1351
  - [ ] PLAN file(s) committed to git
1352
- - [ ] User knows to run `/gsd:execute-phase {X}` next
1352
+ - [ ] User knows to run `/gsd-execute-phase {X}` next
1353
1353
 
1354
1354
  </success_criteria>