Ruflo: organiza un equipo de IA en Claude Code

Ruflo es un conjunto de herramientas de código abierto que ayuda a un asistente de programación con IA a organizar el trabajo: elegir especialistas, guardar memoria del proyecto y recomendar qué modelo usar para cada tarea. Es una capa de coordinación alrededor del asistente que ya utilizas, no otro chatbot ni un modelo que tengas que descargar.

Puedes empezar sin saber programar. El primer objetivo es pequeño a propósito: abrir una carpeta vacía para practicar, añadir Ruflo a Claude Code y pedir un plan. No necesitas construir una aplicación, conectar una cuenta de producción ni poner a trabajar a un equipo de agentes para entender la propuesta.

Documentación comprobada el 22 de octubre de 2026. Todas las instrucciones de instalación y ejecución que siguen proceden de la documentación y no las hemos probado. No instalamos ni ejecutamos Ruflo, sus plugins, servidores MCP, hooks o benchmarks. Los prompts son ejemplos ilustrativos, no conversaciones probadas. Las capturas muestran páginas públicas de las fuentes, no una ejecución nuestra.

Para qué sirve, en palabras sencillas

Un asistente de programación puede convertir una petición en lenguaje cotidiano en archivos, ejecutar comandos y explicar el resultado. Ruflo añade formas de coordinarlo: un agente propone el plan, otro revisa los cambios, la memoria conserva contexto útil y el enrutamiento recomienda un modelo adecuado. Un “swarm”, o enjambre, es un grupo coordinado de agentes, no inteligencia extra gratuita: más agentes pueden implicar más llamadas, costes y posibilidades de error.

Para un primer ejercicio, imagina una página sencilla que presente tu negocio. Pide entender qué se construiría antes de autorizar su creación. Para una petición aislada de texto, quizá baste tu asistente actual; Ruflo resulta más relevante cuando hay varias etapas, revisiones o sesiones.

curl -fsSL https://claude.ai/install.sh | bash

irm https://claude.ai/install.ps1 | iex

claude --version

node --version
npm --version

claude

/plugin marketplace add ruvnet/ruflo

/plugin install ruflo-core@ruflo

/reload-plugins

Estoy aprendiendo en esta carpeta vacía y desechable. Quiero una web sencilla de una página para una panadería ficticia de barrio. Explica en español claro cómo podría ayudar Ruflo y propón solo un plan pequeño. No crees ni cambies archivos, ejecutes comandos en el terminal, instales nada más, inicies agentes, conectes cuentas, publiques ni comiences trabajo de pago con proveedores sin mi aprobación explícita y separada. Indica qué permisos y posibles costes de uso implicaría el siguiente paso y espera.

Más allá

Todo lo que sigue procede de la documentación y no lo hemos probado. No pegues todos los bloques en secuencia. Plugin, inicialización por CLI y registro manual de MCP resuelven problemas distintos.

Configuración completa del proyecto: Core, Console y Mods

Core proporciona herramientas; Console es el panel de control; Mods añaden comportamiento de enrutamiento y políticas dentro del proceso de Claude Code. Esta es la secuencia completa documentada. Si ya instalaste Core, no lo reinstales sin motivo: continúa solo con los plugins opcionales que hayas revisado.

/plugin marketplace add ruvnet/ruflo
/plugin install ruflo-core@ruflo
/plugin install ruflo-console@ruflo
/plugin install ruflo-mods@ruflo
/reload-plugins
/ruflo

Revisa los mods antes de habilitarlos. No están aislados en una sandbox: se ejecutan en el proceso de Claude Code con los permisos de tu cuenta. Una carpeta desechable no es una barrera de contención. Los hooks son scripts activados por eventos del asistente; que estén declarados no demuestra que todos se hayan disparado correctamente. No desactives las comprobaciones de permisos de Claude Code para que esto funcione.

Configuración por CLI: elige el asistente o un init explícito

La CLI es la interfaz de Ruflo en el terminal. npx descarga/ejecuta un paquete sin exigir una instalación global de Ruflo; eso no significa que no deje cambios persistentes. @latest es móvil, no una versión fija y reproducible. La instantánea documental consultada informa de la versión 3.59.14, no de un dist-tag npm verificado.

Elige el asistente interactivo si quieres ayuda para seleccionar la configuración:

npx ruflo@latest init wizard

