Commit Graph

2813 Commits

Author SHA1 Message Date
Lex Christopherson
e8d66e3bf9 docs(15-02): deprecate workflows/plan-phase.md
- Replaced 868-line workflow with deprecation notice
- Points to agents/gsd-planner.md for methodology
- Documents historical content for reference
- Kept file for git history
2026-01-16 07:48:33 -06:00
Lex Christopherson
a52d1fdf12 docs(15-03): add clarifying note to phase-prompt template
Note clarifies relationship with gsd-planner agent:
- Planning methodology is in agents/gsd-planner.md
- This template defines the PLAN.md output format

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-16 07:48:18 -06:00
Lex Christopherson
0585752d74 refactor(15-02): /gsd:plan-phase to thin orchestrator
- Reduced from 103 to 189 lines (thin orchestrator, not workflow)
- Added agent: gsd-planner frontmatter
- Removed all workflow/reference inclusions
- Orchestrator now: validate, parse, spawn agent, handle returns
- Planning methodology delegated to gsd-planner agent
2026-01-16 07:48:16 -06:00
Lex Christopherson
7ba0af81ba chore(15-03): deprecate planning-specific reference files
- principles.md: redirects to <philosophy> section
- plan-format.md: redirects to <plan_format> section
- scope-estimation.md: redirects to <scope_estimation> section
- goal-backward.md: redirects to <goal_backward> section

All content preserved in agents/gsd-planner.md

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-16 07:47:59 -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
d45261e36d feat(plan-phase): run in forked context
Adds context: fork and agent: general-purpose to plan-phase command.

This isolates the heavy discovery/synthesis work in a fresh 200k context
window, keeping the main conversation clean.

