diff --git a/commands/gsd/add-phase.md b/commands/gsd/add-phase.md
index 3ce4cacda..5bc93d46f 100644
--- a/commands/gsd/add-phase.md
+++ b/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}`
`/clear` first → fresh context window
diff --git a/commands/gsd/create-roadmap.md b/commands/gsd/create-roadmap.md
index 4bfc8bb0d..a01444c9e 100644
--- a/commands/gsd/create-roadmap.md
+++ b/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`
`/clear` first → fresh context window
diff --git a/commands/gsd/insert-phase.md b/commands/gsd/insert-phase.md
index 98a706d27..5678278a0 100644
--- a/commands/gsd/insert-phase.md
+++ b/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}`
`/clear` first → fresh context window
diff --git a/commands/gsd/new-project.md b/commands/gsd/new-project.md
index 2e81f7fc0..04377986e 100644
--- a/commands/gsd/new-project.md
+++ b/commands/gsd/new-project.md
@@ -181,9 +181,7 @@ Project initialized:
**[Project Name]** — create roadmap
-```
-/gsd:create-roadmap
-```
+`/gsd:create-roadmap`
`/clear` first → fresh context window
diff --git a/commands/gsd/progress.md b/commands/gsd/progress.md
index 4134ce17c..fa3a003d0 100644
--- a/commands/gsd/progress.md
+++ b/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]`
`/clear` first → fresh context window
@@ -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]`
`/clear` first → fresh context window
@@ -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]`
`/clear` first → fresh context window
diff --git a/get-shit-done/references/continuation-format.md b/get-shit-done/references/continuation-format.md
index 832a9c892..090ab997b 100644
--- a/get-shit-done/references/continuation-format.md
+++ b/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}`
`/clear` first → fresh context window
---
**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 `` 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`
`/clear` first → fresh context window
@@ -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
Final plan in Phase 2
-```
-/gsd:execute-plan .planning/phases/02-auth/02-03-PLAN.md
-```
+`/gsd:execute-plan .planning/phases/02-auth/02-03-PLAN.md`
`/clear` first → fresh context window
@@ -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`
`/clear` first → fresh context window
@@ -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`
`/clear` first → fresh context window
@@ -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`
`/clear` first → fresh context window
@@ -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`
`/clear` first → fresh context window
@@ -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.
diff --git a/get-shit-done/workflows/complete-milestone.md b/get-shit-done/workflows/complete-milestone.md
index e7fc82fcc..d15c1cf8e 100644
--- a/get-shit-done/workflows/complete-milestone.md
+++ b/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`
`/clear` first → fresh context window
diff --git a/get-shit-done/workflows/create-milestone.md b/get-shit-done/workflows/create-milestone.md
index 69093c489..f0fe04120 100644
--- a/get-shit-done/workflows/create-milestone.md
+++ b/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]`
`/clear` first → fresh context window
diff --git a/get-shit-done/workflows/create-roadmap.md b/get-shit-done/workflows/create-roadmap.md
index 9d6b9894d..f3bb68f25 100644
--- a/get-shit-done/workflows/create-roadmap.md
+++ b/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`
`/clear` first → fresh context window
diff --git a/get-shit-done/workflows/discuss-milestone.md b/get-shit-done/workflows/discuss-milestone.md
index 18d3ae8e9..dfa3cc5a9 100644
--- a/get-shit-done/workflows/discuss-milestone.md
+++ b/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`
`/clear` first → fresh context window
diff --git a/get-shit-done/workflows/discuss-phase.md b/get-shit-done/workflows/discuss-phase.md
index bbda1b8c1..50ba3ffbc 100644
--- a/get-shit-done/workflows/discuss-phase.md
+++ b/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}`
`/clear` first → fresh context window
diff --git a/get-shit-done/workflows/execute-phase.md b/get-shit-done/workflows/execute-phase.md
index b8905945d..75d945ebc 100644
--- a/get-shit-done/workflows/execute-phase.md
+++ b/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`
`/clear` first → fresh context window
@@ -1318,9 +1316,7 @@ This milestone is 100% done.
**Complete Milestone** — archive and prepare for next
-```
-/gsd:complete-milestone
-```
+`/gsd:complete-milestone`
`/clear` first → fresh context window
@@ -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]`
`/clear` first → fresh context window
diff --git a/get-shit-done/workflows/map-codebase.md b/get-shit-done/workflows/map-codebase.md
index 3bf078db5..c0002c3f5 100644
--- a/get-shit-done/workflows/map-codebase.md
+++ b/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`
`/clear` first → fresh context window
diff --git a/get-shit-done/workflows/plan-phase.md b/get-shit-done/workflows/plan-phase.md
index a3efc64dd..16bf5120d 100644
--- a/get-shit-done/workflows/plan-phase.md
+++ b/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`
`/clear` first → fresh context window
@@ -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`
`/clear` first → fresh context window
diff --git a/get-shit-done/workflows/resume-project.md b/get-shit-done/workflows/resume-project.md
index 0cf4bdee1..bc0c829ec 100644
--- a/get-shit-done/workflows/resume-project.md
+++ b/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]`
`/clear` first → fresh context window
@@ -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]`
`/clear` first → fresh context window
diff --git a/get-shit-done/workflows/transition.md b/get-shit-done/workflows/transition.md
index a62c7c4dc..4297b8e9c 100644
--- a/get-shit-done/workflows/transition.md
+++ b/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]`
`/clear` first → fresh context window
@@ -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]`
`/clear` first → fresh context window