# gsd-debugger

Субагент gsd-debugger ищет первопричину багов через проверяемые гипотезы, ведёт журнал отладки и запрашивает подтверждения на контрольных точках.

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

## Что делает

Субагент запускается через команду `/gsd:debug` или воркфлоу `diagnose-issues`. Вместо слепых правок он применяет научный метод: формулирует опровержимые гипотезы, ставит изолированные эксперименты и отсекает ложные следы бинарным поиском по кодовой базе.

В распоряжении агента стандартные инструменты: `Read`, `Write`, `Edit`, `Bash`, `Grep`, `Glob` и `WebSearch`. Состояние сессии сохраняется в отдельном файле отладки, поэтому контекст расследования не теряется при сбросе диалога. Если автономно подтвердить причину сбоя невозможно, агент создаёт чекпоинт и ждёт действий пользователя.

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

## Установка

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

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

### Codex

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

### Cursor

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

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

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

## Примеры запросов агенту
- /gsd:debug счётчик кликов увеличивается на 2 вместо 1 при одном нажатии
- /gsd:debug форма отправки падает с ошибкой валидации только на проде
- Запусти отладку через gsd-debugger и выясни причину утечки памяти при смене роута

## Похожие
- [debugger](https://affpapa.org/nevibecode/skills/zhaono1-debugger.md) — скилл · 756 установок
- [llm-debugger](https://affpapa.org/nevibecode/skills/llm-debugger.md) — скилл · 259 установок
- [gem-debugger](https://affpapa.org/nevibecode/agents/gem-debugger.md) — субагент · ★ 41430 у репозитория
- [debugging-toolkit-debugger](https://affpapa.org/nevibecode/agents/debugging-toolkit-debugger.md) — субагент · ★ 42780 у репозитория
- [root-cause-debugger](https://affpapa.org/nevibecode/agents/root-cause-debugger.md) — субагент · ★ 4719 у репозитория
- [browser-debugger](https://affpapa.org/nevibecode/agents/browser-debugger.md) — субагент · ★ 6505 у репозитория

Из того же набора: [davepoon/buildwithclaude](https://affpapa.org/nevibecode/by/davepoon/buildwithclaude.md) — 235 карточек

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

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