Claude Code Club · Cuaderno de estudio
Etapa 7 — Agents

🎼 Orquestador + subagentes (cuándo dividir un trabajo)

Lo que te llevarás: un modelo mental limpio de cuándo usar un agente vs. varios — para no sobre-ingeniar tu primer mes y acabar con 8 especialistas rotos en vez de 1 agente que funciona.

Infografía: orquestador con investigador, redactor y crítico
El director de orquesta con sus tres especialistas: RESEARCHER · DRAFTER · CRITIC.

Un agente haciendo un trabajo es el defecto. No dividas el trabajo porque suene guay o porque viste a alguien en Twitter con un enjambre de 12 agentes. Divides cuando una de estas tres cosas es cierta — y no antes:

  1. El trabajo tiene especialistas claramente separados. «Investigar → Redactar → Revisar» son tres cerebros distintos: el investigador quiere ser exhaustivo; el redactor, contundente; el crítico, brutal. Una sola personalidad no puede ser las tres — la voz se vuelve blanda y la investigación, superficial.
  2. El trabajo necesita mucho contexto desechable. ¿Leer 200 archivos para responder una pregunta? Lanza un subagente para la lectura — trabaja en su espacio limpio y te devuelve solo el resumen. Tu sesión principal no se ensucia ni quemas tu ventana de contexto.
  3. Quieres piezas intercambiables. Si mañana quieres otra voz (otra marca, otra audiencia), tener el redactor como su propio archivo significa cambiar un agente sin reconstruirlo todo. La modularidad es para tu yo del futuro.

El patrón orquestador, en palabras llanas

El orquestador es con quien hablas tú. No hace el trabajo — enruta: lee tu petición, decide a qué especialista llamar, le pasa un brief limpio, recoge el resultado, y llama al siguiente o te devuelve el final. Un jefe de proyecto que nunca teclea nada él mismo.

Ejemplo trabajado — flujo de contenido

El orquestador da a cada uno solo lo que necesita — no todo el historial. Los subagentes tienen memoria corta a propósito; es una funcionalidad, no un fallo. Un redactor que vio la conversación de investigación intentará «justificar» el ángulo en el post. No quieres eso.

Qué NO sobre-ingeniar

🧪 El test mínimo multi-agente: estás listo para dividir cuando puedas escribir «el especialista A hace X, el B hace Y, el orquestador llama a A y luego a B». Si no cabe en dos líneas, no estás dividiendo — estás dando bandazos. Vuelve al agente único y aprieta el SOUL.
🧩 ¿Quieres los cuatro patrones prefabricados? Cuando este instinto de cuándo-dividir se sienta real, la lección «Los cuatro patrones de subagente» (Code Review · Explorar-luego-Actuar · Paralelo · Simplificador) te da cuatro formas con nombre para copiar en vez de inventar la tuya.
Fuente: Claude Code Club · Aula · Etapa 7 «Agents» — lección «Orquestador + subagentes (cuándo dividir un trabajo)».
Añadido al cuaderno: 7 de julio de 2026. Traducción al español para estudio personal.