Dynamic Workflows в Claude Code

Что это

Workflow — это не «много субагентов». Это JS-скрипт, который детерминированно управляет роем: кого поднять, сколько, в каком порядке и с каким промптом у каждого. Control flow (циклы, ветвления, fan-out) исполняет движок, а не модель — поэтому точность держится там, где markdown-ТЗ на объёме рассыпается: у Клода нет жёсткой памяти состояния между шагами, и он теряет часть инструкций по дороге.

Когда включать

Осознанный опт-ин, не автопилот. Workflow может поднять десятки агентов и сжечь много токенов, поэтому запускается только по явному запросу на оркестрацию — просто «большая задача» недостаточный повод. Три реальных повода: охват (разложить и параллельно покрыть фронт), уверенность (независимые мнения + состязательная проверка), масштаб (объём, не влезающий в один контекст).

Честно про лимиты

• Конкурентность ~16 одновременно (min(16, ядра−2)) — остальные агенты ждут очереди и идут волнами.
• 1000 агентов — суммарный потолок за прогон, не одновременно.
• 4096 элементов на один вызов pipeline/parallel.
• 200 документов ≈ 13 волн по 16 — не мгновенно. Агенты жгут тот же общий лимит токенов.

Миф «200 агентов сразу» — самое частое заблуждение в комментариях.

Кейс: 200 актов × 200 счетов

Сопоставить документы в разных форматах, найти расхождения, дубли и пропуски. Ключевая поправка: через агентов гоняется только извлечение (по агенту на файл, там нужен LLM для OCR и смысла, строго по schema). А сопоставление по договору и сумме — обычный JS поверх структурированных данных. Гонять matching через LLM = лишние токены и галлюцинации на самом чувствительном шаге. Деньги/договоры — зона человека: выход это черновик для бухгалтера на проверку, не финальный вердикт.

Собранный workflow лёг в .claude/workflows/ — новая партия гоняется по имени одной командой (через args).

Где заходит

Рефакторинг большого проекта, код-ревью и security-аудит всей базы, конвертация пачки файлов, чанкинг огромных файлов под LLM, транскрипция/саммари больших проектов, deep research и анализ конкурентов. Везде, где объём убивает обычный подход.

В гайде — строительные блоки (agent / pipeline / parallel / schema), развилка pipeline vs parallel, паттерны качества (adversarial verify, judge panel, loop-until-dry, multi-modal sweep) и готовый промпт для копирования.