# team-debug

Запускает несколько агентов-отладчиков параллельно: каждый проверяет свою версию причины бага и собирает доказательства.

- команда · `type=command` · Claude Code, Codex, Cursor · ★ 41729
- Автор: Seth Hobson
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/wshobson/agents/tree/HEAD/plugins/agent-teams/commands/team-debug.md
- Обновлён: 2026-10-24
- HTML: https://affpapa.org/nevibecode/commands/team-debug

## Что делает

Команда работает по методологии Analysis of Competing Hypotheses. Сначала она разбирает описание ошибки или указанный файл, ищет в коде связанные места, смотрит свежие изменения в git и тесты. Потом формирует N гипотез о корневой причине — по умолчанию три — и раскидывает их по категориям: логика, данные, состояние, интеграция, ресурсы, окружение.

Дальше через `TeamCreate` создаётся команда `debug-{timestamp}`, и на каждую гипотезу поднимается отдельный агент `agent-teams:team-debugger`. Они копают параллельно, а вы следите за счётчиком завершённых проверок. В финале команда сравнивает отчёты: что подтвердилось, что опровергнуто, где доказательств не хватило. Гипотезы ранжируются по уверенности и силе причинной цепочки, выдаётся отчёт с указанием `file:line` и предложенным исправлением.

Перед запуском нужна переменная окружения `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` — без неё команда не стартует. Область поиска задаётся флагом `--scope`: `files`, `module` или `project`. Чем шире область, тем дольше идут агенты, поэтому для мелкого бага лучше не разворачивать весь проект.

## Установка

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

1. **Через маркетплейс плагинов**
В чате агента (не в терминале):
```text
/plugin marketplace add wshobson/agents
```
В чате агента (не в терминале):
```text
/plugin install agent-teams@claude-code-workflows
```

2. **Вручную: положить файлы**
- Файл: `.claude/commands/team-debug.md` — Вызов — /team-debug. Для всех проектов — ~/.claude/commands/

### Codex

**Вручную: положить файлы**
- Файл: `~/.codex/prompts/team-debug.md` — Вызов — /prompts:team-debug. В Codex этот формат помечен устаревшим, замена — скиллы

### GitHub Copilot

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

### Gemini CLI

**Вручную: положить файлы**
- Файл: `.gemini/commands/team-debug.toml` — Gemini хранит команды в TOML: текст запроса — в поле prompt

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/wshobson/agents/tree/HEAD/plugins/agent-teams/commands/team-debug.md

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

## Примеры запросов агенту
- /team-debug TypeError: cannot read property 'id' of undefined
- /team-debug src/api/client.ts --hypotheses 4 --scope module
- /team-debug падает тест авторизации --scope project

## Похожие
- [dispatching-parallel-agents](https://affpapa.org/nevibecode/skills/bobmatnyc-dispatching-parallel-agents.md) — скилл · 314 установок
- [om-root-cause](https://affpapa.org/nevibecode/skills/om-root-cause.md) — скилл · 2900 установок
- [root-cause-tracing](https://affpapa.org/nevibecode/skills/root-cause-tracing.md) — скилл · 1300 установок
- [team](https://affpapa.org/nevibecode/skills/team.md) — скилл · 884 установки
- [ae-team](https://affpapa.org/nevibecode/skills/ae-team.md) — скилл · 839 установок
- [investigate-first](https://affpapa.org/nevibecode/skills/investigate-first.md) — скилл · 105400 установок

Из того же набора: [wshobson/agents](https://affpapa.org/nevibecode/by/wshobson/agents.md) — 342 карточки

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

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