Para utilizar los valores predeterminados sin interacción, la alternativa es:

npx ruflo@latest init

Haz una copia de seguridad antes de cualquiera de los dos. Init puede crear o modificar .claude/, .claude-flow/, CLAUDE.md, .mcp.json, ajustes y scripts auxiliares. Por defecto también puede añadir una referencia de integración en ~/.claude/CLAUDE.md, habilitar/instalar mods y registrar skills. Guarda una copia separada de los ajustes existentes del proyecto y del usuario, incluidos los archivos ocultos; un commit del proyecto no protege los ajustes de tu carpeta personal. Nunca uses --force como intento rutinario: autoriza sobrescribir la configuración existente.

Para reducir la configuración de forma explícita, estas opciones documentadas pueden combinarse así. Es una combinación ilustrativa de flags verificados, no una receta de aislamiento probada en ejecución:

npx ruflo@latest init --minimal --no-global --no-mods --no-plugin-install --no-skills-sh --no-codex-detect --no-signup

Para Codex también existe --codex-trust: standard utiliza sandbox workspace-write y aprobaciones bajo petición; full solicita danger-full-access y ninguna aprobación. Mantén el límite predeterminado; una configuración Codex existente no se reescribe automáticamente. Esto no es una recomendación para conceder acceso total.

Otras alternativas de instalación documentadas, no pasos adicionales obligatorios:

npm install -g ruflo@latest
ruflo init

npm install -g ruflo@latest --omit=optional

--omit=optional omite dependencias opcionales de ML/embeddings; no es el --minimal de init. Si ya tienes Bun instalado, otra alternativa es:

bunx ruflo@latest init

El proyecto también ofrece un instalador de shell que descarga código ejecutable. No hace falta para esta guía. Sus flags independientes son --global/-g, --minimal/-m (omite dependencias opcionales), --setup-mcp, --doctor/-d, --no-init, --full/-f (global + MCP + doctor + init) y --version=X.X.X. No los confundas con los de init. --no-init no deshace cambios globales solicitados mediante otras opciones. Inspecciona el instalador fijado en las fuentes antes de plantearte esa ruta.

MCP manual: solo si tu cliente lo necesita

MCP es la conexión de herramientas entre el asistente y Ruflo. Core ya proporciona su servidor. No añadas esto automáticamente encima de Core. Para una configuración Claude basada en CLI sin ese servidor, el README documenta:

claude mcp add claude-flow -- npx ruflo@latest mcp start

Conserva literalmente el identificador claude-flow, tal como está documentado. Para otro cliente MCP, fusiona esta configuración equivalente de comando/argumentos con los ajustes existentes; no sobrescribas sus demás servidores:

{
  "mcpServers": {
    "ruflo": {
      "command": "npx",
      "args": ["-y", "ruflo@latest", "mcp", "start"]
    }
  }
}

Este JSON es una adaptación explícita, no el .mcp.json de Core. Core utiliza un launcher Node dentro de ${CLAUDE_PLUGIN_ROOT}; prefiere una CLI local resuelta y puede recurrir a npx -y @claude-flow/cli@latest mcp start.

El proceso stdio independiente es:

npx -y ruflo@latest mcp start

Es otra forma de iniciar el servidor, no un segundo comando obligatorio después de registrarlo. Deja que el cliente gestione el proceso. Comprueba el registro real, los nombres de herramientas, la espera de la primera descarga, los permisos y las entradas duplicadas. Console/mods son integraciones con Claude Code; otro cliente MCP no recibe automáticamente esas funciones del host.

El enrutamiento recomienda; hay que verificar la ejecución

En la tabla v2 del 5 de mayo de 2026, el coste de API por edición publicado fue US$0 para Agent Booster y US$0,006049 para Opus 4.7. El cero corresponde a esa edición local, no a toda una sesión de IA.

El diseño documentado es: cambios estructurales compatibles en el ordenador sin modelo; Haiku para tareas simples, Sonnet para medias y Opus para difíciles. Los agentes de ejecución son subagentes del propio Claude Code; Ruflo coordina roles, tareas y memoria compartida. No es un modelo nuevo ejecutándose por completo en tu ordenador ni prueba de cambio automático del modelo en cada llamada.

Estos ejemplos documentados de CLI consultan recomendaciones de modelo:

