# debug

Правило debug задаёт порядок отладки: сначала собрать наблюдения и контекст, затем объяснить причину и править код. Включается, когда ошибка не сдаётся или фикс неполный.

- правило · `type=rule` · Claude Code, Cline, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop) · ★ 1054 у репозитория
- Автор: Bhartendu-Kumar
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/Bhartendu-Kumar/rules_template/tree/HEAD/.cursor/rules/debug.mdc
- Обновлён: 2025-07-17
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/rules/debug

## Что делает

Правило `debug` описывает порядок работы, когда ошибка не сдалась с первого раза или исправление вышло половинчатым. Пока агент не застрял, оно не применяется: в описании прямо сказано включать его только в тупике.

Сначала собираются сообщения об ошибке, логи и симптомы, к ним добавляется контекст из файлов. Архитектура проекта, план и текущая задача подтягиваются из `@memory.mdc`. Дальше агент перечисляет наблюдения и объясняет, почему причина именно эта, а не соседняя. Если фактов мало, он добирает их и может попросить уточнение.

Правка идёт последней. Сперва разбор кода через `<ANALYZE CODE>` и поиск похожих решённых случаев в `@error-documentation.mdc`, затем фикс через `<SYSTEMATIC CODE PROTOCOL>` и `<TESTING>`. Оба блока живут в `implement.mdc` из того же репозитория, поэтому без этого файла часть шагов рутины останется без определения.

## Установка

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

**Вручную: положить файлы**
- Файл: `.cursor/rules/debug.mdc` — Во frontmatter: description, globs, alwaysApply

### Claude Code

**Вручную: положить файлы**
- Файл: `.claude/rules/debug.md` — Поле paths во frontmatter ограничивает файлы: globs из источника → paths

### Codex

**AGENTS.md**
- Codex читает AGENTS.md: вставьте текст правила туда

### GitHub Copilot

**Вручную: положить файлы**
- Файл: `.github/instructions/debug.instructions.md` — Поле applyTo задаёт, к каким файлам применять: globs из источника → applyTo

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/rules/debug.md`

### Cline

**Вручную: положить файлы**
- Файл: `.clinerules/debug.md`

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/Bhartendu-Kumar/rules_template/tree/HEAD/.cursor/rules/debug.mdc

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

## Примеры запросов агенту
- Тест `test_cart.py` падает третий раз, включи рутину `debug` и сначала собери наблюдения.
- Не правь код наугад: пройди по шагам и объясни, почему падает сборка.
- Посмотри `@error-documentation.mdc`, может там уже был такой случай, и только потом предлагай фикс.

## Похожие
- [debug-my-harness](https://affpapa.org/nevibecode/skills/debug-my-harness.md) — скилл · 1500 установок
- [debug-issue](https://affpapa.org/nevibecode/skills/debug-issue.md) — скилл · 1100 установок
- [gjalla-debug](https://affpapa.org/nevibecode/skills/gjalla-debug.md) — скилл · 357 установок
- [vue-debug-guides](https://affpapa.org/nevibecode/skills/vue-debug-guides.md) — скилл · 28400 установок
- [no-workarounds](https://affpapa.org/nevibecode/skills/no-workarounds.md) — скилл · 593 установки
- [debug-mantra](https://affpapa.org/nevibecode/skills/debug-mantra.md) — скилл · 5100 установок

Из того же набора: [bhartendu-kumar/rules_template](https://affpapa.org/nevibecode/by/bhartendu-kumar/rules_template.md) — 11 карточек

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