6a2bf05de7
Replace the single 747-line /gsd-help reference with a progressive-disclosure dispatcher (#2551 pattern). Newcomers get a one-page tour; returning users get a 10-line refresher with --brief; the complete reference stays available behind --full; /gsd-help <topic> emits one section; and /gsd-help --brief <topic> is a compact scoped lookup (signature + one-line summary). - workflows/help.md becomes a small dispatcher routing on $ARGUMENTS - workflows/help/modes/{brief,default,full,topic}.md hold the tier bodies - commands/gsd/help.md passes $ARGUMENTS through, advertises composable form - docs/COMMANDS.md documents the new flags and topic form - existing tests that read help.md repointed at help/modes/full.md (bug-2836, bug-2950, bug-2954, cursor-reviewer, execute-phase-wave) - new feat-3039-help-tiered test enforces structure, size budgets, dispatcher routing, shim arg passthrough, topic→section coverage, orphan-heading detection, conflict-resolution rules, routing preamble, and compact-scope rule Trek-e review fixes (PR #3040): - topic.md output rules split into 5a/5b/5c — explicit handling for single sections, multi-section "plus" joins, and bold-line sub-block anchors; each rule also takes scope (full vs compact) into account - explicit resolved-routing preamble line emitted by topic.md before content ("**Topic:** `<alias>` → `<heading>` *(scope: full | compact)*") so the user sees which alias matched at which scope (review finding #3) - composable `--brief <topic>` invokes topic.md in compact scope: heading + first `**/gsd:*`** signature line + one-line summary. Dispatcher and topic.md cooperate via $ARGUMENTS pass-through (review finding #4) - full.md capped at LARGE-tier budget (FULL_BUDGET = 1500); the non-recursive workflow-size-budget test does not reach modes/ subdirs - structural <progressive_disclosure> table parse (5-row assertion) replaces substring-soup regex matching — 5 rows = 4 base tiers + composable scope - forward /gsd:* sub-block token coverage + reverse orphan-heading allowlist catch alias-table drift in both directions - four conflict-resolution tests guard dispatcher promises (--brief+--full without topic → --full; --brief <topic> → compact; --full <topic> or bare → full; dispatcher retains --brief when delegating to topic.md) - hardcoded topic lists removed from docs/COMMANDS.md and full.md (drift surfaces reduced from 5 to 2) - topic.md alias bloat trimmed (~75 → ~25 rows); cleanup/update split into distinct sub-block rows under ### Utility Commands - comment-rot ("~750 lines") removed from default.md and full.md - dispatcher size guard tightened from < 100 to <= 40 lines - commands/gsd/help.md <process> block trimmed to one line - MD040 fence languages added to all plain code blocks across mode files Main-merge conflict resolution: - workflows/help.md kept as dispatcher (body lives in help/modes/full.md) - /gsd-<cmd> → /gsd:<cmd> rename from #3452 reapplied to the mode files (full.md, default.md, brief.md, topic.md) — the six namespace routers (/gsd-context, /gsd-ideate, /gsd-manage, /gsd-project, /gsd-quality, /gsd-workflow) and wildcards (/gsd-*) preserved in hyphen form per main's convention - bug-2950 test combines branch's path repointing with main's namespaced replacement strings
1.9 KiB
1.9 KiB
One-page newcomer-oriented tour of GSD. Output ONLY the `` content below. No additions.
# GSD — Get Shit Done
Plan-driven development for solo agentic work with Claude Code. GSD turns a vague idea into a hierarchical plan, then executes it phase by phase with state tracking and atomic commits.
Start here (3 commands)
/gsd:new-project # Greenfield: questioning → research → requirements → roadmap
/gsd:plan-phase 1 # Create a detailed plan for phase 1
/gsd:execute-phase 1 # Execute all plans in the phase
Existing codebase? Run /gsd:map-codebase first to ground GSD in your code.
Common commands
| Command | Purpose |
|---|---|
/gsd:progress |
Where am I, what's next — also routes freeform intent with --do "..." |
/gsd:quick |
Small ad-hoc task with GSD guarantees (planning dir + atomic commit) |
/gsd:fast "<task>" |
Trivial inline change — no subagents, ≤3 file edits |
/gsd:discuss-phase <N> |
Capture vision and decisions before planning |
/gsd:debug "<symptom>" |
Persistent debug session, survives /clear |
/gsd:capture |
Save an idea, todo, note, seed, or backlog item |
/gsd:verify-work <N> |
Conversational UAT for a completed phase |
/gsd:ship <N> |
Open a PR from a completed phase |
/gsd:help --full |
Complete reference (every command, every flag) |
Want more?
/gsd:help --brief # 10-line refresher of top commands
/gsd:help --full # complete reference
/gsd:help <topic> # one section only — see topics below
/gsd:help --brief <topic> # compact scoped lookup — signature + one-line summary
Topics: workflow · planning · execute · quick · debug · capture · ship · config · milestones · spike · sketch · review · audit · progress
Update GSD
npx get-shit-done-cc@latest