Commit Graph

381 Commits

Author SHA1 Message Date
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
Lex Christopherson
d7826b7091 1.5.13 2026-01-15 13:11:51 -06:00
Lex Christopherson
960b5fcdf0 docs: update changelog for v1.5.13 2026-01-15 13:11:47 -06:00
Lex Christopherson
794e08412b fix(new-milestone): present research as equal option in routing
Match new-project format — both research-project and define-requirements
shown as equal paths with guidance on when to use each.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-15 13:10:10 -06:00
Lex Christopherson
25ced25b29 1.5.12 2026-01-15 13:03:14 -06:00
Lex Christopherson
ed9e8cadd5 docs: update changelog for v1.5.12 2026-01-15 13:03:10 -06:00
Lex Christopherson
d1c1c1790a fix(progress): add Route F for between-milestones state
When ROADMAP.md is missing but PROJECT.md exists (after complete-milestone),
progress now correctly routes to /gsd:discuss-milestone instead of suggesting
new-project.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-15 13:01:54 -06:00
Lex Christopherson
60070b9b7a fix(audit): version MILESTONE-AUDIT.md and archive on completion
- audit-milestone: create v{version}-MILESTONE-AUDIT.md (versioned)
- complete-milestone: move audit file to milestones/ archive
- plan-milestone-gaps: find versioned audit file

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-15 13:00:12 -06:00
Lex Christopherson
2d3a1eadda refactor(milestone): rework milestone cycle for proper requirements flow
- complete-milestone: archive + delete ROADMAP.md and REQUIREMENTS.md
- new-milestone: brownfield new-project (updates PROJECT.md, routes to requirements)
- discuss-milestone: now required before new-milestone (creates context file)
- research-project: milestone-aware (focuses on new features, not validated ones)
- create-roadmap: continues phase numbering from previous milestone

Flow: complete → discuss → new-milestone → research → requirements → roadmap

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-15 12:57:33 -06:00
Lex Christopherson
c986eae851 1.5.11 2026-01-15 11:51:40 -06:00
Lex Christopherson
176c653272 docs: update changelog for v1.5.11 2026-01-15 11:51:36 -06:00
Lex Christopherson
0f9f802828 docs(verifier): clarify step flow for re-verification mode
Step 0 now explicitly states to skip to Step 3 when in re-verification
mode. Steps 1-2 marked as "Initial Mode Only" to make flow clear.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-15 11:50:32 -06:00
Lex Christopherson
da95980dfd perf(verifier): reuse previous must-haves on re-verification
When VERIFICATION.md already exists with gaps, verifier now:
- Loads previous must-haves instead of re-deriving
- Focuses deep verification on failed items
- Quick regression check on passed items
- Tracks re-verification metadata (gaps_closed, regressions)

Saves tokens by not starting from scratch after gap closure.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-15 11:49:16 -06:00
Lex Christopherson
53b1ff8f91 1.5.10 2026-01-15 11:37:30 -06:00
Lex Christopherson
1cf5360815 docs: update changelog for v1.5.10 2026-01-15 11:37:26 -06:00
Lex Christopherson
70cfd76c21 fix(execute-phase): include VERIFICATION.md in phase completion commit
Phase completion commit now stages VERIFICATION.md alongside ROADMAP.md,
STATE.md, and REQUIREMENTS.md so verification results are tracked.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-15 11:35:53 -06:00
Lex Christopherson
7b62452200 refactor(audit-milestone): read existing verifications instead of re-verifying
Milestone audit now reads existing VERIFICATION.md files from phases
(already created during execute-phase) rather than spawning verifiers
again. Aggregates tech debt and deferred gaps, then runs integration
checker for cross-phase wiring. Adds tech_debt status for non-blocking
accumulated debt.

