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
.claude/agents/debugger.mdWhat 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.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 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.