# root-cause-analyzer

Субагент root-cause-analyzer для Claude Code и Cursor, который систематически анализирует корневые причины ошибок, проблем производительности и сбоев. Используй, когда нужно разобраться, почему код ломается, а не просто исправить симптом.

- субагент · `type=agent` · Claude Code, Cursor, Codex · ★ 788 у репозитория
- Автор: alirezarezvani
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/alirezarezvani/claude-code-tresor/tree/HEAD/agents/root-cause-analyzer.md
- Обновлён: 2026-07-03
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/agents/root-cause-analyzer

## Что делает

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

В арсенале — анализ производительности (утечки памяти, узкие места в CPU, I/O-блокировки), проблемы конкурентности (deadlock, race conditions), сетевые и интеграционные сбои. Использует системные инструменты: `strace`, `top`, профайлеры, анализ логов через `grep` и `jq`, запросы к БД с `EXPLAIN`.

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

## Установка

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

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

### Codex

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

### Cursor

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/alirezarezvani/claude-code-tresor/tree/HEAD/agents/root-cause-analyzer.md

## Когда брать
- найти причину утечки памяти или неожиданного роста потребления ресурсов
- разобраться с ошибкой в production, когда логи противоречивы или неполные
- выявить узкое место в производительности базы данных или API
- проанализировать deadlock или гонку потоков в многопоточном коде
- определить, почему интеграция с внешним сервисом нестабильна и как это исправить

## Примеры запросов агенту
- Помоги разобраться, почему приложение ест всю оперативку за час. Вот логи из `app.log`.
- В production вылетает ошибка `SIGKILL`, но в стеке ничего хватательного. Помоги найти настоящую причину.
- Запросы к БД иногда выполняются за 50ms, иногда за 5 секунд. Что тут не так?

## Похожие
- [022-root-cause-analysis](https://affpapa.org/nevibecode/skills/022-root-cause-analysis.md) — скилл · 144 установки
- [root-cause-analyst](https://affpapa.org/nevibecode/agents/root-cause-analyst.md) — субагент · ★ 23950 у репозитория
- [root-cause-analysis](https://affpapa.org/nevibecode/skills/root-cause-analysis.md) — скилл · 940 установок
- [root-cause-tracing](https://affpapa.org/nevibecode/skills/root-cause-tracing.md) — скилл · 1400 установок
- [causal-inference-root-cause](https://affpapa.org/nevibecode/skills/causal-inference-root-cause.md) — скилл · 110 установок
- [root-cause-debugger](https://affpapa.org/nevibecode/agents/root-cause-debugger.md) — субагент · ★ 4719 у репозитория

Из того же набора: [alirezarezvani/claude-code-tresor](https://affpapa.org/nevibecode/by/alirezarezvani/claude-code-tresor.md) — 27 карточек

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

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