Installs into .claude/skills of the current project.
Sponsors
SSkills DirectorySkills Directory
Know which skills are safe — weekly.
SSkills DirectorySkills Directory
Is that skill safe to install?
Are you the author of Debug Root Cause?
Add the live security badge to your README. It updates with every re-scan.
[](https://www.skillsdirectory.com/skills/sergvss-debug-root-cause)
---
name: debug-root-cause
description: Use when facing a bug, a failing test or unexpected behaviour - before proposing or making a fix.
---
# Отладка от корня
1. **Воспроизведи** стабильно и запиши, как.
2. **Найди корень.** Прочитай ошибку целиком. Посмотри, что менялось (`git log`, `git diff`). Проследи данные назад — от места, где значение неверно, к месту, где оно таким стало: место падения и место ошибки часто в разных файлах. Есть работающий аналог — сравни построчно.
3. **Одна гипотеза за раз:** «причина — X, потому что Y». Проверь минимальным изменением. Не подтвердилось — откати и новую гипотезу, а не вторую правку поверх первой.
4. **Исправь через красный тест** (скилл `test-first`): исправление корня, весь набор зелёный.
**Три гипотезы или исправления не помогли — стоп.** Это неверное понимание устройства, а не баг в строке. Доложи пользователю, что проверено и что опровергнуто. Сложный случай — роли `investigator`.
**Признаки гадания:** правка в месте падения, хотя данные испортились раньше; тест подгоняется под фактическое значение; в исправлении зашито значение, которое должен вычислять код (`return 42`).
Полный текст: `${CLAUDE_PLUGIN_ROOT}/checklists/debugging.md`
Если методология установлена копированием — файл лежит в `checklists/debugging.md` репозитория.
