diff --git a/README.md b/README.md index ad4a503d6..7fa904663 100644 --- a/README.md +++ b/README.md @@ -223,7 +223,7 @@ For each area you select, it asks until you're satisfied. The output — `CONTEX The deeper you go here, the more the system builds what you actually want. Skip it and you get reasonable defaults. Use it and you get *your* vision. -**Creates:** `{phase}-CONTEXT.md` +**Creates:** `{phase_num}-CONTEXT.md` --- @@ -241,7 +241,7 @@ The system: Each plan is small enough to execute in a fresh context window. No degradation, no "I'll be more concise now." -**Creates:** `{phase}-RESEARCH.md`, `{phase}-{N}-PLAN.md` +**Creates:** `{phase_num}-RESEARCH.md`, `{phase_num}-{N}-PLAN.md` --- @@ -260,7 +260,7 @@ The system: Walk away, come back to completed work with clean git history. -**Creates:** `{phase}-{N}-SUMMARY.md`, `{phase}-VERIFICATION.md` +**Creates:** `{phase_num}-{N}-SUMMARY.md`, `{phase_num}-VERIFICATION.md` --- @@ -283,7 +283,7 @@ The system: If everything passes, you move on. If something's broken, you don't manually debug — you just run `/gsd:execute-phase` again with the fix plans it created. -**Creates:** `{phase}-UAT.md`, fix plans if issues found +**Creates:** `{phase_num}-UAT.md`, fix plans if issues found --- diff --git a/agents/gsd-phase-researcher.md b/agents/gsd-phase-researcher.md index eeb1032f1..f591cdd45 100644 --- a/agents/gsd-phase-researcher.md +++ b/agents/gsd-phase-researcher.md @@ -177,7 +177,7 @@ Priority: Context7 > Official Docs > Official GitHub > Verified WebSearch > Unve ## RESEARCH.md Structure -**Location:** `.planning/phases/XX-name/{phase}-RESEARCH.md` +**Location:** `.planning/phases/XX-name/{phase_num}-RESEARCH.md` ```markdown # Phase [X]: [Name] - Research diff --git a/agents/gsd-verifier.md b/agents/gsd-verifier.md index 4b2e0babf..17afa2948 100644 --- a/agents/gsd-verifier.md +++ b/agents/gsd-verifier.md @@ -317,7 +317,7 @@ gaps: ## Create VERIFICATION.md -Create `.planning/phases/{phase_dir}/{phase}-VERIFICATION.md`: +Create `.planning/phases/{phase_dir}/{phase_num}-VERIFICATION.md`: ```markdown --- @@ -411,7 +411,7 @@ Return with: **Status:** {passed | gaps_found | human_needed} **Score:** {N}/{M} must-haves verified -**Report:** .planning/phases/{phase_dir}/{phase}-VERIFICATION.md +**Report:** .planning/phases/{phase_dir}/{phase_num}-VERIFICATION.md {If passed:} All must-haves verified. Phase goal achieved. Ready to proceed. diff --git a/commands/gsd/discuss-phase.md b/commands/gsd/discuss-phase.md index 4facd870f..61751434d 100644 --- a/commands/gsd/discuss-phase.md +++ b/commands/gsd/discuss-phase.md @@ -20,7 +20,7 @@ Extract implementation decisions that downstream agents need — researcher and 3. Deep-dive each selected area until satisfied 4. Create CONTEXT.md with decisions that guide research and planning -**Output:** `{phase}-CONTEXT.md` — decisions clear enough that downstream agents can act without asking the user again +**Output:** `{phase_num}-CONTEXT.md` — decisions clear enough that downstream agents can act without asking the user again diff --git a/commands/gsd/verify-work.md b/commands/gsd/verify-work.md index b5c9e13bc..14ab175e3 100644 --- a/commands/gsd/verify-work.md +++ b/commands/gsd/verify-work.md @@ -16,7 +16,7 @@ Validate built features through conversational testing with persistent state. Purpose: Confirm what Claude built actually works from user's perspective. One test at a time, plain text responses, no interrogation. When issues are found, automatically diagnose, plan fixes, and prepare for execution. -Output: {phase}-UAT.md tracking all test results. If issues found: diagnosed gaps, verified fix plans ready for /gsd:execute-phase +Output: {phase_num}-UAT.md tracking all test results. If issues found: diagnosed gaps, verified fix plans ready for /gsd:execute-phase diff --git a/get-shit-done/templates/UAT.md b/get-shit-done/templates/UAT.md index 73e6887f5..5e2118ed2 100644 --- a/get-shit-done/templates/UAT.md +++ b/get-shit-done/templates/UAT.md @@ -1,6 +1,6 @@ # UAT Template -Template for `.planning/phases/XX-name/{phase}-UAT.md` — persistent UAT session tracking. +Template for `.planning/phases/XX-name/{phase_num}-UAT.md` — persistent UAT session tracking. --- diff --git a/get-shit-done/templates/context.md b/get-shit-done/templates/context.md index cdfffa531..574e2e490 100644 --- a/get-shit-done/templates/context.md +++ b/get-shit-done/templates/context.md @@ -1,6 +1,6 @@ # Phase Context Template -Template for `.planning/phases/XX-name/{phase}-CONTEXT.md` - captures implementation decisions for a phase. +Template for `.planning/phases/XX-name/{phase_num}-CONTEXT.md` - captures implementation decisions for a phase. **Purpose:** Document decisions that downstream agents need. Researcher uses this to know WHAT to investigate. Planner uses this to know WHAT choices are locked vs flexible. @@ -276,7 +276,7 @@ The output should answer: "What does the researcher need to investigate? What ch - "Easy to use" **After creation:** -- File lives in phase directory: `.planning/phases/XX-name/{phase}-CONTEXT.md` +- File lives in phase directory: `.planning/phases/XX-name/{phase_num}-CONTEXT.md` - `gsd-phase-researcher` uses decisions to focus investigation - `gsd-planner` uses decisions + research to create executable tasks - Downstream agents should NOT need to ask the user again about captured decisions diff --git a/get-shit-done/templates/planner-subagent-prompt.md b/get-shit-done/templates/planner-subagent-prompt.md index c1fc0d208..bcaa68d27 100644 --- a/get-shit-done/templates/planner-subagent-prompt.md +++ b/get-shit-done/templates/planner-subagent-prompt.md @@ -22,14 +22,14 @@ Template for spawning gsd-planner agent. The agent contains all planning experti @.planning/REQUIREMENTS.md **Phase Context (if exists):** -@.planning/phases/{phase_dir}/{phase}-CONTEXT.md +@.planning/phases/{phase_dir}/{phase_num}-CONTEXT.md **Research (if exists):** -@.planning/phases/{phase_dir}/{phase}-RESEARCH.md +@.planning/phases/{phase_dir}/{phase_num}-RESEARCH.md **Gap Closure (if --gaps mode):** -@.planning/phases/{phase_dir}/{phase}-VERIFICATION.md -@.planning/phases/{phase_dir}/{phase}-UAT.md +@.planning/phases/{phase_dir}/{phase_num}-VERIFICATION.md +@.planning/phases/{phase_dir}/{phase_num}-UAT.md diff --git a/get-shit-done/templates/research.md b/get-shit-done/templates/research.md index dfdffe22e..43ae5d0b4 100644 --- a/get-shit-done/templates/research.md +++ b/get-shit-done/templates/research.md @@ -1,6 +1,6 @@ # Research Template -Template for `.planning/phases/XX-name/{phase}-RESEARCH.md` - comprehensive ecosystem research before planning. +Template for `.planning/phases/XX-name/{phase_num}-RESEARCH.md` - comprehensive ecosystem research before planning. **Purpose:** Document what Claude needs to know to implement a phase well - not just "which library" but "how do experts build this." @@ -547,6 +547,6 @@ function useVehicleControls(rigidBodyRef) { - Code examples can be referenced in task actions **After creation:** -- File lives in phase directory: `.planning/phases/XX-name/{phase}-RESEARCH.md` +- File lives in phase directory: `.planning/phases/XX-name/{phase_num}-RESEARCH.md` - Referenced during planning workflow - plan-phase loads it automatically when present diff --git a/get-shit-done/templates/verification-report.md b/get-shit-done/templates/verification-report.md index ec57cbd40..8684fe2c4 100644 --- a/get-shit-done/templates/verification-report.md +++ b/get-shit-done/templates/verification-report.md @@ -1,6 +1,6 @@ # Verification Report Template -Template for `.planning/phases/XX-name/{phase}-VERIFICATION.md` — phase goal verification results. +Template for `.planning/phases/XX-name/{phase_num}-VERIFICATION.md` — phase goal verification results. --- diff --git a/get-shit-done/workflows/diagnose-issues.md b/get-shit-done/workflows/diagnose-issues.md index 75be6eaf0..7b5b866f8 100644 --- a/get-shit-done/workflows/diagnose-issues.md +++ b/get-shit-done/workflows/diagnose-issues.md @@ -158,7 +158,7 @@ Update status in frontmatter to "diagnosed". Commit the updated UAT.md: ```bash -node ~/.claude/get-shit-done/bin/gsd-tools.js commit "docs({phase}): add root causes from diagnosis" --files ".planning/phases/XX-name/{phase}-UAT.md" +node ~/.claude/get-shit-done/bin/gsd-tools.js commit "docs({phase_num}): add root causes from diagnosis" --files ".planning/phases/XX-name/{phase_num}-UAT.md" ``` diff --git a/get-shit-done/workflows/execute-phase.md b/get-shit-done/workflows/execute-phase.md index e6fefaa08..9bc222d96 100644 --- a/get-shit-done/workflows/execute-phase.md +++ b/get-shit-done/workflows/execute-phase.md @@ -267,7 +267,7 @@ All automated checks passed. {N} items need human testing: ## ⚠ Phase {X}: {Name} — Gaps Found **Score:** {N}/{M} must-haves verified -**Report:** {phase_dir}/{phase}-VERIFICATION.md +**Report:** {phase_dir}/{phase_num}-VERIFICATION.md ### What's Missing {Gap summaries from VERIFICATION.md} @@ -279,7 +279,7 @@ All automated checks passed. {N} items need human testing: `/clear` first → fresh context window -Also: `cat {phase_dir}/{phase}-VERIFICATION.md` — full report +Also: `cat {phase_dir}/{phase_num}-VERIFICATION.md` — full report Also: `/gsd:verify-work {X}` — manual testing first ``` diff --git a/get-shit-done/workflows/plan-phase.md b/get-shit-done/workflows/plan-phase.md index 7aefc43ab..6d021f99b 100644 --- a/get-shit-done/workflows/plan-phase.md +++ b/get-shit-done/workflows/plan-phase.md @@ -104,7 +104,7 @@ IMPORTANT: If CONTEXT.md exists below, it contains user decisions from /gsd:disc -Write to: {phase_dir}/{phase}-RESEARCH.md +Write to: {phase_dir}/{phase_num}-RESEARCH.md ``` diff --git a/get-shit-done/workflows/progress.md b/get-shit-done/workflows/progress.md index 987a3e243..c37281a04 100644 --- a/get-shit-done/workflows/progress.md +++ b/get-shit-done/workflows/progress.md @@ -194,7 +194,7 @@ Read its `` section. **Route B: Phase needs planning** -Check if `{phase}-CONTEXT.md` exists in phase directory. +Check if `{phase_num}-CONTEXT.md` exists in phase directory. **If CONTEXT.md exists:** @@ -246,7 +246,7 @@ UAT.md exists with gaps (diagnosed issues). User needs to plan fixes. ## ⚠ UAT Gaps Found -**{phase}-UAT.md** has {N} gaps requiring fixes. +**{phase_num}-UAT.md** has {N} gaps requiring fixes. `/gsd:plan-phase {phase} --gaps` diff --git a/get-shit-done/workflows/verify-work.md b/get-shit-done/workflows/verify-work.md index c3e11886b..8db33d739 100644 --- a/get-shit-done/workflows/verify-work.md +++ b/get-shit-done/workflows/verify-work.md @@ -164,7 +164,7 @@ skipped: 0 [none yet] ``` -Write to `.planning/phases/XX-name/{phase}-UAT.md` +Write to `.planning/phases/XX-name/{phase_num}-UAT.md` Proceed to `present_test`. @@ -292,7 +292,7 @@ Clear Current Test section: Commit the UAT file: ```bash -node ~/.claude/get-shit-done/bin/gsd-tools.js commit "test({phase}): complete UAT - {passed} passed, {issues} issues" --files ".planning/phases/XX-name/{phase}-UAT.md" +node ~/.claude/get-shit-done/bin/gsd-tools.js commit "test({phase_num}): complete UAT - {passed} passed, {issues} issues" --files ".planning/phases/XX-name/{phase_num}-UAT.md" ``` Present summary: @@ -366,7 +366,7 @@ Task( **Mode:** gap_closure **UAT with diagnoses:** -@.planning/phases/{phase_dir}/{phase}-UAT.md +@.planning/phases/{phase_dir}/{phase_num}-UAT.md **Project State:** @.planning/STATE.md