# debugger

Субагент debugger находит корневую причину бага: строит гипотезы, проверяет их логами и трассировкой кода, код не правит.

- субагент · `type=agent` · Claude Code, Codex, Cursor · ★ 489 у репозитория
- Автор: josstei
- Лицензия: Apache-2.0 · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/josstei/maestro-orchestrate/tree/HEAD/antigravity/src/agents/debugger.md
- Обновлён: 2026-10-26
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/agents/josstei-debugger

## Что делает

Субагент `debugger` разбирает баги по шагам: сначала фиксирует разницу между ожидаемым и реальным поведением, потом формирует 2-3 гипотезы о причине и проверяет каждую через анализ стектрейса, логов и состояния кода. Для поиска момента, когда баг появился, использует `git log` и бисекцию коммитов, а для сопоставления по времени сверяет логи приложения, базы данных и инфраструктуры.

Каждую улику он помечает как подтверждающую, противоречащую или нейтральную. Вывод о причине агент делает только если набралось минимум три подтверждения и ноль противоречий, и причина объясняет все симптомы, а не часть. Если гипотезы не подтвердились, он честно сообщает, что уже исключил.

По инструменту: доступны только чтение файлов, поиск и выполнение shell-команд — править код `debugger` не умеет и передаёт результат другим агентам, например `coder` с точным местом `file:line` или `tester` с шагами воспроизведения.

## Установка

### Claude Code (родная платформа)

**Вручную: положить файлы**
- Файл: `.claude/agents/debugger.md` — Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

### Codex

**Вручную: положить файлы**
- Файл: `.codex/agents/debugger.toml` — Codex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/agents/debugger.md` — Cursor понимает и .claude/agents/

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/josstei/maestro-orchestrate/tree/HEAD/antigravity/src/agents/debugger.md

## Когда брать
- найти причину падающего теста без правок кода
- разобрать стектрейс и понять, где баг появился
- вычислить коммит, после которого всё сломалось
- сопоставить логи из разных источников по времени
- отличить совпадение по времени от реальной причины

## Примеры запросов агенту
- Разберись, почему API отдаёт 500 на эндпоинте оплаты
- Найди причину, почему запросы к базе стали в 10 раз медленнее после деплоя
- Выясни, почему тест падает нестабильно

## Похожие
- [rca-debugger](https://affpapa.org/nevibecode/agents/rca-debugger.md) — субагент · ★ 880 у репозитория
- [root-cause-analysis](https://affpapa.org/nevibecode/skills/autohandai-root-cause-analysis.md) — скилл · ★ 219 у репозитория
- [systematic-debugging](https://affpapa.org/nevibecode/skills/sammcj-systematic-debugging.md) — скилл · ★ 173 у репозитория
- [debugging-toolkit-debugger](https://affpapa.org/nevibecode/agents/debugging-toolkit-debugger.md) — субагент · ★ 42780 у репозитория
- [codex-debugger](https://affpapa.org/nevibecode/agents/codex-debugger.md) — субагент · ★ 195 у репозитория
- [debug](https://affpapa.org/nevibecode/skills/cyrusagents-debug.md) — скилл · 871 установка

## Другие версии с тем же именем
- [debugger · voltagent](https://affpapa.org/nevibecode/agents/debugger.md) — 13459 установок
- [debugger · voltagent](https://affpapa.org/nevibecode/agents/voltagent-debugger.md) — ★ 6505 у репозитория
- [debugger · rohitg00](https://affpapa.org/nevibecode/agents/rohit-ghumare-debugger.md) — ★ 2966 у репозитория
- [debugger · cloudai-x](https://affpapa.org/nevibecode/agents/cloudai-x-debugger.md) — ★ 1424 у репозитория
- [debugger · qdhenry](https://affpapa.org/nevibecode/agents/qdhenry-debugger.md) — ★ 1357 у репозитория

Из того же набора: [josstei/maestro-orchestrate](https://affpapa.org/nevibecode/by/josstei/maestro-orchestrate.md) — 40 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
