Files
msd-core/.planning/phases/13-debug-agent/13-03-PLAN.md
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

4.4 KiB

phase, plan, type, wave, depends_on, files_modified, autonomous, must_haves
phase plan type wave depends_on files_modified autonomous must_haves
13-debug-agent 03 execute 2
13-01
get-shit-done/references/debugging/debugging-mindset.md
get-shit-done/references/debugging/hypothesis-testing.md
get-shit-done/references/debugging/investigation-techniques.md
get-shit-done/references/debugging/verification-patterns.md
get-shit-done/references/debugging/when-to-research.md
true
truths artifacts key_links
Reference files replaced with pointers to agent
No duplicate content between references and agent
path provides contains
get-shit-done/references/debugging/debugging-mindset.md Redirect to gsd-debugger agent gsd-debugger
from to via pattern
get-shit-done/references/debugging/*.md agents/gsd-debugger.md redirect notice agents/gsd-debugger
Deprecate debugging reference files with pointers to gsd-debugger agent.

Purpose: Eliminate duplicate content. Debugging expertise now lives solely in the agent file.

Output: 5 reference files reduced to redirect notices.

<execution_context> @/.claude/get-shit-done/workflows/execute-plan.md @/.claude/get-shit-done/templates/summary.md </execution_context>

@.planning/PROJECT.md @.planning/ROADMAP.md @.planning/STATE.md @.planning/phases/13-debug-agent/13-01-SUMMARY.md

Agent that now contains this content:

@agents/gsd-debugger.md

Task 1: Deprecate all debugging reference files get-shit-done/references/debugging/debugging-mindset.md get-shit-done/references/debugging/hypothesis-testing.md get-shit-done/references/debugging/investigation-techniques.md get-shit-done/references/debugging/verification-patterns.md get-shit-done/references/debugging/when-to-research.md Replace each file with a redirect notice pointing to the agent.

Template for each file (~15 lines):

# [Original Title] (DEPRECATED)

This reference has been consolidated into the `gsd-debugger` agent.

**Location:** `agents/gsd-debugger.md`

**Section:** `<[relevant_section_name]>`

**Reason:** Debugging expertise is now baked into the agent. Loading separate reference files into orchestrator context was wasteful (~95% context reduction).

See `agents/gsd-debugger.md` for the consolidated debugging methodology.

Specific mappings:

  1. debugging-mindset.md → <philosophy> section
  2. hypothesis-testing.md → <hypothesis_testing> section
  3. investigation-techniques.md → <investigation_techniques> section
  4. verification-patterns.md → <verification_patterns> section
  5. when-to-research.md → <research_vs_reasoning> section

Each file should be ~15 lines with the redirect notice. All 5 files exist with redirect notices. Each file is <20 lines. Each file points to agents/gsd-debugger.md. Each file specifies the relevant section in the agent. All debugging reference files deprecated with agent pointers

Task 2: Update installer to include agents directory bin/install.js Verify that `bin/install.js` copies the `agents/` directory during installation.

Check if agents/ is already included. If not, add it to the copy list.

Expected behavior:

  • agents/*.md files copied to ~/.claude/agents/ (global) or .claude/agents/ (local)
  • Similar to how commands/, get-shit-done/, etc. are handled

If already handled: No changes needed, note in summary. If not handled: Add agents directory to the copy list. Run: node bin/install.js --local --dry-run (if dry-run exists) or check install.js code Confirm agents/ directory will be copied on install. Installer copies agents/ directory

Before declaring plan complete: - [ ] All 5 debugging reference files are <20 lines each - [ ] All 5 files point to agents/gsd-debugger.md - [ ] Each file specifies the section in the agent - [ ] Installer handles agents/ directory

<success_criteria>

  • Debugging reference files deprecated
  • No duplicate content between references and agent
  • Installer copies agents directory </success_criteria>
After completion, create `.planning/phases/13-debug-agent/13-03-SUMMARY.md`