Резюме

Делегируйте задачи по коду сжатым subagent-ам, которые уменьшают контекст примерно на 60% за каждую делегацию.

Три предустановленных subagent обрабатывают типичные рабочие процессы: cavecrew-investigator находит символы и определения, cavecrew-builder выполняет точечные правки в 1–2 файлах, cavecrew-reviewer проверяет diff на наличие багов
Вывод сжат по принципу caveman (структурированные фрагменты вместо прозы), что снижает стоимость основного контекста с примерно 2k токенов за делегацию до примерно 700 токенов
Лучше всего подходит для длинных сессий, где важен бюджет контекста; используйте обычный Explore или Code Reviewer, когда вам нужна проза, комментарии по архитектуре или рефакторинг нескольких файлов
Типичный рабочий процесс: investigator находит места, builder редактирует известные пути, reviewer проверяет diff

Cavecrew = три предустановленных subagent, которые выдают вывод в стиле caveman. Выполняют ту же работу, что и стандартные решения от Anthropic (Explore, edit-style agent-ы, reviewer); разница в том, что возвращаемый tool-result сжат, поэтому основной контекст уменьшается с каждой делегацией.

Когда использовать cavecrew, а не альтернативы

Задача	Использовать
«Где определён X / кто вызывает Y / список использований Z»	cavecrew-investigator
То же самое, но также нужны предложения / комментарии по архитектуре	Explore (обычный)
Точечная правка, ≤2 файлов, область очевидна	cavecrew-builder
Новая функциональность / 3+ файлов / сквозной рефакторинг	Основной поток или feature-dev:code-architect
Проверка diff, ветки или файла на наличие багов	cavecrew-reviewer
Глубокое code review с обоснованием и альтернативами	Code Reviewer (обычный)
Однострочный ответ, который вы уже знаете	Основной поток, без subagent

Простое правило: если вы бы хотели получить вывод subagent в 1/3 токенов — выбирайте cavecrew. Если вам нужна проза — выбирайте обычный вариант.

Зачем это существует (настоящая выгода)

Tool results subagent вставляются в основной контекст дословно. Обычный Explore, возвращающий 2k токенов прозы, стоит 2k токенов бюджета основного контекста при каждом вызове. То же самое обнаружение от cavecrew-investigator возвращает примерно 700 токенов. За 20 делегаций в одной сессии это разница между исчерпанием контекста и успешным завершением задачи.

Контракты вывода

На что основной поток может рассчитывать для каждого agent-а:

cavecrew-investigator

<Заголовок>:
- путь:строка — `символ` — краткая заметка
итого: <количество>.

Или No match. Всегда путь к файлу первым, номер строки прикреплён, символы в обратных кавычках. Безопасно искать grep-ом по шаблону path:\d+.

cavecrew-builder

<путь:диапазон-строк> — <изменение ≤10 слов>.
verified: <повторное чтение OK | несовпадение @ путь:строка>.

Или одно из: too-big. / needs-confirm. / ambiguous. / regressed. (терминальный первый токен).

cavecrew-reviewer

путь:строка: <эмодзи> <уровень>: <проблема>. <исправление>.
итого: N🔴 N🟡 N🔵 N❓

Или No issues. Замечания отсортированы по файлу → по возрастанию строки.

Шаблоны связывания

Локализовать → исправить → проверить (наиболее распространённый):

cavecrew-investigator возвращает список мест.
Основной поток выбирает 1-2 места и передаёт пути в cavecrew-builder.
cavecrew-reviewer проверяет diff.

Параллельная разведка (когда обследование широкое): Запустите 2-3 вызова cavecrew-investigator в одном сообщении (разные углы: определения vs вызывающие vs тесты). Агрегируйте в основном потоке.

Разовая правка (когда место уже известно): Пропустите investigator. Передайте точный путь:строка напрямую в cavecrew-builder.

Чего НЕ делать

Не используйте cavecrew-builder, если вы ещё не знаете файл. Сначала запустите investigator, иначе основной поток потратит токены на передачу контекста.
Не связывайте cavecrew-investigator → cavecrew-builder для рефакторинга из 5 файлов. Builder вернёт too-big., и вы зря потратите ход.
Не просите cavecrew-reviewer о «общей обратной связи» — он возвращает только замечания, без мнений об архитектуре. Для этого используйте Code Reviewer.
Не ожидайте прозы. Вывод cavecrew структурирован, иногда лаконичен до степени загадочности. Если это будет читать человек напрямую — перефразируйте.

Автопонятность (унаследованная)

Subagent переключаются с caveman на нормальный английский для предупреждений безопасности, подтверждений необратимых действий и любого вывода, где неоднозначность фрагментов может быть понята неправильно. Возвращайте caveman после

Установка

npx skills add https://github.com/juliusbrussee/caveman --skill cavecrew