# Instrucciones para el agente: Ruflo: coordina herramientas y sesiones de agentes

Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.

- Dificultad: intermedio
- Proyecto: https://github.com/ruvnet/ruflo (licencia MIT)
- Guía completa: https://lab.wisd.ai/hub/ruflow-orchestrator

---

## Para el agente: cómo acompañar al usuario

1. Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
2. Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
3. Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
4. Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
5. No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
6. Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.

---

## Pasos de configuración

### Preparación

Comprueba Node.js ≥20 y npm/npx para la ruta MCP, según el manifiesto oficial. Abre la raíz del proyecto y comprueba que tu cliente admite servidores MCP locales por stdio (entrada y salida estándar). La ruta alternativa de plugins exige Claude Code ≥2.1.287.

Para un cliente MCP, ejecuta el asistente documentado desde tu proyecto:

```bash
npx ruflo@latest init wizard
```

El servidor stdio se ejecuta con:

```bash
npx -y ruflo@latest mcp start
```

Para concretar el registro en un cliente stdio, añade a su configuración MCP este bloque y reinicia el cliente:

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

No necesitas mantener el servidor manual de la terminal en ejecución: el cliente lanza su propio proceso.

## Comprobación

Comprueba que el cliente descubre las herramientas y ejecuta una tarea acotada con revisión de cambios.

## Si algo falla

Revisa versión del arnés y ruta elegida: MCP y plugins tienen capacidades distintas.