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