pi-gsd 2.0.22 → 2.0.23

package/.gsd/harnesses/pi/get-shit-done/workflows/audit-milestone.md

@@ -289,7 +289,7 @@ All requirements covered. Cross-phase integration verified. E2E flows complete.
 
 /gsd-complete-milestone {version}
 
-<sub>/clear first → fresh context window</sub>
+<sub>/new first → fresh context window</sub>
 
 ───────────────────────────────────────────────────────────────
 
@@ -334,7 +334,7 @@ Phases needing validation: run `/gsd-validate-phase {N}` for each flagged phase.
 
 /gsd-plan-milestone-gaps
 
-<sub>/clear first → fresh context window</sub>
+<sub>/new first → fresh context window</sub>
 
 ───────────────────────────────────────────────────────────────
 
@@ -376,7 +376,7 @@ All requirements met. No critical blockers. Accumulated tech debt needs review.
 
 /gsd-plan-milestone-gaps
 
-<sub>/clear first → fresh context window</sub>
+<sub>/new first → fresh context window</sub>
 
 ───────────────────────────────────────────────────────────────
 </offer_next>

package/.gsd/harnesses/pi/get-shit-done/workflows/complete-milestone.md

@@ -234,7 +234,7 @@ Tag: v[X.Y]
 
 `/gsd-new-milestone`
 
