Commit Graph

325 Commits

Author SHA1 Message Date
Lex Christopherson
f3f6707cbe feat: add gsd-verifier subagent for phase goal verification
- gsd-verifier.md: dedicated verification subagent with all logic baked in
- Goal-backward verification: checks codebase, not SUMMARY claims
- Creates VERIFICATION.md, returns status to orchestrator
- execute-phase spawns gsd-verifier instead of general-purpose

Co-Authored-By: Claude <noreply@anthropic.com>
2026-01-15 09:51:14 -06:00
Lex Christopherson
82c522b8c3 fix: update remaining general-purpose refs to gsd-executor
- execute-phase.md: wave execution example now uses gsd-executor
- execute-plan.md workflow: subagent spawning uses gsd-executor
- continuation-prompt.md: continuation spawning uses gsd-executor
- Remove obsolete subagent-task-prompt.md reference

Co-Authored-By: Claude <noreply@anthropic.com>
2026-01-15 09:40:53 -06:00
Lex Christopherson
87909f97ae feat: enhance roadmap and planning workflows
- create-roadmap: improved phase structuring and requirements tracing
- plan-phase: better task decomposition and wave assignment
- roadmap.md template: cleaner format
- phase-prompt.md template: structured planning prompt

Co-Authored-By: Claude <noreply@anthropic.com>
2026-01-15 09:34:48 -06:00
Lex Christopherson
869f02e973 docs: add goal-backward planning reference
Explains working backwards from desired outcome to concrete tasks.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-01-15 09:34:43 -06:00
Lex Christopherson
6d7246dcf5 feat: add phase verification system
- verify-phase.md workflow: validates phase goal achievement vs task completion
- subagent-verify-prompt.md: template for spawning verification agents
- verification-report.md: VERIFICATION.md output template
- verification-patterns.md: common anti-patterns and verification strategies

Co-Authored-By: Claude <noreply@anthropic.com>
2026-01-15 09:34:38 -06:00
Lex Christopherson
e95186b2a7 refactor: update execute commands to spawn gsd-executor subagent
- execute-plan.md: spawn gsd-executor instead of general-purpose with template
- execute-phase.md: spawn gsd-executor for wave-based parallel execution
- Remove template filling, subagent has all logic baked in

Co-Authored-By: Claude <noreply@anthropic.com>
2026-01-15 09:34:32 -06:00
Lex Christopherson
b2646c894c feat: add gsd-executor subagent with dedicated plan execution logic
Moves all plan execution logic into a dedicated subagent:
- Deviation rules, checkpoint protocols, commit formatting
- Summary creation, state updates, TDD execution
- Authentication gate handling, continuation support

Installer now copies agents/ to ~/.claude/agents/

