| name | gsd-workflow |
| description | Use when the user asks "what should I work on", mentions GSD phases, ROADMAP, or .planning/ artifacts. Routes to the correct GSD command for the current project state. |
| description-frequency | on-demand |
| user-invocable | true |
| version | 1.0.0 |
| format | "2025-10-02T00:00:00.000Z" |
| triggers | ["what should I work on next","which GSD command do I run"] |
| updated | "2026-04-25T00:00:00.000Z" |
| status | ACTIVE |
GSD Workflow Routing
Route user intent to GSD commands. Explicit /gsd: commands bypass routing -- read .claude/commands/gsd/[command].md directly.
5-Stage Classification Pipeline
When the user provides natural language related to project workflow, route through the GSD Orchestrator's classification pipeline:
- Exact match -- direct command mapping (fastest)
- Lifecycle filtering -- narrow candidates by current project phase
- Bayesian classification -- probabilistic intent matching
- Semantic fallback -- embedding-based similarity for ambiguous requests
- Confidence resolution -- threshold check; ask user if uncertain
When to use the orchestrator: The user says something like "review the requirements," "what's the project status," "let's verify phase 3," or any natural language that maps to a GSD lifecycle action but doesn't use explicit slash commands.
When to bypass it: The user types an explicit GSD slash command. Execute directly.
When confidence is low: Ask the user to clarify rather than guessing. A wrong routing is worse than a clarifying question.
Quick Command Routing
The top-10 most common routes:
| User Says | Route To |
|---|
| "what should I work on" | /gsd:progress |
| "continue where I left off" | /gsd:progress |
| "build phase X" | /gsd:execute-phase X |
| "plan the next phase" | /gsd:plan-phase N |
| "discuss how phase X should work" | /gsd:discuss-phase N |
| "something's broken" | /gsd:debug |
| "quick fix / small task" | /gsd:quick |
| "verify phase X" | /gsd:verify-work X |
| "add a phase" | /gsd:phase |
| "start new project" | /gsd:new-project |
For full routing tables including skill-creator actions, see references/command-routing.md.
