gsd-help

<objective>
Display the GSD command reference. Output ONLY the reference below — no additions.
</objective>

<process>
Output the following reference directly:

---

# GSD Command Reference

11 commands. Compact surface, full workflow.

## Core Loop

| Command | Purpose |
|---------|---------|
| `$gsd-start` | Initialize project or new milestone |
| `$gsd-plan [phase]` | Plan a phase (research → plan → verify) |
| `$gsd-run [phase]` | Execute work (phase, quick task, or trivial fix) |
| `$gsd-verify [phase]` | Validate built features via UAT |
| `$gsd-ship [phase]` | Push branch, create PR, prepare for merge |

## Support

| Command | Purpose |
|---------|---------|
| `$gsd-debug [issue]` | Systematic debugging with subagent isolation |
| `$gsd-session` | Resume, pause, check progress, or get next step |
| `$gsd-capture <text>` | Capture note, todo, or backlog item |
| `$gsd-settings` | Configure model profile and workflow toggles |
| `$gsd-update` | Refresh runtime bundle and changelog |
| `$gsd-help` | Show this reference |

---

## Typical Flow

```
$gsd-start                    # new project → PROJECT.md + ROADMAP.md
$gsd-plan 1                   # plan phase 1 → PLAN.md
$gsd-run 1                    # execute phase 1
$gsd-verify 1                 # UAT validation
$gsd-ship 1                   # create PR
$gsd-session next             # advance to phase 2
```

---

## Cost Profiles

| Profile | Use When | Cost Impact |
|---------|----------|-------------|
| `quality` | Critical architecture | Highest |
| `balanced` | Normal development (default) | Medium |
| `budget` | Solo dev, MVPs, high-volume | ~50% lower |
| `inherit` | OpenRouter, Ollama, local models | Zero Anthropic cost |

Set profile: `$gsd-settings --profile budget`

---

## Key Flags

| Command | Flag | Effect |
|---------|------|--------|
| `$gsd-start` | `--milestone 'v1.1'` | New milestone |
| `$gsd-start` | `--map [area]` | Brownfield codebase mapping before planning |
| `$gsd-plan` | `--discuss` | Clarify assumptions first |
| `$gsd-plan` | `--ui` | Generate UI design contract before planning |
| `$gsd-plan` | `add-phase "desc"` | Append future roadmap phase |
| `$gsd-plan` | `insert-phase N "desc"` | Insert urgent future phase |
| `$gsd-plan` | `remove-phase N` | Remove future phase safely |
| `$gsd-plan` | `--gaps` | Fix plans from verification gaps |
| `$gsd-run` | `--quick <task>` | Quick task with GSD guarantees |
| `$gsd-run` | `--fast <task>` | Trivial inline edit |
| `$gsd-run` | `--review [phase]` | Cross-AI review before ship |
| `$gsd-run` | `--workspace new|list|remove` | Multi-workspace operations |
| `$gsd-run` | `--milestone audit|complete` | Milestone operations |
| `$gsd-run` | `--interactive` | Sequential, no subagents |
| `$gsd-verify` | `--audit` | Cross-phase UAT gap scan |
| `$gsd-verify` | `--validate [phase]` | Validation debt audit for completed work |
| `$gsd-verify` | `--health [--repair]` | Planning directory diagnostics |
| `$gsd-session` | `pause` | Save context handoff |
| `$gsd-session` | `report` | Token usage summary |
| `$gsd-capture` | `todo <text>` | Add to active queue |
| `$gsd-capture` | `backlog <text>` | Park for future milestone |
| `$gsd-capture` | `seed <text>` | Save idea with later trigger |
| `$gsd-settings` | `--profile budget` | Cut costs ~50% |
| `$gsd-settings` | `--profile inherit` | Required for non-Anthropic |

---

## Capability Map

| Need | Use |
|------|-----|
| New project or milestone | `$gsd-start` |
| Existing repo / brownfield mapping | `$gsd-start --map` |
| Clarify before planning | `$gsd-plan --discuss` |
| UI planning | `$gsd-plan --ui` |
| Add / insert / remove roadmap phase | `$gsd-plan add-phase|insert-phase|remove-phase` |
| Full phase execution | `$gsd-run <N>` |
| Quick task | `$gsd-run --quick "task"` |
| Trivial fix | `$gsd-run --fast "task"` |
| Cross-AI review | `$gsd-run --review` |
| UAT / audit / health | `$gsd-verify` |
| Pause / resume / next | `$gsd-session` |
| Todo / backlog / seed | `$gsd-capture` |
</process>