Commands
All /gsd:* commands with descriptions, flags, and when to use them
Core Workflow
| Command | Description | Flags | When to Use |
|---|---|---|---|
| /gsd:new-project | Full initialization: questions → research → requirements → roadmap | --auto | Start of a new project |
| /gsd:discuss-phase [N] | Conversational deep-dive on a phase before planning begins | --auto | Before planning, to shape how it gets built |
| /gsd:plan-phase [N] | Research domain, generate atomic PLAN.md files for a phase | --auto, --skip-research, --skip-verify | Before executing a phase |
| /gsd:execute-phase <N> | Run all plans in a phase, commit each task atomically | — | After planning is complete |
| /gsd:verify-work [N] | Post-execution verification: checks must-haves and integration points | — | After execution completes |
| /gsd:audit-milestone | Cross-phase audit for gaps, missing requirements, integration issues | — | Before completing milestone |
| /gsd:complete-milestone | Archive milestone, update MILESTONES.md, prepare for next milestone | — | All phases verified |
| /gsd:new-milestone [name] | Initialize a new milestone with fresh research and requirements | — | After completing a milestone |
| /gsd:research-phase [N] | Run domain research only — no planning output | — | Complex or unfamiliar domain (research only) |
Navigation
| Command | Description | Flags | When to Use |
|---|---|---|---|
| /gsd:progress | Show current milestone, phase, plan status and progress bar | — | Anytime — "where am I?" |
| /gsd:resume-work | Load STATE.md context and resume from last stopping point | — | Starting a new session |
| /gsd:pause-work | Save session state so you can safely stop and return later | — | Stopping mid-phase |
| /gsd:help | Display command reference and quick-start guide | — | Quick reference |
| /gsd:update | Check for new GSD versions and apply available updates | — | Check for new versions |
| /gsd:join-discord | Open the GSD community Discord invite link | — | Questions or community |
Phase Management
| Command | Description | Flags | When to Use |
|---|---|---|---|
| /gsd:add-phase | Append a new phase to the current milestone roadmap | — | Scope grows after initial planning |
| /gsd:insert-phase [N] | Insert a phase before phase N, renumbering subsequent phases | — | Urgent fix mid-milestone |
| /gsd:remove-phase [N] | Remove a phase and renumber remaining phases | — | Descoping a feature |
| /gsd:list-phase-assumptions [N] | List all assumptions baked into a phase's plans | — | Before planning, to validate direction |
| /gsd:plan-milestone-gaps | Generate plans to close gaps identified by /gsd:audit-milestone | — | After audit finds missing items |
| /gsd:validate-phase [N] | Retroactively audit test coverage gaps in a completed phase | — | Retroactively audit test coverage gaps |
Brownfield & Utilities
| Command | Description | Flags | When to Use |
|---|---|---|---|
| /gsd:map-codebase | Analyze existing codebase: stack, architecture, conventions, entry points | — | Before /gsd:new-project on existing code |
| /gsd:quick | Fast single-task execution without full planning overhead | --full, --discuss | Bug fixes, small features, config changes |
| /gsd:debug [desc] | Systematic debugging session with persistent state tracking | — | When something breaks |
| /gsd:add-todo [desc] | Capture an idea or task to the pending todos list | — | Capture an idea for later |
| /gsd:check-todos | Review all pending todos and plan next actions | — | Review captured ideas |
| /gsd:settings | View and change GSD configuration (mode, model, workflow toggles) | — | Change model, toggle agents |
| /gsd:set-profile <profile> | Switch model profile to quality, balanced, or budget | — | Change cost/quality tradeoff |
| /gsd:reapply-patches | Re-apply local customization patches after a GSD update | — | After /gsd:update if you had local edits |
| /gsd:health | Validate .planning/ directory integrity and config correctness | --repair | Validate .planning/ integrity |