fix: use inline code for Next Up commands (avoids nesting ambiguity)

commands/gsd/add-phase.md

@@ -169,9 +169,7 @@ Project state updated: .planning/STATE.md
 
 **Phase {N}: {description}**
 
-```
-/gsd:plan-phase {N}
-```
+`/gsd:plan-phase {N}`
 
 <sub>`/clear` first → fresh context window</sub>
 

commands/gsd/create-roadmap.md

@@ -82,9 +82,7 @@ Roadmap created:
 
 **Phase 1: [Name]** — [Goal from ROADMAP.md]
 
-```
-/gsd:plan-phase 1
-```
+`/gsd:plan-phase 1`
 
 <sub>`/clear` first → fresh context window</sub>
 

commands/gsd/insert-phase.md

@@ -188,9 +188,7 @@ Project state updated: .planning/STATE.md
 
 **Phase {decimal_phase}: {description}** — urgent insertion
 
-```
-/gsd:plan-phase {decimal_phase}
-```
+`/gsd:plan-phase {decimal_phase}`
 
 <sub>`/clear` first → fresh context window</sub>
 

commands/gsd/new-project.md

@@ -181,9 +181,7 @@ Project initialized:
 
 **[Project Name]** — create roadmap
 
-```
-/gsd:create-roadmap
-```
+`/gsd:create-roadmap`
 
 <sub>`/clear` first → fresh context window</sub>
 

commands/gsd/progress.md

@@ -106,9 +106,7 @@ Check if `{phase}-{plan}-PLAN.md` exists for that number.
 
   **{phase}-{plan}: [Plan Name]** — [objective summary from PLAN.md]
 
-  ```
-  /gsd:execute-plan [full-path-to-PLAN.md]
-  ```
+  `/gsd:execute-plan [full-path-to-PLAN.md]`
 
   <sub>`/clear` first → fresh context window</sub>
 
@@ -132,9 +130,7 @@ Check if `{phase}-{plan}-PLAN.md` exists for that number.
 
   **Phase [N]: [Name]** — [Goal from ROADMAP.md]
 
-  ```
-  /gsd:plan-phase [phase-number]
-  ```
+  `/gsd:plan-phase [phase-number]`
 
   <sub>`/clear` first → fresh context window</sub>
 
@@ -151,9 +147,7 @@ Check if `{phase}-{plan}-PLAN.md` exists for that number.
 
   **Phase [N]: [Name]** — [Goal from ROADMAP.md]
 
-  ```
-  /gsd:plan-phase [phase]
-  ```
+  `/gsd:plan-phase [phase]`
 
   <sub>`/clear` first → fresh context window</sub>
 

get-shit-done/references/continuation-format.md

@@ -4,24 +4,22 @@ Standard format for presenting next steps after completing a command or workflow
 
 ## Core Structure
 
-```markdown
+```
 ---
 
 ## ▶ Next Up
 
 **{identifier}: {name}** — {one-line description}
 
-```
-{command to copy-paste}
-```
+`{command to copy-paste}`
 
 <sub>`/clear` first → fresh context window</sub>
 
 ---
 
 **Also available:**
