01 Qué es un subagente y qué información recibe
Un subagente es otra instancia de Claude que tu sesión lanza para una tarea concreta, con su propio prompt de sistema y su propia ventana de contexto. Trabaja aparte y devuelve un texto. Lo importante es lo que no recibe: no ha visto tu conversación. Carga los CLAUDE.md del proyecto, pero todo lo que hayas decidido hablando con Claude tiene que ir escrito en el encargo.
- ✓Rol y criterio: quién es y con qué exigencia trabaja.
- ✓Material exacto: archivos con su ruta o el texto copiado dentro del encargo.
- ✓Alcance: qué tiene que hacer, en pasos, y qué no le toca.
- ✓Formato de salida: lista, tabla o párrafo, con longitud máxima.
- ✓Criterio de terminado: qué condición debe cumplir el resultado.
@agent-code-reviewer revisa los cambios de src/pagos (dentro de Claude Code)
claude --agent code-reviewer (toda la sesión con ese perfil)
/subtask redacta los tests del parser (fork que sí hereda la conversación)02 Límites de concurrencia y profundidad
| Límite | Valor por defecto | Cómo se cambia |
|---|---|---|
| Subagentes simultáneos en una sesión | 20 (al superarlo aparece «Concurrent subagent limit reached») | Variable CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS |
| Capas de subagentes que lanzan subagentes | 3 por debajo de tu conversación | Variable CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH |
| Total de subagentes en la sesión | Sin límite | Se ejecutan por tandas |
{
"env": {
"CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS": "10",
"CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH": "2"
}
}03 Formación 1: fan-out y fan-in
Divides un trabajo en partes similares, lanzas un subagente por parte a la vez y, cuando todos vuelven, un paso final las unifica. Sirve para investigar varias fuentes, revisar un proyecto por carpetas o analizar varios competidores. Sin el paso de unificación (fan-in) solo tienes cuatro informes con formatos distintos.
Lanza un subagente por cada uno de estos competidores: [web 1], [web 2], [web 3], [web 4]. A todos dales exactamente el mismo encargo:
«Eres analista de marketing. Revisa la web indicada y devuelve una tabla con: propuesta de valor en una frase, servicios principales, precios publicados (o «no publica»), público objetivo, llamadas a la acción y tres puntos fuertes. Indica la URL de donde sale cada dato. Máximo 250 palabras.»
Cuando vuelvan todos, une los resultados en una sola tabla comparativa, señala qué datos no se pudieron confirmar y termina con tres oportunidades de diferenciación para nosotros.04 Formación 2: debate
Para decisiones con dos caminos defendibles (migrar o no de framework, mensual o anual, contratar o subcontratar). Dos subagentes defienden posturas contrarias a propósito, cada uno critica al otro una vez y un tercero, que no ha participado, decide con argumentos.
Decisión: [describe la decisión y el contexto con datos].
1. Lanza dos subagentes en paralelo. El A defiende [opción 1] y el B defiende [opción 2]. Cada uno entrega sus cinco mejores argumentos con evidencia y el principal riesgo de su propia postura.
2. Pasa a cada uno los argumentos del otro y pídele una réplica de máximo 150 palabras.
3. Lanza un tercer subagente como juez que reciba solo el contexto y los cuatro textos. Debe elegir una opción, explicar qué argumento ha sido decisivo y qué condición le haría cambiar de opinión.
Devuélveme el veredicto y un resumen de una línea por argumento.05 Formación 3: consenso
Cuando necesitas fiabilidad: varios subagentes resuelven la misma pregunta por separado y te quedas con lo que coincide. Sirve para extraer datos de un contrato, clasificar incidencias o revisar cálculos. Que tres agentes coincidan solo significa algo si han trabajado de forma independiente y cada uno cita dónde se apoya.
Lanza tres subagentes independientes con el mismo encargo y sin compartir sus resultados entre ellos:
«Lee contratos/proveedor.pdf y extrae: duración, renovación automática, preaviso para cancelar, penalizaciones y limitación de responsabilidad. Para cada dato, cita la cláusula exacta. Si algo no aparece, escribe «no consta».»
Después compara las tres respuestas: marca como confirmado lo que coincide en las tres, como dudoso lo que coincide en dos y como discrepancia lo demás. Para cada discrepancia, vuelve tú al documento y resuélvela citando la cláusula.06 Formación 4: orquestador
Para trabajos desiguales: un agente principal planifica, reparte tareas distintas a especialistas (contenido, código, SEO, pruebas) y revisa lo que entregan. Los especialistas no hablan entre sí; toda coordinación pasa por el orquestador. Puedes guardar a los especialistas como subagentes en .claude/agents/ para reutilizarlos.
---
name: revisor-seo
description: Revisa páginas web en español y señala problemas de SEO on-page. Úsalo cuando haya que auditar títulos, encabezados, enlaces internos o metadatos.
tools: Read, Grep, Glob
---
Eres un especialista en SEO on-page. Solo señalas, no corriges.
Devuelve una tabla con: archivo, problema, gravedad (alta, media, baja) y solución propuesta.
Máximo 20 filas, ordenadas por gravedad.Actúa como orquestador del lanzamiento de la landing de [servicio]. Divide el trabajo en tareas independientes y asigna cada una a un subagente: redacción de textos, maquetación, revisión SEO (usa @agent-revisor-seo) y revisión de accesibilidad. Escribe para cada uno un encargo completo con rol, archivos, alcance, formato de salida y criterio de terminado. Enséñame los encargos antes de lanzarlos. Cuando vuelvan, revisa que cada entrega cumpla su criterio, integra los resultados y dime qué ha quedado pendiente.07 Cuál usar en cada caso
| Formación | Úsala cuando | Evítala cuando |
|---|---|---|
| Fan-out | El trabajo se divide en partes parecidas | Las partes dependen unas de otras |
| Debate | Hay dos opciones razonables y mucho en juego | La respuesta es objetiva o la decisión es menor |
| Consenso | Un error saldría caro y el dato es verificable | La tarea es creativa y no tiene respuesta única |
| Orquestador | Las tareas son distintas y requieren especialistas | Una sola persona o agente lo resuelve en minutos |
Preguntas frecuentes
No. Empiezan con el contexto vacío, salvo los CLAUDE.md del proyecto y su propio prompt. Todo lo relevante debe ir en el encargo. La única excepción es el fork con /subtask, que hereda la conversación.
Los mínimos que dividan bien el trabajo. Para la mayoría de tareas, entre tres y cinco. El límite por defecto de 20 simultáneos es un techo técnico, no una recomendación.
No. Los subagentes viven dentro de una sesión y devuelven su resultado a ella. Varias sesiones en paralelo son independientes y se coordinan de otra forma, por ejemplo con worktrees o con la vista de agentes.
Casi siempre falta alguno de los cinco elementos del encargo: rol, material, alcance, formato o criterio de terminado. Revisa el encargo antes de culpar al modelo.
Sobre el autor
Equipo editorial de appyweb
Marketing, SEO y desarrollo con IA
Especialistas de appyweb en SEO, publicidad, desarrollo web y automatización con IA.