claude-flow (ruflo)

★ 64.160

Orquestación multiagente para Claude Code, Codex y otros: enjambres, memoria adaptativa, integración con RAG.

claude-flow (repositorio renombrado a ruflo; los paquetes de npm claude-flow y ruflo existen en paralelo, ambos actualmente en la versión 3.25.6) es un framework de orquestación multiagente para Claude Code, Codex y otros agentes de programación. Su pieza central es una coordinación de enjambre «queen-led»: varios agentes trabajan en subtareas, se sincronizan mediante mecanismos de consenso (Raft, Byzantine, Gossip) y comparten una memoria común.

Esta memoria (AgentDB) está indexada con HNSW para búsqueda vectorial y, según la documentación del proyecto, es varias veces más rápida que una búsqueda por fuerza bruta ingenua en volúmenes de datos pequeños; a esto se suman la búsqueda híbrida y el recorrido de grafos. Mediante los patrones neuronales SONA y un «ReasoningBank», los agentes deben aprender de trayectorias de tareas pasadas y reutilizar estrategias exitosas en tareas futuras similares.

El framework es agnóstico de modelo (Claude, GPT, Gemini, Cohere, local vía Ollama) con enrutamiento automático, incluye alrededor de 210 herramientas MCP repartidas en cinco grupos de servidores (Core, Intelligence, Agents, Memory, DevTools) y también se puede instalar como un conjunto de plugins de Claude Code (entre otros ruflo-core, ruflo-swarm, ruflo-rag-memory). Una función de federación permite conectar varias instancias de claude-flow entre equipos u organizaciones vía WebSocket y traspasar tareas entre ellas.

🔧 SETUP

Configuración interactiva: `npx ruflo@latest init wizard` (sin asistente: `npx ruflo@latest init`)
Alternativamente instalar de forma global: `npm install -g ruflo@latest`
Registrar como servidor MCP en Claude Code: `claude mcp add ruflo -- npx ruflo@latest mcp start`
Opcionalmente como plugins de Claude Code: `/plugin install ruflo-core@ruflo`, `/plugin install ruflo-swarm@ruflo`, `/plugin install ruflo-rag-memory@ruflo`
Para conexión entre equipos: `npx claude-flow@latest federation init` o `federation join wss://...`

✅ ¿CUÁNDO USARLO?

Coordinar varios agentes en paralelo

Una función compleja se descompone en subtareas, y varios agentes trabajan en ella simultáneamente mediante una topología de enjambre, con memoria compartida.

Los agentes deben aprender de la experiencia

SONA/ReasoningBank recuerda trayectorias de tareas exitosas y las vuelve a aplicar en tareas futuras similares.

⛔ ¿CUÁNDO MEJOR NO?

Una tarea única y sencilla

El overhead de swarm, memoria y mecanismos de consenso no compensa para una tarea única y bien delimitada que un solo agente puede resolver.

Mejor: Usar Claude Code directamente, sin capa de orquestación.

Federación entre equipos sin infraestructura

La federación necesita un endpoint WebSocket accesible (wss://) — sin infraestructura de servidor propia no resulta útil en la práctica.

Mejor: Configuración local sin comandos de federation, con una sola instancia.