-- {alternative option 1}
-- {alternative option 2}
+- `{alternative option 1}` — description
+- `{alternative option 2}` — description
 
 ---
 ```
@@ -30,7 +28,7 @@ Standard format for presenting next steps after completing a command or workflow
 
 1. **Always show what it is** — name + description, never just a command path
 2. **Pull context from source** — ROADMAP.md for phases, PLAN.md `<objective>` for plans
-3. **Command in clean code block** — easy to copy-paste
+3. **Command in inline code** — backticks, easy to copy-paste, renders as clickable link
 4. **`/clear` explanation** — always include, keeps it concise but explains why
 5. **"Also available" not "Other options"** — sounds more app-like
 6. **Visual separators** — `---` above and below to make it stand out
@@ -39,16 +37,14 @@ Standard format for presenting next steps after completing a command or workflow
 
 ### Execute Next Plan
 
-```markdown
+```
 ---
 
 ## ▶ Next Up
 
 **02-03: Refresh Token Rotation** — Add /api/auth/refresh with sliding expiry
 
-```
-/gsd:execute-plan .planning/phases/02-auth/02-03-PLAN.md
-```
+`/gsd:execute-plan .planning/phases/02-auth/02-03-PLAN.md`
 
 <sub>`/clear` first → fresh context window</sub>
 
@@ -65,7 +61,7 @@ Standard format for presenting next steps after completing a command or workflow
 
 Add note that this is the last plan and what comes after:
 
-```markdown
+```
 ---
 
 ## ▶ Next Up
@@ -73,9 +69,7 @@ Add note that this is the last plan and what comes after:
 **02-03: Refresh Token Rotation** — Add /api/auth/refresh with sliding expiry
 <sub>Final plan in Phase 2</sub>
 
-```
-/gsd:execute-plan .planning/phases/02-auth/02-03-PLAN.md
-```
+`/gsd:execute-plan .planning/phases/02-auth/02-03-PLAN.md`
 
 <sub>`/clear` first → fresh context window</sub>
 
@@ -90,16 +84,14 @@ Add note that this is the last plan and what comes after:
 
 ### Plan a Phase
 
-```markdown
+```
 ---
 
 ## ▶ Next Up
 
 **Phase 2: Authentication** — JWT login flow with refresh tokens
 
-```
-/gsd:plan-phase 2
-```
+`/gsd:plan-phase 2`
 
 <sub>`/clear` first → fresh context window</sub>
 
@@ -117,7 +109,7 @@ Add note that this is the last plan and what comes after:
 
 Show completion status before next action:
 
-```markdown
+```
 ---
 
 ## ✓ Phase 2 Complete
@@ -128,9 +120,7 @@ Show completion status before next action:
 
 **Phase 3: Core Features** — User dashboard, settings, and data export
 
-```
-/gsd:plan-phase 3
-```
+`/gsd:plan-phase 3`
 
 <sub>`/clear` first → fresh context window</sub>
 
@@ -148,27 +138,18 @@ Show completion status before next action:
 
 When there's no clear primary action:
 
-```markdown
+```
 ---
 
 ## ▶ Next Up
 
 **Phase 3: Core Features** — User dashboard, settings, and data export
 
-**To plan directly:**
-```
-/gsd:plan-phase 3
-```
+**To plan directly:** `/gsd:plan-phase 3`
 
-**To discuss context first:**
-```
-/gsd:discuss-phase 3
-```
+**To discuss context first:** `/gsd:discuss-phase 3`
 
-**To research unknowns:**
-```
-/gsd:research-phase 3
-```
+**To research unknowns:** `/gsd:research-phase 3`
 
 <sub>`/clear` first → fresh context window</sub>
 
@@ -177,7 +158,7 @@ When there's no clear primary action:
 
 ### Milestone Complete
 
-```markdown
+```
 ---
 
 ## 🎉 Milestone v1.0 Complete
@@ -188,9 +169,7 @@ All 4 phases shipped
 
 **Plan v1.1** — Enhanced features and optimizations
 
-```
-/gsd:discuss-milestone
-```
+`/gsd:discuss-milestone`
 
 <sub>`/clear` first → fresh context window</sub>
 
@@ -237,23 +216,19 @@ Extract: `**02-03: Refresh Token Rotation** — Add /api/auth/refresh with slidi
 
 ### Don't: Command-only (no context)
 
-```markdown
+```
 ## To Continue
 
 Run `/clear`, then paste:
-```
 /gsd:execute-plan .planning/phases/02-auth/02-03-PLAN.md
 ```
-```
 
 User has no idea what 02-03 is about.
 
 ### Don't: Missing /clear explanation
 
-```markdown
-```
-/gsd:plan-phase 3
 ```
+`/gsd:plan-phase 3`
 
 Run /clear first.
 ```
@@ -262,9 +237,19 @@ Doesn't explain why. User might skip it.
 
 ### Don't: "Other options" language
 
-```markdown
+```
 Other options:
 - Review roadmap
 ```
 
 Sounds like an afterthought. Use "Also available:" instead.
+
+### Don't: Fenced code blocks for commands
+
+```
+```
+/gsd:plan-phase 3
+```
+```
+
+Fenced blocks inside templates create nesting ambiguity. Use inline backticks instead.

get-shit-done/workflows/complete-milestone.md

@@ -430,9 +430,7 @@ Tag: v[X.Y]
 
 **Plan Next Milestone** — define v[X.Y+1] features and scope
 
-```
-/gsd:discuss-milestone
-```
+`/gsd:discuss-milestone`
 
 <sub>`/clear` first → fresh context window</sub>
 

get-shit-done/workflows/create-milestone.md

@@ -329,9 +329,7 @@ Milestone v[X.Y] [Name] created:
 
 **Phase [N]: [Name]** — [Goal from ROADMAP.md]
 
-```
-/gsd:plan-phase [N]
-```
+`/gsd:plan-phase [N]`
 
 <sub>`/clear` first → fresh context window</sub>
 

get-shit-done/workflows/create-roadmap.md

@@ -388,9 +388,7 @@ Project initialized:
 
 **Phase 1: [Name]** — [Goal from ROADMAP.md]
 
-```
-/gsd:plan-phase 1
-```
+`/gsd:plan-phase 1`
 
 <sub>`/clear` first → fresh context window</sub>
 

get-shit-done/workflows/discuss-milestone.md