npx ruflo@latest hooks model-route --task "fix typo in README"
npx ruflo@latest hooks model-route --task "design distributed consensus system"

El primero pide corregir una errata del README; el segundo, diseñar un sistema de consenso distribuido. La herramienta MCP hooks_route describe su función como “Get a 3-tier routing recommendation for a task” y “Use this BEFORE spawning an agent”. Comprueba si quien inicia el agente realmente aplica el modelo recomendado. Una recomendación por sí sola no cambia un archivo ni demuestra que se haya evitado una llamada cara.

Para ediciones elegibles de Tier 1, la ruta actual utiliza codemods determinísticos basados en el compilador TypeScript, no Agent Booster/WASM. Los intents compatibles son var-to-const (puede elegir let si existe reasignación), remove-console y add-logging. add-types, add-error-handling y async-await pasan a modelos Tier 2/3. La señal es [CODEMOD_AVAILABLE]; la ejecución utiliza hooks_codemod. Empieza con dryRun sobre código desechable y revisa el diff. Acepta código, un archivo, una lista o un glob; lotes/glob dependen de la API Node 22 indicada antes. Este dry run no es un init --dry-run universal.

Qué demuestran las cifras de velocidad y ahorro

Resultados históricos publicados por el proyecto, no mediciones nuestras. El benchmark 0002-baseline.md se registró inicialmente el 4 de mayo de 2026 y después incorporó comparaciones del 5 de mayo de 2026. Su tabla v2 (plugin v0.4.0) incluye 12 casos Tier 1 y cuatro adversariales:

La aceleración publicada es 3035.9× en estas microediciones. Ambos acertaron 12/12 casos Tier 1; eso no significa igual precisión general ni un proyecto 3035.9× más rápido. Otra comparación del corpus original en el mismo archivo informa de 2634.1× (aproximadamente 2634×), no una segunda cifra para combinar con la v2.

La implementación cambió después. El ADR-143, aceptado/implementado el 29 de mayo de 2026, sustituyó Booster en Tier 1. Explica que la antigua ruta de ejecución no estaba conectada al runtime CLI/MCP: quienes la invocaban usaban route(), que emitía una recomendación. Booster aplicaba una edición calculada previamente; no generaba una transformación a partir de una intención en lenguaje natural. Esto no borra el microbenchmark directo de AgentBooster.apply(), pero impide tratarlo como prueba de enrutamiento integrado automático.

El ADR-143 publica otro benchmark de codemods: 12/12, media de 0.55 ms/edición, p99 de 3.1 ms, sin cargo de API de modelo por la transformación. Las tablas históricas no establecen una comparación actual de codemod frente a Opus. “$0” en una transformación no hace gratuitos la planificación, las llamadas de agentes ni el flujo completo.

El User Guide afirma literalmente “75% lower costs by using right-sized models”: costes un 75% menores al usar modelos ajustados a la tarea. Esa afirmación no presenta método ni benchmark que respalde ese porcentaje; no la tratamos como ahorro medido o garantizado. El benchmark antiguo también enumera la reducción de tokens por retrieval, el ahorro de Booster con carga real y la tasa de aciertos de caché como no verificados allí. No sumes esos porcentajes.

Un contrapunto útil es la issue #1748: una evaluación de terceros contra una versión de principios de mayo de 2026 informó del mismo diff de renombrado con 35% más tiempo y 163% más coste, sin uso de herramientas/hooks Ruflo. Los mantenedores reconocieron errores reales y publicaron correcciones concretas, incluidas las versiones 3.6.29/3.6.30, y pidieron repetir las pruebas; un último comentario del 11 de mayo todavía señalaba carencias en las descripciones de herramientas. Que esté cerrada no significa que se hayan revalidado todos los resultados. Tampoco ese informe antiguo demuestra que falle la versión actual. Compara una tarea representativa tuya, con los mismos criterios de aceptación y una referencia sin Ruflo, antes de confiar en el ahorro.

Preguntas frecuentes y límites seguros

¿Necesito saber programar?

No para pedir un plan y entender los papeles. Para modificar y publicar software, alguien sigue teniendo que evaluar archivos, pruebas, privacidad y fallos. Empieza con explicaciones y un proyecto ficticio; pide ayuda antes de aprobar cambios que no sabes evaluar. Ruflo no garantiza que una aplicación sea correcta o segura.

