fix: replace /gsd: slash command format with /gsd- skill format in all user-facing content (#1579)
* fix: replace /gsd: command format with /gsd- skill format in all suggestions All next-step suggestions shown to users were still using the old colon format (/gsd:xxx) which cannot be copy-pasted as skills. Migrated all occurrences across agents/, commands/, get-shit-done/, docs/, README files, bin/install.js (hardcoded defaults for claude runtime), and get-shit-done/bin/lib/*.cjs (generate-claude-md templates and error messages). Updated tests to assert new hyphen format instead of old colon format. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> * fix: migrate remaining /gsd: format to /gsd- in hooks, workflows, and sdk Addresses remaining user-facing occurrences missed in the initial migration: - hooks/: fix 4 user-facing messages (pause-work, update, fast, quick) and 2 comments in gsd-workflow-guard.js - get-shit-done/workflows/: fix 21 Skill() literal calls that Claude executes directly (installer does not transform workflow content) - sdk/prompt-sanitizer.ts: update regex to strip /gsd- format in addition to legacy /gsd: format; update JSDoc comment - tests/: update autonomous-ui-steps, prompt-sanitizer to assert new format Note: commands/gsd/*.md frontmatter (name: gsd:xxx) intentionally unchanged — installer derives skillName from directory path, not the name field. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> * fix(plan-phase): preserve --chain flag in auto-advance sync and handle ui-phase gate in chain mode Bug 1: step 15 sync-flag check only guarded against --auto, causing _auto_chain_active to be cleared when plan-phase is invoked without --auto in ARGUMENTS even though a --chain pipeline was active. Added --chain to the guard condition, matching discuss-phase behaviour. Bug 2: UI Design Contract gate (step 5.6) always exited the workflow when UI-SPEC was missing, breaking the discuss --chain pipeline silently. When _auto_chain_active is true, the gate now auto-invokes gsd-ui-phase --auto via Skill() and continues to step 6 without prompting. Manual invocations retain the existing AskUserQuestion flow. * fix: remove <sub>/clear</sub> pattern and duplicate old-format command in discuss-phase.md --------- Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
346
docs/COMMANDS.md
346
docs/COMMANDS.md
@@ -6,7 +6,7 @@
|
||||
|
||||
## Command Syntax
|
||||
|
||||
- **Claude Code / Gemini / Copilot:** `/gsd:command-name [args]`
|
||||
- **Claude Code / Gemini / Copilot:** `/gsd-command-name [args]`
|
||||
- **OpenCode / Kilo:** `/gsd-command-name [args]`
|
||||
- **Codex:** `$gsd-command-name [args]`
|
||||
|
||||
@@ -14,7 +14,7 @@
|
||||
|
||||
## Core Workflow Commands
|
||||
|
||||
### `/gsd:new-project`
|
||||
### `/gsd-new-project`
|
||||
|
||||
Initialize a new project with deep context gathering.
|
||||
|
||||
@@ -26,13 +26,13 @@ Initialize a new project with deep context gathering.
|
||||
**Produces:** `PROJECT.md`, `REQUIREMENTS.md`, `ROADMAP.md`, `STATE.md`, `config.json`, `research/`, `CLAUDE.md`
|
||||
|
||||
```bash
|
||||
/gsd:new-project # Interactive mode
|
||||
/gsd:new-project --auto @prd.md # Auto-extract from PRD
|
||||
/gsd-new-project # Interactive mode
|
||||
/gsd-new-project --auto @prd.md # Auto-extract from PRD
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### `/gsd:new-workspace`
|
||||
### `/gsd-new-workspace`
|
||||
|
||||
Create an isolated workspace with repo copies and independent `.planning/` directory.
|
||||
|
||||
@@ -52,14 +52,14 @@ Create an isolated workspace with repo copies and independent `.planning/` direc
|
||||
**Produces:** `WORKSPACE.md`, `.planning/`, repo copies (worktrees or clones)
|
||||
|
||||
```bash
|
||||
/gsd:new-workspace --name feature-b --repos hr-ui,ZeymoAPI
|
||||
/gsd:new-workspace --name feature-b --repos . --strategy worktree # Same-repo isolation
|
||||
/gsd:new-workspace --name spike --repos api,web --strategy clone # Full clones
|
||||
/gsd-new-workspace --name feature-b --repos hr-ui,ZeymoAPI
|
||||
/gsd-new-workspace --name feature-b --repos . --strategy worktree # Same-repo isolation
|
||||
/gsd-new-workspace --name spike --repos api,web --strategy clone # Full clones
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### `/gsd:list-workspaces`
|
||||
### `/gsd-list-workspaces`
|
||||
|
||||
List active GSD workspaces and their status.
|
||||
|
||||
@@ -67,12 +67,12 @@ List active GSD workspaces and their status.
|
||||
**Shows:** Name, repo count, strategy, GSD project status
|
||||
|
||||
```bash
|
||||
/gsd:list-workspaces
|
||||
/gsd-list-workspaces
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### `/gsd:remove-workspace`
|
||||
### `/gsd-remove-workspace`
|
||||
|
||||
Remove a workspace and clean up git worktrees.
|
||||
|
||||
@@ -83,12 +83,12 @@ Remove a workspace and clean up git worktrees.
|
||||
**Safety:** Refuses removal if any repo has uncommitted changes. Requires name confirmation.
|
||||
|
||||
```bash
|
||||
/gsd:remove-workspace feature-b
|
||||
/gsd-remove-workspace feature-b
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### `/gsd:discuss-phase`
|
||||
### `/gsd-discuss-phase`
|
||||
|
||||
Capture implementation decisions before planning.
|
||||
|
||||
@@ -106,15 +106,15 @@ Capture implementation decisions before planning.
|
||||
**Produces:** `{phase}-CONTEXT.md`, `{phase}-DISCUSSION-LOG.md` (audit trail)
|
||||
|
||||
```bash
|
||||
/gsd:discuss-phase 1 # Interactive discussion for phase 1
|
||||
/gsd:discuss-phase 3 --auto # Auto-select defaults for phase 3
|
||||
/gsd:discuss-phase --batch # Batch mode for current phase
|
||||
/gsd:discuss-phase 2 --analyze # Discussion with trade-off analysis
|
||||
/gsd-discuss-phase 1 # Interactive discussion for phase 1
|
||||
/gsd-discuss-phase 3 --auto # Auto-select defaults for phase 3
|
||||
/gsd-discuss-phase --batch # Batch mode for current phase
|
||||
/gsd-discuss-phase 2 --analyze # Discussion with trade-off analysis
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### `/gsd:ui-phase`
|
||||
### `/gsd-ui-phase`
|
||||
|
||||
Generate UI design contract for frontend phases.
|
||||
|
||||
@@ -126,12 +126,12 @@ Generate UI design contract for frontend phases.
|
||||
**Produces:** `{phase}-UI-SPEC.md`
|
||||
|
||||
```bash
|
||||
/gsd:ui-phase 2 # Design contract for phase 2
|
||||
/gsd-ui-phase 2 # Design contract for phase 2
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### `/gsd:plan-phase`
|
||||
### `/gsd-plan-phase`
|
||||
|
||||
Research, plan, and verify a phase.
|
||||
|
||||
@@ -153,14 +153,14 @@ Research, plan, and verify a phase.
|
||||
**Produces:** `{phase}-RESEARCH.md`, `{phase}-{N}-PLAN.md`, `{phase}-VALIDATION.md`
|
||||
|
||||
```bash
|
||||
/gsd:plan-phase 1 # Research + plan + verify phase 1
|
||||
/gsd:plan-phase 3 --skip-research # Plan without research (familiar domain)
|
||||
/gsd:plan-phase --auto # Non-interactive planning
|
||||
/gsd-plan-phase 1 # Research + plan + verify phase 1
|
||||
/gsd-plan-phase 3 --skip-research # Plan without research (familiar domain)
|
||||
/gsd-plan-phase --auto # Non-interactive planning
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### `/gsd:execute-phase`
|
||||
### `/gsd-execute-phase`
|
||||
|
||||
Execute all plans in a phase with wave-based parallelization, or run a specific wave.
|
||||
|
||||
@@ -173,13 +173,13 @@ Execute all plans in a phase with wave-based parallelization, or run a specific
|
||||
**Produces:** per-plan `{phase}-{N}-SUMMARY.md`, git commits, and `{phase}-VERIFICATION.md` when the phase is fully complete
|
||||
|
||||
```bash
|
||||
/gsd:execute-phase 1 # Execute phase 1
|
||||
/gsd:execute-phase 1 --wave 2 # Execute only Wave 2
|
||||
/gsd-execute-phase 1 # Execute phase 1
|
||||
/gsd-execute-phase 1 --wave 2 # Execute only Wave 2
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### `/gsd:verify-work`
|
||||
### `/gsd-verify-work`
|
||||
|
||||
User acceptance testing with auto-diagnosis.
|
||||
|
||||
@@ -191,31 +191,31 @@ User acceptance testing with auto-diagnosis.
|
||||
**Produces:** `{phase}-UAT.md`, fix plans if issues found
|
||||
|
||||
```bash
|
||||
/gsd:verify-work 1 # UAT for phase 1
|
||||
/gsd-verify-work 1 # UAT for phase 1
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### `/gsd:next`
|
||||
### `/gsd-next`
|
||||
|
||||
Automatically advance to the next logical workflow step. Reads project state and runs the appropriate command.
|
||||
|
||||
**Prerequisites:** `.planning/` directory exists
|
||||
**Behavior:**
|
||||
- No project → suggests `/gsd:new-project`
|
||||
- Phase needs discussion → runs `/gsd:discuss-phase`
|
||||
- Phase needs planning → runs `/gsd:plan-phase`
|
||||
- Phase needs execution → runs `/gsd:execute-phase`
|
||||
- Phase needs verification → runs `/gsd:verify-work`
|
||||
- All phases complete → suggests `/gsd:complete-milestone`
|
||||
- No project → suggests `/gsd-new-project`
|
||||
- Phase needs discussion → runs `/gsd-discuss-phase`
|
||||
- Phase needs planning → runs `/gsd-plan-phase`
|
||||
- Phase needs execution → runs `/gsd-execute-phase`
|
||||
- Phase needs verification → runs `/gsd-verify-work`
|
||||
- All phases complete → suggests `/gsd-complete-milestone`
|
||||
|
||||
```bash
|
||||
/gsd:next # Auto-detect and run next step
|
||||
/gsd-next # Auto-detect and run next step
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### `/gsd:session-report`
|
||||
### `/gsd-session-report`
|
||||
|
||||
Generate a session report with work summary, outcomes, and estimated resource usage.
|
||||
|
||||
@@ -223,7 +223,7 @@ Generate a session report with work summary, outcomes, and estimated resource us
|
||||
**Produces:** `.planning/reports/SESSION_REPORT.md`
|
||||
|
||||
```bash
|
||||
/gsd:session-report # Generate post-session summary
|
||||
/gsd-session-report # Generate post-session summary
|
||||
```
|
||||
|
||||
**Report includes:**
|
||||
@@ -235,7 +235,7 @@ Generate a session report with work summary, outcomes, and estimated resource us
|
||||
|
||||
---
|
||||
|
||||
### `/gsd:ship`
|
||||
### `/gsd-ship`
|
||||
|
||||
Create PR from completed phase work with auto-generated body.
|
||||
|
||||
@@ -244,12 +244,12 @@ Create PR from completed phase work with auto-generated body.
|
||||
| `N` | No | Phase number or milestone version (e.g., `4` or `v1.0`) |
|
||||
| `--draft` | No | Create as draft PR |
|
||||
|
||||
**Prerequisites:** Phase verified (`/gsd:verify-work` passed), `gh` CLI installed and authenticated
|
||||
**Prerequisites:** Phase verified (`/gsd-verify-work` passed), `gh` CLI installed and authenticated
|
||||
**Produces:** GitHub PR with rich body from planning artifacts, STATE.md updated
|
||||
|
||||
```bash
|
||||
/gsd:ship 4 # Ship phase 4
|
||||
/gsd:ship 4 --draft # Ship as draft PR
|
||||
/gsd-ship 4 # Ship phase 4
|
||||
/gsd-ship 4 --draft # Ship as draft PR
|
||||
```
|
||||
|
||||
**PR body includes:**
|
||||
@@ -261,7 +261,7 @@ Create PR from completed phase work with auto-generated body.
|
||||
|
||||
---
|
||||
|
||||
### `/gsd:ui-review`
|
||||
### `/gsd-ui-review`
|
||||
|
||||
Retroactive 6-pillar visual audit of implemented frontend.
|
||||
|
||||
@@ -273,13 +273,13 @@ Retroactive 6-pillar visual audit of implemented frontend.
|
||||
**Produces:** `{phase}-UI-REVIEW.md`, screenshots in `.planning/ui-reviews/`
|
||||
|
||||
```bash
|
||||
/gsd:ui-review # Audit current phase
|
||||
/gsd:ui-review 3 # Audit phase 3
|
||||
/gsd-ui-review # Audit current phase
|
||||
/gsd-ui-review 3 # Audit phase 3
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### `/gsd:audit-uat`
|
||||
### `/gsd-audit-uat`
|
||||
|
||||
Cross-phase audit of all outstanding UAT and verification items.
|
||||
|
||||
@@ -287,12 +287,12 @@ Cross-phase audit of all outstanding UAT and verification items.
|
||||
**Produces:** Categorized audit report with human test plan
|
||||
|
||||
```bash
|
||||
/gsd:audit-uat
|
||||
/gsd-audit-uat
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### `/gsd:audit-milestone`
|
||||
### `/gsd-audit-milestone`
|
||||
|
||||
Verify milestone met its definition of done.
|
||||
|
||||
@@ -300,12 +300,12 @@ Verify milestone met its definition of done.
|
||||
**Produces:** Audit report with gap analysis
|
||||
|
||||
```bash
|
||||
/gsd:audit-milestone
|
||||
/gsd-audit-milestone
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### `/gsd:complete-milestone`
|
||||
### `/gsd-complete-milestone`
|
||||
|
||||
Archive milestone, tag release.
|
||||
|
||||
@@ -313,12 +313,12 @@ Archive milestone, tag release.
|
||||
**Produces:** `MILESTONES.md` entry, git tag
|
||||
|
||||
```bash
|
||||
/gsd:complete-milestone
|
||||
/gsd-complete-milestone
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### `/gsd:milestone-summary`
|
||||
### `/gsd-milestone-summary`
|
||||
|
||||
Generate comprehensive project summary from milestone artifacts for team onboarding and review.
|
||||
|
||||
@@ -338,13 +338,13 @@ Generate comprehensive project summary from milestone artifacts for team onboard
|
||||
- Interactive Q&A offered after generation
|
||||
|
||||
```bash
|
||||
/gsd:milestone-summary # Summarize current milestone
|
||||
/gsd:milestone-summary v1.0 # Summarize specific milestone
|
||||
/gsd-milestone-summary # Summarize current milestone
|
||||
/gsd-milestone-summary v1.0 # Summarize specific milestone
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### `/gsd:new-milestone`
|
||||
### `/gsd-new-milestone`
|
||||
|
||||
Start next version cycle.
|
||||
|
||||
@@ -357,24 +357,24 @@ Start next version cycle.
|
||||
**Produces:** Updated `PROJECT.md`, new `REQUIREMENTS.md`, new `ROADMAP.md`
|
||||
|
||||
```bash
|
||||
/gsd:new-milestone # Interactive
|
||||
/gsd:new-milestone "v2.0 Mobile" # Named milestone
|
||||
/gsd:new-milestone --reset-phase-numbers "v2.0 Mobile" # Restart milestone numbering at 1
|
||||
/gsd-new-milestone # Interactive
|
||||
/gsd-new-milestone "v2.0 Mobile" # Named milestone
|
||||
/gsd-new-milestone --reset-phase-numbers "v2.0 Mobile" # Restart milestone numbering at 1
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Phase Management Commands
|
||||
|
||||
### `/gsd:add-phase`
|
||||
### `/gsd-add-phase`
|
||||
|
||||
Append new phase to roadmap.
|
||||
|
||||
```bash
|
||||
/gsd:add-phase # Interactive — describe the phase
|
||||
/gsd-add-phase # Interactive — describe the phase
|
||||
```
|
||||
|
||||
### `/gsd:insert-phase`
|
||||
### `/gsd-insert-phase`
|
||||
|
||||
Insert urgent work between phases using decimal numbering.
|
||||
|
||||
@@ -383,10 +383,10 @@ Insert urgent work between phases using decimal numbering.
|
||||
| `N` | No | Insert after this phase number |
|
||||
|
||||
```bash
|
||||
/gsd:insert-phase 3 # Insert between phase 3 and 4 → creates 3.1
|
||||
/gsd-insert-phase 3 # Insert between phase 3 and 4 → creates 3.1
|
||||
```
|
||||
|
||||
### `/gsd:remove-phase`
|
||||
### `/gsd-remove-phase`
|
||||
|
||||
Remove future phase and renumber subsequent phases.
|
||||
|
||||
@@ -395,10 +395,10 @@ Remove future phase and renumber subsequent phases.
|
||||
| `N` | No | Phase number to remove |
|
||||
|
||||
```bash
|
||||
/gsd:remove-phase 7 # Remove phase 7, renumber 8→7, 9→8, etc.
|
||||
/gsd-remove-phase 7 # Remove phase 7, renumber 8→7, 9→8, etc.
|
||||
```
|
||||
|
||||
### `/gsd:list-phase-assumptions`
|
||||
### `/gsd-list-phase-assumptions`
|
||||
|
||||
Preview Claude's intended approach before planning.
|
||||
|
||||
@@ -407,20 +407,20 @@ Preview Claude's intended approach before planning.
|
||||
| `N` | No | Phase number |
|
||||
|
||||
```bash
|
||||
/gsd:list-phase-assumptions 2 # See assumptions for phase 2
|
||||
/gsd-list-phase-assumptions 2 # See assumptions for phase 2
|
||||
```
|
||||
|
||||
### `/gsd:analyze-dependencies`
|
||||
### `/gsd-analyze-dependencies`
|
||||
|
||||
Analyze phase dependencies and suggest `Depends on` entries for ROADMAP.md before running `/gsd:manager`.
|
||||
Analyze phase dependencies and suggest `Depends on` entries for ROADMAP.md before running `/gsd-manager`.
|
||||
|
||||
**Prerequisites:** `.planning/ROADMAP.md` exists
|
||||
**Produces:** Dependency suggestion table; optionally updates `Depends on` fields in ROADMAP.md with confirmation
|
||||
|
||||
**Run this before `/gsd:manager`** when phases have empty `Depends on` fields and you want to avoid merge conflicts from unordered parallel execution.
|
||||
**Run this before `/gsd-manager`** when phases have empty `Depends on` fields and you want to avoid merge conflicts from unordered parallel execution.
|
||||
|
||||
```bash
|
||||
/gsd:analyze-dependencies # Analyze all phases and suggest dependencies
|
||||
/gsd-analyze-dependencies # Analyze all phases and suggest dependencies
|
||||
```
|
||||
|
||||
**Detection methods:**
|
||||
@@ -430,27 +430,27 @@ Analyze phase dependencies and suggest `Depends on` entries for ROADMAP.md befor
|
||||
|
||||
---
|
||||
|
||||
### `/gsd:plan-milestone-gaps`
|
||||
### `/gsd-plan-milestone-gaps`
|
||||
|
||||
Create phases to close gaps from milestone audit.
|
||||
|
||||
```bash
|
||||
/gsd:plan-milestone-gaps # Creates phases for each audit gap
|
||||
/gsd-plan-milestone-gaps # Creates phases for each audit gap
|
||||
```
|
||||
|
||||
### `/gsd:research-phase`
|
||||
### `/gsd-research-phase`
|
||||
|
||||
Deep ecosystem research only (standalone — usually use `/gsd:plan-phase` instead).
|
||||
Deep ecosystem research only (standalone — usually use `/gsd-plan-phase` instead).
|
||||
|
||||
| Argument | Required | Description |
|
||||
|----------|----------|-------------|
|
||||
| `N` | No | Phase number |
|
||||
|
||||
```bash
|
||||
/gsd:research-phase 4 # Research phase 4 domain
|
||||
/gsd-research-phase 4 # Research phase 4 domain
|
||||
```
|
||||
|
||||
### `/gsd:validate-phase`
|
||||
### `/gsd-validate-phase`
|
||||
|
||||
Retroactively audit and fill Nyquist validation gaps.
|
||||
|
||||
@@ -459,38 +459,38 @@ Retroactively audit and fill Nyquist validation gaps.
|
||||
| `N` | No | Phase number |
|
||||
|
||||
```bash
|
||||
/gsd:validate-phase 2 # Audit test coverage for phase 2
|
||||
/gsd-validate-phase 2 # Audit test coverage for phase 2
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Navigation Commands
|
||||
|
||||
### `/gsd:progress`
|
||||
### `/gsd-progress`
|
||||
|
||||
Show status and next steps.
|
||||
|
||||
```bash
|
||||
/gsd:progress # "Where am I? What's next?"
|
||||
/gsd-progress # "Where am I? What's next?"
|
||||
```
|
||||
|
||||
### `/gsd:resume-work`
|
||||
### `/gsd-resume-work`
|
||||
|
||||
Restore full context from last session.
|
||||
|
||||
```bash
|
||||
/gsd:resume-work # After context reset or new session
|
||||
/gsd-resume-work # After context reset or new session
|
||||
```
|
||||
|
||||
### `/gsd:pause-work`
|
||||
### `/gsd-pause-work`
|
||||
|
||||
Save context handoff when stopping mid-phase.
|
||||
|
||||
```bash
|
||||
/gsd:pause-work # Creates continue-here.md
|
||||
/gsd-pause-work # Creates continue-here.md
|
||||
```
|
||||
|
||||
### `/gsd:manager`
|
||||
### `/gsd-manager`
|
||||
|
||||
Interactive command center for managing multiple phases from one terminal.
|
||||
|
||||
@@ -502,24 +502,24 @@ Interactive command center for managing multiple phases from one terminal.
|
||||
- Designed for power users parallelizing work across phases from one terminal
|
||||
|
||||
```bash
|
||||
/gsd:manager # Open command center dashboard
|
||||
/gsd-manager # Open command center dashboard
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### `/gsd:help`
|
||||
### `/gsd-help`
|
||||
|
||||
Show all commands and usage guide.
|
||||
|
||||
```bash
|
||||
/gsd:help # Quick reference
|
||||
/gsd-help # Quick reference
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Utility Commands
|
||||
|
||||
### `/gsd:quick`
|
||||
### `/gsd-quick`
|
||||
|
||||
Execute ad-hoc task with GSD guarantees.
|
||||
|
||||
@@ -532,13 +532,13 @@ Execute ad-hoc task with GSD guarantees.
|
||||
Flags are composable.
|
||||
|
||||
```bash
|
||||
/gsd:quick # Basic quick task
|
||||
/gsd:quick --discuss --research # Discussion + research + planning
|
||||
/gsd:quick --full # With plan checking and verification
|
||||
/gsd:quick --discuss --research --full # All optional stages
|
||||
/gsd-quick # Basic quick task
|
||||
/gsd-quick --discuss --research # Discussion + research + planning
|
||||
/gsd-quick --full # With plan checking and verification
|
||||
/gsd-quick --discuss --research --full # All optional stages
|
||||
```
|
||||
|
||||
### `/gsd:autonomous`
|
||||
### `/gsd-autonomous`
|
||||
|
||||
Run all remaining phases autonomously.
|
||||
|
||||
@@ -547,19 +547,19 @@ Run all remaining phases autonomously.
|
||||
| `--from N` | Start from a specific phase number |
|
||||
|
||||
```bash
|
||||
/gsd:autonomous # Run all remaining phases
|
||||
/gsd:autonomous --from 3 # Start from phase 3
|
||||
/gsd-autonomous # Run all remaining phases
|
||||
/gsd-autonomous --from 3 # Start from phase 3
|
||||
```
|
||||
|
||||
### `/gsd:do`
|
||||
### `/gsd-do`
|
||||
|
||||
Route freeform text to the right GSD command.
|
||||
|
||||
```bash
|
||||
/gsd:do # Then describe what you want
|
||||
/gsd-do # Then describe what you want
|
||||
```
|
||||
|
||||
### `/gsd:note`
|
||||
### `/gsd-note`
|
||||
|
||||
Zero-friction idea capture — append, list, or promote notes to todos.
|
||||
|
||||
@@ -574,12 +574,12 @@ Zero-friction idea capture — append, list, or promote notes to todos.
|
||||
| `--global` | Use global scope for note operations |
|
||||
|
||||
```bash
|
||||
/gsd:note "Consider caching strategy for API responses"
|
||||
/gsd:note list
|
||||
/gsd:note promote 3
|
||||
/gsd-note "Consider caching strategy for API responses"
|
||||
/gsd-note list
|
||||
/gsd-note promote 3
|
||||
```
|
||||
|
||||
### `/gsd:debug`
|
||||
### `/gsd-debug`
|
||||
|
||||
Systematic debugging with persistent state.
|
||||
|
||||
@@ -588,10 +588,10 @@ Systematic debugging with persistent state.
|
||||
| `description` | No | Description of the bug |
|
||||
|
||||
```bash
|
||||
/gsd:debug "Login button not responding on mobile Safari"
|
||||
/gsd-debug "Login button not responding on mobile Safari"
|
||||
```
|
||||
|
||||
### `/gsd:add-todo`
|
||||
### `/gsd-add-todo`
|
||||
|
||||
Capture idea or task for later.
|
||||
|
||||
@@ -600,18 +600,18 @@ Capture idea or task for later.
|
||||
| `description` | No | Todo description |
|
||||
|
||||
```bash
|
||||
/gsd:add-todo "Consider adding dark mode support"
|
||||
/gsd-add-todo "Consider adding dark mode support"
|
||||
```
|
||||
|
||||
### `/gsd:check-todos`
|
||||
### `/gsd-check-todos`
|
||||
|
||||
List pending todos and select one to work on.
|
||||
|
||||
```bash
|
||||
/gsd:check-todos
|
||||
/gsd-check-todos
|
||||
```
|
||||
|
||||
### `/gsd:add-tests`
|
||||
### `/gsd-add-tests`
|
||||
|
||||
Generate tests for a completed phase.
|
||||
|
||||
@@ -620,18 +620,18 @@ Generate tests for a completed phase.
|
||||
| `N` | No | Phase number |
|
||||
|
||||
```bash
|
||||
/gsd:add-tests 2 # Generate tests for phase 2
|
||||
/gsd-add-tests 2 # Generate tests for phase 2
|
||||
```
|
||||
|
||||
### `/gsd:stats`
|
||||
### `/gsd-stats`
|
||||
|
||||
Display project statistics.
|
||||
|
||||
```bash
|
||||
/gsd:stats # Project metrics dashboard
|
||||
/gsd-stats # Project metrics dashboard
|
||||
```
|
||||
|
||||
### `/gsd:profile-user`
|
||||
### `/gsd-profile-user`
|
||||
|
||||
Generate a developer behavioral profile from Claude Code session analysis across 8 dimensions (communication style, decision patterns, debugging approach, UX preferences, vendor choices, frustration triggers, learning style, explanation depth). Produces artifacts that personalize Claude's responses.
|
||||
|
||||
@@ -642,16 +642,16 @@ Generate a developer behavioral profile from Claude Code session analysis across
|
||||
|
||||
**Generated artifacts:**
|
||||
- `USER-PROFILE.md` — Full behavioral profile
|
||||
- `/gsd:dev-preferences` command — Load preferences in any session
|
||||
- `/gsd-dev-preferences` command — Load preferences in any session
|
||||
- `CLAUDE.md` profile section — Auto-discovered by Claude Code
|
||||
|
||||
```bash
|
||||
/gsd:profile-user # Analyze sessions and build profile
|
||||
/gsd:profile-user --questionnaire # Interactive questionnaire fallback
|
||||
/gsd:profile-user --refresh # Re-generate from fresh analysis
|
||||
/gsd-profile-user # Analyze sessions and build profile
|
||||
/gsd-profile-user --questionnaire # Interactive questionnaire fallback
|
||||
/gsd-profile-user --refresh # Re-generate from fresh analysis
|
||||
```
|
||||
|
||||
### `/gsd:health`
|
||||
### `/gsd-health`
|
||||
|
||||
Validate `.planning/` directory integrity.
|
||||
|
||||
@@ -660,23 +660,23 @@ Validate `.planning/` directory integrity.
|
||||
| `--repair` | Auto-fix recoverable issues |
|
||||
|
||||
```bash
|
||||
/gsd:health # Check integrity
|
||||
/gsd:health --repair # Check and fix
|
||||
/gsd-health # Check integrity
|
||||
/gsd-health --repair # Check and fix
|
||||
```
|
||||
|
||||
### `/gsd:cleanup`
|
||||
### `/gsd-cleanup`
|
||||
|
||||
Archive accumulated phase directories from completed milestones.
|
||||
|
||||
```bash
|
||||
/gsd:cleanup
|
||||
/gsd-cleanup
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Diagnostics Commands
|
||||
|
||||
### `/gsd:forensics`
|
||||
### `/gsd-forensics`
|
||||
|
||||
Post-mortem investigation of failed or stuck GSD workflows.
|
||||
|
||||
@@ -696,15 +696,15 @@ Post-mortem investigation of failed or stuck GSD workflows.
|
||||
- GitHub issue creation offered if actionable findings exist
|
||||
|
||||
```bash
|
||||
/gsd:forensics # Interactive — prompted for problem
|
||||
/gsd:forensics "Phase 3 execution stalled" # With problem description
|
||||
/gsd-forensics # Interactive — prompted for problem
|
||||
/gsd-forensics "Phase 3 execution stalled" # With problem description
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Workstream Management
|
||||
|
||||
### `/gsd:workstreams`
|
||||
### `/gsd-workstreams`
|
||||
|
||||
Manage parallel workstreams for concurrent work on different milestone areas.
|
||||
|
||||
@@ -724,28 +724,28 @@ Manage parallel workstreams for concurrent work on different milestone areas.
|
||||
**Produces:** Workstream directories under `.planning/`, state tracking per workstream
|
||||
|
||||
```bash
|
||||
/gsd:workstreams # List all workstreams
|
||||
/gsd:workstreams create backend-api # Create new workstream
|
||||
/gsd:workstreams switch backend-api # Set active workstream
|
||||
/gsd:workstreams status backend-api # Detailed status
|
||||
/gsd:workstreams progress # Cross-workstream progress overview
|
||||
/gsd:workstreams complete backend-api # Archive completed workstream
|
||||
/gsd:workstreams resume backend-api # Resume work in workstream
|
||||
/gsd-workstreams # List all workstreams
|
||||
/gsd-workstreams create backend-api # Create new workstream
|
||||
/gsd-workstreams switch backend-api # Set active workstream
|
||||
/gsd-workstreams status backend-api # Detailed status
|
||||
/gsd-workstreams progress # Cross-workstream progress overview
|
||||
/gsd-workstreams complete backend-api # Archive completed workstream
|
||||
/gsd-workstreams resume backend-api # Resume work in workstream
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Configuration Commands
|
||||
|
||||
### `/gsd:settings`
|
||||
### `/gsd-settings`
|
||||
|
||||
Interactive configuration of workflow toggles and model profile.
|
||||
|
||||
```bash
|
||||
/gsd:settings # Interactive config
|
||||
/gsd-settings # Interactive config
|
||||
```
|
||||
|
||||
### `/gsd:set-profile`
|
||||
### `/gsd-set-profile`
|
||||
|
||||
Quick profile switch.
|
||||
|
||||
@@ -754,15 +754,15 @@ Quick profile switch.
|
||||
| `profile` | **Yes** | `quality`, `balanced`, `budget`, or `inherit` |
|
||||
|
||||
```bash
|
||||
/gsd:set-profile budget # Switch to budget profile
|
||||
/gsd:set-profile quality # Switch to quality profile
|
||||
/gsd-set-profile budget # Switch to budget profile
|
||||
/gsd-set-profile quality # Switch to quality profile
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Brownfield Commands
|
||||
|
||||
### `/gsd:map-codebase`
|
||||
### `/gsd-map-codebase`
|
||||
|
||||
Analyze existing codebase with parallel mapper agents.
|
||||
|
||||
@@ -771,35 +771,35 @@ Analyze existing codebase with parallel mapper agents.
|
||||
| `area` | No | Scope mapping to a specific area |
|
||||
|
||||
```bash
|
||||
/gsd:map-codebase # Full codebase analysis
|
||||
/gsd:map-codebase auth # Focus on auth area
|
||||
/gsd-map-codebase # Full codebase analysis
|
||||
/gsd-map-codebase auth # Focus on auth area
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Update Commands
|
||||
|
||||
### `/gsd:update`
|
||||
### `/gsd-update`
|
||||
|
||||
Update GSD with changelog preview.
|
||||
|
||||
```bash
|
||||
/gsd:update # Check for updates and install
|
||||
/gsd-update # Check for updates and install
|
||||
```
|
||||
|
||||
### `/gsd:reapply-patches`
|
||||
### `/gsd-reapply-patches`
|
||||
|
||||
Restore local modifications after a GSD update.
|
||||
|
||||
```bash
|
||||
/gsd:reapply-patches # Merge back local changes
|
||||
/gsd-reapply-patches # Merge back local changes
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Fast & Inline Commands
|
||||
|
||||
### `/gsd:fast`
|
||||
### `/gsd-fast`
|
||||
|
||||
Execute a trivial task inline — no subagents, no planning overhead. For typo fixes, config changes, small refactors, forgotten commits.
|
||||
|
||||
@@ -807,18 +807,18 @@ Execute a trivial task inline — no subagents, no planning overhead. For typo f
|
||||
|----------|----------|-------------|
|
||||
| `task description` | No | What to do (prompted if omitted) |
|
||||
|
||||
**Not a replacement for `/gsd:quick`** — use `/gsd:quick` for anything needing research, multi-step planning, or verification.
|
||||
**Not a replacement for `/gsd-quick`** — use `/gsd-quick` for anything needing research, multi-step planning, or verification.
|
||||
|
||||
```bash
|
||||
/gsd:fast "fix typo in README"
|
||||
/gsd:fast "add .env to gitignore"
|
||||
/gsd-fast "fix typo in README"
|
||||
/gsd-fast "add .env to gitignore"
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Code Quality Commands
|
||||
|
||||
### `/gsd:review`
|
||||
### `/gsd-review`
|
||||
|
||||
Cross-AI peer review of phase plans from external AI CLIs.
|
||||
|
||||
@@ -834,16 +834,16 @@ Cross-AI peer review of phase plans from external AI CLIs.
|
||||
| `--coderabbit` | Include CodeRabbit review |
|
||||
| `--all` | Include all available CLIs |
|
||||
|
||||
**Produces:** `{phase}-REVIEWS.md` — consumable by `/gsd:plan-phase --reviews`
|
||||
**Produces:** `{phase}-REVIEWS.md` — consumable by `/gsd-plan-phase --reviews`
|
||||
|
||||
```bash
|
||||
/gsd:review --phase 3 --all
|
||||
/gsd:review --phase 2 --gemini
|
||||
/gsd-review --phase 3 --all
|
||||
/gsd-review --phase 2 --gemini
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### `/gsd:pr-branch`
|
||||
### `/gsd-pr-branch`
|
||||
|
||||
Create a clean PR branch by filtering out `.planning/` commits.
|
||||
|
||||
@@ -854,13 +854,13 @@ Create a clean PR branch by filtering out `.planning/` commits.
|
||||
**Purpose:** Reviewers see only code changes, not GSD planning artifacts.
|
||||
|
||||
```bash
|
||||
/gsd:pr-branch # Filter against main
|
||||
/gsd:pr-branch develop # Filter against develop
|
||||
/gsd-pr-branch # Filter against main
|
||||
/gsd-pr-branch develop # Filter against develop
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### `/gsd:audit-uat`
|
||||
### `/gsd-audit-uat`
|
||||
|
||||
Cross-phase audit of all outstanding UAT and verification items.
|
||||
|
||||
@@ -868,14 +868,14 @@ Cross-phase audit of all outstanding UAT and verification items.
|
||||
**Produces:** Categorized audit report with human test plan
|
||||
|
||||
```bash
|
||||
/gsd:audit-uat
|
||||
/gsd-audit-uat
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Backlog & Thread Commands
|
||||
|
||||
### `/gsd:add-backlog`
|
||||
### `/gsd-add-backlog`
|
||||
|
||||
Add an idea to the backlog parking lot using 999.x numbering.
|
||||
|
||||
@@ -883,28 +883,28 @@ Add an idea to the backlog parking lot using 999.x numbering.
|
||||
|----------|----------|-------------|
|
||||
| `description` | **Yes** | Backlog item description |
|
||||
|
||||
**999.x numbering** keeps backlog items outside the active phase sequence. Phase directories are created immediately so `/gsd:discuss-phase` and `/gsd:plan-phase` work on them.
|
||||
**999.x numbering** keeps backlog items outside the active phase sequence. Phase directories are created immediately so `/gsd-discuss-phase` and `/gsd-plan-phase` work on them.
|
||||
|
||||
```bash
|
||||
/gsd:add-backlog "GraphQL API layer"
|
||||
/gsd:add-backlog "Mobile responsive redesign"
|
||||
/gsd-add-backlog "GraphQL API layer"
|
||||
/gsd-add-backlog "Mobile responsive redesign"
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### `/gsd:review-backlog`
|
||||
### `/gsd-review-backlog`
|
||||
|
||||
Review and promote backlog items to active milestone.
|
||||
|
||||
**Actions per item:** Promote (move to active sequence), Keep (leave in backlog), Remove (delete).
|
||||
|
||||
```bash
|
||||
/gsd:review-backlog
|
||||
/gsd-review-backlog
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### `/gsd:plant-seed`
|
||||
### `/gsd-plant-seed`
|
||||
|
||||
Capture a forward-looking idea with trigger conditions — surfaces automatically at the right milestone.
|
||||
|
||||
@@ -915,15 +915,15 @@ Capture a forward-looking idea with trigger conditions — surfaces automaticall
|
||||
Seeds solve context rot: instead of a one-liner in Deferred that nobody reads, a seed preserves the full WHY, WHEN to surface, and breadcrumbs to details.
|
||||
|
||||
**Produces:** `.planning/seeds/SEED-NNN-slug.md`
|
||||
**Consumed by:** `/gsd:new-milestone` (scans seeds and presents matches)
|
||||
**Consumed by:** `/gsd-new-milestone` (scans seeds and presents matches)
|
||||
|
||||
```bash
|
||||
/gsd:plant-seed "Add real-time collaboration when WebSocket infra is in place"
|
||||
/gsd-plant-seed "Add real-time collaboration when WebSocket infra is in place"
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### `/gsd:thread`
|
||||
### `/gsd-thread`
|
||||
|
||||
Manage persistent context threads for cross-session work.
|
||||
|
||||
@@ -933,22 +933,22 @@ Manage persistent context threads for cross-session work.
|
||||
| `name` | — | Resume existing thread by name |
|
||||
| `description` | — | Create new thread |
|
||||
|
||||
Threads are lightweight cross-session knowledge stores for work that spans multiple sessions but doesn't belong to any specific phase. Lighter weight than `/gsd:pause-work`.
|
||||
Threads are lightweight cross-session knowledge stores for work that spans multiple sessions but doesn't belong to any specific phase. Lighter weight than `/gsd-pause-work`.
|
||||
|
||||
```bash
|
||||
/gsd:thread # List all threads
|
||||
/gsd:thread fix-deploy-key-auth # Resume thread
|
||||
/gsd:thread "Investigate TCP timeout in pasta service" # Create new
|
||||
/gsd-thread # List all threads
|
||||
/gsd-thread fix-deploy-key-auth # Resume thread
|
||||
/gsd-thread "Investigate TCP timeout in pasta service" # Create new
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Community Commands
|
||||
|
||||
### `/gsd:join-discord`
|
||||
### `/gsd-join-discord`
|
||||
|
||||
Open Discord community invite.
|
||||
|
||||
```bash
|
||||
/gsd:join-discord
|
||||
/gsd-join-discord
|
||||
```
|
||||
|
||||
Reference in New Issue
Block a user