@@ -144,9 +144,7 @@ Ready to create the milestone structure.
 
 **Create Milestone v[X.Y]** — [Theme Name]
 
-```
-/gsd:new-milestone
-```
+`/gsd:new-milestone`
 
 <sub>`/clear` first → fresh context window</sub>
 

get-shit-done/workflows/discuss-phase.md

@@ -200,9 +200,7 @@ Created: .planning/phases/${PHASE}-${SLUG}/${PHASE}-CONTEXT.md
 
 **Phase ${PHASE}: [Name]** — [Goal from ROADMAP.md]
 
-```
-/gsd:plan-phase ${PHASE}
-```
+`/gsd:plan-phase ${PHASE}`
 
 <sub>`/clear` first → fresh context window</sub>
 

get-shit-done/workflows/execute-phase.md

@@ -1262,9 +1262,7 @@ Summary: .planning/phases/XX-name/{phase}-{plan}-SUMMARY.md
 
 **{phase}-{next-plan}: [Plan Name]** — [objective from next PLAN.md]
 
-```
-/gsd:execute-plan .planning/phases/XX-name/{phase}-{next-plan}-PLAN.md
-```
+`/gsd:execute-plan .planning/phases/XX-name/{phase}-{next-plan}-PLAN.md`
 
 <sub>`/clear` first → fresh context window</sub>
 
@@ -1318,9 +1316,7 @@ This milestone is 100% done.
 
 **Complete Milestone** — archive and prepare for next
 
-```
-/gsd:complete-milestone
-```
+`/gsd:complete-milestone`
 
 <sub>`/clear` first → fresh context window</sub>
 
@@ -1349,9 +1345,7 @@ All [Y] plans finished.
 
 **Phase [X+1]: [Name]** — [Goal from ROADMAP.md]
 
-```
-/gsd:plan-phase [X+1]
-```
+`/gsd:plan-phase [X+1]`
 
 <sub>`/clear` first → fresh context window</sub>
 

get-shit-done/workflows/map-codebase.md

@@ -385,9 +385,7 @@ Created .planning/codebase/:
 
 **Initialize project** — use codebase context for planning
 
-```
-/gsd:new-project
-```
+`/gsd:new-project`
 
 <sub>`/clear` first → fresh context window</sub>
 

get-shit-done/workflows/plan-phase.md

@@ -771,9 +771,7 @@ Phase plan created: .planning/phases/XX-name/{phase}-01-PLAN.md
 
 **{phase}-01: [Plan Name]** — [objective summary]
 
-```
-/gsd:execute-plan .planning/phases/XX-name/{phase}-01-PLAN.md
-```
+`/gsd:execute-plan .planning/phases/XX-name/{phase}-01-PLAN.md`
 
 <sub>`/clear` first → fresh context window</sub>
 
@@ -802,9 +800,7 @@ Total: [X] tasks across [Y] focused plans.
 
 **{phase}-01: [Plan Name]** — [objective summary]
 
-```
-/gsd:execute-plan .planning/phases/XX-name/{phase}-01-PLAN.md
-```
+`/gsd:execute-plan .planning/phases/XX-name/{phase}-01-PLAN.md`
 
 <sub>`/clear` first → fresh context window</sub>
 

get-shit-done/workflows/resume-project.md

@@ -182,9 +182,7 @@ Based on user selection, route to appropriate workflow:
 
   **{phase}-{plan}: [Plan Name]** — [objective from PLAN.md]
 
-  ```
-  /gsd:execute-plan [path]
-  ```
+  `/gsd:execute-plan [path]`
 
   <sub>`/clear` first → fresh context window</sub>
 
@@ -198,9 +196,7 @@ Based on user selection, route to appropriate workflow:
 
   **Phase [N]: [Name]** — [Goal from ROADMAP.md]
 
-  ```
-  /gsd:plan-phase [phase-number]
-  ```
+  `/gsd:plan-phase [phase-number]`
 
   <sub>`/clear` first → fresh context window</sub>
 

get-shit-done/workflows/transition.md

@@ -397,9 +397,7 @@ Exit skill and invoke SlashCommand("/gsd:plan-phase [X+1]")
 
 **Phase [X+1]: [Name]** — [Goal from ROADMAP.md]
 
-```
-/gsd:plan-phase [X+1]
-```
+`/gsd:plan-phase [X+1]`
 
 <sub>`/clear` first → fresh context window</sub>
 
@@ -440,9 +438,7 @@ Exit skill and invoke SlashCommand("/gsd:complete-milestone [version]")
 
 **Complete Milestone [version]** — archive and prepare for next
 
-```
-/gsd:complete-milestone [version]
-```
+`/gsd:complete-milestone [version]`
 
 <sub>`/clear` first → fresh context window</sub>