golem15/msd-core
3
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat(quick-001): create GSD commands HTML reference page

Browse Source 
- Lists all 25 GSD commands with descriptions
- Organized into logical groups (Setup, Planning, Execution, etc.)
- Mobile-friendly responsive design
- Single-file with inline CSS, no dependencies
This commit is contained in:
Lex Christopherson
2026-01-19 15:42:29 -06:00
parent 942e65916d
commit deec75c8af
4 changed files with 280 additions and 62 deletions
Download Patch File Download Diff File Expand all files Collapse all files

48
.planning/REQUIREMENTS.md
View File

@@ -7,24 +7,24 @@
### Command
- [ ] **CMD-01**: `/gsd:quick "description"` parses description from arguments
- [ ] **CMD-02**: Command errors if .planning/ROADMAP.md doesn't exist
- [ ] **CMD-03**: Command calculates next decimal phase from current phase in STATE.md
- [ ] **CMD-04**: Command creates phase directory `.planning/phases/{decimal}-{slug}/`
- [ ] **CMD-05**: Command inserts decimal phase entry in ROADMAP.md
- [x] **CMD-01**: `/gsd:quick "description"` parses description from arguments
- [x] **CMD-02**: Command errors if .planning/ROADMAP.md doesn't exist
- [x] **CMD-03**: Command calculates next decimal phase from current phase in STATE.md
- [x] **CMD-04**: Command creates phase directory `.planning/phases/{decimal}-{slug}/`
- [x] **CMD-05**: Command inserts decimal phase entry in ROADMAP.md
### Execution
- [ ] **EXEC-01**: Command spawns gsd-planner (no researcher, no checker)
- [ ] **EXEC-02**: Command spawns gsd-executor for each plan created
- [ ] **EXEC-03**: Multiple plans execute in parallel waves (same as execute-phase)
- [ ] **EXEC-04**: Executor commits only files it edits/creates
- [x] **EXEC-01**: Command spawns gsd-planner (no researcher, no checker)
- [x] **EXEC-02**: Command spawns gsd-executor for each plan created
- [x] **EXEC-03**: Multiple plans execute in parallel waves (same as execute-phase)
- [x] **EXEC-04**: Executor commits only files it edits/creates
### State
- [ ] **STATE-01**: STATE.md "Last activity" updated after completion
- [ ] **STATE-02**: STATE.md "Quick Tasks Completed" table created/updated
- [ ] **STATE-03**: ROADMAP.md decimal phase marked complete with date
- [x] **STATE-01**: STATE.md "Last activity" updated after completion
- [x] **STATE-02**: STATE.md "Quick Tasks Completed" table created/updated
- [x] **STATE-03**: ROADMAP.md decimal phase marked complete with date
### Resume
@@ -59,18 +59,18 @@
| Requirement | Phase | Status |
|-------------|-------|--------|
| CMD-01 | Phase 1 | Pending |
| CMD-02 | Phase 1 | Pending |
| CMD-03 | Phase 1 | Pending |
| CMD-04 | Phase 1 | Pending |
| CMD-05 | Phase 1 | Pending |
| EXEC-01 | Phase 1 | Pending |
| EXEC-02 | Phase 1 | Pending |
| EXEC-03 | Phase 1 | Pending |
| EXEC-04 | Phase 1 | Pending |
| STATE-01 | Phase 1 | Pending |
| STATE-02 | Phase 1 | Pending |
| STATE-03 | Phase 1 | Pending |
| CMD-01 | Phase 1 | Complete |
| CMD-02 | Phase 1 | Complete |
| CMD-03 | Phase 1 | Complete |
| CMD-04 | Phase 1 | Complete |
| CMD-05 | Phase 1 | Complete |
| EXEC-01 | Phase 1 | Complete |
| EXEC-02 | Phase 1 | Complete |
| EXEC-03 | Phase 1 | Complete |
| EXEC-04 | Phase 1 | Complete |
| STATE-01 | Phase 1 | Complete |
| STATE-02 | Phase 1 | Complete |
| STATE-03 | Phase 1 | Complete |
| RESUME-01 | Phase 2 | Pending |
| RESUME-02 | Phase 2 | Pending |
| DOCS-01 | Phase 3 | Pending |

