Commit Graph

421 Commits

Author SHA1 Message Date
Lex Christopherson
fb0ba88428 feat(16-02): add planner -> checker verification loop to plan-phase
- Steps 1-7: Validate, parse, spawn planner (existing flow)
- Step 8: Spawn gsd-plan-checker with verification_context
- Step 9: Handle checker return (passed | issues)
- Step 10: Revision loop (max 3 iterations)
- Step 11: Present final status with verification outcome

User sees ping-pong between planner and checker in main context.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-16 08:59:59 -06:00
Lex Christopherson
8420752585 docs(16-03): update role section to document revision mode
- Add revision mode spawning to orchestrator list
- Add revision responsibility to core responsibilities
2026-01-16 08:59:44 -06:00
Lex Christopherson
6b31a920dd feat(16-03): add revision_mode section to gsd-planner
- 6-step revision process for handling checker feedback
- Strategy table mapping issue dimensions to revision actions
- Surgeon mindset: minimal targeted updates to existing plans
- Return format for revision summary
2026-01-16 08:59:20 -06:00
Lex Christopherson
58df1ba1e1 chore(16-02): update plan-phase.md frontmatter for verification loop
- Remove context: fork (orchestrator stays in main context)
- Add --skip-verify flag to argument-hint
- Add Task tool to allowed-tools for spawning checker

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-16 08:58:55 -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
47eab1a2b0 feat(16-01): create gsd-plan-checker agent
Goal-backward plan verification before execution:
- Six verification dimensions (coverage, completeness, dependencies, links, scope, derivation)
- Structured issue reporting for planner feedback
- Examples covering common failure modes

agents/gsd-plan-checker.md (744 lines)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-16 08:56:31 -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
70fa2ad740 feat(15-02): create planner-subagent-prompt.md template
- Context-only template for spawning gsd-planner
- Contains planning_context, downstream_consumer, quality_gate sections
- Includes continuation template for checkpoints
- Follows debug-subagent-prompt.md pattern
2026-01-16 07:48:56 -06:00
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