# Swarm Orchestration

> Coordinación de swarms multi-agente para tareas complejas. Usa topología jerárquica con agentes especializados para dividir y ejecutar trabajo en varios archivos y módulos.

Fuente: https://skillsagentes.com/skills/ruvnet/ruflo/swarm-orchestration
Markdown: https://skillsagentes.com/skills/ruvnet/ruflo/swarm-orchestration.md

Repositorio: https://github.com/ruvnet/ruflo
Autor: ruvnet
Licencia: MIT
Actualizado: hace 6 meses
Coste de contexto: 126 tok instalada, 779 tok al activarse, 906 tok con todos los archivos del bundle
Bundle: 3 archivos, 4 KB
Permisos que pide: ninguno declarado

## Instalación

Un skill son archivos markdown: los mismos archivos valen para cualquier agente y lo único que cambia es el directorio de destino, es decir la bandera `--agent`. Añade `-g` para instalarlo en todos los proyectos de la máquina.

```bash
# Claude Code
npx -y skills add ruvnet/ruflo --skill swarm-orchestration --agent claude-code
# Cursor
npx -y skills add ruvnet/ruflo --skill swarm-orchestration --agent cursor
# Codex
npx -y skills add ruvnet/ruflo --skill swarm-orchestration --agent codex
# Gemini CLI
npx -y skills add ruvnet/ruflo --skill swarm-orchestration --agent gemini
# Windsurf
npx -y skills add ruvnet/ruflo --skill swarm-orchestration --agent windsurf
# Cline
npx -y skills add ruvnet/ruflo --skill swarm-orchestration --agent cline
```

## Qué hace

- Coordina un swarm de agentes con topología jerárquica para dividir y ejecutar tareas complejas.
- Enruta tareas al tipo de agente adecuado según su naturaleza.
- Genera y spawnea agentes especializados y monitorea el estado del swarm.

## Cuándo usarla

- Cambios en 3 o más archivos, nueva funcionalidad o refactorización entre módulos.
- Cambios de API con tests, cambios relacionados con seguridad o de esquema de base de datos.
- Optimización de rendimiento en todo el código base.

## Cuándo no

- Edición de un solo archivo o corrección de bugs simples (1-2 líneas).
- Actualizaciones de documentación o cambios de configuración.
- Exploración rápida.

## Qué la activa

- "Inicializa un swarm jerárquico con 8 agentes para implementar OAuth2"
- "Orquesta la tarea de refactorizar el módulo de auth con estrategia paralela"
- "Lista todos los agentes activos del swarm"

## Antes de instalar

- Necesita en el PATH: npx

## Archivos

- SKILL.md — 3 KB
- scripts/swarm-monitor.sh — 177 B
- scripts/swarm-start.sh — 331 B

## SKILL.md

Reproducido tal cual desde ruvnet/ruflo bajo MIT. Esta sección es el documento original y está en inglés.

# Swarm Orchestration Skill

## Purpose
Multi-agent swarm coordination for complex tasks. Uses hierarchical topology with specialized agents to break down and execute complex work across multiple files and modules.

## When to Trigger
- 3+ files need changes
- new feature implementation
- cross-module refactoring
- API changes with tests
- security-related changes
- performance optimization across codebase
- database schema changes

## When to Skip
- single file edits
- simple bug fixes (1-2 lines)
- documentation updates
- configuration changes
- quick exploration

## Commands

### Initialize Swarm
Start a new swarm with hierarchical topology (anti-drift)

```bash
npx @claude-flow/cli swarm init --topology hierarchical --max-agents 8 --strategy specialized
```

**Example:**
```bash
npx @claude-flow/cli swarm init --topology hierarchical --max-agents 6 --strategy specialized
```

### Route Task
Route a task to the appropriate agents based on task type

```bash
npx @claude-flow/cli hooks route --task "[task description]"
```

**Example:**
```bash
npx @claude-flow/cli hooks route --task "implement OAuth2 authentication flow"
```

### Spawn Agent
Spawn a specific agent type

```bash
npx @claude-flow/cli agent spawn --type [type] --name [name]
```

**Example:**
```bash
npx @claude-flow/cli agent spawn --type coder --name impl-auth
```

### Monitor Status
Check the current swarm status

```bash
npx @claude-flow/cli swarm status --verbose
```

### Orchestrate Task
Orchestrate a task across multiple agents

```bash
npx @claude-flow/cli task orchestrate --task "[task]" --strategy adaptive
```

**Example:**
```bash
npx @claude-flow/cli task orchestrate --task "refactor auth module" --strategy parallel --max-agents 4
```

### List Agents
List all active agents

```bash
npx @claude-flow/cli agent list --filter active
```

## Scripts

| Script | Path | Description |
|--------|------|-------------|
| `swarm-start` | `.agents/scripts/swarm-start.sh` | Initialize swarm with default settings |
| `swarm-monitor` | `.agents/scripts/swarm-monitor.sh` | Real-time swarm monitoring dashboard |

## References

| Document | Path | Description |
|----------|------|-------------|
| `Agent Types` | `docs/agents.md` | Complete list of agent types and capabilities |
| `Topology Guide` | `docs/topology.md` | Swarm topology configuration guide |

## Best Practices
1. Check memory for existing patterns before starting
2. Use hierarchical topology for coordination
3. Store successful patterns after completion
4. Document any new learnings

## Dónde encaja

- Categoría: [Automatización](https://skillsagentes.com/categorias/automatizacion.md) — Flujos de varios pasos que se ejecutan sin supervisión.
- Creador: [ruvnet](https://skillsagentes.com/creators/ruvnet.md) — 275 skills en el directorio
- [Todas las skills](https://skillsagentes.com/skills.md)
- [Ranking de instalaciones](https://skillsagentes.com/ranking.md)

## Otras skills del mismo repositorio

- [Harness Gepa](https://skillsagentes.com/skills/ruvnet/ruflo/harness-gepa.md): Inspecciona y audita genomas GEPA: carga y valida un genoma, renderiza el system prompt que compila, o clasifica los modos de fallo de una transcripción de ejecución.
- [Deepseek Reason](https://skillsagentes.com/skills/ruvnet/ruflo/deepseek-reason.md): Completion en modo razonamiento contra deepseek-reasoner (R1) de DeepSeek. Devuelve el chain-of-thought por separado de la respuesta final. Lee DEEPSEEK_API_KEY y degrada si falta o la API no responde.
- [Deepseek Chat](https://skillsagentes.com/skills/ruvnet/ruflo/deepseek-chat.md): Completion de un solo turno contra el modelo deepseek-chat de DeepSeek vía /v1/chat/completions. Lee DEEPSEEK_API_KEY y degrada con status:degraded si falta o la API no responde. Para tareas sin razonamiento.
- [Adr Index](https://skillsagentes.com/skills/ruvnet/ruflo/adr-index.md): Construye o reconstruye el índice de ADRs y su grafo de dependencias ejecutando scripts/import.mjs, en vez de cientos de llamadas MCP.
- [Agntcy Status](https://skillsagentes.com/skills/ruvnet/ruflo/agntcy-status.md): Muestra el estado de la integración AGNTCY/SLIM/CASA: si los paquetes están instalados, qué transporte está activo y si el enforcement de CASA está habilitado.

---

Skills Agentes · [Índice de páginas en markdown](https://skillsagentes.com/sitemap.md) · [Inicio](https://skillsagentes.com/index.md)