Commit Graph

54 Commits

Author SHA1 Message Date
Lex Christopherson
3230fdfd2b fix(04): revise plans based on checker feedback
04-02: Added SessionStart hook wiring verification to Task 3 and
key_links. The hook already exists from Phase 2 - plan now verifies
it correctly injects the new graph-backed summary format.

04-03: Removed embedded JavaScript execution pattern. Commands are
instructions Claude follows, not scripts. Entity generation now uses
Task tool to spawn subagents for batch processing instead of pretending
markdown can execute JS.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-20 09:43:37 -06:00
Lex Christopherson
e3d39c09e6 docs(04): create phase 4 plans for semantic intelligence
Phase 4: Semantic Intelligence & Scale
- 3 plans in 2 waves
- Wave 1: 04-01 SQLite graph layer (sql.js WASM)
- Wave 2: 04-02 Rich summary generation, 04-03 Semantic entity generation

Key additions:
- sql.js for zero-native-deps graph database
- @anthropic-ai/sdk for Claude API entity generation
- Recursive CTEs for dependency queries ("what uses X")
- Graph-backed summaries with hotspots

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-20 09:39:22 -06:00
Lex Christopherson
d0db04f32f chore: stop tracking .planning/ (already gitignored)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-19 23:43:55 -06:00
Lex Christopherson
cffb3f24cd feat(settings): add /gsd:settings command for workflow toggles
Adds interactive settings command to toggle workflow agents:
- Plan Researcher (workflow.research)
- Plan Checker (workflow.plan_check)
- Execution Verifier (workflow.verifier)

Updates plan-phase.md and execute-phase.md to check config before
spawning these agents. Flags still override config per-invocation.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-19 23:42:48 -06:00
Lex Christopherson
06ac420326 feat(02-01): add convention detection functions
- Add detectCase() to identify naming conventions (camelCase, PascalCase, snake_case, kebab-case, SCREAMING_SNAKE)
- Add detectConventions() to analyze index for patterns
- Add DIRECTORY_PURPOSES and SUFFIX_PURPOSES lookup tables
- Add MIN_SAMPLES (5) and MIN_MATCH_RATE (0.70) thresholds
2026-01-19 23:40:13 -06:00
Lex Christopherson
eeebde660a docs(phase-1): complete Foundation & Learning phase
Phase 1 verified: 6/6 must-haves passed.
- INDEX-01 through INDEX-05: Complete
- CONV-06: Complete

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-19 23:21:43 -06:00
Lex Christopherson
fb397df9b2 docs: create v1.9.0 roadmap (3 phases)
Phases:
1. Foundation & Learning: Index store, PostToolUse hook
2. Context Injection: Convention detection, SessionStart hook
3. Brownfield & Integration: analyze-codebase, GSD integration, docs

