Skip to main content
subagent CX Codex

debugger · justxor — Claude Code subagent: debugging and setup

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.

MIT ★ 353 updated 2026-10-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

debugger starts by recording the symptom, such as an error message, stack trace, or reproduction steps. It runs a command or test, forms hypotheses, and checks them, adding temporary logging when needed. Its available tools are Read, Edit, Grep, Glob, and Bash.

Once it finds the root cause, the subagent makes a minimal change, removes temporary logs, and reruns the check. Its report covers the cause, supporting evidence, the fix, and how to prevent the issue from recurring. The model is inherited from the main Claude Code configuration, so this agent file does not select a separate model.

What it helps with

  • reproduce an error from its stack trace
  • test hypotheses about a failing test
  • trace unexpected behavior to its cause
  • fix a defect and rerun the check

Example prompts for the agent

  • Investigate this stack trace, reproduce the error, and identify its root cause.
  • Find out why this test fails, fix the issue, and run the test again.
  • Track down this unexpected behavior and explain how to prevent it from recurring.

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 do I install debugger in Claude Code?

Add the agent file at .claude/agents/debugger.md.

What does debugger do?

It reproduces errors and test failures, checks possible causes, and applies a minimal fix. It then reruns the check and reports what it found.

Which tools can debugger use?

The subagent has access to Read, Edit, Grep, Glob, and Bash. It inherits the model from the main Claude Code configuration.

Source text

debugger.md · MIT
---
name: debugger
description: Специалист по отладке ошибок, падающих тестов и неожиданного поведения. Используй при любой ошибке или стектрейсе.
tools: Read, Edit, Grep, Glob, Bash
model: inherit
---

Ты эксперт по отладке. Работай методично:

1. Зафиксируй симптом: сообщение об ошибке, стектрейс, шаги воспроизведения.
2. Воспроизведи проблему (команда/тест).
3. Сформулируй 2–3 гипотезы, проверяй от наиболее вероятной. Добавляй временное логирование при необходимости.
4. Найди первопричину, а не симптом.
5. Сделай минимальное исправление, убери временное логирование.
6. Подтверди исправление запуском теста/команды.

Отчёт: первопричина, доказательства, исправление, как предотвратить в будущем.

© justxor · MIT · justxor/claude-code-pro-course

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 qdhenry debugger — a targeted troubleshooting subagent for Claude Code that isolates root causes, inspects test failures, and writes minimal diffs. CX Codex ★ 1,357repo stars llm-debugger patricio0312rev llm-debugger diagnoses LLM output failures, patches faulty prompts, refines tool schemas, and generates regression test cases. CX Codex +1 259installs gem-debugger official github gem-debugger is a GitHub Copilot subagent that traces failures, reads stack traces, and helps reproduce errors. It handles regression diagnosis without editing code. CX Codex +1 ★ 41,430repo 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 gsd-debugger davepoon gsd-debugger investigates bugs using falsifiable hypotheses, manages persistent debug sessions, and handles checkpoints when manual input is needed. CX Codex ★ 3,785repo stars root-cause-debugger zebbern The root-cause-debugger subagent for Claude Code and Codex reproduces failures and finds bug root causes before code changes. It helps diagnose bugs without editing code. CX Codex ★ 4,719repo stars browser-debugger VoltAgent The browser-debugger subagent reproduces browser failures, gathers UI and network evidence, and helps trace client-side bugs to their cause. CX Codex ★ 6,505repo stars

From the same set15

The whole set →
testing testing sets automated test standards for Claude Code: Arrange-Act-Assert structure, banned sleep calls, and strict boundaries for mocks. CX Codex +1 ★ 353repo stars review This skill checks code changes for security issues and exposed secrets, then reports findings with risk levels and file locations. Run it before a merge or when asked for a security review. CX Codex +1 ★ 353repo stars fix-issue fix-issue — a skill that runs the full cycle of fixing a GitHub issue by number — from analysis and test to commit. CX Codex +1 ★ 353repo stars test-runner test-runner runs tests on modified files, diagnoses failures, and distinguishes real code bugs from outdated test suites. CX Codex ★ 353repo stars docs-writer docs-writer — a subagent that updates README, API docs, code comments, and ADRs whenever your code changes. It verifies actual behavior and keeps examples aligned with reality. CX Codex ★ 353repo stars pr-description pr-description generates clear pull request titles and descriptions by inspecting branch commits and diffs against main. CX Codex +1 ★ 353repo stars architect The architect subagent examines a project before implementation, compares design options, and lays out a change plan. Use it to scope a feature or a major refactor. CX Codex ★ 353repo stars code-reviewer code-reviewer reads your diff, flags security holes, missing tests and edge cases, then returns a severity-sorted report with a file and line for each fix. CX Codex ★ 353repo stars

Project sponsors

Companies that keep this analytics open