Run once when you first bring GSD into the project.
/gsd:map-codebase
/gsd:new-project
/gsd:progress # see where you left off
/gsd:resume-work # full context restore (if needed)
/gsd:discuss-phase [N] # lock in how you want it built
/gsd:plan-phase [N] # research + plan + self-verify
/gsd:execute-phase [N] # parallel execution, auto-commits
/gsd:verify-work [N] # UAT + auto-diagnosis
/gsd:ship [N] # create PR (optional, needs gh CLI)
Shortcuts:
--skip-researchonplan-phaseif the domain is familiar--autoondiscuss-phaseto let Claude pick defaults
Most bugs — use /gsd:quick:
/gsd:quick
> Describe the bug
# Optional flags:
/gsd:quick --discuss # light pre-fix discussion
/gsd:quick --research # spawns a researcher first
/gsd:quick --full # adds plan checking + verification
Trivial bugs (typo, config, one-liner):
/gsd:fast "fix the typo in the login error message"
Complex / hard-to-reproduce bugs:
/gsd:debug "login button not responding on mobile Safari"
Persistent state, tracks hypotheses across the session.
| Need | Command |
|---|---|
| Where am I / what's next? | /gsd:progress |
| Auto-advance to next step | /gsd:next |
| Capture an idea | /gsd:add-todo "description" |
| Park something for later | /gsd:add-backlog "description" |
| Save context before stopping | /gsd:pause-work |
| Something feels stuck/broken | /gsd:forensics |
Tips: Run /clear between major commands to keep context clean. Phase numbers [N] are optional — GSD defaults to the current phase if omitted.
Sources: