Skip to main content
subagent CX Codex

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

Install into Claude Code · Manually: put the files in place All methods and platforms ↓
.claude/agents/debugger.md
Open on GitHub

What 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.md

For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

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.

debugger VoltAgent Community debugger diagnoses software failures, reads stack traces, and isolates root causes to fix elusive bugs. Helpful when logs alone do not explain a crash. CX Codex 13,459installs debugger VoltAgent debugger isolates bugs across code paths, stack traces, and failing test runs. It pinpoints the defect and recommends a minimal fix. CX Codex ★ 6,505repo stars debugger Rohit Ghumare debugger is a Claude Code subagent that investigates difficult bugs, failed tests, and runtime errors. It traces the cause before proposing a code change. CX Codex ★ 2,966repo stars debugger CloudAI-X debugger finds root causes for test failures, memory leaks, and crashes. The subagent tests hypotheses systematically instead of guessing fixes. CX Codex ★ 1,424repo stars debugger justxor The debugger subagent reproduces errors and failing tests, tracks down their cause, then checks the fix. Use it when a stack trace or unexpected behavior needs investigation. CX Codex ★ 353repo stars debugging-toolkit-debugger Seth Hobson The debugging-toolkit-debugger subagent investigates errors, failed tests, and odd behavior by tracing failures to their cause and checking a focused fix. CX Codex ★ 42,780repo stars general-debugger Giuseppe Trisciuoglio general-debugger takes a crash or a failing test down to the line that caused it: reads the stack trace, walks the execution path backwards, then suggests a small fix. CX Codex ★ 372repo stars systematic-debugging Jesse Vincent systematic-debugging is a Claude Code and Codex skill that blocks fixes until root cause analysis is complete. It activates on test failures, bugs, or unexpected behavior. CX Codex +1 306,118installs principle-attack-the-premise backnotprop principle-attack-the-premise is a Claude Code skill that tests a shared premise after two or more fixes fail at the same gate. It checks the assumption before another fix is written. CX Codex +1 10,100installs debugging sentimony debugging enforces root-cause discipline during bug investigations. Prevents the agent from modifying code until it proves why a failure happens. CX Codex +1 2,800installs root-cause-tracing NeoLabHQ root-cause-tracing — a skill that walks the agent backward through the call stack until it finds the original trigger, then fixes there instead of at the crash site. CX Codex +1 1,400installs

From the same set112

The whole set →
documentation-expert documentation-expert is a Claude Code subagent for creating and maintaining software documentation. It can handle requests for API references, user guides, and documentation structure. CX Codex ★ 1,357repo stars commit Generates task-aligned Conventional Commits, tracks status transitions, and validates changed files against task scopes. CX Codex +1 ★ 1,357repo stars incident-responder incident-responder guides production incident response, from assessing impact and coordinating roles to restoring service and documenting follow-up work. CX Codex ★ 1,357repo stars quick-spec quick-spec reads your codebase, asks up to 10 questions and writes a focused spec file. Built for plain features and refactors where a full elicitation round is overkill. CX Codex +1 ★ 1,357repo stars extract-video-frames The extract-video-frames skill samples video at a chosen interval and saves matching audio clips when a soundtrack is present. Use it to prepare a recording for visual review, transcription, or handoff to another agent. CX Codex +1 ★ 1,357repo stars svelte-storybook svelte-storybook documents SvelteKit components in Storybook and writes the story files with Svelte CSF. Handy when a single component needs checking away from the running app. CX Codex ★ 1,357repo stars data-scientist data-scientist analyzes metrics, constructs advanced SQL workflows, and optimizes BigQuery queries to control data scanning costs. CX Codex ★ 1,357repo stars ux-designer The ux-designer subagent shapes interfaces around user tasks, accessibility, and ease of use. It fits research, interaction design, testing, and handoff work. CX Codex ★ 1,357repo stars

Project sponsors

Companies that keep this analytics open