Also adds VERIFICATION.md to phase completion commit in execute-phase.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-15 11:34:43 -06:00
Lex Christopherson
adc0bd6fa7 1.5.9 2026-01-15 11:25:13 -06:00
Lex Christopherson
a840743887 docs: update changelog for v1.5.9 2026-01-15 11:25:10 -06:00
Lex Christopherson
1325d3077d refactor: remove domain expertise feature
The ~/.claude/skills/expertise/ system was personal tooling
that doesn't exist for other users. Removed from:
- create-roadmap workflow (detect_domain step)
- plan-phase workflow (domain loading)
- roadmap template (Domain Expertise section)
- phase-prompt template (domain frontmatter)
- plan-format reference (domain field)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-15 11:22:39 -06:00
Lex Christopherson
931592c944 style(agents): update subagent colors
- gsd-executor: blue → yellow
- gsd-integration-checker: cyan → blue

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-15 11:15:35 -06:00
Lex Christopherson
5fcb2d7f19 chore: remove tracked .claude/ files (already gitignored)
These files were committed before .claude/ was added to .gitignore.
Removing from tracking as they're local install artifacts.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-15 11:15:31 -06:00
Lex Christopherson
b150254e63 style(checkpoints): update command and workflow to match new format
Sync execute-plan command and workflow with improved checkpoint display:
- Box header with ╔═══╗ for visual prominence
- Progress indicator at top
- Separator line before unmissable "→ YOUR ACTION:" prompt

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-15 11:11:36 -06:00
Lex Christopherson
c196434f9f style(checkpoints): improve visual formatting with box headers
Use double-line box for checkpoint headers with clear visual hierarchy:
- Progress and task info at top
- Content details in middle
- Separator line before unmissable "→ YOUR ACTION:" prompt

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-15 11:03:09 -06:00
Lex Christopherson
f3e0e69ce6 refactor(audit-milestone): command is orchestrator, not subagent
Subagents can't spawn subagents. The command itself orchestrates:
- Wave 1: Spawn gsd-verifier per phase (parallel)
- Wave 2: Spawn gsd-integration-checker
- Aggregate results into MILESTONE-AUDIT.md

Remove gsd-milestone-auditor agent (command does this now).

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-15 10:56:26 -06:00
Lex Christopherson
6b4f73efd8 fix(execute-phase): recommend audit-milestone when milestone completes
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-15 10:54:03 -06:00
Lex Christopherson
02d0c47c58 docs(milestone-auditor): clarify parallel Task spawning
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-15 10:52:53 -06:00
Lex Christopherson
6630c3217d feat(milestone): add milestone audit system
- Add /gsd:audit-milestone command (spawns auditor)
- Add gsd-milestone-auditor agent (orchestrates verification)
- Add gsd-integration-checker agent (cross-phase wiring + E2E flows)
- Add /gsd:plan-milestone-gaps command (creates phases from audit gaps)
- Update complete-milestone to recommend audit first

Flow: audit-milestone → plan-milestone-gaps → execute phases → re-audit → complete-milestone

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-15 10:50:58 -06:00
Lex Christopherson
b920d47cb1 fix(research-phase): remove domain gatekeeping
The when_to_use section was overly restrictive, refusing research
for "standard" domains. Research benefits any unfamiliar territory,
not just niche technical domains.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-01-15 10:50:11 -06:00
Lex Christopherson
e78321e1cb 1.5.8 2026-01-15 10:45:29 -06:00
Lex Christopherson
4703d48110 docs: update changelog for v1.5.8
Co-Authored-By: Claude <noreply@anthropic.com>
2026-01-15 10:45:25 -06:00
Lex Christopherson
f9edfcf6b4 style: update executor color to blue, format verifier
Co-Authored-By: Claude <noreply@anthropic.com>
2026-01-15 10:43:01 -06:00
Lex Christopherson
8e6ad96af1 feat(verification): add verify → plan → execute loop for gap closure
- Add verify_phase_goal step to execute-phase workflow
- Verifier outputs structured gaps: YAML for planner consumption
- Add --gaps flag to plan-phase for gap closure mode
- Route by verification status: passed, gaps_found, human_needed
- Gap closure creates sequential plans (04, 05...) from verification gaps
- User stays in control at each decision point

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-15 10:34:38 -06:00