-<sub>`/clear` first → fresh context window</sub>
+<sub>`/new` first → fresh context window</sub>
 
 ---
 ```

package/.gsd/harnesses/pi/get-shit-done/workflows/discuss-phase-assumptions.md

@@ -653,7 +653,7 @@ Created: .planning/phases/${PADDED_PHASE}-${SLUG}/${PADDED_PHASE}-CONTEXT.md
 
 `/gsd-plan-phase ${PHASE}`
 
-<sub>`/clear` first → fresh context window</sub>
+<sub>`/new` first → fresh context window</sub>
 
 ---
 

package/.gsd/harnesses/pi/get-shit-done/workflows/discuss-phase.md

@@ -913,7 +913,7 @@ Created: .planning/phases/${PADDED_PHASE}-${SLUG}/${PADDED_PHASE}-CONTEXT.md
 
 `/gsd-plan-phase ${PHASE} ${GSD_WS}`
 
-<sub>`/clear` first → fresh context window</sub>
+<sub>`/new` first → fresh context window</sub>
 
 ---
 
@@ -1045,7 +1045,7 @@ This keeps the auto-advance chain flat - discuss, plan, and execute all run at t
   Auto-advance pipeline finished: discuss → plan → execute
 
   Next: /gsd-discuss-phase ${NEXT_PHASE} --auto ${GSD_WS}
-  <sub>/clear first → fresh context window</sub>
+  <sub>/new first → fresh context window</sub>
   ```
 - **PLANNING COMPLETE** → Planning done, execution didn't complete:
   ```

package/.gsd/harnesses/pi/get-shit-done/workflows/discuss-phase.md.bak

@@ -875,7 +875,7 @@ Created: .planning/phases/${PADDED_PHASE}-${SLUG}/${PADDED_PHASE}-CONTEXT.md
 
 `/gsd-plan-phase ${PHASE} ${GSD_WS}`
 
-<sub>`/clear` first → fresh context window</sub>
+<sub>`/new` first → fresh context window</sub>
 
 ---
 
@@ -1007,7 +1007,7 @@ This keeps the auto-advance chain flat - discuss, plan, and execute all run at t
   Auto-advance pipeline finished: discuss → plan → execute
 
   Next: /gsd-discuss-phase ${NEXT_PHASE} --auto ${GSD_WS}
-  <sub>/clear first → fresh context window</sub>
+  <sub>/new first → fresh context window</sub>
   ```
 - **PLANNING COMPLETE** → Planning done, execution didn't complete:
   ```

package/.gsd/harnesses/pi/get-shit-done/workflows/execute-phase.md

@@ -751,7 +751,7 @@ Items saved to `{phase_num}-HUMAN-UAT.md` - they will appear in `/gsd-progress`
 
 `/gsd-plan-phase {X} --gaps ${GSD_WS}`
 
-<sub>`/clear` first → fresh context window</sub>
+<sub>`/new` first → fresh context window</sub>
 
 Also: `cat {phase_dir}/{phase_num}-VERIFICATION.md` - full report
 Also: `/gsd-verify-work {X} ${GSD_WS}` - manual testing first
@@ -889,7 +889,7 @@ Subagents: fresh context each (200k-1M depending on model). No polling (Task blo
 For 1M+ context models, consider:
 - Passing richer context (code snippets, dependency outputs) directly to executors instead of just file paths
 - Running small phases (≤3 plans, no dependencies) inline without subagent spawning overhead
-- Relaxing /clear recommendations - context rot onset is much further out with 5x window
+- Relaxing /new recommendations - context rot onset is much further out with 5x window
 </context_efficiency>
 
 <failure_handling>

package/.gsd/harnesses/pi/get-shit-done/workflows/execute-phase.md.bak

@@ -690,7 +690,7 @@ Items saved to `{phase_num}-HUMAN-UAT.md` - they will appear in `/gsd-progress`
 
 `/gsd-plan-phase {X} --gaps ${GSD_WS}`
 
-<sub>`/clear` first → fresh context window</sub>
+<sub>`/new` first → fresh context window</sub>
 
 Also: `cat {phase_dir}/{phase_num}-VERIFICATION.md` - full report
 Also: `/gsd-verify-work {X} ${GSD_WS}` - manual testing first
@@ -828,7 +828,7 @@ Subagents: fresh context each (200k-1M depending on model). No polling (Task blo
 For 1M+ context models, consider:
 - Passing richer context (code snippets, dependency outputs) directly to executors instead of just file paths
 - Running small phases (≤3 plans, no dependencies) inline without subagent spawning overhead
-- Relaxing /clear recommendations - context rot onset is much further out with 5x window
+- Relaxing /new recommendations - context rot onset is much further out with 5x window
 </context_efficiency>
 
 <failure_handling>

package/.gsd/harnesses/pi/get-shit-done/workflows/execute-plan.md

@@ -533,7 +533,7 @@ If `USER_SETUP_CREATED=true`: display `⚠️ USER SETUP REQUIRED` with path + e
 | summaries = plans, current < highest phase | **B: Phase done**     | Show completion, suggest `/gsd-plan-phase {Z+1}` + `/gsd-verify-work {Z}` + `/gsd-discuss-phase {Z+1}`                                                  |
 | summaries = plans, current = highest phase | **C: Milestone done** | Show banner, suggest `/gsd-complete-milestone` + `/gsd-verify-work` + `/gsd-add-phase`                                                                  |
 
-All routes: `/clear` first for fresh context.
+All routes: `/new` first for fresh context.
 </step>
 
 </process>

package/.gsd/harnesses/pi/get-shit-done/workflows/help.md

@@ -270,7 +270,7 @@ Systematic debugging with persistent state across context resets.
 - Gathers symptoms through adaptive questioning
 - Creates `.planning/debug/[slug].md` to track investigation
 - Investigates using scientific method (evidence → hypothesis → test)
-- Survives `/clear` - run `/gsd-debug` with no args to resume
+- Survives `/new` - run `/gsd-debug` with no args to resume
 - Archives resolved issues to `.planning/debug/resolved/`
 
 Usage: `/gsd-debug "login button doesn't work"`
@@ -553,9 +553,9 @@ Example config:
 
 ```
 /gsd-new-project        # Unified flow: questioning → research → requirements → roadmap
-/clear
+/new
 /gsd-plan-phase 1       # Create plans for first phase
-/clear
+/new
 /gsd-execute-phase 1    # Execute all plans in phase
 ```
 
@@ -577,7 +577,7 @@ Example config:
 
 ```
 /gsd-complete-milestone 1.0.0
-/clear
+/new
 /gsd-new-milestone  # Start next milestone (questioning → research → requirements → roadmap)
 ```
 
@@ -595,7 +595,7 @@ Example config:
 ```
 /gsd-debug "form submission fails silently"  # Start debug session
 # ... investigation happens, context fills up ...
