# debugger

debugger — a targeted troubleshooting subagent for Claude Code that isolates root causes, inspects test failures, and writes minimal diffs.

- subagent · `type=agent` · Claude Code, Codex, Cursor · ★ 1357 repo stars
- Author: qdhenry
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/qdhenry/Claude-Command-Suite/tree/HEAD/.claude/agents/quality-testing/debugger.md
- Updated: 2026-03-01
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/agents/qdhenry-debugger

## What it 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.

## Install

### Claude Code (native platform)

**Manually: put the files in place**
- File: `.claude/agents/debugger.md` — For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

### Codex

**Manually: put the files in place**
- File: `.codex/agents/debugger.toml` — Codex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/

### Cursor

**Manually: put the files in place**
- File: `.cursor/agents/debugger.md` — Cursor also reads .claude/agents/

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/qdhenry/Claude-Command-Suite/tree/HEAD/.claude/agents/quality-testing/debugger.md

## When to use it
- 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
- 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

## Similar
- [debugging-toolkit-debugger](https://affpapa.org/en/nevibecode/agents/debugging-toolkit-debugger.md) — subagent · ★ 42780 repo stars
- [general-debugger](https://affpapa.org/en/nevibecode/agents/general-debugger.md) — subagent · ★ 372 repo stars
- [systematic-debugging](https://affpapa.org/en/nevibecode/skills/systematic-debugging.md) — skill · 306118 installs
- [principle-attack-the-premise](https://affpapa.org/en/nevibecode/skills/principle-attack-the-premise.md) — skill · 10100 installs
- [debugging](https://affpapa.org/en/nevibecode/skills/sentimony-debugging.md) — skill · 2800 installs
- [root-cause-tracing](https://affpapa.org/en/nevibecode/skills/root-cause-tracing.md) — skill · 1400 installs

## Other versions with the same name
- [debugger · voltagent](https://affpapa.org/en/nevibecode/agents/debugger.md) — 13459 installs
- [debugger · voltagent](https://affpapa.org/en/nevibecode/agents/voltagent-debugger.md) — ★ 6505 repo stars
- [debugger · rohitg00](https://affpapa.org/en/nevibecode/agents/rohit-ghumare-debugger.md) — ★ 2966 repo stars
- [debugger · cloudai-x](https://affpapa.org/en/nevibecode/agents/cloudai-x-debugger.md) — ★ 1424 repo stars
- [debugger · justxor](https://affpapa.org/en/nevibecode/agents/justxor-debugger.md) — ★ 353 repo stars

From the same set: [qdhenry/claude-command-suite](https://affpapa.org/en/nevibecode/by/qdhenry/claude-command-suite.md) — 112 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
