debug — правило для Claude Code и Cline: рутина отладки
Правило debug задаёт порядок отладки: сначала собрать наблюдения и контекст, затем объяснить причину и править код. Включается, когда ошибка не сдаётся или фикс неполный.
лицензия не указана ★ 1 054 обновлён 2025-07-17
.cursor/rules/debug.mdcЧто делает debug
Правило debug описывает порядок работы, когда ошибка не сдалась с первого раза или исправление вышло половинчатым. Пока агент не застрял, оно не применяется: в описании прямо сказано включать его только в тупике.
Сначала собираются сообщения об ошибке, логи и симптомы, к ним добавляется контекст из файлов. Архитектура проекта, план и текущая задача подтягиваются из @memory.mdc. Дальше агент перечисляет наблюдения и объясняет, почему причина именно эта, а не соседняя. Если фактов мало, он добирает их и может попросить уточнение.
Правка идёт последней. Сперва разбор кода через <ANALYZE CODE> и поиск похожих решённых случаев в @error-documentation.mdc, затем фикс через <SYSTEMATIC CODE PROTOCOL> и <TESTING>. Оба блока живут в implement.mdc из того же репозитория, поэтому без этого файла часть шагов рутины останется без определения.
Какие задачи решает
- разобрать тест, который падает который раз подряд, вместо латания наугад
- собрать логи, симптомы и контекст файлов до правки
- отличить архитектурную ошибку от обычного бага
- найти в проекте уже решённый похожий случай
- показать рассуждение раньше, чем агент тронет код
Примеры запросов агенту
- Тест
test_cart.pyпадает третий раз, включи рутинуdebugи сначала собери наблюдения. - Не правь код наугад: пройди по шагам и объясни, почему падает сборка.
- Посмотри
@error-documentation.mdc, может там уже был такой случай, и только потом предлагай фикс.
Как установить debug
Вручную: положить файлы
.cursor/rules/debug.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.claude/rules/debug.mdПоле paths во frontmatter ограничивает файлы: globs из источника → paths
AGENTS.md
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.github/instructions/debug.instructions.mdПоле applyTo задаёт, к каким файлам применять: globs из источника → applyTo
Вручную: положить файлы
.devin/rules/debug.mdВручную: положить файлы
.clinerules/debug.mdПо шагам, с командами для каждой платформы: Cursor rules: файлы .mdc, четыре режима и замена .cursorrules
Вопросы о debug
Как установить debug в Claude Code?
Скопируй файл правила в .claude/rules/debug.md в корне проекта. Дальше Claude берёт его оттуда сам.
Что делает debug?
Включает рутину для застрявших ошибок и неполных фиксов: собрать наблюдения, объяснить причину, проверить похожие случаи, и только затем менять код.
Нужны ли другие файлы правил?
Да. Шаги ссылаются на implement.mdc (<ANALYZE CODE>, <SYSTEMATIC CODE PROTOCOL>, <TESTING>), на @error-documentation.mdc и на @memory.mdc с архитектурой и текущей задачей. Без них часть рутины останется без определения.