chore: complete v1.8.0 Quick Mode milestone
Archived: - milestones/v1.8.0-ROADMAP.md - milestones/v1.8.0-REQUIREMENTS.md Deleted (fresh for next milestone): - ROADMAP.md - REQUIREMENTS.md Updated: - MILESTONES.md (new entry) - PROJECT.md (requirements → Validated) - STATE.md (reset for next milestone) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
28
.planning/MILESTONES.md
Normal file
28
.planning/MILESTONES.md
Normal file
@@ -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
|
||||||
|
|
||||||
|
---
|
||||||
@@ -2,7 +2,7 @@
|
|||||||
|
|
||||||
## What This Is
|
## 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
|
## Core Value
|
||||||
|
|
||||||
@@ -12,24 +12,20 @@ Same guarantees, 50-70% fewer tokens for simple tasks.
|
|||||||
|
|
||||||
### Validated
|
### 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
|
### 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)
|
- [ ] `/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
|
### Out of Scope
|
||||||
|
|
||||||
@@ -42,41 +38,30 @@ Same guarantees, 50-70% fewer tokens for simple tasks.
|
|||||||
- gsd-verifier — verification skipped by design
|
- gsd-verifier — verification skipped by design
|
||||||
- Requirements mapping — quick tasks are ad-hoc
|
- Requirements mapping — quick tasks are ad-hoc
|
||||||
- `/gsd:squash-quick` — future enhancement if fragmentation becomes a problem
|
- `/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
|
## Context
|
||||||
|
|
||||||
GSD's current flow spawns 5-8 agents for every task:
|
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.
|
||||||
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)
|
|
||||||
|
|
||||||
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.
|
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.
|
||||||
|
|
||||||
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.
|
|
||||||
|
|
||||||
## Constraints
|
## 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)
|
- **Artifacts**: Same artifacts as full mode (PLAN.md, SUMMARY.md)
|
||||||
|
- **Directory**: Quick tasks in `.planning/quick/`, not `.planning/phases/`
|
||||||
|
|
||||||
## Key Decisions
|
## Key Decisions
|
||||||
|
|
||||||
| Decision | Rationale | Outcome |
|
| Decision | Rationale | Outcome |
|
||||||
|----------|-----------|---------|
|
|----------|-----------|---------|
|
||||||
| No planner changes | Quick mode is orchestrator-level, not agent-level | — Pending |
|
| No planner changes | Quick mode is orchestrator-level, not agent-level | ✓ Good |
|
||||||
| Decimal phases required | Maintains full traceability and state integrity | — Pending |
|
| No decimal phases | Quick tasks don't need ROADMAP integration | ✓ Good — simpler |
|
||||||
| No flags for MVP | Simplest possible interface | — Pending |
|
| No flags for MVP | Simplest possible interface | ✓ Good |
|
||||||
| Parallel wave execution | Matches execute-phase behavior for multi-plan tasks | — Pending |
|
| Quick Tasks table in STATE.md | Better tracking than just Last activity | ✓ Good |
|
||||||
| Quick Tasks table in STATE.md | Better tracking than just Last activity | — Pending |
|
| Error if no ROADMAP | Maintains state integrity, no standalone mode | ✓ Good |
|
||||||
| Error if no ROADMAP | Maintains state integrity, no standalone mode | — Pending |
|
| 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*
|
||||||
|
|||||||
@@ -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 |
|
|
||||||
@@ -2,19 +2,17 @@
|
|||||||
|
|
||||||
## Project Reference
|
## 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
|
**Core value:** Same guarantees, 50-70% fewer tokens for simple tasks
|
||||||
**Current focus:** Phase 2 - Documentation
|
**Current focus:** Planning next milestone
|
||||||
|
|
||||||
## Current Position
|
## Current Position
|
||||||
|
|
||||||
Phase: 2 of 2 (Documentation)
|
Phase: Ready for new milestone
|
||||||
Plan: 1 of 1 in current phase
|
Plan: Not started
|
||||||
Status: Phase complete
|
Status: v1.8.0 shipped, ready for next milestone
|
||||||
Last activity: 2026-01-19 - Completed 02-01-PLAN.md
|
Last activity: 2026-01-19 — v1.8.0 Quick Mode milestone complete
|
||||||
|
|
||||||
Progress: [##########] 100%
|
|
||||||
|
|
||||||
## Performance Metrics
|
## Performance Metrics
|
||||||
|
|
||||||
@@ -30,10 +28,6 @@ Progress: [##########] 100%
|
|||||||
| 1. Core Command | 2/2 | 4 min | 2 min |
|
| 1. Core Command | 2/2 | 4 min | 2 min |
|
||||||
| 2. Documentation | 1/1 | 3 min | 3 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*
|
*Updated after each plan completion*
|
||||||
|
|
||||||
## Quick Tasks Completed
|
## Quick Tasks Completed
|
||||||
@@ -47,26 +41,18 @@ Progress: [##########] 100%
|
|||||||
|
|
||||||
### Decisions
|
### Decisions
|
||||||
|
|
||||||
Decisions are logged in PROJECT.md Key Decisions table.
|
Key decisions 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)
|
|
||||||
|
|
||||||
### Pending Todos
|
### Pending Todos
|
||||||
|
|
||||||
None yet.
|
- `/gsd:resume-work` decimal phase handling (deferred from v1.8.0)
|
||||||
|
|
||||||
### Blockers/Concerns
|
### Blockers/Concerns
|
||||||
|
|
||||||
None yet.
|
None.
|
||||||
|
|
||||||
## Session Continuity
|
## Session Continuity
|
||||||
|
|
||||||
Last session: 2026-01-19
|
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
|
Resume file: None
|
||||||
|
|||||||
@@ -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
|
# Requirements: GSD Quick Mode
|
||||||
|
|
||||||
**Defined:** 2025-01-19
|
**Defined:** 2025-01-19
|
||||||
@@ -28,8 +38,8 @@
|
|||||||
|
|
||||||
### Resume
|
### Resume
|
||||||
|
|
||||||
- [ ] **RESUME-01**: `/gsd:resume-work` parses decimal phase numbers (3.1, 3.2)
|
- [ ] **RESUME-01**: `/gsd:resume-work` parses decimal phase numbers (3.1, 3.2) — DEFERRED
|
||||||
- [ ] **RESUME-02**: `/gsd:resume-work` finds decimal phase directories
|
- [ ] **RESUME-02**: `/gsd:resume-work` finds decimal phase directories — DEFERRED
|
||||||
|
|
||||||
### Docs
|
### Docs
|
||||||
|
|
||||||
@@ -71,17 +81,24 @@
|
|||||||
| STATE-01 | Phase 1 | Complete |
|
| STATE-01 | Phase 1 | Complete |
|
||||||
| STATE-02 | Phase 1 | Complete |
|
| STATE-02 | Phase 1 | Complete |
|
||||||
| STATE-03 | Phase 1 | Complete |
|
| STATE-03 | Phase 1 | Complete |
|
||||||
| RESUME-01 | Phase 2 | Pending |
|
| RESUME-01 | — | Deferred |
|
||||||
| RESUME-02 | Phase 2 | Pending |
|
| RESUME-02 | — | Deferred |
|
||||||
| DOCS-01 | Phase 2 | Complete |
|
| DOCS-01 | Phase 2 | Complete |
|
||||||
| DOCS-02 | Phase 2 | Complete |
|
| DOCS-02 | Phase 2 | Complete |
|
||||||
| DOCS-03 | Phase 2 | Complete |
|
| DOCS-03 | Phase 2 | Complete |
|
||||||
|
|
||||||
**Coverage:**
|
**Coverage:**
|
||||||
- v1 requirements: 17 total
|
- v1 requirements: 17 total
|
||||||
- Mapped to phases: 17
|
- Shipped: 15
|
||||||
- Unmapped: 0
|
- 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*
|
||||||
69
.planning/milestones/v1.8.0-ROADMAP.md
Normal file
69
.planning/milestones/v1.8.0-ROADMAP.md
Normal file
@@ -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*
|
||||||
Reference in New Issue
Block a user