Маршрутизация работы: какой агент, какая модель, сколько сразу
Для кого? Для того, кто оркестрирует агентов в репозитории, который уже охраняют проверки: решает, какая модель берёт какую работу, когда распараллеливать и когда останавливаться на ревью. Когда читать? Когда одного агента уже не хватает по скорости или дорогая модель делает дешёвую работу. Правила против столкновений нескольких агентов — в «Больше одного агента»; когда правило мешает — «Адаптация правил»; lane'ы в панелях herdr и agent teams внутри lane — «Agent teams и herdr».
Проверки решают, когда работа закончена. О том, как быстро она туда приходит, они не говорят ничего, а harness, внутри которого медленно работать, начинают обходить. Эта страница — вторая половина: как тратить модели и параллелизм так, чтобы проверки оставались зелёными и работа двигалась.
Три роли
harnessimo init кладёт в .claude/agents/ три определения агентов — заготовки, которые
нужно править, а не правила, которым надо подчиняться. Каждое правило в них несёт своё
зачем, чтобы агент мог понять, когда оно перестало работать.
| Роль | Модель | Получает | Никогда |
|---|---|---|---|
architect |
самая сильная (opus) | спеки, ADR, вердикты гейтов, холодное ревью рискованных дифов | не пишет продакшен-код |
implementer |
рабочая (sonnet) | код одной полосы, задача за задачей, с цитатой проверок | не правит спеки, не порождает агентов |
scout |
самая дешёвая (haiku) | поиск только на чтение: grep, brief, версии, логи |
не пишет ничего |
Правило под этим: платить за суждение там, где ошибка дорога и невидима; за пропускную способность — везде остальном. Неверный порядок блокировок, правило округления, ключ идемпотентности или миграция данных невидимы в зелёном прогоне тестов и дороги в проде — такой диф идёт архитектору со свежим контекстом, потому что контекст автора и спрятал баг. Переименование, тест, правка документа — это пропускная способность.
Глубина рассуждения следует той же линии: низкая для поиска и механических правок, результат которых проверяет себя сам; высокая — для того единственного куска, который требует больше мысли, чем работа вокруг.
Модель роли доходит до агента в панели флагом запуска
Модель из файла роли Claude Code читает для сабагента. Агент lane, которого
harnessimo herd up запускает в панели herdr, — это сессия верхнего уровня, она файл не
читает, поэтому up сам читает файл роли и стартует агента с --model <m> --effort <e>
(implementer → sonnet, architect → opus, scout → haiku). Агенты на Sonnet работают с
effort high, если effort: роли или herd.roles не говорит иначе. Подробности,
приоритеты и запасные варианты: Agent teams и herdr.
Никогда не меняйте модель запущенного агента через /model или /effort. Оба сохраняют
выбор как глобальное значение пользователя в ~/.claude/settings.json и меняют все его
остальные сессии. Остановите агента и запустите заново с флагами.
Рутинную работу с herdr делает сам координатор — открывает панели, запускает агентов,
отправляет промпты, которые самодостаточны и используют абсолютные пути (в боковом worktree
файлов координации может не быть). Владельцу ручные шаги не передают. Во вкладке не больше
четырёх панелей, считая панель координатора; для остальных herd up открывает новую вкладку.
Распараллеливать, когда потоки независимы
Две задачи независимы, когда ни одна не читает того, что пишет другая. Такие идут параллельно, каждая в своём checkout:
harnessimo worktree add search # ../<repo>-search на ветке wt-search, установка выполнена
harnessimo worktree add billing
# … по implementer на worktree …
harnessimo worktree merge search # --no-ff в текущую ветку
harnessimo worktree remove search # отказывает, если работа не влита или не закоммичена
Свежий worktree сначала выполняет шаг установки проекта (worktree.install или команду
установки из coldStart.commands), потому что иначе его первый коммит упадёт на pre-commit
hook далеко от причины. Каждая полоса по-прежнему объявляет ## Owns, так что два потока,
оказавшиеся не независимыми, падают на harnessimo tracks, а не на merge.
Основной checkout владеет общим состоянием — PROGRESS.md, TRACKS.md, handoff'ами. Боковые
ветки несут код и файлы своей полосы, и merge'и остаются скучными.
Цепочки задач и пакетное ревью
- Implementer может пройти цепочку задач одного потока: закоммитить каждую, сразу перейти к следующей, отчитаться один раз в конце. Остановка после каждой задачи превращает параллельные потоки обратно в очередь с лишними шагами.
- Задачи
[review]получают одно пакетное ревью на поток, а не остановку после каждой. Гейтом остаётся ревью — ничего не вливается с непросмотренной задачей[review], — но одно холодное чтение связного дифа находит больше, чем пять чтений обрывков.
Оркестратор не простаивает
Сессия, раздающая работу, её не ждёт. Когда агент отчитался, оркестратор в том же ходу вливает зелёное, запускает следующий поток или пакетное ревью и обновляет общее состояние. Простаивающий оркестратор — то самое узкое место, которое параллельный прогон должен был убрать.
Скорость — от параллелизма, а не от срезанных углов
Проверки остаются. Скорость берётся из того, чтобы не гонять их чаще, чем они могут измениться:
- внутренний цикл гоняет только то, чего коснулась правка; полный гейт — раз на задачу;
- вывод гейта сохраняется целиком вместе с кодом выхода (
cmd > log 2>&1; echo "exit=$?") — никогда черезtail, чей код выхода подменяет код гейта; - тесты слушают порт
0и опрашивают состояние — две обычные причины флаков в параллельных прогонах; - фоновые процессы останавливаются до отчёта.
Когда работу тормозит правило процесса — не проверка, — ответ в том, чтобы адаптировать процесс в границах, а не обходить проверку. Как — в «Адаптации правил».