# sleuth

Субагент sleuth для системного разбора ошибок: ищет корень проблемы через код, логи и историю изменений, документирует гипотезы и выводы.

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

## Что делает

Sleuth работает по методу эротетического анализа: сначала формирует вопросы, которые нужно разрешить, потом методично отвечает на них через инструменты. Использует `Read`, `Bash`, `Grep` и `Glob` для поиска ошибок в коде, анализа логов и трассировки через git history. На выходе создаёт структурированный отчёт с гипотезами, пройденными проверками и рекомендациями по исправлению.

Для каждого расследования субагент требует описания симптома, контекста и уже пройденных попыток исправления. Собирает доказательства из конкретных строк кода, сообщений об ошибках и логов, оценивает уверенность в диагнозе. Отчёт пишет в файл `.claude/cache/agents/sleuth/output-{timestamp}.md`, чтобы разработчик мог действовать на его основе.

## Установка

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

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

### Codex

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

### Cursor

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/parcadei/Continuous-Claude-v3/tree/HEAD/.claude/agents/sleuth.md

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

## Примеры запросов агенту
- Ошибка при загрузке данных из БД: ищи, где на самом деле происходит запрос и что изменилось.
- Тесты падают с непонятным сообщением — разберись, в каком модуле и почему.
- После деплоя API возвращает 500: проанализируй логи и покажи, какая строка кода это выбрасывает.

## Похожие
- [debug](https://affpapa.org/nevibecode/skills/pwguler-debug.md) — скилл · 1000 установок
- [root-cause-analyzer](https://affpapa.org/nevibecode/agents/root-cause-analyzer.md) — субагент · ★ 788 у репозитория
- [root-cause-analyst](https://affpapa.org/nevibecode/agents/root-cause-analyst.md) — субагент · ★ 23950 у репозитория
- [deployment](https://affpapa.org/nevibecode/skills/deployment.md) — скилл · 69 установок
- [crash-decode](https://affpapa.org/nevibecode/skills/crash-decode.md) — скилл · ★ 125 у репозитория
- [geo-sleuth](https://affpapa.org/nevibecode/skills/geo-sleuth.md) — скилл · 5000 установок

Из того же набора: [parcadei/continuous-claude-v3](https://affpapa.org/nevibecode/by/parcadei/continuous-claude-v3.md) — 161 карточка

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

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