Removes AskUserQuestion from allowed-tools (workflow doesn't use it).
2026-01-16 07:32:38 -06:00
Lex Christopherson
32e68cde75 fix: remove zombie gsd-milestone-auditor agent
This agent was correctly deleted in f3e0e69 (subagents can't spawn
subagents), then accidentally re-added in d07ef33 during install fix.

The command audit-milestone.md is the orchestrator. No agent needed.
2026-01-16 07:30:30 -06:00
Lex Christopherson
159925c058 feat: add statusline with context usage, model, and current task
- Install statusline.sh to {claudeDir}/hooks/
- Configure statusLine in settings.json automatically
- Skip if statusline already exists (non-interactive)
- Prompt to keep/replace in interactive mode
- Add --force-statusline flag to override

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-16 07:12:11 -06:00
Lex Christopherson
83ecf38028 Add GitHub Sponsors funding configuration
Enables the Sponsor button on repo once sponsor account is approved.

Closes #95

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-16 06:18:23 -06:00
Lex Christopherson
db4cd3950d 1.5.17 2026-01-15 18:26:36 -06:00
Lex Christopherson
f16ffa5bb1 docs: update changelog for v1.5.17
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-15 18:26:32 -06:00
Lex Christopherson
7865f123ea feat(gsd): add update command with changelog display
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-15 18:21:02 -06:00
Lex Christopherson
46279f2d71 1.5.16 2026-01-15 17:31:44 -06:00
Lex Christopherson
6adf84b5ae docs: update changelog for v1.5.16 2026-01-15 17:31:41 -06:00
Lex Christopherson
a151696d30 refactor(research): inject rich context from orchestrators to agent
research-phase.md:
- Added <key_insight> framing ("what don't I know that I don't know")
- Added <downstream_consumer> explaining plan-phase integration
- Added <quality_gate> checklist

research-project.md:
- Added milestone context (greenfield vs v1.1+)
- Added <downstream_consumer> per dimension
- Added <quality_gate> per agent
- Enhanced roadmap implications guidance

gsd-researcher.md:
- Simplified <gsd_integration> to point to orchestrator-provided context
- Agent is now pure research capability, context is injected

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-15 17:29:50 -06:00
Lex Christopherson
411b5a369b feat(gsd): add dedicated codebase mapper agent
Reduces context exhaustion during /gsd:map-codebase by having agents
write documents directly instead of returning findings to orchestrator.

- Create gsd-codebase-mapper agent with embedded templates
- Agent understands downstream consumers (plan-phase, execute-plan)
- Parameterized by focus: tech, arch, quality, concerns
- Each focus writes specific documents directly to .planning/codebase/
- Orchestrator receives only confirmation + line counts

Context savings: ~40 lines returned vs potentially thousands of lines
of exploration findings previously transferred back to orchestrator.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-15 17:16:02 -06:00
Lex Christopherson
ae1c7f2d9d docs(14): add GSD integration context to researcher agent
Explains why research matters: output directly consumed by plan-phase.
Documents the contract between RESEARCH.md sections and planning workflow.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-15 17:15:54 -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
ac316e8fdd fix(new-milestone): add explicit MILESTONE-CONTEXT.md reference
The context section now includes @.planning/MILESTONE-CONTEXT.md so
Claude actually loads the file from discuss-milestone instead of just
seeing a text mention in the process steps.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-15 17:07:19 -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
ccac62d8ae docs(14-03): deprecate research-pitfalls.md reference
- Content consolidated into gsd-researcher agent
- Points to verification_protocol section in agent
- Preserved content below notice for reference
2026-01-15 17:04:47 -06:00
Lex Christopherson
faaeae25b1 feat(14-02): add research-subagent-prompt.md template
- Context-only template (92 lines)
- Matches debug-subagent-prompt.md pattern
- Research expertise lives in agent, not template
2026-01-15 17:04:05 -06:00
Lex Christopherson
fc67d2cd16 docs(14-03): deprecate workflows/research-project.md
- Workflow consolidated into gsd-researcher agent
- Points to agents/gsd-researcher.md as new location
- Kept file for git history traceability
2026-01-15 17:03:54 -06:00
Lex Christopherson
982faf16f8 refactor(14-03): convert research-project to thin orchestrator
- Command spawns 4 parallel gsd-researcher agents
- Stack, Features, Architecture, Pitfalls each get dedicated agent
- Orchestrator handles project analysis and synthesis
- Reduced from 138 + 427 workflow lines to 137 lines
2026-01-15 17:03:38 -06:00
Lex Christopherson
3ca6b1fef4 docs(14-02): deprecate workflows/research-phase.md
- Replace 458-line workflow with deprecation notice
- Point to agents/gsd-researcher.md as replacement
- Keep file for git history traceability
2026-01-15 17:03:33 -06:00
Lex Christopherson
94f3083c78 refactor(14-02): convert /gsd:research-phase to thin orchestrator
- Reduce from ~540 lines (command + workflow) to 130 lines
- Delegate research methodology to gsd-researcher agent
- Keep phase validation, context gathering in orchestrator
- Add spawn and continuation patterns for agent
2026-01-15 17:03:18 -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
2f8b55178e feat(14-01): create gsd-researcher agent with research methodology
- 4 research modes: ecosystem, feasibility, implementation, comparison
- Tool strategy with Context7 > Official docs > WebSearch hierarchy
- Source hierarchy with HIGH/MEDIUM/LOW confidence levels
- Complete verification protocol with known pitfalls
- Output formats for phase research, project research, comparisons
- Execution flow and structured returns to orchestrator

902 lines consolidated from ~1,200 lines of source material (25% reduction)
2026-01-15 16:59:36 -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
667d7097b5 docs(debugger): restore high-value examples and patterns
- Add rich code examples for investigation techniques (minimal
  reproduction, working backwards, differential debugging, etc.)
- Restore test-first debugging pattern with full process
- Add stability testing examples (parallel stress, race condition)
- Add hypothesis testing pitfalls table
- Add research vs reasoning decision tree and red flags
- Add combining techniques guidance

990 → 1,184 lines (+194 lines of actionable content)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-15 16:46:10 -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
9c6c60d532 refactor(13-02): simplify debug-subagent-prompt.md
- Reduced from 355 lines to 91 lines
- Removed embedded expertise (execution_context, checkpoint_behavior, investigation_protocol)
- Template now provides context only - agent has methodology
- Uses subagent_type="gsd-debugger"
2026-01-15 16:20:41 -06:00
Lex Christopherson
759968de14 docs(13-02): deprecate workflows/debug.md
- Replaced 665-line workflow with 14-line redirect
- Points to agents/gsd-debugger.md for debugging expertise
- Preserves git history while marking content as moved
2026-01-15 16:20:17 -06:00
Lex Christopherson
514ac2680f chore(13-03): deprecate debugging reference files with agent pointers
- debugging-mindset.md → agents/gsd-debugger.md <philosophy>
- hypothesis-testing.md → agents/gsd-debugger.md <hypothesis_testing>
- investigation-techniques.md → agents/gsd-debugger.md <investigation_techniques>
- verification-patterns.md → agents/gsd-debugger.md <verification_patterns>
- when-to-research.md → agents/gsd-debugger.md <research_vs_reasoning>

Eliminates duplicate content. Debugging expertise now lives solely in agent file.
2026-01-15 16:20:08 -06:00
Lex Christopherson
81c6c75b0e refactor(13-02): rewrite /gsd:debug as thin orchestrator
- Reduced from 202 lines to 149 lines
- Removed workflow/reference loading (expertise now in agent)
- Uses subagent_type="gsd-debugger" instead of "general-purpose"
- Keeps symptom gathering and checkpoint handling in orchestrator
2026-01-15 16:19:59 -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
7cefaf1145 feat(13-01): create gsd-debugger agent with consolidated debugging expertise
- All 12 sections present: role, philosophy, hypothesis_testing,
  investigation_techniques, verification_patterns, research_vs_reasoning,
  debug_file_protocol, execution_flow, checkpoint_behavior,
  structured_returns, modes, success_criteria
- Consolidated ~2,400 lines to 990 lines (59% reduction)
- Complete debugging methodology: scientific method, meta-debugging,
  cognitive biases, investigation techniques, verification patterns
- Full checkpoint and return format specifications
- Debug file protocol with update rules and status transitions
2026-01-15 16:16:25 -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
2b1fd968a7 docs: update changelog for v1.5.15 2026-01-15 15:46:50 -06:00
Lex Christopherson
0f96379a85 1.5.15 2026-01-15 15:44:10 -06:00
Lex Christopherson
d07ef33353 fix(install): include agents folder in npm package
The agents folder (gsd-executor, gsd-verifier, gsd-integration-checker,
gsd-milestone-auditor) was not being published to npm because it was
missing from the package.json files array.

Also adds the missing gsd-milestone-auditor.md agent.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-15 15:44:07 -06:00
Lex Christopherson
2869fee206 refactor(verify-work): consolidate plan-fix into plan-phase --gaps
Unify gap handling - whether discovered by code verification or user
testing, gaps feed into the same plan-phase --gaps workflow.

Changes:
- Delete commands/gsd/plan-fix.md (redundant)
- Update verify-work to route to plan-phase --gaps
- Update progress Route E to detect UAT gaps
- Change UAT.md "Issues" section to "Gaps" with YAML format
- Extend plan-phase --gaps to read from both VERIFICATION.md and UAT.md
- Update diagnose-issues to output gaps in YAML format
- Update all references (debug, templates, workflows)

One path: gap discovered → diagnosed → plan-phase --gaps → fixed

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-15 15:40:18 -06:00
Lex Christopherson
8c66a7167a perf(verify-work): batch UAT file writes instead of per-response
Write to file only on: issue found, every 5 passes, or completion.
Eliminates wasteful I/O while maintaining reasonable crash recovery.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-15 15:24:25 -06:00
Lex Christopherson
1ebd05b0ee 1.5.14 2026-01-15 14:38:34 -06:00
Lex Christopherson
12dda42253 docs: update changelog for v1.5.14 2026-01-15 14:38:19 -06:00
Lex Christopherson
0960882012 fix(plan-phase): always route to execute-phase regardless of plan count
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-15 14:37:34 -06:00