34
.planning/ROADMAP.md
View File

@@ -10,9 +10,8 @@ Quick mode adds a fast-path command (`/gsd:quick`) that executes small tasks wit
- Integer phases (1, 2, 3): Planned milestone work
- Decimal phases (2.1, 2.2): Urgent insertions (marked with INSERTED)
- [ ] **Phase 1: Core Command** - Complete `/gsd:quick` command end-to-end
- [ ] **Phase 2: Resume Integration** - Update `/gsd:resume-work` for decimal phases
- [ ] **Phase 3: Documentation** - Update help.md, README.md, and GSD-STYLE.md
- [x] **Phase 1: Core Command** - Complete `/gsd:quick` command end-to-end
- [ ] **Phase 2: Documentation** - Update help.md, README.md, and GSD-STYLE.md
## Phase Details
@@ -23,24 +22,12 @@ Quick mode adds a fast-path command (`/gsd:quick`) that executes small tasks wit
**Plans:** 2 plans
Plans:
- [ ] 01-01-PLAN.md — Quick command file with pre-flight validation and directory setup
- [ ] 01-02-PLAN.md — Quick orchestration (planner spawn, executor spawn, state update)
- [x] 01-01-PLAN.md — Quick command file with pre-flight validation and directory setup
- [x] 01-02-PLAN.md — Quick orchestration (planner spawn, executor spawn, state update)
### Phase 2: Resume Integration
**Goal**: User can resume failed quick tasks using existing `/gsd:resume-work`
**Depends on**: Phase 1
**Requirements**: RESUME-01, RESUME-02
**Success Criteria** (what must be TRUE):
1. `/gsd:resume-work` correctly parses decimal phase numbers (3.1, 3.2)
2. `/gsd:resume-work` finds and resumes decimal phase directories
**Plans**: TBD
Plans:
- [ ] 02-01: TBD
### Phase 3: Documentation
### Phase 2: Documentation
**Goal**: Quick mode is documented in all relevant locations
**Depends on**: Phase 2
**Depends on**: Phase 1
**Requirements**: DOCS-01, DOCS-02, DOCS-03
**Success Criteria** (what must be TRUE):
1. help.md lists `/gsd:quick` with usage and description
@@ -49,15 +36,14 @@ Plans:
**Plans**: TBD
Plans:
- [ ] 03-01: TBD
- [ ] 02-01: TBD
## Progress
**Execution Order:**
Phases execute in numeric order: 1 -> 2 -> 3
Phases execute in numeric order: 1 -> 2
| Phase | Plans Complete | Status | Completed |
|-------|----------------|--------|-----------|
| 1. Core Command | 0/2 | Ready to execute | - |
| 2. Resume Integration | 0/? | Not started | - |
| 3. Documentation | 0/? | Not started | - |
| 1. Core Command | 2/2 | Complete | 2026-01-19 |
| 2. Documentation | 0/? | Not started | - |

31
.planning/STATE.md
View File

