Swarm básico: 3 agentes con routing
Un repo con README: instalación en una línea, la configuración de routing ya escrita (las tareas simples van al modelo barato, las complejas al bueno) y tres roles de agente listos: el que investiga, el que escribe y el que revisa.
Para qué sirve
Para repartir un trabajo grande entre tres agentes sin pagar el modelo caro por todo. El routing decide por tarea; los tres roles cubren el ciclo investigar → escribir → revisar, que es el que produce trabajo bueno en vez de rápido.
Instalación
git clone [el repo] && cd swarm-basico && ./instalar.sh
Deja la carpeta .claude/agents/ con los tres roles y routing.json con las reglas.
Los tres roles
| Agente | Qué hace | Qué modelo usa | Qué devuelve |
|---|---|---|---|
| investigador | Lee las fuentes que le des y saca los hechos con su cita | El rápido | Una lista de hechos con fuente |
| escritor | Con los hechos, escribe la pieza en tu voz | El bueno | El archivo escrito |
| revisor | Lee la pieza contra los hechos y corrige el archivo (no escribe un informe sobre el informe) | El bueno | El archivo corregido y 5 líneas de qué cambió |
El routing
{
"simple": { "modelo": "rapido", "cuando": ["clasificar", "extraer", "resumir < 2 páginas", "buscar en archivos"] },
"compleja": { "modelo": "bueno", "cuando": ["escribir para publicar", "revisar", "decidir entre opciones", "código"] },
"regla": "ante la duda, rápido primero; si el resultado no pasa la revisión, se repite con el bueno"
}
Cómo se usa
«Investiga [tema] en estos archivos, escribe [la pieza] y revísala». El agente principal reparte: investigador → escritor → revisor, y te entrega el archivo final más el resumen del revisor.
Las dos reglas que evitan que se descontrole
- Máximo tres agentes a la vez. Un agente puede lanzar sub agentes, así que dos se vuelven doce si no se limita.
- Cada agente escribe a disco y devuelve un resumen, nunca el trabajo entero en la respuesta: si se corta, lo hecho queda guardado.
Qué NO resuelve
No mejora una fuente mala: el investigador saca lo que hay. Y no reemplaza tu lectura final.
Siguiente paso
«Tu equipo de agentes, un archivo por rol» es este mismo esquema con seis roles de negocio.