All 29 v1 requirements mapped to phases.
2026-01-19 22:58:46 -06:00
Lex Christopherson
cef51336c0 docs: start milestone v1.9.0 Codebase Intelligence System
Living knowledge system that learns codebase structure and conventions,
injecting understanding into every Claude session automatically.
2026-01-19 22:41:25 -06:00
Lex Christopherson
f616bb06b3 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>
2026-01-19 19:03:32 -06:00
Lex Christopherson
125b97784e chore: gitignore commands.html
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-19 16:20:41 -06:00
Lex Christopherson
9539c9643a chore: remove test files (gsd-meta agent, commands.html)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-19 15:59:29 -06:00
Lex Christopherson
d673b8caf5 docs(02-01): add Quick Mode section to help.md
- Add /gsd:quick command documentation
- Place between Execution and Roadmap Management sections
- Document usage, purpose, and output files
2026-01-19 15:59:29 -06:00
Lex Christopherson
eed4e57456 docs(quick-001): create GSD commands HTML reference page
Quick task completed.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-19 15:59:29 -06:00
Lex Christopherson
deec75c8af feat(quick-001): create GSD commands HTML reference page
- 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
2026-01-19 15:59:29 -06:00
Lex Christopherson
2b36394f35 feat(01-01): create quick.md command file with structure
- Add frontmatter with name, description, allowed-tools
- Include objective explaining quick mode purpose
- Add process section with steps 1-7 (orchestration deferred to Plan 02)
- Include success criteria for full quick task flow

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-19 15:59:29 -06:00
Lex Christopherson
6d0a9a0543 docs(01): research phase domain
Phase 1: Core Command
- Standard stack identified (gsd-planner quick mode, gsd-executor)
- Architecture patterns documented (.planning/quick/ structure, STATE.md table)
- Pitfalls catalogued (ROADMAP updates, decimal phases, flags - all rejected by CONTEXT.md)
2026-01-19 15:59:29 -06:00
Lex Christopherson
ae43baccd2 docs(01): capture phase context
Phase 01: Core Command
- Implementation decisions documented
- Phase boundary established
- Quick tasks use .planning/quick/ directory structure

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-19 15:59:29 -06:00
Lex Christopherson
d21f2d9092 docs: create roadmap (3 phases)
Phases:
1. Core Command: CMD-01-05, EXEC-01-04, STATE-01-03
2. Resume Integration: RESUME-01-02
3. Documentation: DOCS-01-03

All v1 requirements mapped to phases.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-19 14:40:19 -06:00
Lex Christopherson
535b316e17 docs: define v1 requirements
17 requirements across 5 categories
0 requirements deferred to v2

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-19 14:40:19 -06:00
Lex Christopherson
eac1503139 chore: add project config
Mode: yolo
Depth: quick
Parallelization: enabled

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-19 14:40:19 -06:00
Lex Christopherson
922debfcb1 docs: initialize project
Fast-path /gsd:quick command — same guarantees, 50-70% fewer tokens for simple tasks

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-19 14:40:19 -06:00
Lex Christopherson
eb641b7339 chore: delete old .planning files 2026-01-16 17:18:28 -06:00
Lex Christopherson
280baed097 docs(16): complete plan verification loop phase 2026-01-16 09:06:25 -06:00
Lex Christopherson
bb217e471a docs(16-03): complete planner revision mode plan
Tasks completed: 3/3
- Add revision_mode section with 6-step process
- Update role section for revision mode
- Add REVISION COMPLETE return format

SUMMARY: .planning/phases/16-plan-verification-loop/16-03-SUMMARY.md
2026-01-16 09:02:34 -06:00
Lex Christopherson
b838692c53 docs(16-01): complete gsd-plan-checker plan
Tasks completed: 2/2
- Create gsd-plan-checker agent with six verification dimensions
- Examples included for common failure modes

SUMMARY: .planning/phases/16-plan-verification-loop/16-01-SUMMARY.md

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-16 08:58:01 -06:00
Lex Christopherson
96cd23c750 docs(16): create phase plan
Phase 16: Plan Verification Loop
- 3 plan(s) in 2 wave(s)
- Wave 1: 16-01 (create gsd-plan-checker agent)
- Wave 2: 16-02, 16-03 (parallel - orchestrator + planner revision)
- Ready for execution

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-16 08:52:31 -06:00
Lex Christopherson
d24062ffae docs(15-01): complete create gsd-planner agent plan
Tasks completed: 2/2
- Task 1: Create gsd-planner agent file (1,147 lines)
- Task 2: Verify agent completeness (all 14 sections present)

