diff --git a/.planning/MILESTONES.md b/.planning/MILESTONES.md new file mode 100644 index 000000000..e9b1fd2d1 --- /dev/null +++ b/.planning/MILESTONES.md @@ -0,0 +1,28 @@ +# Project Milestones: GSD + +## v1.8.0 Quick Mode (Shipped: 2026-01-19) + +**Delivered:** Fast-path command (`/gsd:quick`) for executing small tasks with full GSD guarantees but 50-70% fewer tokens. + +**Phases completed:** 1-2 (3 plans total) + +**Key accomplishments:** + +- Created `/gsd:quick` command with interactive prompting and directory setup +- Implemented gsd-planner and gsd-executor spawning for quick mode +- Added STATE.md Quick Tasks Completed table integration +- Documented quick mode in help.md, README.md, and GSD-STYLE.md +- Established quick task directory structure (`.planning/quick/NNN-slug/`) + +**Stats:** + +- 34 files created/modified +- +1,129/-379 lines +- 2 phases, 3 plans, 2 quick tasks +- Same-day completion (2026-01-19) + +**Git range:** `2b36394` → `7692ebd` (1.8.0) + +**What's next:** Codebase Intelligence System + +--- diff --git a/.planning/PROJECT.md b/.planning/PROJECT.md index 52094599d..79ad951c6 100644 --- a/.planning/PROJECT.md +++ b/.planning/PROJECT.md @@ -2,7 +2,7 @@ ## What This Is -A fast-path command (`/gsd:quick`) for GSD that executes small tasks with the same guarantees (atomic commits, STATE.md tracking, ROADMAP.md integration) but skips optional verification agents. Reduces agent spawns from 5-8 to 2 (planner + executor) for tasks where the user already knows what to do. +A fast-path command (`/gsd:quick`) for GSD that executes small tasks with the same guarantees (atomic commits, STATE.md tracking) but skips optional verification agents. Reduces agent spawns from 5-8 to 2 (planner + executor) for tasks where the user already knows what to do. ## Core Value @@ -12,24 +12,20 @@ Same guarantees, 50-70% fewer tokens for simple tasks. ### Validated -(None yet — ship to validate) +- ✓ `/gsd:quick "description"` command executes end-to-end — v1.8.0 +- ✓ Spawns gsd-planner (unchanged, just skips researcher/checker) — v1.8.0 +- ✓ Spawns gsd-executor for each plan — v1.8.0 +- ✓ Commits only files it edits/creates (not entire working dir) — v1.8.0 +- ✓ Updates STATE.md with "Quick Tasks Completed" table — v1.8.0 +- ✓ Updates STATE.md "Last activity" line — v1.8.0 +- ✓ Errors if no ROADMAP.md exists — v1.8.0 +- ✓ help.md updated with quick command — v1.8.0 +- ✓ README.md updated with quick mode section — v1.8.0 +- ✓ GSD-STYLE.md updated with quick mode patterns — v1.8.0 ### Active -- [ ] `/gsd:quick "description"` command executes end-to-end -- [ ] Creates decimal phase (3.1, 3.2) in ROADMAP.md -- [ ] Spawns gsd-planner (unchanged, just skips researcher/checker) -- [ ] Spawns gsd-executor for each plan -- [ ] Handles multiple plans with wave-based parallel execution -- [ ] Commits only files it edits/creates (not entire working dir) -- [ ] Updates STATE.md with "Quick Tasks Completed" table -- [ ] Updates STATE.md "Last activity" line -- [ ] Marks decimal phase complete in ROADMAP.md -- [ ] Errors if no ROADMAP.md exists - [ ] `/gsd:resume-work` handles decimal phases (3.1, 3.2) -- [ ] help.md updated with quick command -- [ ] README.md updated with quick mode section -- [ ] GSD-STYLE.md updated with quick mode patterns ### Out of Scope @@ -42,41 +38,30 @@ Same guarantees, 50-70% fewer tokens for simple tasks. - gsd-verifier — verification skipped by design - Requirements mapping — quick tasks are ad-hoc - `/gsd:squash-quick` — future enhancement if fragmentation becomes a problem +- Decimal phases in ROADMAP.md — Quick tasks use `.planning/quick/` instead +- Handles multiple plans with wave-based execution — Quick tasks are single-plan by design ## Context -GSD's current flow spawns 5-8 agents for every task: -1. gsd-phase-researcher (research) -2. gsd-planner (planning) -3. gsd-plan-checker (verification loop, 2-6 spawns) -4. gsd-executor (execution) -5. gsd-verifier (verification) +Shipped v1.8.0 with `/gsd:quick` command. Quick tasks live in `.planning/quick/NNN-slug/` directories with sequential numbering. Each quick task spawns planner + executor and commits atomically. -For simple tasks like "transition cards to table layout", only planner + executor are needed. The research, checker loops, and verifier add no value when the user knows exactly what to do. - -Quick mode is the normal flow with 3 agent types removed: -- No gsd-phase-researcher -- No gsd-plan-checker -- No gsd-verifier - -Everything else stays the same: same planner, same executor, same artifacts, same commits, same state tracking. +Design change: Quick tasks don't integrate with ROADMAP.md or use decimal phases. They're tracked separately in STATE.md's Quick Tasks Completed table. ## Constraints -- **Integration**: Must use decimal phases for ROADMAP.md integration (borrowing from /gsd:insert-phase) -- **Compatibility**: Must work with /gsd:resume-work for failed quick tasks - **Artifacts**: Same artifacts as full mode (PLAN.md, SUMMARY.md) +- **Directory**: Quick tasks in `.planning/quick/`, not `.planning/phases/` ## Key Decisions | Decision | Rationale | Outcome | |----------|-----------|---------| -| No planner changes | Quick mode is orchestrator-level, not agent-level | — Pending | -| Decimal phases required | Maintains full traceability and state integrity | — Pending | -| No flags for MVP | Simplest possible interface | — Pending | -| Parallel wave execution | Matches execute-phase behavior for multi-plan tasks | — Pending | -| Quick Tasks table in STATE.md | Better tracking than just Last activity | — Pending | -| Error if no ROADMAP | Maintains state integrity, no standalone mode | — Pending | +| No planner changes | Quick mode is orchestrator-level, not agent-level | ✓ Good | +| No decimal phases | Quick tasks don't need ROADMAP integration | ✓ Good — simpler | +| No flags for MVP | Simplest possible interface | ✓ Good | +| Quick Tasks table in STATE.md | Better tracking than just Last activity | ✓ Good | +| Error if no ROADMAP | Maintains state integrity, no standalone mode | ✓ Good | +| Orchestration inline in command | No separate workflow needed for simple flow | ✓ Good | --- -*Last updated: 2025-01-19 after initialization* +*Last updated: 2026-01-19 after v1.8.0 milestone* diff --git a/.planning/ROADMAP.md b/.planning/ROADMAP.md deleted file mode 100644 index ed90ed243..000000000 --- a/.planning/ROADMAP.md +++ /dev/null @@ -1,49 +0,0 @@ -# Roadmap: GSD Quick Mode - -## Overview - -Quick mode adds a fast-path command (`/gsd:quick`) that executes small tasks with full GSD guarantees (atomic commits, STATE.md tracking) but skips optional verification agents. Quick tasks live in `.planning/quick/` separate from planned phases. - -## Phases - -**Phase Numbering:** -- Integer phases (1, 2, 3): Planned milestone work -- Decimal phases (2.1, 2.2): Urgent insertions (marked with INSERTED) - -- [x] **Phase 1: Core Command** - Complete `/gsd:quick` command end-to-end -- [x] **Phase 2: Documentation** - Update help.md, README.md, and GSD-STYLE.md - -## Phase Details - -### Phase 1: Core Command -**Goal**: User can run `/gsd:quick` (with interactive prompt) and have it execute with full state tracking -**Depends on**: Nothing (first phase) -**Requirements**: CMD-01, CMD-02, CMD-03, CMD-04, EXEC-01, EXEC-02, EXEC-03, EXEC-04, STATE-01, STATE-02 -**Plans:** 2 plans - -Plans: -- [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: Documentation -**Goal**: Quick mode is documented in all relevant locations -**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 - 2. README.md includes quick mode section explaining when to use it - 3. GSD-STYLE.md documents quick mode patterns -**Plans:** 1 plan - -Plans: -- [x] 02-01-PLAN.md — Document /gsd:quick in help.md, README.md, and GSD-STYLE.md - -## Progress - -**Execution Order:** -Phases execute in numeric order: 1 -> 2 - -| Phase | Plans Complete | Status | Completed | -|-------|----------------|--------|-----------| -| 1. Core Command | 2/2 | Complete | 2026-01-19 | -| 2. Documentation | 1/1 | Complete | 2026-01-19 | diff --git a/.planning/STATE.md b/.planning/STATE.md index dec255ae0..27c39e3d8 100644 --- a/.planning/STATE.md +++ b/.planning/STATE.md @@ -2,19 +2,17 @@ ## Project Reference -See: .planning/PROJECT.md (updated 2025-01-19) +See: .planning/PROJECT.md (updated 2026-01-19) **Core value:** Same guarantees, 50-70% fewer tokens for simple tasks -**Current focus:** Phase 2 - Documentation +**Current focus:** Planning next milestone ## Current Position -Phase: 2 of 2 (Documentation) -Plan: 1 of 1 in current phase -Status: Phase complete -Last activity: 2026-01-19 - Completed 02-01-PLAN.md - -Progress: [##########] 100% +Phase: Ready for new milestone +Plan: Not started +Status: v1.8.0 shipped, ready for next milestone +Last activity: 2026-01-19 — v1.8.0 Quick Mode milestone complete ## Performance Metrics @@ -30,10 +28,6 @@ Progress: [##########] 100% | 1. Core Command | 2/2 | 4 min | 2 min | | 2. Documentation | 1/1 | 3 min | 3 min | -**Recent Trend:** -- Last 5 plans: 01-01 (1 min), 01-02 (3 min), 02-01 (3 min) -- Trend: Stable - *Updated after each plan completion* ## Quick Tasks Completed @@ -47,26 +41,18 @@ Progress: [##########] 100% ### Decisions -Decisions are logged in PROJECT.md Key Decisions table. -Recent decisions affecting current work: - -- 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) -- Quick Mode section placement: after Execution in help.md (02-01) -- README dual entry: How It Works section AND Utilities table (02-01) +Key decisions logged in PROJECT.md Key Decisions table. ### Pending Todos -None yet. +- `/gsd:resume-work` decimal phase handling (deferred from v1.8.0) ### Blockers/Concerns -None yet. +None. ## Session Continuity Last session: 2026-01-19 -Stopped at: Completed quick task 002 (90s HTML command reference) +Stopped at: v1.8.0 milestone complete Resume file: None diff --git a/.planning/REQUIREMENTS.md b/.planning/milestones/v1.8.0-REQUIREMENTS.md similarity index 78% rename from .planning/REQUIREMENTS.md rename to .planning/milestones/v1.8.0-REQUIREMENTS.md index 40bbf9cbd..de5aedf65 100644 --- a/.planning/REQUIREMENTS.md +++ b/.planning/milestones/v1.8.0-REQUIREMENTS.md @@ -1,3 +1,13 @@ +# Requirements Archive: v1.8.0 Quick Mode + +**Archived:** 2026-01-19 +**Status:** ✅ SHIPPED + +This is the archived requirements specification for v1.8.0. +For current requirements, see `.planning/REQUIREMENTS.md` (created for next milestone). + +--- + # Requirements: GSD Quick Mode **Defined:** 2025-01-19 @@ -28,8 +38,8 @@ ### Resume -- [ ] **RESUME-01**: `/gsd:resume-work` parses decimal phase numbers (3.1, 3.2) -- [ ] **RESUME-02**: `/gsd:resume-work` finds decimal phase directories +- [ ] **RESUME-01**: `/gsd:resume-work` parses decimal phase numbers (3.1, 3.2) — DEFERRED +- [ ] **RESUME-02**: `/gsd:resume-work` finds decimal phase directories — DEFERRED ### Docs @@ -71,17 +81,24 @@ | 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 | +| RESUME-01 | — | Deferred | +| RESUME-02 | — | Deferred | | DOCS-01 | Phase 2 | Complete | | DOCS-02 | Phase 2 | Complete | | DOCS-03 | Phase 2 | Complete | **Coverage:** - v1 requirements: 17 total -- Mapped to phases: 17 -- Unmapped: 0 +- Shipped: 15 +- Deferred: 2 (RESUME-01, RESUME-02) --- -*Requirements defined: 2025-01-19* -*Last updated: 2025-01-19 after roadmap creation* + +## Milestone Summary + +**Shipped:** 15 of 17 v1 requirements +**Adjusted:** CMD-03, CMD-04, CMD-05, STATE-03 — Design changed from decimal phases in ROADMAP.md to separate `.planning/quick/` directory structure +**Dropped:** None + +--- +*Archived: 2026-01-19 as part of v1.8.0 milestone completion* diff --git a/.planning/milestones/v1.8.0-ROADMAP.md b/.planning/milestones/v1.8.0-ROADMAP.md new file mode 100644 index 000000000..9a0561849 --- /dev/null +++ b/.planning/milestones/v1.8.0-ROADMAP.md @@ -0,0 +1,69 @@ +# Milestone v1.8.0: Quick Mode + +**Status:** ✅ SHIPPED 2026-01-19 +**Phases:** 1-2 +**Total Plans:** 3 + +## Overview + +Quick mode adds a fast-path command (`/gsd:quick`) that executes small tasks with full GSD guarantees (atomic commits, STATE.md tracking) but skips optional verification agents. Quick tasks live in `.planning/quick/` separate from planned phases. + +## Phases + +### Phase 1: Core Command + +**Goal**: User can run `/gsd:quick` and have it execute with full state tracking +**Depends on**: Nothing (first phase) +**Plans**: 2 plans + +Plans: +- [x] 01-01: Quick command file with pre-flight validation and directory setup +- [x] 01-02: Quick orchestration (planner spawn, executor spawn, state update) + +**Details:** +- Created `/gsd:quick` command file with proper frontmatter +- Implemented ROADMAP.md validation with clear error messaging +- Added interactive description prompt using AskUserQuestion +- Implemented slug generation and sequential numbering for quick task directories +- Implemented gsd-planner spawn with quick mode context +- Implemented gsd-executor spawn with no-ROADMAP constraint +- Added STATE.md Quick Tasks Completed table creation/update logic +- Added final commit pattern and GSD-style completion output + +### Phase 2: Documentation + +**Goal**: Quick mode is documented in all relevant locations +**Depends on**: Phase 1 +**Plans**: 1 plan + +Plans: +- [x] 02-01: Document /gsd:quick in help.md, README.md, and GSD-STYLE.md + +**Details:** +- help.md Quick Mode section with command usage, purpose, and output files +- README.md Quick Mode section in How It Works plus Utilities table entry +- GSD-STYLE.md Quick Mode Patterns section with when-to-use, structure, tracking, orchestration, and commit conventions + +--- + +## Milestone Summary + +**Key Decisions:** +- No planner changes — Quick mode is orchestrator-level, not agent-level +- No decimal phases — Quick tasks don't need ROADMAP integration +- No flags for MVP — Simplest possible interface +- Quick Tasks table in STATE.md — Better tracking than just Last activity +- Orchestration inline in command — No separate workflow needed + +**Issues Resolved:** +- Token efficiency for simple tasks (50-70% reduction) + +**Issues Deferred:** +- `/gsd:resume-work` decimal phase handling (deferred to future) +- `/gsd:squash-quick` for consolidating fragmented quick tasks + +**Technical Debt Incurred:** +- None significant + +--- +*For current project status, see .planning/ROADMAP.md*