⚪️ Workflows от Антропика


Ну вот мы и дождались полноценного оркестратора от вендора! Тема - огромная, как уместить даже в серию постов - не совсем ясно. Спрашивайте в комментах если нужно.

Почитал первые обзоры - все оч поверхностно, повторяет документацию, а ее вы и сами прочитаете. Я решил начать с конца/с сути: сначала скажу анатомию воркфлоу, а всю обвязку разберем в последующих постах.

▶️ Workflow - это детерминированный скрипт на js, написанный с применением специальных функций для флоу. Вот они, главные кирпичики флоу:
* phase: устанавливает фазу вашего воркфлоу, этап в прогрессе;
* agent: запускает субагента; можно пускать в worktree; можно указать фазу; можно указать кастомный промпт для субагента; можно выбрать модель; важно - указываем SCHEMA для генерации агентом ответа по схеме - мы же в детерминированном скрипте, для обработки это нужно;
* parallel(tasks): запускает переданные элементы tasks параллельно, и как барьер ждет чтобы все они завершились результатом (или упали) - как promise.all()
* pipeline(items, ...stages): этот примитив КАЖДЫЙ item запускает через этапы STAGES независимо; то есть элемент 2 может быть на 2м этапе, а элемент 4 уже все этапы пройти; элементы обрабатываются независимо и параллельно; считай - fan-out;
* workflow: запуск суб-воркфлоу (вложенность ограничена 1, то есть из воркфлоу можно пустить еще один суб-воркфлоу) - выполнит воркфлоу и вернет все что воркфлоу возвращает;

▶️ Воркфлоу описан на верхнем уровне из двух секций - meta описание (фазы), параметры запуска, и далее тело воркфлоу на js состоящее из примитивов воркфлоу и обычного кода js. Часть функций внутри js нелоступна - так как воркфлоу можно возобновлять, Date(), math.random() запрещены, они нарушают возможность сохранять состояние воркфлоу и возобновлять его.

▶️ Паралелльные задачи выполняются с учетом общей конкурентности вашей системы. Если вы дали parallel например 100 задач, а максимальная конкурентность в системе 10, то заачи будут выполняться пачками по 10. Но логика барьера parallel сохранится - он дождется всех задач.

▶️ Есть встроенный /deep-research воркфлоу, из 5 фаз:
* scope: декомпозировать вопрос в пять разныз углов зрения;
* search: сделать parallel с 5 воркерами, по одному на каждый угол зрения;
* fetch: получить итоги поиска, сделать дедупликацию, и достать top-15 из каждого угла зрения;
* verify: интересная штука - запускаем parallel со скептиками, которые должны покритиковать релевантность результата; остаются только те, кто прошел;
* synthesize: синтезировать результат из отфильтрованных итогов

Этот ворфлоу можно вызывать из своих воркфлоу, если нужно что-то качнственно поискать в интернете (например, решение для какого то бага в коде)

▶️ Сам Workflow это тул в СС, вызывается с указанием скрипта из .claude/workflows
Команда /workflows показывает список ваших воркфлоу/их запусков, включая текущий - можно смотреть как там каждая фаза, как там агент и что делает (промпт/результат), ставить флоу на паузу/останавливать.

(ц) вот такое!

@deksden_notes