SUMMARY: .planning/phases/15-dedicated-planner-agent/15-01-SUMMARY.md
2026-01-16 07:46:36 -06:00
Lex Christopherson
1f45befed4 feat(15-01): create gsd-planner agent file
Consolidate ~3,580 lines of planning references into dedicated agent:
- Complete planning methodology in 1,147 lines
- 14 sections covering full planning workflow
- Follows gsd-debugger/gsd-researcher pattern
- Solo developer + Claude workflow philosophy
- Quality degradation curve and scope estimation
- Dependency graph and wave assignment
- Goal-backward verification methodology
- TDD integration and checkpoint handling
- Gap closure mode for verification failures
2026-01-16 07:44:45 -06:00
Lex Christopherson
c1fe62cc86 docs(15): create phase plans for dedicated planner agent
Phase 15: Dedicated Planner Agent
- 3 plans in 2 waves
- Wave 1: 15-01 (create gsd-planner agent)
- Wave 2: 15-02, 15-03 (parallel - orchestrator refactor, deprecations)
- Ready for execution

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-16 07:39:14 -06:00
Lex Christopherson
5f30575ef0 docs(14): complete dedicated researcher agent phase
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-15 17:09:20 -06:00
Lex Christopherson
cc5b8b50a4 docs(14-03): complete research-project orchestrator plan
Tasks completed: 3/3
- Refactor research-project to thin orchestrator
- Deprecate workflows/research-project.md
- Deprecate research-pitfalls.md reference

SUMMARY: .planning/phases/14-dedicated-researcher-agent/14-03-SUMMARY.md
2026-01-15 17:06:33 -06:00
Lex Christopherson
47786d06db docs(14-02): complete researcher orchestrator integration
Tasks completed: 3/3
- Refactored /gsd:research-phase to thin orchestrator (130 lines)
- Deprecated workflows/research-phase.md
- Created research-subagent-prompt.md template
2026-01-15 17:05:28 -06:00
Lex Christopherson
064e5c916f docs(14-01): complete gsd-researcher agent plan
Tasks completed: 2/2
- Create gsd-researcher agent file (902 lines)
- Verify agent completeness

SUMMARY: .planning/phases/14-dedicated-researcher-agent/14-01-SUMMARY.md
2026-01-15 17:01:20 -06:00
Lex Christopherson
f93a177788 docs(14): create researcher agent phase plans
Phase 14: Dedicated Researcher Agent
- 3 plans in 2 waves
- Wave 1: 14-01 (agent creation)
- Wave 2: 14-02, 14-03 (parallel orchestrator refactoring)
- Ready for execution

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-15 16:54:12 -06:00
Lex Christopherson
d20d284433 docs(14): create researcher agent phase plans
Phase 14: Dedicated Researcher Agent
- 3 plans in 2 waves
- Wave 1: 14-01 (gsd-researcher agent creation)
- Wave 2: 14-02, 14-03 (orchestrator refactoring, parallel)
- Ready for execution
2026-01-15 16:40:51 -06:00
Lex Christopherson
0a19b2e04d docs(13): complete dedicated debug agent phase
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-15 16:26:40 -06:00
Lex Christopherson
941bcd98bf docs(13-01): complete gsd-debugger agent plan
Tasks completed: 2/2
- Task 1: Create gsd-debugger agent file
- Task 2: Verify agent completeness

SUMMARY: .planning/phases/13-debug-agent/13-01-SUMMARY.md
2026-01-15 16:18:46 -06:00
Lex Christopherson
20bb2101bd docs(13): create phase plans for dedicated debug agent
Phase 13: Dedicated Debug Agent - 3 plans in 2 waves

Wave 1:
- 13-01: Create gsd-debugger agent with consolidated debugging expertise

Wave 2 (parallel):
- 13-02: Refactor /gsd:debug to thin orchestrator
- 13-03: Deprecate debugging reference files with agent pointers

Goal: ~95% context reduction in orchestrator (2,400 → 150 lines)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-15 16:08:32 -06:00
Lex Christopherson
d7680cd537 docs(12-03): complete whats-new command plan
Tasks completed: 3/3
- Create whats-new.md command
- Update install.js to write VERSION file
- Update help.md to include whats-new command