-/clear
+/new
 /gsd-debug                                    # Resume from where you left off
 ```
 

package/.gsd/harnesses/pi/get-shit-done/workflows/insert-phase.md

@@ -153,7 +153,7 @@ Project state updated: .planning/STATE.md
 
 `/gsd-plan-phase {decimal_phase}`
 
-<sub>`/clear` first -> fresh context window</sub>
+<sub>`/new` first -> fresh context window</sub>
 
 ---
 

package/.gsd/harnesses/pi/get-shit-done/workflows/map-codebase.md

@@ -382,7 +382,7 @@ Created .planning/codebase/:
 
 `/gsd-new-project`
 
-<sub>`/clear` first → fresh context window</sub>
+<sub>`/new` first → fresh context window</sub>
 
 ---
 

package/.gsd/harnesses/pi/get-shit-done/workflows/new-milestone.md

@@ -489,7 +489,7 @@ pi-gsd-tools commit "docs: create milestone v[X.Y] roadmap ([N] phases)" --files
 
 `/gsd-discuss-phase [N] ${GSD_WS}` - gather context and clarify approach
 
-<sub>`/clear` first → fresh context window</sub>
+<sub>`/new` first → fresh context window</sub>
 
 Also: `/gsd-plan-phase [N] ${GSD_WS}` - skip discussion, plan directly
 ```

package/.gsd/harnesses/pi/get-shit-done/workflows/new-milestone.md.bak

@@ -461,7 +461,7 @@ pi-gsd-tools commit "docs: create milestone v[X.Y] roadmap ([N] phases)" --files
 
 `/gsd-discuss-phase [N] ${GSD_WS}` - gather context and clarify approach
 
-<sub>`/clear` first → fresh context window</sub>
+<sub>`/new` first → fresh context window</sub>
 
 Also: `/gsd-plan-phase [N] ${GSD_WS}` - skip discussion, plan directly
 ```

package/.gsd/harnesses/pi/get-shit-done/workflows/new-project.md

@@ -1209,7 +1209,7 @@ PHASE1_HAS_UI=$(echo "$PHASE1_SECTION" | grep -qi "UI hint.*yes" && echo "true"
 
 /gsd-discuss-phase 1 - gather context and clarify approach
 
-<sub>/clear first → fresh context window</sub>
+<sub>/new first → fresh context window</sub>
 
 ---
 
@@ -1231,7 +1231,7 @@ PHASE1_HAS_UI=$(echo "$PHASE1_SECTION" | grep -qi "UI hint.*yes" && echo "true"
 
 /gsd-discuss-phase 1 - gather context and clarify approach
 
-<sub>/clear first → fresh context window</sub>
+<sub>/new first → fresh context window</sub>
 
 ---
 

package/.gsd/harnesses/pi/get-shit-done/workflows/new-project.md.bak

@@ -1173,7 +1173,7 @@ PHASE1_HAS_UI=$(echo "$PHASE1_SECTION" | grep -qi "UI hint.*yes" && echo "true"
 
 /gsd-discuss-phase 1 - gather context and clarify approach
 
-<sub>/clear first → fresh context window</sub>
+<sub>/new first → fresh context window</sub>
 
 ---
 
@@ -1195,7 +1195,7 @@ PHASE1_HAS_UI=$(echo "$PHASE1_SECTION" | grep -qi "UI hint.*yes" && echo "true"
 
 /gsd-discuss-phase 1 - gather context and clarify approach
 
-<sub>/clear first → fresh context window</sub>
+<sub>/new first → fresh context window</sub>
 
 ---
 

package/.gsd/harnesses/pi/get-shit-done/workflows/plan-milestone-gaps.md

@@ -202,7 +202,7 @@ pi-gsd-tools commit "docs(roadmap): add gap closure phases {N}-{M}" --files .pla
 
 `/gsd-plan-phase {N}`
 
-<sub>`/clear` first → fresh context window</sub>
+<sub>`/new` first → fresh context window</sub>
 
 ---
 

package/.gsd/harnesses/pi/get-shit-done/workflows/plan-phase.md

@@ -859,7 +859,7 @@ Verification: {Passed | Passed with override | Skipped}
 
 /gsd-execute-phase {X} ${GSD_WS}
 
-<sub>/clear first → fresh context window</sub>
+<sub>/new first → fresh context window</sub>
 
 ───────────────────────────────────────────────────────────────
 

package/.gsd/harnesses/pi/get-shit-done/workflows/plan-phase.md.bak

@@ -805,7 +805,7 @@ Verification: {Passed | Passed with override | Skipped}
 
 /gsd-execute-phase {X} ${GSD_WS}
 
-<sub>/clear first → fresh context window</sub>
+<sub>/new first → fresh context window</sub>
 
 ───────────────────────────────────────────────────────────────
 

package/.gsd/harnesses/pi/get-shit-done/workflows/progress.md

@@ -273,7 +273,7 @@ Read its `<objective>` section.
 
 `/gsd-execute-phase {phase} ${GSD_WS}`
 
-<sub>`/clear` first → fresh context window</sub>
+<sub>`/new` first → fresh context window</sub>
 
 ---
 ```
