Перейти к содержанию

Маршрутизация работы: какой агент, какая модель, сколько сразу

Для кого? Для того, кто оркестрирует агентов в репозитории, который уже охраняют проверки: решает, какая модель берёт какую работу, когда распараллеливать и когда останавливаться на ревью. Когда читать? Когда одного агента уже не хватает по скорости или дорогая модель делает дешёвую работу. Правила против столкновений нескольких агентов — в «Больше одного агента»; когда правило мешает — «Адаптация правил»; 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 и опрашивают состояние — две обычные причины флаков в параллельных прогонах;
  • фоновые процессы останавливаются до отчёта.

Когда работу тормозит правило процесса — не проверка, — ответ в том, чтобы адаптировать процесс в границах, а не обходить проверку. Как — в «Адаптации правил».