debugger · qdhenry — Claude Code subagent: what it does, how to install
debugger — a targeted troubleshooting subagent for Claude Code that isolates root causes, inspects test failures, and writes minimal diffs.
no license ★ 1,357 updated 2026-03-01
.claude/agents/debugger.mdWhat debugger does
This subagent handles defects through structured diagnosis rather than quick symptom fixes. When builds break or runtime behavior drifts, it evaluates stack traces, sets up reproduction hypotheses, and identifies the exact line responsible. It deliberately rejects feature creep: the protocol enforces minimal code modifications and strictly forbids adding extra capabilities during a fix.
The definition relies on the sonnet model paired with core file tools, Bash, web lookups, and task management. It also connects to external integrations: sequential-thinking manages multi-step deductive analysis, while context7 pulls framework documentation. Keep in mind that lacking those two MCP servers in your environment limits its dedicated research capabilities.
Each diagnostic pass yields a structured summary containing root-cause analysis, supporting log evidence, a unified diff, and a verification recipe to stop regressions.
What it helps with
- diagnose root causes from crash logs and stack traces
- investigate flaky and failing test suites
- produce focused unified diffs without touching unrelated logic
- draft verification plans to prevent future regressions
Example prompts for the agent
- Investigate the latest test failure and provide a unified diff
- Analyze this crash trace and isolate the faulty state logic
- Help reproduce this intermittent error and propose a verification plan
How to install debugger
Manually: put the files in place
.claude/agents/debugger.mdFor all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention
Manually: put the files in place
.codex/agents/debugger.tomlCodex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/
Manually: put the files in place
.cursor/agents/debugger.mdCursor also reads .claude/agents/
Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean
Questions about debugger
How to install debugger in Claude Code?
Place the subagent markdown configuration at .claude/agents/debugger.md in your repository.
What does the debugger subagent do?
It diagnoses unexpected behavior, isolates the core issue behind test failures, and provides a small targeted diff alongside prevention steps.
Which MCP servers does debugger use?
Its tools list includes mcp__sequential-thinking__sequentialthinking for deduction steps and mcp__context7 helpers for library reference lookup.
Similar subagents
All subagents for Testing and QA →debugger by other authors comes first.