@@ -9,29 +9,29 @@ See: .planning/PROJECT.md (updated 2025-01-19)
## Current Position
Phase: 1 of 3 (Core Command)
Plan: 0 of ? in current phase
Status: Ready to plan
Last activity: 2025-01-19 - Roadmap created
Phase: 1 of 2 (Core Command)
Plan: 2 of 2 in current phase
Status: Phase complete
Last activity: 2026-01-19 - Completed 01-02-PLAN.md
Progress: [----------] 0%
Progress: [#####-----] 50%
## Performance Metrics
**Velocity:**
- Total plans completed: 0
- Average duration: -
- Total execution time: 0 hours
- Total plans completed: 2
- Average duration: 2 min
- Total execution time: 4 min
**By Phase:**
| Phase | Plans | Total | Avg/Plan |
|-------|-------|-------|----------|
| - | - | - | - |
| 1. Core Command | 2/2 | 4 min | 2 min |
**Recent Trend:**
- Last 5 plans: -
- Trend: -
- Last 5 plans: 01-01 (1 min), 01-02 (3 min)
- Trend: Stable
*Updated after each plan completion*
@@ -42,7 +42,10 @@ Progress: [----------] 0%
Decisions are logged in PROJECT.md Key Decisions table.
Recent decisions affecting current work:
- None yet
- Quick task directory structure: `.planning/quick/NNN-slug/` (01-01)
- Quick task validation: ROADMAP.md only, no phase status check (01-01)
- Orchestration inline in command file, no separate workflow (01-02)
- STATE.md Quick Tasks table created on first quick task (01-02)
### Pending Todos
@@ -54,6 +57,6 @@ None yet.
## Session Continuity
Last session: 2025-01-19
Stopped at: Roadmap creation complete
Last session: 2026-01-19
Stopped at: Completed 01-02-PLAN.md (Phase 1 complete)
Resume file: None

229
docs/commands.html Normal file
View File

@@ -0,0 +1,229 @@
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>GSD Commands</title>
<style>
* {
box-sizing: border-box;
}
body {
font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif;
line-height: 1.6;
max-width: 900px;
margin: 0 auto;
padding: 2rem 1rem;
background: #fafafa;
color: #333;
}
h1 {
font-size: 2rem;
margin-bottom: 0.5rem;
color: #111;
}
.subtitle {
color: #666;
margin-bottom: 2rem;
font-size: 1.1rem;
}
h2 {
font-size: 1.25rem;
margin-top: 2rem;
margin-bottom: 1rem;
padding-bottom: 0.5rem;
border-bottom: 2px solid #e0e0e0;
color: #222;
}
.command-list {
list-style: none;
padding: 0;
margin: 0;
}
.command-item {
display: flex;
flex-wrap: wrap;
gap: 0.5rem 1rem;
padding: 0.75rem 0;
border-bottom: 1px solid #eee;
align-items: baseline;
}
.command-item:last-child {
border-bottom: none;
}
.command-name {
font-family: "SF Mono", Monaco, "Cascadia Code", "Roboto Mono", Consolas, monospace;
font-size: 0.9rem;
background: #e8f4fd;
color: #0066cc;
padding: 0.2rem 0.5rem;
border-radius: 4px;
white-space: nowrap;
font-weight: 500;
}
.command-desc {
color: #555;
flex: 1;
min-width: 200px;
}
footer {
margin-top: 3rem;
padding-top: 1rem;
border-top: 1px solid #ddd;
color: #888;
font-size: 0.85rem;
}
@media (max-width: 600px) {
body {
padding: 1rem;
}
h1 {
font-size: 1.5rem;
}
.command-item {
flex-direction: column;
gap: 0.25rem;
}
.command-name {
align-self: flex-start;
}
}
</style>
</head>
<body>
<h1>GSD Commands</h1>
<p class="subtitle">Quick reference for all Get Shit Done slash commands</p>
<h2>Project Setup</h2>
<ul class="command-list">
<li class="command-item">
<code class="command-name">/gsd:new-project</code>
<span class="command-desc">Initialize a new project with deep context gathering and PROJECT.md</span>
</li>
<li class="command-item">
<code class="command-name">/gsd:new-milestone</code>
<span class="command-desc">Start a new milestone cycle — update PROJECT.md and route to requirements</span>
</li>
<li class="command-item">
<code class="command-name">/gsd:map-codebase</code>
<span class="command-desc">Analyze codebase with parallel mapper agents to produce .planning/codebase/ documents</span>
</li>
</ul>
<h2>Planning</h2>
<ul class="command-list">
<li class="command-item">
<code class="command-name">/gsd:discuss-phase</code>
<span class="command-desc">Gather phase context through adaptive questioning before planning</span>
</li>
<li class="command-item">
<code class="command-name">/gsd:list-phase-assumptions</code>
<span class="command-desc">Surface Claude's assumptions about a phase approach before planning</span>
</li>
<li class="command-item">
<code class="command-name">/gsd:research-phase</code>
<span class="command-desc">Research how to implement a phase (standalone - usually use /gsd:plan-phase instead)</span>
</li>
<li class="command-item">
<code class="command-name">/gsd:plan-phase</code>
<span class="command-desc">Create detailed execution plan for a phase (PLAN.md) with verification loop</span>
</li>
<li class="command-item">
<code class="command-name">/gsd:add-phase</code>
<span class="command-desc">Add phase to end of current milestone in roadmap</span>
</li>
<li class="command-item">
<code class="command-name">/gsd:insert-phase</code>
<span class="command-desc">Insert urgent work as decimal phase (e.g., 72.1) between existing phases</span>
</li>
<li class="command-item">
<code class="command-name">/gsd:remove-phase</code>
<span class="command-desc">Remove a future phase from roadmap and renumber subsequent phases</span>
</li>
</ul>
<h2>Execution</h2>
<ul class="command-list">
<li class="command-item">
<code class="command-name">/gsd:execute-phase</code>
<span class="command-desc">Execute all plans in a phase with wave-based parallelization</span>
</li>
<li class="command-item">
<code class="command-name">/gsd:quick</code>
<span class="command-desc">Execute a quick task with GSD guarantees (atomic commits, state tracking) but skip optional agents</span>
</li>
<li class="command-item">
<code class="command-name">/gsd:debug</code>
<span class="command-desc">Systematic debugging with persistent state across context resets</span>
</li>
</ul>
<h2>Progress & Status</h2>
<ul class="command-list">
<li class="command-item">
<code class="command-name">/gsd:progress</code>
<span class="command-desc">Check project progress, show context, and route to next action (execute or plan)</span>
</li>
<li class="command-item">
<code class="command-name">/gsd:verify-work</code>
<span class="command-desc">Validate built features through conversational UAT</span>
</li>
<li class="command-item">
<code class="command-name">/gsd:audit-milestone</code>
<span class="command-desc">Audit milestone completion against original intent before archiving</span>
</li>
<li class="command-item">
<code class="command-name">/gsd:plan-milestone-gaps</code>
<span class="command-desc">Create phases to close all gaps identified by milestone audit</span>
</li>
<li class="command-item">
<code class="command-name">/gsd:complete-milestone</code>
<span class="command-desc">Archive completed milestone and prepare for next version</span>
</li>
</ul>
<h2>Task Management</h2>
<ul class="command-list">
<li class="command-item">
<code class="command-name">/gsd:add-todo</code>
<span class="command-desc">Capture idea or task as todo from current conversation context</span>
</li>
<li class="command-item">
<code class="command-name">/gsd:check-todos</code>
<span class="command-desc">List pending todos and select one to work on</span>
</li>
</ul>
<h2>Session Management</h2>
<ul class="command-list">
<li class="command-item">
<code class="command-name">/gsd:pause-work</code>
<span class="command-desc">Create context handoff when pausing work mid-phase</span>
</li>
<li class="command-item">
<code class="command-name">/gsd:resume-work</code>
<span class="command-desc">Resume work from previous session with full context restoration</span>
</li>
</ul>
<h2>Utilities</h2>
<ul class="command-list">
<li class="command-item">
<code class="command-name">/gsd:help</code>
<span class="command-desc">Show available GSD commands and usage guide</span>
</li>
<li class="command-item">
<code class="command-name">/gsd:update</code>
<span class="command-desc">Update GSD to latest version with changelog display</span>
</li>
<li class="command-item">
<code class="command-name">/gsd:whats-new</code>
<span class="command-desc">See what's new in GSD since your installed version</span>
</li>
</ul>
<footer>
<p>GSD (Get Shit Done) — <a href="https://www.npmjs.com/package/get-shit-done-cc">get-shit-done-cc</a></p>
</footer>
</body>
</html>