SUMMARY: .planning/phases/12-changelog-and-update-awareness/12-03-SUMMARY.md
2026-01-14 14:08:05 -06:00
Lex Christopherson
1a55ac8539 feat(12-03): create whats-new.md command
- Reads installed version from VERSION file
- Fetches remote changelog from GitHub
- Displays version comparison and missed changes
- Provides update instructions when behind
2026-01-14 14:06:06 -06:00
Lex Christopherson
63113e9522 feat(12-01): create CHANGELOG.md with Keep-a-Changelog format
- Added 1.4.24 entry documenting parallel execution, planning changes
- Marked ISSUES.md removal as BREAKING change
- Established changelog structure for ongoing releases

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-14 14:03:28 -06:00
Lex Christopherson
b810d1ddca fix(execute-phase): add one-subagent-per-plan constraint
Context isolation is the primary goal, not parallelization.
Even sequential plans spawn separate subagents for fresh 200k context.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-12 14:34:37 -06:00
Lex Christopherson
a0d465b687 docs(99): create phase plan
Phase 99: Test Parallel (THROWAWAY)
- 3 plans created (all parallelizable)
- 3 total tasks defined
- Ready for /gsd:execute-phase 99
2026-01-12 14:28:33 -06:00
Lex Christopherson
e88818a37f docs(11-04): complete documentation and examples plan
Tasks completed: 2/2
- Add parallel-aware splitting strategy to scope-estimation.md
- Add parallel vs sequential examples to phase-prompt.md

SUMMARY: .planning/phases/11-parallel-aware-planning/11-04-SUMMARY.md

Phase 11: Parallel-Aware Planning complete
Milestone 100% complete (23/23 plans)
2026-01-12 14:23:08 -06:00
Lex Christopherson
9935f27227 docs(11-03): complete execute-phase frontmatter support plan
Tasks completed: 2/2
- Update analyze_plan_dependencies to read frontmatter fields
- Update categorization to use frontmatter parallelizable field

SUMMARY: .planning/phases/11-parallel-aware-planning/11-03-SUMMARY.md
2026-01-12 14:19:47 -06:00
Lex Christopherson
661cebe5a6 docs(11-02): complete parallel-aware planning step
Tasks completed: 2/2
- Add parallelization_aware step to plan-phase.md
- Update write_phase_prompt with frontmatter guidance

SUMMARY: .planning/phases/11-parallel-aware-planning/11-02-SUMMARY.md
2026-01-12 14:15:52 -06:00
Lex Christopherson
942b8c8466 docs(11-01): complete parallelization frontmatter plan
Tasks completed: 2/2
- Add parallelization frontmatter to phase-prompt.md
- Add read_parallelization_config step to plan-phase.md

SUMMARY: .planning/phases/11-parallel-aware-planning/11-01-SUMMARY.md
2026-01-12 14:09:38 -06:00
Lex Christopherson
8e67241e73 feat(11-01): add read_parallelization_config step to plan-phase workflow
- Reads .planning/config.json parallelization settings early
- Documents planning behavior when parallel enabled vs disabled
- Placed after load_project_state, before load_codebase_context
- Default: assume parallelization enabled for new projects
2026-01-12 14:08:19 -06:00
Lex Christopherson
9b87de4ff1 docs(10-04): complete agent-history schema update plan
Tasks completed: 3/3
- Update schema version and add new fields
- Add parallel execution examples
- Document resume support for parallel groups

Phase 10 complete. Milestone complete.

SUMMARY: .planning/phases/10-parallel-phase-execution/10-04-SUMMARY.md
2026-01-12 13:26:08 -06:00
Lex Christopherson
52372c336b docs(10-03): complete execute-phase command plan
Tasks completed: 3/3
- Create execute-phase command
- Add parallelization config to config.json template
- Update documentation

SUMMARY: .planning/phases/10-parallel-phase-execution/10-03-SUMMARY.md
2026-01-12 13:17:33 -06:00