Lex Christopherson
6e757aaa77
fix(05): revise plan 05-02 based on checker feedback
...
- Reframe must_haves truths to outcome-focused (scalability, UX)
- Add instruction to fix outdated slug documentation (-- to -)
- Add slug verification to task verify checklist
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com >
2026-01-20 11:47:43 -06:00
Lex Christopherson
d994732a45
docs(05): create phase plan for subagent codebase analysis
...
Phase 05: Subagent Codebase Analysis
- 2 plans in 2 waves
- Plan 05-01: Create gsd-entity-generator subagent (Wave 1)
- Plan 05-02: Refactor analyze-codebase to use subagent (Wave 2)
- Ready for execution
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com >
2026-01-20 11:44:32 -06:00
Lex Christopherson
701b10d5f9
docs(05): research subagent codebase analysis
...
Phase 5: Subagent Codebase Analysis
- Refactor entity generation from main context to subagent delegation
- Follow gsd-codebase-mapper pattern
- Prevent context exhaustion on 500+ file codebases
- Single subagent with full file list (not multiple batches)
- Subagent writes entities directly, returns statistics only
2026-01-20 11:40:58 -06:00
Lex Christopherson
1c746a548a
docs(04-05): complete intel injection into planner plan
...
Tasks completed: 2/2
- Add intel file read to Step 7
- Add intel section to planner prompt template
SUMMARY: .planning/phases/04-semantic-intelligence/04-05-SUMMARY.md
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com >
2026-01-20 10:25:35 -06:00
Lex Christopherson
fe72ca41bd
docs(04-04): complete CLI query interface plan
...
Tasks completed: 2/2
- Add query action routing to stdin handler
- Add usage documentation as code comment
SUMMARY: .planning/phases/04-semantic-intelligence/04-04-SUMMARY.md
2026-01-20 10:15:00 -06:00
Lex Christopherson
04d296471d
docs(04): create gap closure plan for CLI query interface
...
Phase 04-04: Expose orphaned getDependents() function
- Add handleQuery() routing for stdin query actions
- Enable "what uses this file?" queries via CLI
- Closes verification gap for INTEL-05
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com >
2026-01-20 10:09:31 -06:00
Lex Christopherson
28c4c19112
docs(04-02): complete query interface plan
...
Tasks completed: 3/3
- Add graph query helpers
- Create graph-backed summary generator
- Integrate graph summary into regeneration flow
SUMMARY: .planning/phases/04-semantic-intelligence/04-02-SUMMARY.md
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com >
2026-01-20 10:00:21 -06:00
Lex Christopherson
9d9d7622d9
docs(04-03): complete entity generation instructions plan
...
Tasks completed: 3/3
- Add @anthropic-ai/sdk dependency
- Add semantic entity generation to analyze-codebase
- Add context section explaining execution model
SUMMARY: .planning/phases/04-semantic-intelligence/04-03-SUMMARY.md
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com >
2026-01-20 09:59:08 -06:00
Lex Christopherson
0837278d60
docs(04-01): complete SQLite graph layer plan
...
Tasks completed: 3/3
- Add sql.js dependency and graph schema
- Implement graph database helpers
- Sync entity files to graph on write
SUMMARY: .planning/phases/04-semantic-intelligence/04-01-SUMMARY.md
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com >
2026-01-20 09:54:35 -06:00
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