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

Continuation Format

Standard format for presenting next steps after completing a command or workflow.

Core Structure

---

## ▶ Next Up

**{identifier}: {name}** — {one-line description}

{command to copy-paste}

<sub>`/clear` first → fresh context window</sub>

---

**Also available:**
- {alternative option 1}
- {alternative option 2}

---

Format Rules

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
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

Variants

Execute Next Plan

---

## ▶ 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

<sub>`/clear` first → fresh context window</sub>

---

**Also available:**
- Review plan before executing
- `/gsd:list-phase-assumptions 2` — check assumptions

---

Execute Final Plan in Phase

Add note that this is the last plan and what comes after:

---

## ▶ Next Up

**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

<sub>`/clear` first → fresh context window</sub>

---

**After this completes:**
- Phase 2 → Phase 3 transition
- Next: **Phase 3: Core Features** — User dashboard and settings

---

Plan a Phase

---

## ▶ Next Up

**Phase 2: Authentication** — JWT login flow with refresh tokens

/gsd:plan-phase 2

<sub>`/clear` first → fresh context window</sub>

---

**Also available:**
- `/gsd:discuss-phase 2` — gather context first
- `/gsd:research-phase 2` — investigate unknowns
- Review roadmap

---

Phase Complete, Ready for Next

Show completion status before next action:

---

## ✓ Phase 2 Complete

3/3 plans executed

## ▶ Next Up

**Phase 3: Core Features** — User dashboard, settings, and data export

/gsd:plan-phase 3

<sub>`/clear` first → fresh context window</sub>

---

**Also available:**
- `/gsd:discuss-phase 3` — gather context first
- `/gsd:research-phase 3` — investigate unknowns
- Review what Phase 2 built

---

Multiple Equal Options

When there's no clear primary action:

---

## ▶ Next Up

**Phase 3: Core Features** — User dashboard, settings, and data export

**To plan directly:**

/gsd:plan-phase 3

**To discuss context first:**

/gsd:discuss-phase 3

**To research unknowns:**

/gsd:research-phase 3

<sub>`/clear` first → fresh context window</sub>

---

Milestone Complete

---

## 🎉 Milestone v1.0 Complete

All 4 phases shipped

## ▶ Next Up

**Plan v1.1** — Enhanced features and optimizations

/gsd:discuss-milestone

<sub>`/clear` first → fresh context window</sub>

---

**Also available:**
- `/gsd:new-milestone` — create directly if scope is clear
- Review accomplishments before moving on

---

Pulling Context

For phases (from ROADMAP.md):

### Phase 2: Authentication
**Goal**: JWT login flow with refresh tokens

Extract: **Phase 2: Authentication** — JWT login flow with refresh tokens

For plans (from ROADMAP.md):

Plans:
- [ ] 02-03: Add refresh token rotation

Or from PLAN.md <objective>:

<objective>
Add refresh token rotation with sliding expiry window.

Purpose: Extend session lifetime without compromising security.
</objective>

Extract: **02-03: Refresh Token Rotation** — Add /api/auth/refresh with sliding expiry

Anti-Patterns

Don't: Command-only (no context)

## 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

/gsd:plan-phase 3

Run /clear first.

Doesn't explain why. User might skip it.

Don't: "Other options" language

Other options:
- Review roadmap

Sounds like an afterthought. Use "Also available:" instead.