Ruflo: рой агентов

Ruflo это система, где задачу решает не один агент, а рой. Координатор раздаёт подзадачи, агенты работают параллельно, результат собирается обратно в одно целое. Вместо того чтобы один агент линейно прогрызал большую задачу шаг за шагом, ты получаешь несколько агентов, которые рубят её одновременно с разных сторон.

Проект делает rUv, репозиторий https://github.com/ruvnet/ruflo, ~57k звёзд на GitHub намекают, что идея зашла сообществу. Это не отдельный продукт, а надстройка поверх Claude Code: Ruflo цепляется к нему как MCP-сервер и оркестрирует агентов. Подход заточен под крупные задачи, которые одному агенту не по зубам или просто слишком долго делать в одну голову. Ниже разберём логику, как это работает, и как стартовать, не наступив на типичные грабли.

Что понадобится

Тебе нужен Claude Code на машине, это база, на которой всё крутится. Нужен Node.js, на нём поднимается сам Ruflo. Нужна задача, которую реально дробить на параллельные части, потому что в этом весь смысл роя, если задача не делится, рой не поможет. И заложи терпение на настройку под себя. Система мощная, но требует, чтобы ты один раз сел и довёл её под свой воркфлоу.

Как это сделать

1. Поставь систему

Установка одной командой. На macOS, Linux или WSL запускаешь инсталлер, либо инициализируешь через npx на любой платформе. Дальше подключаешь Ruflo к Claude Code как MCP-сервер. Точные команды ниже в блоке, бери оттуда. Авторы расписали остальные шаги в репозитории, на спорных моментах сверяйся с README, а не импровизируй.

2. Опиши задачу координатору

Дай координатору крупную цель, а не мелкий таск. Координатор сам режет её на подзадачи и раздаёт агентам. Твоя работа на этом шаге, чётко сформулировать, чего ты хочешь на выходе, чтобы координатору было от чего отталкиваться при нарезке.

3. Собери результат

Агенты отрабатывают параллельно, каждый по своей подзадаче. Ты получаешь собранный итог и смотришь швы, то есть стыки между частями. Именно на стыках чаще всего вылезают расхождения, потому что разные агенты могли по-разному понять общий контекст. Проверка швов это твоя зона ответственности, а не координатора.

Установка Ruflo

Команды ниже ставят Ruflo и цепляют его к Claude Code. Первая поднимает систему через инсталлер, вторая, кроссплатформенный вариант через npx с мастером настройки, третья подключает Ruflo к Claude Code как MCP-сервер. После этого открываешь claude в папке проекта и работаешь как обычно, рой подключается под капотом.

# macOS / Linux / WSL: установка инсталлером
curl -fsSL https://cdn.jsdelivr.net/gh/ruvnet/ruflo@main/scripts/install.sh | bash

# любая платформа: init через npx с мастером настройки
npx ruflo@latest init wizard

# подключить Ruflo к Claude Code как MCP-сервер
claude mcp add ruflo -- npx ruflo@latest mcp start

Альтернатива через маркетплейс Claude Code, прямо в сессии: /plugin marketplace add ruvnet/ruflo, потом /plugin install ruflo-core@ruflo и при желании /plugin install ruflo-swarm@ruflo.

Промпт координатору

Это шаблон, с которого начинаешь работу с роем. Ты даёшь координатору крупную цель и сразу задаёшь правила: разбить на независимые подзадачи, по каждой описать вход, выход и критерий готовности, показать план распределения до старта и дождаться твоего ок. Так ты не отдаёшь управление вслепую, а видишь план до того, как агенты что-то запустят.

Крупная цель: <описание>.

Разбей её на независимые подзадачи, которые можно делать параллельно.
Для каждой подзадачи: что на входе, что на выходе, критерий готовности.
Покажи план распределения до старта, жди моего ок.
Потом запускай агентов и собери результат с проверкой швов.

Где заходит, где осторожнее

Заходит: большие задачи, которые честно делятся на части, тут рой раскрывается. И параллельная обработка, где один агент медленный и линейный проход занял бы слишком долго. Несколько агентов одновременно срезают время в разы.

Осторожнее: маленькую задачу роем делать дороже, чем одним агентом, ты тратишь токены и время на координацию там, где её не нужно. И швы между частями надо проверять руками, координатор не идеален, на стыках подзадач он может пропустить расхождение. Не доверяй сборке вслепую.

Чеклист перед стартом

Перед запуском пройдись по списку. Claude Code и Node.js на машине готовы. Ruflo установлен и подключён как MCP-сервер. Задача реально дробится на части, а не притворяется большой. План распределения показан тебе до старта, ты видишь, кто что делает. И ты держишь в голове, что швы между частями проверяешь сам, это не отдаётся на откуп координатору.

Частые ошибки

Первая, запускать рой на маленькой задаче, где он только удорожает работу. Вторая, не проверять швы на стыках, и тогда расхождения между частями уезжают в финальный результат. Третья, не задавать критерии готовности подзадач, из-за чего агенты не понимают, где остановиться и что считать сделанным. И четвёртая, доверять координатору вслепую, без плана распределения до старта и без финальной проверки, чем это закончилось.