diff --git a/.planning/REQUIREMENTS.md b/.planning/REQUIREMENTS.md index 87472536e..04ac1993c 100644 --- a/.planning/REQUIREMENTS.md +++ b/.planning/REQUIREMENTS.md @@ -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 | diff --git a/.planning/ROADMAP.md b/.planning/ROADMAP.md index ad2221a44..d5e5229d0 100644 --- a/.planning/ROADMAP.md +++ b/.planning/ROADMAP.md @@ -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 | - | diff --git a/.planning/STATE.md b/.planning/STATE.md index 2d00e7edc..54463e0b5 100644 --- a/.planning/STATE.md +++ b/.planning/STATE.md @@ -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 diff --git a/docs/commands.html b/docs/commands.html new file mode 100644 index 000000000..abb598334 --- /dev/null +++ b/docs/commands.html @@ -0,0 +1,229 @@ + + +
+ + +Quick reference for all Get Shit Done slash commands
+ +/gsd:new-project
+ Initialize a new project with deep context gathering and PROJECT.md
+ /gsd:new-milestone
+ Start a new milestone cycle — update PROJECT.md and route to requirements
+ /gsd:map-codebase
+ Analyze codebase with parallel mapper agents to produce .planning/codebase/ documents
+ /gsd:discuss-phase
+ Gather phase context through adaptive questioning before planning
+ /gsd:list-phase-assumptions
+ Surface Claude's assumptions about a phase approach before planning
+ /gsd:research-phase
+ Research how to implement a phase (standalone - usually use /gsd:plan-phase instead)
+ /gsd:plan-phase
+ Create detailed execution plan for a phase (PLAN.md) with verification loop
+ /gsd:add-phase
+ Add phase to end of current milestone in roadmap
+ /gsd:insert-phase
+ Insert urgent work as decimal phase (e.g., 72.1) between existing phases
+ /gsd:remove-phase
+ Remove a future phase from roadmap and renumber subsequent phases
+ /gsd:execute-phase
+ Execute all plans in a phase with wave-based parallelization
+ /gsd:quick
+ Execute a quick task with GSD guarantees (atomic commits, state tracking) but skip optional agents
+ /gsd:debug
+ Systematic debugging with persistent state across context resets
+ /gsd:progress
+ Check project progress, show context, and route to next action (execute or plan)
+ /gsd:verify-work
+ Validate built features through conversational UAT
+ /gsd:audit-milestone
+ Audit milestone completion against original intent before archiving
+ /gsd:plan-milestone-gaps
+ Create phases to close all gaps identified by milestone audit
+ /gsd:complete-milestone
+ Archive completed milestone and prepare for next version
+ /gsd:add-todo
+ Capture idea or task as todo from current conversation context
+ /gsd:check-todos
+ List pending todos and select one to work on
+ /gsd:pause-work
+ Create context handoff when pausing work mid-phase
+ /gsd:resume-work
+ Resume work from previous session with full context restoration
+ /gsd:help
+ Show available GSD commands and usage guide
+ /gsd:update
+ Update GSD to latest version with changelog display
+ /gsd:whats-new
+ See what's new in GSD since your installed version
+