Subagentes y delegación
Cuándo conviene repartir una tarea entre varios agentes con su propio contexto, cómo darles encargos claros y cómo reunir sus resultados sin perder el control.
Antes de empezar
- Diseño del contexto para agentesTécnica
Qué información recibe el agente en cada momento, por qué más no siempre es mejor y cómo darle lo justo: lo esencial desde el principio y el resto cuando lo necesite.
Publicado - Verificación y evaluaciónTécnica
Cómo comprobar que el agente hizo bien el trabajo sin fiarte de su palabra: darle formas de verificarse a sí mismo, revisar el resultado y el proceso, y comparar configuraciones con honestidad.
Publicado
La idea clave: un subagente es un agente auxiliar con su propia ventana de contexto. Hace una parte del trabajo y devuelve solo un resumen. Sirve para mantener limpio el contexto principal y para trabajar en paralelo, pero solo si cada parte está bien definida.
El problema
Pídele a un agente que revise un cambio grande y verás cómo se llena su contexto: lee decenas de archivos, explora dependencias, ejecuta pruebas. Cuando llega el momento de decidir, lo importante está enterrado entre los detalles de la exploración.
Un subagente lo resuelve como lo haría un equipo: la persona responsable encarga una investigación a alguien, que trabaja por su cuenta y vuelve con un informe de una página. La responsable no necesita ver todo lo que se leyó; necesita las conclusiones.
Cómo funciona
- El agente principal delega una parte de la tarea con un encargo concreto.
- El subagente trabaja en su propio contexto, con sus propias instrucciones y, a menudo, con un conjunto limitado de herramientas.
- Devuelve un resumen al agente principal. Toda su exploración se queda fuera del contexto principal.
- El agente principal integra los resultados y decide qué hacer.
Los subagentes pueden trabajar en secuencia (uno investiga y otro implementa con esa información) o en paralelo (varios revisan aspectos distintos a la vez).
En Claude Code, por ejemplo, un subagente se define con un archivo Markdown en .claude/agents/ que indica su nombre, su descripción, las herramientas que puede usar y sus instrucciones. Codex y otros clientes ofrecen mecanismos parecidos.
Ejemplo práctico
Un subagente revisor de solo lectura, en el formato de Claude Code:
---
name: security-reviewer
description: Revisa cambios en busca de problemas de seguridad. Úsalo después de modificar código que maneja entradas externas, autenticación o permisos.
tools: Read, Grep, Glob
---
Eres un revisor de seguridad. Revisa el diff indicado y busca:
- entradas externas sin validar;
- secretos en el código;
- permisos más amplios de lo necesario.
No modifiques archivos. Devuelve una lista de hallazgos, cada uno con
archivo, línea, gravedad y por qué es un problema. Si no encuentras nada,
dilo de forma explícita.
Fíjate en tres decisiones:
- Herramientas limitadas: solo puede leer y buscar. Aunque se equivoque, no puede romper nada.
- Encargo acotado: sabe exactamente qué buscar y qué no debe hacer.
- Formato de entrega definido: el agente principal sabe qué va a recibir, incluido el caso “no hay hallazgos”.
Este último punto importa mucho: lo que devuelve un subagente es todo lo que el agente principal sabrá de su trabajo. Pide hechos con evidencia (archivo, línea, salida de un comando), no solo opiniones.
Errores comunes
- Delegar tareas pequeñas. Coordinar tiene un coste: más llamadas, más tiempo y más tokens. Si la tarea cabe con comodidad en un solo agente, no la dividas.
- Paralelizar lo que depende entre sí. Si una parte necesita el resultado de otra, al hacerlas en paralelo saldrán resultados incompatibles.
- Varios subagentes editando los mismos archivos. Sus cambios chocarán. Si varios deben editar, que trabajen en archivos distintos o en copias separadas del repositorio, por ejemplo con worktrees de Git.
- Creerse el resumen sin verificar. Un resumen puede omitir dudas o errores. El agente principal sigue siendo responsable de verificar el resultado final.
- Encargos vagos. “Revisa el código” produce informes vagos. Aplica lo que viste en Diseñar tareas: objetivo, límites y formato de entrega.
Cuándo usarlo
Cuando una tarea tenga partes realmente independientes —investigar tres módulos, revisar seguridad y rendimiento por separado— o cuando una exploración larga vaya a llenar el contexto principal de detalles que luego no necesitas. Para tareas pequeñas o secuenciales, un solo agente es más sencillo y suele bastar.
Siguiente paso
Este es el último tema de la ruta. Con estas piezas —encargos claros, contexto justo, estado fuera del modelo, instrucciones del proyecto, Skills, herramientas contenidas, verificación, hooks y delegación— ya puedes diseñar un harness completo para tu proyecto.
Fuentes
Consultadas el 2026-10-05.
Contenido relacionado
- Skills: procedimientos reutilizables para agentesTécnica
Una carpeta con instrucciones, y opcionalmente scripts y referencias, que enseña al agente un tipo de tarea concreto. Solo se carga cuando hace falta.
Publicado - Herramientas y permisosTécnica
Qué es una herramienta, cómo la usa un agente y cómo decidir qué puede hacer sin preguntar, qué necesita tu aprobación y qué queda prohibido.
Publicado