| name | gdd-next |
| description | Routes to the next pipeline stage based on current STATE.md position |
| tools | Read, Write, mcp__gdd_status, mcp__gdd_phase_current, mcp__gdd_plans_list |
| disable-model-invocation | true |
Get Design Done - Next
Role: Lightweight router. Read .design/STATE.md and recommend the next command.
Logic
Two paths - MCP preferred when available, file-read fallback otherwise.
MCP path (preferred)
When mcp__gdd_phase_current is exposed (Phase 27.7+, registered via npx @hegemonart/get-design-done --register-mcp):
- Call
mcp__gdd_status (no args) → {phase, branch, last_decisions, last_completed_plans, blocker_count}. Gives cycle + branch context for the output block in one call.
- Call
mcp__gdd_phase_current (no args) → {phase, stage, task_progress, status}. Use stage to drive the routing table below.
- (Optional) Call
mcp__gdd_plans_list (no args) → current phase plans + status, to identify the next incomplete plan and refine the recommendation.
- If
mcp__gdd_status returns a "STATE.md missing" error, print: "No STATE.md found. Run /gdd:new-project to initialize, or @get-design-done brief to start the pipeline." and stop. Otherwise, skip to the routing table.
Two to three MCP calls = full routing decision (~3s, ~32k tokens - Storybloq benchmark).
File-read path (fallback)
When MCP tools are not available, fall back to the legacy flow:
- Check if
.design/STATE.md exists.
- No STATE.md → Print: "No STATE.md found. Run
/gdd:new-project to initialize, or @get-design-done brief to start the pipeline."
- If STATE.md exists, parse frontmatter
stage: field. Proceed to the routing table.
This path loads the same context in 1–2 file reads (~20s, ~46.5k tokens - file-reading baseline).
Routing table
Map the stage (from either path above) to the next recommended command:
Current stage: | Recommendation |
|---|
brief | Run @get-design-done explore to scan and interview |
explore | Run @get-design-done plan to create design plan |
plan | Run @get-design-done design to execute design tasks |
design | Run @get-design-done verify to audit and verify |
verify | Pipeline complete. Run /gdd:new-cycle for next cycle or /gdd:ship to create PR |
Output
Print the recommendation as a single formatted block:
━━━ Next step ━━━
Current stage: <stage>
Status: <status>
→ <recommendation>
━━━━━━━━━━━━━━━━━━
Do Not
- Do not modify STATE.md.
- Do not invoke the next stage automatically - only recommend.
NEXT COMPLETE
