Al terminar este módulo, vas a contratar a tu primer equipo: agentes especializados que trabajan en paralelo mientras tú diriges.
Con este módulo cierras el arco de los superpoderes — y es el más gordo del manual, porque es el que más cambia cómo trabajas. Hasta hoy has dirigido a UN empleado. Hoy descubres que ese empleado puede, a su vez, contratar ayuda.
¿Te acuerdas de la mesa del módulo 2 — la ventana de contexto, todo lo que Claude lee y escribe ocupando lugar? Una investigación larga (leer 40 archivos, comparar, resumir) llena esa mesa rapidísimo, y para cuando llega la parte que de verdad te importa —la conclusión— la mesa ya está saturada de borradores, intentos y lecturas de más.
La solución no es una mesa más grande. Es OTRO empleado, con SU PROPIA mesa vacía, al que le encargas por escrito exactamente lo que necesitas — y que solo te trae de vuelta la conclusión, no todo su desorden de trabajo.
Un subagente es otro empleado con su propia mesa limpia y un encargo por escrito. Nace CIEGO: no vio tu conversación, no sabe qué archivos ya leíste, no conoce tu negocio — es, otra vez, el empleado en su primer día del módulo 0, solo que ahora lo contratas TÚ, a mitad de tu propia sesión, para una chamba puntual. Por eso su encargo tiene que llevar TODO lo que necesita saber: dónde buscar, qué formato de entrega, qué NO tocar. Cuando termina, no te regresa su mesa llena de borradores — te regresa el resultado.
Cuando Claude decide (o tú le pides) contratar a un subagente, lo ves pasar en tu propia pantalla: un bloque nuevo que dice algo como "Agent (nombre-del-especialista)…" y empieza a trabajar aparte. Esa herramienta —la que dispara la contratación— se llamaba Task; hoy se llama Agent (si en algún tutorial viejo ves la palabra "Task", es la misma herramienta con el nombre anterior; sigue funcionando igual).
El Task / Agent tool es la contratación en vivo: eso que ves aparecer en pantalla es, literalmente, a tu empleado contratando a otro delante de ti.
Cuando Claude contrata a un subagente, vas a ver algo así:
● Agent (analista) — Auditando proyecto-auditable/…
Leyendo gastos.csv (33 movimientos)…
Escribiendo dictamen-analista.md…
✔ Listo — 3 hallazgosQué significa: ese bloque es OTRA mesa, trabajando aparte de la tuya. Tú puedes seguir viendo cómo avanza, o seguir platicando de otra cosa mientras tanto.
Si en vez de eso ves que Claude hizo la chamba él mismo, sin contratar a nadie: no pediste (ni existe todavía) un subagente para eso — más abajo armas el tuyo.
Un dato fresco, y de los buenos: antes, cuando Claude contrataba a alguien, decidía caso por caso si te dejaba trabajando mientras el subagente iba, o si te hacía esperar a que terminara. Hoy cambió el default: salvo que la chamba lo requiera de inmediato, el subagente arranca directo en segundo plano — tú sigues en lo tuyo, pidiendo otras cosas, y Claude solo lo trae "al frente" cuando de verdad necesita su resultado para continuar. Cuando termina, te avisa.
¿Te acuerdas del tercer cajón de la oficina, del módulo 5 — la nómina, que dijimos que abríamos hasta hoy? Ahí es: cada subagente tuyo es un archivo .md dentro de ~/.claude/agents/, con la misma anatomía de dos partes que ya conoces de los skills (módulo 7): arriba, la etiqueta de portada; abajo, las instrucciones en español normal.
Los datos de la etiqueta que te importan:
| Campo | Para qué sirve |
|---|---|
| name | El nombre del puesto |
| description | El gatillo — cuándo Claude debe contratarlo (igual que la description de un skill) |
| tools | Qué manos tiene permitidas — si solo lee, no le des permiso de escribir |
| model | Qué cerebro trae puesto (¿te acuerdas de los puestos del módulo 6? aquí se asigna) |
Y lo más importante para un negocio: los candados —las reglas de "esto jamás lo hagas"— se escriben DENTRO del archivo del subagente, no se los tienes que repetir cada vez que lo contratas. Se crean igual que los skills: se lo dictas a Claude y él escribe el archivo.
Así se ve uno real y sencillo por dentro (el que vas a usar hoy mismo, referencia en ejercicios/m09/analista-ejemplo.md):
---
name: analista
description: Analista read-only del negocio. Audita una carpeta y entrega su
dictamen en un archivo. Úsalo cuando pida "audita", "analiza la carpeta" o
"dame un dictamen".
tools: Read, Glob, Grep, Write
---
Eres el analista del negocio: ojos frescos, cero manos sobre lo que auditas.
1. Lee TODO lo que haya en la carpeta que te indiquen.
2. Busca hallazgos reales: números que no cuadran, duplicados, faltantes —
cada uno con su evidencia exacta.
3. Entrega tu dictamen en dictamen-analista.md: veredicto, hallazgos, lo que
NO pudiste verificar, y 3 recomendaciones.
Candado: JAMÁS edites, muevas ni borres lo que auditas — solo escribes tu
propio dictamen.Fíjate dónde vive el candado: no en tu memoria, no en un mensaje que le mandaste hace rato — en el archivo mismo. Cada vez que este subagente trabaje, así sea dentro de un año, el candado sigue ahí.
Síntoma: "Tecleé /agents esperando ver mi nómina completa y solo me salió un mensaje."
Causa: /agents dejó de ser un menú interactivo (cambio reciente) — hoy solo te recuerda cómo crear o editar tus subagentes.
Salida: pídeselo directo a Claude: "lista los subagentes que tengo instalados y qué hace cada uno" — él lee la carpeta ~/.claude/agents/ por ti y te lo traduce.
Aquí está la distinción que más confunde, y que vale la pena dejar clarísima.
Un subagente es un TRABAJADOR: tiene criterio propio dentro de su encargo, decide CÓMO hacer su parte. Un workflow es un GUION: pasos escritos una sola vez, siempre en el mismo orden, que pueden despachar a muchos trabajadores a la vez — decenas, hasta cientos. El guion no piensa. El trabajador no decide el orden del guion.
Cuándo usas cada uno, con ejemplo aterrizado:
Un caso real, ya documentado por Anthropic mismo: el equipo de Growth Marketing de la propia casa procesa cientos de anuncios en una hoja de cálculo, identifica los de bajo desempeño y genera variantes dentro de límites de caracteres usando subagentes — "cientos de anuncios nuevos en minutos en vez de horas" ("hundreds of new ads in minutes instead of hours"). Cuando la escala crece todavía más —de cientos de piezas a algo que ni conviene ir despachando contratación por contratación— es cuando entra el guion: un workflow escrito una vez que reparte ese trabajo de forma reusable, sin que Claude tenga que decidir cada despacho en vivo.
Para tu negocio del día a día, casi todo lo que vas a necesitar es un subagente (o un par, en paralelo). El guion es el escalón siguiente: existe, lo escribe Claude cuando la tarea de verdad es de decenas o cientos de piezas — no lo vas a necesitar todas las semanas.
Si esto te suena a chino, bríncatelo: no lo necesitas para seguir. Un subagente puede, a su vez, contratar a OTRO subagente (hasta 5 niveles de profundidad) — un especialista que reparte partes de su propio encargo a más ayuda. Tú nunca ves ese detalle: solo te llega el resultado final, ya masticado.
Cuando despachas más de un subagente, hay dos formas de organizarlos:
La orquestación es repartir trabajo entre varios empleados, y el broker es el jefe por el que todo pasa: los empleados NO se contratan entre ellos por su cuenta — todo encargo, y todo resultado, cruza primero por el jefe.
Dos patrones, en llano:
Y una regla que separa a quien dirige agentes en serio de quien se lleva sorpresas:
El reporte de un subagente es una AFIRMACIÓN, no un hecho — igual que el reporte de una persona. Antes de darlo por bueno: abre el archivo que dice haber creado, corre lo que dice que ya corrió, mira el resultado con tus propios ojos. Un subagente entusiasta que se equivoca suena EXACTAMENTE igual de seguro que uno que acertó.
Por eso el entregable de un subagente siempre aterriza en un dictamen: un archivo, no un mensaje de chat que se pierde entre el resto de la conversación. Un archivo sobrevive, se revisa, se le puede pasar al siguiente eslabón sin tener que volver a explicar nada.
Síntoma: "Los dos dictámenes salieron, pero uno dice cosas que no cuadran con lo que hay en la carpeta real."
Causa: exactamente lo que dice la regla de arriba — un subagente también se puede equivocar o inventar un dato.
Salida: ábrelo tú y compáralo contra el archivo original; si algo no cuadra, pídele al subagente (o a Claude) que lo corrija citando la evidencia exacta, línea por línea.
Cada subagente nace ciego, y eso tiene un costo: tiene que releer todo desde cero, lo cual toma tiempo y mesa. Para la chamba chica del día a día —una pregunta, un archivo, un ajuste rápido— contratar a alguien más es más lento que simplemente pedírselo a Claude en tu propia conversación. Los subagentes ganan cuando la chamba es grande, se puede partir en pedazos independientes, o es tan delicada que vale la pena un par de ojos frescos y separados. No es la herramienta para todo; es la herramienta para esto.
SmartProcess corre una nómina real de subagentes en producción. Dos ejemplos de la cadena: el Perito hace un análisis exhaustivo y READ-ONLY de un problema y entrega su dictamen en archivo — nunca edita nada, nunca crea ramas. Ese dictamen pasa a el Programador, que arregla el problema en una rama propia, corre las pruebas, y reporta para aprobación — pero JAMÁS hace push ni merge: eso lo decide el humano. Los dos Peritos de la casa (análisis y seguridad) trabajan en PARALELO sobre el mismo repo cuando hace falta, porque no dependen uno del otro.
Todo ese reparto obedece seis leyes fijas, escritas en la constitución de la casa:
La cadena completa, de punta a punta: ticket → el Perito entrega dictamen en archivo → el Programador arregla en rama, sin tocar main → el humano revisa y aprueba. Ningún eslabón se salta al humano en la decisión que de verdad importa.
Qué vas a lograr: tu primer subagente real —un "analista" READ-ONLY con el candado grabado en su propio archivo— y la experiencia de despachar DOS a la vez, cada uno con su chamba, mientras tú sigues en lo tuyo.
Qué necesitas: la carpeta ejercicios/m09/proyecto-auditable/ (trae gastos.csv y una carpeta contenido/ con 5 posts de un negocio ficticio) y, como referencia por si te atoras, ejercicios/m09/analista-ejemplo.md.
Pasos:
proyecto-auditable completa dentro de ~/Curso-Claude/.Quiero crear un subagente llamado "analista": read-only, audita la carpeta que le indique, y entrega su dictamen en un archivo dictamen-analista.md (veredicto en 2 líneas, hallazgos con evidencia, lo que no pudo verificar, 3 recomendaciones). Candado: jamás edita, mueve ni borra lo que audita — solo escribe su propio dictamen. Escríbelo en mi carpeta de subagentes y enséñamelo antes de guardarlo. Si te atoras, hay un ejemplo de referencia en ejercicios/m09/analista-ejemplo.md.
Vas a ver algo así:
● Agent (analista) — auditando contenido/…
Leyendo 5 archivos…
Escribiendo dictamen-analista.md…
✔ ListoQué significa: el analista trabajó en SU mesa, y solo te regresó el resultado — no viste sus lecturas de más ni sus intentos.
Si en vez de eso ves que te pide más datos: dale la ruta completa de la carpeta; nació ciego, no adivina dónde estás parado.
Despacha al analista sobre proyecto-auditable/gastos.csv Y al analista sobre proyecto-auditable/contenido/, cada uno por su cuenta, cada uno con su propio dictamen.
Vas a ver algo así:
● Agent (analista) — auditando gastos.csv…
● Agent (analista) — auditando contenido/…
(los dos avanzando a la vez)
✔ dictamen-analista.md (gastos) — 1 hallazgo
✔ dictamen-analista.md (contenido) — 2 hallazgosQué significa: son dos mesas trabajando al mismo tiempo, cada una en lo suyo, y tú no tuviste que dirigir el tráfico.
Si en vez de eso ves que los corrió uno después del otro: pídele explícito "quiero que corran los dos AL MISMO TIEMPO, no uno primero" — a veces hay que pedir el paralelo con esas palabras.
gastos.csv. Debe negarse — ese candado vive en SU archivo, no en tu memoria.¿LO LOGRASTE?
dictamen-analista.md (uno para gastos, otro para contenido), en archivo.subagente — otro empleado con mesa limpia y encargo por escrito; nace ciego, no vio tu conversación.
Task / Agent tool — la herramienta con la que Claude contrata subagentes; la "contratación en vivo" (antes se llamaba Task, hoy Agent).
workflow — el guion determinista que despacha muchos agentes en un orden fijo.
orquestación / broker — repartir trabajo entre agentes; el jefe por el que todo pasa.
paralelo / pipeline — a la vez (sin dependencia) / en cadena (con dependencia).
dictamen — el entregable de un agente, aterrizado en archivo, no en chat.
La demo de 5 minutos: despacha en vivo dos subagentes en paralelo sobre una carpeta real del salón y, mientras trabajan, sigue platicando con el grupo de otra cosa. El "¿o sea que puedo tener varios a la vez?" es el momento que vende el módulo entero.
El error que el alumno VA a cometer: escribir un encargo incompleto ("audita esto") sin decir carpeta, formato ni candado — y el subagente improvisa o se sale de su chamba. Provócalo a propósito, y luego arréglenlo juntos agregando lo que faltaba: la lección de "el encargo lleva TODO" se queda sola.
La pregunta de arranque: "¿Qué chamba de tu negocio necesitaría dos pares de ojos a la vez, cada uno viendo algo distinto?"
Verificado contra documentación oficial el 2026-07-12.