¿Es gratuito? ¿Bajará mi factura de Claude?

El software original tiene licencia MIT. El acceso a Claude, las APIs de proveedores, el alojamiento y las llamadas adicionales de agentes pueden costar dinero o consumir la cuota de una suscripción. La instalación puede descargar paquetes; la primera conversación ya puede consumir uso. Configura límites en el proveedor real, revisa el consumo y autoriza el trabajo explícitamente. Una recomendación de enrutamiento no es un descuento garantizado.

¿Necesito un ordenador potente? ¿Puedo usar el móvil?

La ruta documentada necesita un ordenador compatible, terminal, Node/npm y Claude Code. La página de Anthropic indica al menos 4 GB de RAM para Claude Code; eso no garantiza recursos suficientes para todas las cargas Ruflo. Los servicios locales adicionales de memoria/embeddings pueden necesitar más recursos. Utilizar modelos de proveedores no exige descargar un modelo de última generación completo. El navegador del móvil sirve para leer esta guía, pero no sustituye esta instalación en un ordenador; el acceso remoto sigue dependiendo de un equipo protegido y añade sus propios riesgos.

¿Ejecutarlo localmente significa privado o sin internet?

No. Los plugins se ejecutan localmente, pero las peticiones a modelos pueden salir del ordenador hacia el proveedor elegido. Archivos, prompts, registros y memoria persistente pueden contener datos confidenciales. Mantén secretos y datos reales de clientes fuera del ejercicio, revisa permisos y código de plugins/mods, y utiliza los controles de privacidad del proveedor. Nunca pegues claves de API en prompts de ejemplo ni las incluyas en commits de configuración.

¿Y si no aparecen herramientas, aparecen duplicadas o piden permisos?

Comprueba primero la versión de Claude, el plugin activo, la recarga y la conexión MCP real. Herramientas/hooks duplicados pueden indicar que se han superpuesto plugin y configuración CLI/manual. Haz una copia de seguridad, identifica la duplicación y conserva una única ruta intencionada; no borres ajustes a ciegas. Ante un acceso inesperado, recházalo e investiga en vez de eludir los permisos. Un hook cargado no demuestra una tarea de swarm completada.

¿Cómo deshago el ejercicio?

Detén los procesos que hayas iniciado explícitamente, utiliza la gestión de plugins del asistente para deshabilitar/eliminar los que instalaste y retira solo las entradas MCP que añadiste. Compara los ajustes del proyecto y del usuario con tus copias de seguridad; restaura con cuidado, incluida la referencia en la carpeta personal si init la escribió. Borrar solo la carpeta de práctica no elimina paquetes globales, plugins, ajustes del usuario ni consumo de la cuenta. No hemos probado una reversión automática de Ruflo.

Ten las referencias a mano

Copias locales para leer/descargar: User Guide, README, licencia MIT, benchmark histórico 0002, ADR-143 y notas de verificación e inventario de fuentes. Conservan el material consultado el 22 de octubre de 2026, incluidas afirmaciones históricas superadas por la implementación posterior; no son registros de pruebas de ejecución.

Fuentes y créditos

Ruflo fue creado por Reuven Cohen (rUv)/RuvNet, originalmente como Claude Flow. El proyecto original utiliza la licencia MIT, copyright © 2024–2026 ruvnet: conserva el aviso de copyright y permiso al redistribuir partes sustanciales; el software se proporciona “AS IS”, sin garantía. Cauhi es autor de esta guía explicativa, no de Ruflo.

Los enlaces oficiales de archivos que siguen están fijados al commit 5d99b57e7862c0623cf26e0c152dff60e3b50346, consultado el 22 de octubre de 2026. Los comandos con @latest no están fijados a ese commit.

• README e instalación mediante plugins
• User Guide, incluida la afirmación literal del 75%
• Opciones y efectos de init
• Declaración MCP de Core, launcher y hooks
• Benchmark histórico 0002 y ADR-143
• Definiciones de enrutamiento/codemod, instalador opcional de shell y licencia MIT
• Issue #1748 y respuestas fechadas de los mantenedores: historial mutable de una issue, no archivo fijado a un commit.
• Instalación oficial de Claude Code por Anthropic: instalación nativa y requisitos del ordenador, consultados el 22 de octubre de 2026; documentación viva, no fuente Ruflo fijada.