Co-Authored-By: Claude <noreply@anthropic.com>
2026-01-15 09:34:26 -06:00
Lex Christopherson
f237cf0982 chore: ignore local test installs (.claude/) 2026-01-15 09:34:18 -06:00
Lex Christopherson
9ac4901e76 1.5.6 2026-01-15 02:48:31 -06:00
Lex Christopherson
7d5922be52 docs: update changelog for v1.5.6 2026-01-15 02:48:26 -06:00
Lex Christopherson
238332513b fix(execute-phase): bundle phase metadata into single commit
ROADMAP.md, STATE.md, and REQUIREMENTS.md updates now commit
together as phase completion instead of separate commits.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-15 02:38:25 -06:00
Lex Christopherson
c74f4a05e8 docs: clarify research-project optional, define-requirements required
- Split into separate steps: 1, 1.5 (optional), 2, 3, 4, 5
- Research is recommended for quality, skip only for speed
- Define-requirements is required before create-roadmap

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-15 02:37:02 -06:00
Lex Christopherson
0e4a56221b 1.5.5 2026-01-15 02:30:26 -06:00
Lex Christopherson
431fe3cf4a docs: update changelog for v1.5.5 2026-01-15 02:30:21 -06:00
Lex Christopherson
f03947a3f4 docs: document research-project and define-requirements flow
- Add research & scope step to "How It Works" (optional but recommended)
- Update brownfield section with full optional flow
- Add research-project and define-requirements to commands
- Add research/ and REQUIREMENTS.md to context engineering table
- Split commands into 7 grouped tables for easier scanning

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-15 02:29:15 -06:00
Lex Christopherson
de287fddf9 1.5.4 2026-01-15 01:44:36 -06:00
Lex Christopherson
a70ecff401 docs: update changelog for v1.5.4 2026-01-15 01:44:32 -06:00
Lex Christopherson
3b0ea3187f feat(research-phase): load REQUIREMENTS.md for focused research
Research now loads concrete requirements (e.g., "AUTH-02: User receives
email verification") to inform research domains, not just high-level
roadmap descriptions.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-01-15 01:43:30 -06:00
Lex Christopherson
e1f8a487da 1.5.3 2026-01-15 01:06:16 -06:00
Lex Christopherson
c42735a012 docs: update changelog for v1.5.3 2026-01-15 01:06:12 -06:00
Lex Christopherson
bd4bd9db53 refactor: remove dead code, improve execute-phase UX, fix requirements flow
- Remove phantom status.md command (background agent model abandoned)
- Remove agent-history.md template (unused)
- Remove _archive/ directory
- Add narration to execute-phase (describe what's being built before/after waves)
- Update new-project to offer define-requirements as fast path
- Make define-requirements work without research (gather through questioning)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-15 01:04:41 -06:00
Lex Christopherson
73083db966 1.5.2 2026-01-15 00:25:23 -06:00
Lex Christopherson
206b7092a5 docs: update changelog for v1.5.2 2026-01-15 00:25:19 -06:00
Lex Christopherson
1f24f7e689 docs: add staying updated section to help and README
Promote /gsd:whats-new and update command visibility.
GSD evolves fast — users should check periodically.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-15 00:23:29 -06:00
Lex Christopherson
365c04163c refactor: move requirements status update to commands (orchestrator)
Subagents can't determine if phase is complete. The orchestrator
(execute-plan and execute-phase commands) runs in main context,
can count plans vs summaries, and updates REQUIREMENTS.md when
phase completes.

- execute-plan: Step 2.5 updates requirements when summaries = plans
- execute-phase: Step 6 updates requirements (phase always complete)
- Removed duplicate from workflow (subagent can't run it anyway)
2026-01-15 00:20:00 -06:00
Lex Christopherson
e1b6655d57 feat: update requirement status to Complete when phase finishes
When all plans in a phase complete:
1. Look up phase's requirements from ROADMAP.md
2. Update REQUIREMENTS.md traceability table (Pending → Complete)
3. Include in metadata commit

Closes the loop on requirement tracking.
2026-01-15 00:11:35 -06:00
Lex Christopherson
3e9c7f77d6 refactor: combine workflow preferences into single AskUserQuestion
Mode, depth, and parallelization now asked in one call (3 questions)
instead of 3 separate interactions.
2026-01-15 00:07:41 -06:00
Lex Christopherson
fc0f861808 fix: align research-project next steps (both point to define-requirements) 2026-01-15 00:04:55 -06:00
Lex Christopherson
b708a8d361 feat: add requirements traceability to roadmap and plan-phase
- Roadmap template now includes Requirements: field for each phase
- plan-phase loads REQUIREMENTS.md and extracts phase-specific requirements
- define-requirements shows full list inline before commit (not just counts)
2026-01-15 00:04:29 -06:00
Lex Christopherson
36ff4f4f94 fix: show full requirements list, not just counts
Summary step now displays every requirement inline so user can
see exactly what they're committing to before approval.
2026-01-14 23:56:59 -06:00
Lex Christopherson
1ccc66f16b fix: offer both define-requirements and create-roadmap as next steps
Requirements definition is recommended but not mandatory after research.
2026-01-14 23:53:41 -06:00
Lex Christopherson
9e092cd402 1.5.1 2026-01-14 23:51:14 -06:00
Lex Christopherson
bb5b0da78e docs: update changelog for v1.5.1 2026-01-14 23:51:09 -06:00
Lex Christopherson
fb2dcf6430 refactor: subagents write their own research files
Each research agent (stack, features, architecture, pitfalls) writes
directly to .planning/research/. Orchestrator only writes SUMMARY.md
after reading all agent outputs.

Benefits:
- Parallel writes (no aggregation bottleneck)
- Simpler orchestrator (just spawns and synthesizes)
- Better isolation (failed agent doesn't lose others' work)
- Leaner context (orchestrator doesn't hold 4 full docs)
2026-01-14 23:50:03 -06:00
Lex Christopherson
194d1d88bb refactor: slim principles.md and load in core commands
Reduce principles.md from 158 to 73 lines:
- Remove duplicates (atomic_commits, tdd, deviation_rules)
- Remove version drag from claude_automates
- Keep core orientation: solo dev model, plans are prompts,
  scope control, ship fast, anti-enterprise

Add principles.md to 9 core commands so Claude always
understands what GSD is.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-14 23:48:44 -06:00
Lex Christopherson
e2d4ce5531 1.5.0 2026-01-14 23:41:55 -06:00
Lex Christopherson
0604268a03 docs: update changelog for v1.5.0 2026-01-14 23:41:51 -06:00
Lex Christopherson
e6bdd26118 refactor: simplify questioning to four essentials
Focus on what to extract, not what to avoid:
- What they're building
- Why it needs to exist
- Who it's for
- What done looks like

Remove version drag and redundant question categories.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-14 23:32:21 -06:00
Lex Christopherson
d5ff9a4531 refactor: improve questioning flow in new-project
- Follow threads naturally instead of rigid step order
- Cleaner question techniques in questioning.md
- Background context checklist instead of forced checklist mode
- Updated next steps to show research flow
2026-01-14 23:30:17 -06:00
Lex Christopherson
d0488c503f feat: add define-requirements command for scoped v1 requirements
Adds /gsd:define-requirements to transform research findings into
checkable requirements before roadmap creation.

New flow:
  new-project → research-project → define-requirements → create-roadmap

New files:
- commands/gsd/define-requirements.md
- get-shit-done/workflows/define-requirements.md
- get-shit-done/templates/requirements.md

Modified:
- new-project.md: updated next steps
- research-project.md: points to define-requirements
- create-roadmap.md: requires REQUIREMENTS.md, validates coverage
- workflows/create-roadmap.md: maps phases to requirements, updates traceability

Key changes:
- Phases now map to specific requirement IDs
- 100% requirement coverage required before roadmap creation
- REQUIREMENTS.md traceability section tracks phase assignments

Co-Authored-By: Claude <noreply@anthropic.com>
2026-01-14 23:25:41 -06:00
Lex Christopherson
53efcfbfe1 feat: add research-project command for pre-roadmap ecosystem research
Adds /gsd:research-project to research domain ecosystem before creating roadmap.
Spawns parallel agents to investigate stack, features, architecture, and pitfalls.

New files:
- commands/gsd/research-project.md
- get-shit-done/workflows/research-project.md
- get-shit-done/templates/research-project/ (5 templates)

Modified:
- new-project.md: offers research vs direct roadmap options
- create-roadmap.md: loads research if exists
- workflows/create-roadmap.md: uses research to inform phases

Co-Authored-By: Claude <noreply@anthropic.com>
2026-01-14 22:59:01 -06:00
Lex Christopherson
294e00afaa 1.4.29 2026-01-14 22:27:49 -06:00
Lex Christopherson
82a216f5a2 docs: update changelog for v1.4.29 2026-01-14 22:27:44 -06:00
Lex Christopherson
6bffcf12be chore: delete old files 2026-01-14 16:56:06 -06:00
Lex Christopherson
f5e5b8fb98 1.4.28 2026-01-14 16:42:14 -06:00
Lex Christopherson
ccf3865bd7 docs: update changelog for v1.4.28 2026-01-14 16:42:08 -06:00
Lex Christopherson
aaf5bceebc refactor(execute-phase): slim command, delegate to workflow
Command now references workflow for checkpoint handling details
instead of duplicating logic. Keeps command thin as intended.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-14 16:30:23 -06:00
Lex Christopherson
e98bebfeeb fix(checkpoints): restore rich documentation and fix continuation pattern
- execute-plan.md: Replace broken Task(resume=...) with fresh continuation agent
- execute-phase.md: Expand checkpoint handling with full continuation flow
- checkpoints.md: Restore ~500 lines of detailed examples and anti-patterns

Checkpoint presentation formats now documented for all three types.
Templates referenced: checkpoint-return.md, continuation-prompt.md

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-14 16:26:08 -06:00
Lex Christopherson
ac31b89526 1.4.27 2026-01-14 15:35:53 -06:00
Lex Christopherson
5a883626c3 docs: update changelog for v1.4.27 2026-01-14 15:35:36 -06:00