@@ -303,7 +303,7 @@ PHASE_HAS_UI=$(echo "$PHASE_SECTION" | grep -qi "UI hint.*yes" && echo "true" ||
 
 `/gsd-plan-phase {phase-number} ${GSD_WS}`
 
-<sub>`/clear` first → fresh context window</sub>
+<sub>`/new` first → fresh context window</sub>
 
 ---
 ```
@@ -319,7 +319,7 @@ PHASE_HAS_UI=$(echo "$PHASE_SECTION" | grep -qi "UI hint.*yes" && echo "true" ||
 
 `/gsd-discuss-phase {phase}` - gather context and clarify approach
 
-<sub>`/clear` first → fresh context window</sub>
+<sub>`/new` first → fresh context window</sub>
 
 ---
 
@@ -342,7 +342,7 @@ PHASE_HAS_UI=$(echo "$PHASE_SECTION" | grep -qi "UI hint.*yes" && echo "true" ||
 
 `/gsd-discuss-phase {phase} ${GSD_WS}` - gather context and clarify approach
 
-<sub>`/clear` first → fresh context window</sub>
+<sub>`/new` first → fresh context window</sub>
 
 ---
 
@@ -368,7 +368,7 @@ UAT.md exists with gaps (diagnosed issues). User needs to plan fixes.
 
 `/gsd-plan-phase {phase} --gaps ${GSD_WS}`
 
-<sub>`/clear` first → fresh context window</sub>
+<sub>`/new` first → fresh context window</sub>
 
 ---
 
@@ -394,7 +394,7 @@ UAT.md exists with `status: partial` - testing session ended before all items re
 
 `/gsd-verify-work {phase} ${GSD_WS}` - resume testing from where you left off
 
-<sub>`/clear` first → fresh context window</sub>
+<sub>`/new` first → fresh context window</sub>
 
 ---
 
@@ -450,7 +450,7 @@ NEXT_HAS_UI=$(echo "$NEXT_PHASE_SECTION" | grep -qi "UI hint.*yes" && echo "true
 
 `/gsd-discuss-phase {Z+1}` - gather context and clarify approach
 
-<sub>`/clear` first → fresh context window</sub>
+<sub>`/new` first → fresh context window</sub>
 
 ---
 
@@ -475,7 +475,7 @@ NEXT_HAS_UI=$(echo "$NEXT_PHASE_SECTION" | grep -qi "UI hint.*yes" && echo "true
 
 `/gsd-discuss-phase {Z+1} ${GSD_WS}` - gather context and clarify approach
 
-<sub>`/clear` first → fresh context window</sub>
+<sub>`/new` first → fresh context window</sub>
 
 ---
 
@@ -503,7 +503,7 @@ All {N} phases finished!
 
 `/gsd-complete-milestone ${GSD_WS}`
 
-<sub>`/clear` first → fresh context window</sub>
+<sub>`/new` first → fresh context window</sub>
 
 ---
 
@@ -534,7 +534,7 @@ Ready to plan the next milestone.
 
 `/gsd-new-milestone ${GSD_WS}`
 
-<sub>`/clear` first → fresh context window</sub>
+<sub>`/new` first → fresh context window</sub>
 
 ---
 ```

package/.gsd/harnesses/pi/get-shit-done/workflows/resume-project.md

@@ -297,7 +297,7 @@ Based on user selection, route to appropriate workflow:
 
   `/gsd-execute-phase {phase} ${GSD_WS}`
 
-  <sub>`/clear` first → fresh context window</sub>
+  <sub>`/new` first → fresh context window</sub>
 
   ---
   ```
@@ -311,7 +311,7 @@ Based on user selection, route to appropriate workflow:
 
   `/gsd-plan-phase [phase-number] ${GSD_WS}`
 
-  <sub>`/clear` first → fresh context window</sub>
+  <sub>`/new` first → fresh context window</sub>
 
   ---
 

package/.gsd/harnesses/pi/get-shit-done/workflows/settings.md

@@ -105,7 +105,7 @@ AskUserQuestion([
     header: "Auto",
     multiSelect: false,
     options: [
-      { label: "No (Recommended)", description: "Manual /clear + paste between stages" },
+      { label: "No (Recommended)", description: "Manual /new + paste between stages" },
       { label: "Yes", description: "Chain stages via Task() subagents (same isolation)" }
     ]
   },

package/.gsd/harnesses/pi/get-shit-done/workflows/transition.md

@@ -539,7 +539,7 @@ Exit skill and invoke SlashCommand("/gsd-discuss-phase [X+1] --auto ${GSD_WS}")
 
 `/gsd-discuss-phase [X+1] ${GSD_WS}` - gather context and clarify approach
 
-<sub>`/clear` first → fresh context window</sub>
+<sub>`/new` first → fresh context window</sub>
 
 ---
 
@@ -564,7 +564,7 @@ Exit skill and invoke SlashCommand("/gsd-discuss-phase [X+1] --auto ${GSD_WS}")
 
 `/gsd-plan-phase [X+1] ${GSD_WS}`
 
-<sub>`/clear` first → fresh context window</sub>
+<sub>`/new` first → fresh context window</sub>
 
 ---
 
@@ -674,7 +674,7 @@ Exit skill and invoke SlashCommand("/gsd-complete-milestone {version} ${GSD_WS}"
 
 `/gsd-complete-milestone {version} ${GSD_WS}`
 
-<sub>`/clear` first → fresh context window</sub>
+<sub>`/new` first → fresh context window</sub>
 
 ---
 

package/.gsd/harnesses/pi/get-shit-done/workflows/ui-phase.md

@@ -347,7 +347,7 @@ Dimensions: 6/6 passed
 
 `/gsd-plan-phase {N}`
 
-<sub>/clear first → fresh context window</sub>
+<sub>/new first → fresh context window</sub>
 
 ───────────────────────────────────────────────────────────────
 ```

package/.gsd/harnesses/pi/get-shit-done/workflows/ui-review.md

@@ -213,7 +213,7 @@ Full review: {path to UI-REVIEW.md}
 - `/gsd-verify-work {N}` - UAT testing
 - `/gsd-plan-phase {N+1}` - plan next phase
 
-<sub>/clear first → fresh context window</sub>
+<sub>/new first → fresh context window</sub>
 
 ───────────────────────────────────────────────────────────────
 ```

package/.gsd/harnesses/pi/get-shit-done/workflows/validate-phase.md

@@ -227,7 +227,7 @@ GSD > PHASE {N} VALIDATED (PARTIAL)
 ▶ Retry: /gsd-validate-phase {N} ${GSD_WS}
 ```
 
-Display `/clear` reminder.
+Display `/new` reminder.
 
 </process>
 

package/.gsd/harnesses/pi/get-shit-done/workflows/verify-work.md

@@ -635,7 +635,7 @@ Plans verified and ready for execution.
 
 **Execute fixes** - run fix plans
 
-`/clear` then `/gsd-execute-phase {phase} --gaps-only`
+`/new` then `/gsd-execute-phase {phase} --gaps-only`
 
 ───────────────────────────────────────────────────────────────
 ```