# subagent-spawn-cap

Плагин subagent-spawn-cap считает спавны субагентов за сессию: спрашивает разрешение на 20-м, потом каждые 10, а на 60-м отказывает. Возвращает лимит, который Claude убрал в 2.1.224.

- плагин · `type=plugin` · Claude Code · ★ 586 у репозитория
- Автор: Karan Bansal
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/karanb192/claude-code-hooks/tree/HEAD/plugins/subagent-spawn-cap
- Обновлён: 2026-10-26
- Проверка безопасности: автоматическая, 2026-11-16 (текст и 4 файла скриптов) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/plugins/subagent-spawn-cap

## Что делает

Плагин вешает хук `PreToolUse` на инструмент `Agent` (старое имя `Task`). Каждый спавн субагента дописывает строку в журнал сессии, и число строк — израсходованный бюджет. На 20-м спавне хук возвращает `ask`, дальше спрашивает каждые 10, на 60-м отвечает `deny`.

Журнал — append-only файл `~/.claude/subagent-spawn-cap/<session_id>.jsonl`, по строке на разрешённый или спрошенный спавн. Дозапись выбрана из-за гонки: параллельные вызовы в одном ходу запускают параллельные процессы хука, и счётчик с чтением-записью такое не переживёт. Отказ в журнал не попадает, а спрошенный спавн записывается до вашего ответа. Хуки срабатывают и внутри субагентов с тем же `session_id`, поэтому вложенные веера идут в общий бюджет.

Пороги живут в переменных `SPAWN_CAP_ASK`, `SPAWN_CAP_ASK_STEP` и `SPAWN_CAP_DENY` в блоке `env` файла `settings.json`; после правки нужен перезапуск, неверное значение откатывается к дефолту. В headless-запуске `claude -p` и в режиме `dontAsk` запрос на подтверждение превращается в отказ, поэтому с дефолтами сессия кончится на 20-м спавне, а не на 60-м: для CI поставьте `SPAWN_CAP_ASK` равным `SPAWN_CAP_DENY`. Видны только спавны через `Agent` — скрипт Workflow пройдёт мимо.

## Установка

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

**Через маркетплейс плагинов**
В чате агента (не в терминале):
```text
/plugin marketplace add karanb192/claude-code-hooks
```
В чате агента (не в терминале):
```text
/plugin install subagent-spawn-cap@claude-code-hooks
```

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

## Примеры запросов агенту
- Разбей рефакторинг на субагентов, по одному на модуль
- Запусти по субагенту на каждый пакет и собери отчёты
- Продолжай в этой сессии, бюджет спавнов ещё не кончился

## Похожие
- [Creed Space](https://affpapa.org/nevibecode/mcp/creed-space.md) — MCP-сервер · 10491 установка
- [autobahn](https://affpapa.org/nevibecode/skills/autobahn.md) — скилл · 1500 установок
- [careful](https://affpapa.org/nevibecode/skills/careful.md) — скилл · 417 установок
- [nah](https://affpapa.org/nevibecode/plugins/nah.md) — плагин · ★ 494 у репозитория
- [env-file-protection](https://affpapa.org/nevibecode/hooks/env-file-protection.md) — хук · 279 установок
- [team-spawn](https://affpapa.org/nevibecode/commands/team-spawn.md) — команда · ★ 42780 у репозитория

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

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

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