Si construyes con Claude, lo que te falta aprender es a dirigir
El modelo más caro que tienes no debería estar escribiendo código. Debería estar repartiendo el trabajo y revisando lo que le entregan. Esta guía es el oficio completo: el documento que se reparte, quién dirige según tu plan, las cuatro formas de repartir, el contrato que le exiges a cada agente y el bucle donde le regresas el trabajo al que no cumplió.
Las nueve paradas · de un vistazo
Antes de repartir, escríbelo
Un prompt que te entrevista y deja tu semana en un archivo. Sin documento no hay reparto.
Opus 5 si pagas $20, Fable 5 si pagas más
La razón real no es el poder del modelo: es que en Pro cada token de Fable se cobra aparte.
Modo plan, y la orden de no tocar nada
Abres Claude Code en la carpeta, entras a modo plan y le dices que solo lea. Nada más.
Quién sostiene el plan
Subagentes, habilidades, equipos y workflows resuelven lo mismo. Cambia quién decide qué sigue.
Perfiles con modelo asignado
El prompt que reparte la lista, y los archivos de agente donde queda escrito quién usa Opus y quién Sonnet.
Qué te tiene que entregar cada uno
Archivo, formato, criterio de aceptación y zona prohibida. Sin esto no puedes rechazar nada.
Workflows o equipos de agentes
Una es estable y se prende en /config. La otra es experimental y trae el bucle de revisión de fábrica.
Al que no cumpla, regrésaselo
Tres maneras de cerrar el ciclo: el prompt a mano, una condición verificable y la aprobación de plan.
Qué haces tú, y qué te cuesta
La vista de progreso, los topes reales y las tres palancas para que no se te vaya la cuenta.
Guía comunidad · 31 de julio de 2026
Tú no construyes: repartes y revisas. Nueve paradas, siete prompts para copiar y las dos rutas para armarlo.
Casi todos usan el modelo grande como si fuera un programador más rápido. Ese es el desperdicio. Un director no toca el instrumento: decide quién toca qué, con qué criterio, y para cuándo. Aquí armas ese puesto de principio a fin — desde la entrevista que convierte lo que traes en la cabeza en un documento repartible, hasta la vuelta en la que el director te dice cuál entregable no pasó y por qué.
01 el documento
Antes de repartir, escribe lo que hay que hacer
Abres Claude Code y escribes lo primero que traes en la cabeza. Te contesta rápido, se siente productivo. Veinte minutos después le pides otra cosa, y otra, y para el turno doce está construyendo lo que entendió de tu última frase, no lo que tú traías desde el principio. No se le olvidó: nunca lo tuvo escrito.
Ese es el techo real de trabajar sin documento. Mientras el plan viva nada más en tu cabeza, tú eres el único que lo conoce, y eso te vuelve el cuello de botella de todo lo que quieras repartir. No puedes delegar lo que no está escrito. Cada agente que lances va a recibir el resumen que se te ocurra en ese momento, distinto del que le diste al anterior.
Por eso el primer paso de orquestar no es abrir la terminal. Es producir un archivo.
SÍNTOMAS
Así se ve trabajar sin documento
- Le explicas el mismo proyecto tres veces en la misma semana, y cada vez sale distinto.
- Te entrega algo y no sabes si está bien o no. Solo sabes que no era lo que imaginabas.
- A la mitad te preguntas si ya hizo lo del lunes, y tienes que subir a leer la conversación.
- Todo lo que arranca lo arrancas tú. Nada avanza mientras no estés escribiendo.
Por qué gana un archivo
Sobrevive al contexto
La conversación se compacta sola cuando crece, la sesión se cierra y mañana abres otra. El archivo sigue ahí, igualito. Lo que solo dijiste se pierde en el primer arranque nuevo.
Se puede repartir
Un archivo se parte en pedazos y cada pedazo se le entrega a un agente distinto, con exactamente la misma redacción para todos. Un resumen hablado se degrada cada vez que lo repites.
Se puede revisar contra él
Cuando el trabajo regresa necesitas algo con qué compararlo. Sin documento no puedes rechazar nada, solo opinar. Con documento, o cumple la línea que dice qué es terminado, o no la cumple.
La forma rápida de sacarlo de tu cabeza
No te sientes a escribirlo. Deja que te entrevisten. El prompt de abajo abre una sesión que no construye nada: pregunta. Una pregunta, se detiene y espera. Si contestas vago, repregunta sobre ese mismo punto antes de avanzar.
Son entre diez y quince minutos, y sí, se siente lento. Es el mismo rato que ibas a perder corrigiendo trabajo mal encaminado, solo que gastado antes y no después.
El prompt que te entrevista
Pégalo en una sesión nueva y deja que te pregunte. No es tu calendario ni tu agenda: es tu lista de construcción, la que después se reparte entre agentes. Sale un archivo SEMANA.md.
Vas a entrevistarme para armar la lista de todo lo que tengo que sacar esta semana. Reglas de la entrevista: - Una pregunta a la vez. Preguntas, te detienes y esperas mi respuesta antes de la siguiente. - Nada de preguntas dobles ni de listas de cinco puntos en un mismo mensaje. - Si mi respuesta queda vaga, repregunta sobre ese mismo punto antes de avanzar. De cada pendiente tienes que sacarme estas cinco cosas: 1. Qué tengo que entregar exactamente, y a quién le llega. 2. Para cuándo. Fecha concreta, no "esta semana". 3. Qué ya existe y qué es desde cero. 4. Qué NO se debe tocar: archivos, carpetas, accesos, textos que ya están aprobados. 5. Qué significa "terminado" para ese punto, dicho de una forma que se pueda comprobar. Cuando ya no me quede ningún pendiente por contarte, escribe el archivo SEMANA.md con la lista completa: un bloque por pendiente y esos cinco campos en cada bloque. No propongas soluciones, no me recomiendes herramientas y no empieces a construir nada. Esta ronda es solo para entender qué hay que hacer.
De cada pendiente te va a sacar cinco cosas: qué se entrega, para cuándo, qué ya existe, qué no se toca y qué significa terminado. El campo incómodo es el último. Ahí es donde vas a descubrir que la mitad de tus pendientes no tienen definición de terminado, tienen una sensación.
DETALLE QUE IMPORTA
Una pregunta a la vez, en serio
Si te manda cinco preguntas juntas, vas a contestar las fáciles y a saltarte la que todavía no tienes resuelta. Justo esa es la que después se convierte en una suposición del agente. En cuanto lo veas amontonar preguntas, córtalo y pídele que regrese a una por turno.
SEMANA.md
lo que sale de la entrevista
# SEMANA.md — del 3 al 9 de agosto Cinco pendientes. Ninguno se da por terminado sin su criterio. --- ## 1 · Landing de Casa Miralta - **Entregable:** la página del cliente en /clientes/casa-miralta, con encabezado, tres bloques de servicio, formulario de contacto y pie. - **Fecha:** viernes 7, antes de las 6 pm. La presento en llamada ese día. - **Qué existe:** los textos ya están aprobados en textos/casa-miralta.md y el logo está en public/clientes/. La página es desde cero. - **No tocar:** nada fuera de la carpeta del cliente. El tema global y los componentes compartidos se quedan como están. - **Terminado cuando:** la página abre sin errores en consola, se ve bien a 390 y a 1280 de ancho, y el formulario manda el correo de prueba a mi bandeja. --- ## 2 · Tres creativos para la campaña de agosto - **Entregable:** tres piezas, cada una en 1080x1350 y en 1080x1920. Seis archivos. - **Fecha:** miércoles 5. Se programan el jueves temprano. - **Qué existe:** concepto y copy aprobados en campanas/agosto/brief.md. Las fotos de producto ya están en la carpeta. - **No tocar:** el copy no se cambia ni una palabra. Los precios no aparecen en las piezas. - **Terminado cuando:** los seis archivos existen con el nombre acordado, ninguno recorta el producto, y todo el texto queda dentro de la zona segura de cada medida. --- ## 3 · Agente de WhatsApp que conteste preguntas frecuentes - **Entregable:** el documento con las preguntas, las respuestas y las reglas de cuándo pasa a una persona. - **Fecha:** domingo 9. El lunes 10 arranca la prueba con clientes reales. - **Qué existe:** las conversaciones viejas exportadas en datos/whatsapp/. El bot todavía no existe; esta semana es solo el guion. - **No tocar:** no se inventan políticas de devolución, tiempos de entrega ni precios. Si falta un dato, se marca como FALTA. - **Terminado cuando:** hay al menos 15 preguntas con su respuesta, cada respuesta cabe en un mensaje de celular, y está escrito qué se escala a una persona. --- ## 4 · El formulario de contacto no manda correo - **Entregable:** el arreglo, en el archivo donde esté la falla. - **Fecha:** hoy. Lleva dos días caído y ahí es donde entran los prospectos. - **Qué existe:** pasa solo en producción desde el martes; en local sí manda. El proveedor de correo no reporta caídas. - **No tocar:** no se cambia de proveedor ni se mueven variables de entorno sin avisarme antes. - **Terminado cuando:** se manda un correo de prueba desde producción y llega, y queda escrito en una línea cuál era la causa. --- ## 5 · Actualizar el README del repo de la tienda - **Entregable:** README.md al día. - **Fecha:** domingo 9. Sin prisa, pero sin falta. - **Qué existe:** el README de hace ocho meses. Los comandos cambiaron y hay dos variables de entorno nuevas. - **No tocar:** no se agregan secciones nuevas ni se reescribe el tono. Solo se corrige lo que ya no es cierto. - **Terminado cuando:** cada comando del README corre sin error, y las variables de entorno que pide coinciden con las que usa el código de hoy.
Cinco pendientes revueltos a propósito: una página de cliente, un lote de creativos, un guion de atención, un error caído en producción y un documento viejo. Así se ve una semana de verdad. Este mismo archivo es el que se reparte más adelante.
QUÉ ES Y QUÉ NO ES
Esto no es tu agenda semanal
No lleva juntas, ni recordatorios, ni el gimnasio, ni el pendiente de hablarle al contador. No es tu calendario ni tu planeación personal.
Es tu lista de construcción: el inventario de lo que hay que producir, escrito para que otro lo ejecute sin preguntarte nada. Si un renglón no le sirve a un agente, no va aquí.
Y al revés: si un pendiente tuyo no cabe en este formato, casi siempre es porque todavía no está listo para repartirse. Le falta que tú decidas algo.
Cuatro señales de que ya se puede repartir
- Cada punto nombra un entregable concreto, con su ruta o su nombre de archivo. "Mejorar la landing" no es un entregable; "la página en /clientes/casa-miralta" sí lo es.
- Cada punto dice cuándo está terminado, y eso se comprueba leyendo un archivo o corriendo algo. Si el criterio se puede discutir en una junta, no sirve como criterio.
- Ningún punto depende de una decisión que todavía no tomas. El precio, el proveedor, el nombre: eso es pendiente tuyo antes de ser tarea de nadie.
- Cada punto dice qué no se toca. Esa zona prohibida es lo único que evita que dos agentes se peleen el mismo archivo cuando corran al mismo tiempo.
Si las cuatro se cumplen, ya tienes qué repartir. Si falla una, arréglala aquí: corregirla ahora cuesta un renglón; corregirla después cuesta una tarde de trabajo devuelto.
02 quién dirige
Opus 5 si pagas $20, Fable 5 si pagas más
La regla que corre por ahí es «depende de tu cuenta». Es cierta y no sirve de nada. La razón real no tiene que ver con qué modelo razona mejor, sino con cómo te lo cobran — y eso sí está escrito, plan por plan.
En Max, tanto el de $100 como el de $200, Fable 5 viene incluido: puedes gastar hasta la mitad de tus límites semanales en él sin costo extra. Es muchísimo. Media semana entera dirigiendo con el modelo más capaz que tienes, sin sacar la tarjeta.
En Pro, el de $20, Fable 5 también está disponible, pero no entra en los límites de tu plan. Corre con usage credits de pago desde el primer token. No hay cuota incluida que se acabe primero: el primer mensaje que le mandes a Fable ya es un cargo aparte. Con Opus 5 no pasa eso — Opus sí está dentro del plan de $20.
De ahí sale la regla, y es de dinero, no de inteligencia: con $20 diriges con Opus 5; con $100 o $200 diriges con Fable 5. En los dos casos los subagentes que construyen pueden ser Sonnet, que es donde se te va el volumen de verdad.
| Tu plan | Fable 5 | Opus 5 | Con qué diriges |
|---|---|---|---|
| Pro · $20 | Disponible, pero fuera de los límites del plan: corre con usage credits de pago desde el primer token. | Incluido dentro del plan. | Opus 5 |
| Max · $100 | Incluido. Hasta el 50% de tus límites semanales en Fable sin costo extra. | Incluido dentro del plan. | Fable 5 |
| Max · $200 | Incluido, misma mecánica. El límite semanal es más grande, así que ese 50% también lo es. | Incluido dentro del plan. | Fable 5 |
Pasarte de ese 50% en Max no apaga nada: sigues con usage credits, o te cambias de modelo y terminas la semana dirigiendo con Opus. En el plan gratis Fable 5 no aparece — es exclusivo de los planes de pago.
OJO CON LA CUENTA
En Pro, poner a Fable de director es la forma más rápida de pagar de más sin darte cuenta
El director trabaja todo el tiempo: lee, reparte, espera, revisa y vuelve a repartir. Es el rol que más turnos consume de la sesión. Si lo pones en Fable con un plan de $20, cada uno de esos turnos sale de tu saldo de pago, no de tu plan.
Y como no hay cuota incluida que se agote primero, tampoco hay un aviso que te frene. Te enteras cuando ves el cargo. La versión sana en Pro: Opus 5 de director, Sonnet en los que construyen, y Fable solo el día que decidas pagarlo a propósito para algo que lo valga.
Disponible no es lo mismo que puesto
Cada cuenta arranca con un modelo por default: Pro abre en Sonnet 5 y Max abre en Opus 5. Fable 5 no es el default de ninguna cuenta, ni siquiera en la de $200. Si lo quieres de director, lo pones tú. Y muchos que ya pagan Max llevan meses dirigiendo con Opus sin saber que tienen Fable incluido ahí adentro.
Se cambia con una línea, al inicio de la sesión, antes de la primera instrucción. El modelo que reparte es el que define la calidad del reparto: si se equivoca ahí, los subagentes ejecutan bien una mala idea.
Director en el plan de $20
/model opusDirector en Max ($100 y $200)
/model fableFable 5 pide Claude Code v2.1.170 o más nuevo. Si escribes /model y Fable no aparece en la lista aunque pagues Max, no es tu plan: es tu versión. Actualiza y vuelve a entrar.
Los dos alias que te ahorran decidir esto cada vez
- best — usa Fable donde exista y, si no está disponible, cae al Opus más nuevo. Sirve si trabajas en varias cuentas o compartes la máquina: escribes siempre lo mismo y el alias resuelve por ti.
- opusplan — dirige con Opus mientras planea y baja a Sonnet cuando ejecuta. Un solo comando, dos modelos, cero configuración.
Si esta guía completa te suena a mucho trabajo, opusplan es la versión mínima: te da lo esencial del reparto — cabeza cara, manos baratas — sin escribir un solo archivo. Lo que no te da es elegir quién hace qué, ni el contrato de entregable, ni el bucle donde le regresas el trabajo al que no cumplió. Para eso siguen las otras siete paradas.
La perilla que casi nadie toca
Además del modelo puedes elegir cuánto piensa. Con /effort escoges entre low, medium, high, xhigh y max. El default es high, y ahí se queda toda la vida porque nadie lo revisa. Fable 5 y Opus 5 soportan los cinco niveles.
El director es justo el puesto donde subirlo paga solo. Su chamba no es teclear: es partir el trabajo, decidir quién agarra cada pedazo y cachar el entregable que no cumple. Eso se hace una vez por vuelta, no en cada archivo. Un director en xhigh que reparte bien te ahorra tres rondas de subagentes mal instruidos.
Al revés aplica igual: un subagente que solo sigue una instrucción clara no necesita estar en high. Ahí bajarle es ahorro puro, y no se nota en el resultado.
Mientras planeas y repartes
/effort xhighCómo lo dejas puesto en treinta segundos
Revisa en qué estás parado
Escribe /model sin nada más. Te dice cuál está activo y cuáles tiene disponibles tu cuenta. Es la única forma de saber qué estás pagando en este momento.
Pon al director antes de hablar
/model opus si pagas $20, /model fable si pagas $100 o $200. Primero el modelo, después la primera instrucción: cambiarlo a media sesión no rehace lo que ya se repartió mal.
Súbele el esfuerzo al que decide
/effort xhigh mientras planeas y repartes. Cuando ya solo estás revisando entregables cortos, high alcanza de sobra.
03 el arranque
Modo plan, y la orden de no tocar nada
Ya tienes la lista y ya sabes qué modelo te toca. Lo que sigue es el minuto donde se decide toda la semana: el primer turno. Si ese turno arranca mal, el modelo grande se pone a construir y ya no tienes director; tienes un obrero carísimo con la lista abierta encima del escritorio.
El arranque son cuatro movimientos. Los dos primeros son obvios. Los dos últimos son los que casi nadie hace, y son los que sostienen todo lo demás.
Abre Claude Code dentro de la carpeta del proyecto
Entra a la carpeta del proyecto en la terminal y ahí lanzas Claude Code. No lo abras en tu escritorio ni en tu carpeta de usuario, aunque sea más cómodo.
El director necesita ver el terreno: qué archivos ya existen, cómo se llaman las carpetas, qué está escrito y qué no. Sin eso reparte a ciegas, y sus instrucciones a los subagentes salen genéricas.
Si el proyecto tiene un CLAUDE.md, se carga solo al arrancar. Todo lo que reparta después hereda esas reglas sin que se las repitas.
Pon el modelo que te toca
El comando es el de la sección anterior: /model fable si lo tienes disponible, /model opus si no.
Confirma que sí cambió antes de seguir. Si escribiste mal el alias, la sesión se queda con el modelo default de tu cuenta y vas a dirigir con el equivocado sin enterarte hasta que el reparto salga pobre.
El nivel de esfuerzo default es high, y para dirigir está bien. Súbelo con /effort solo si el reparto te sale flojo; para leer una lista y hacer preguntas rara vez hace falta.
Entra a modo plan con Shift+Tab
Shift+Tab cicla entre tres estados: default, aceptar ediciones y plan. Píchale hasta que la etiqueta diga plan.
En modo plan no puede editar nada. Ni aunque tú se lo pidas a media conversación, ni aunque se convenza de que es lo mejor. Deja de ser una promesa suya y pasa a ser una pared del programa.
Esto importa por lo que viene: la orden del paso 04 es texto, y el texto se puede desobedecer. El modo plan no.
Dale la orden de solo leer
Pega tu lista con el prompt de abajo. El primer turno no produce trabajo: produce una lectura.
Con el modo plan ya puesto son cinturón y tirantes, y así lo quieres. El modo plan lo frena de escribir archivos; el prompt lo frena de planear la implementación del primer punto, que es la otra forma de perderlo.
Solo léelo y dime qué entendiste
El primer turno de la sesión de dirección. Antes de que reparta nada, quieres saber si entendió lo mismo que tú y qué le falta.
Aquí va todo lo que necesito terminar esta semana: [pega aquí tu SEMANA.md, o la lista como la tengas] No hagas nada todavía. No abras archivos para editarlos, no escribas nada, no me propongas un plan de trabajo. Lo único que quiero de vuelta en este turno: 1. Qué entendiste. Repíteme cada pendiente con tus palabras, en una línea cada uno. 2. Qué te falta. Qué dato necesitas y no está: rutas, accesos, textos, decisiones que nadie ha tomado. 3. Qué está mal planteado. Cuál de estos pendientes en realidad son dos, cuál depende de otro que va después, y cuál no se puede verificar tal como está escrito. 4. Cuál es el de mayor riesgo y por qué. Si estás asumiendo algo, dilo con todas sus letras: "estoy asumiendo que...". Prefiero corregirte ahora y no después de que hayas construido media semana sobre una suposición.
Por qué la primera orden es “no hagas nada”
El modelo grande está entrenado para ser útil, y ser útil se ve como empezar. Le pegas una lista de nueve pendientes y el reflejo es agarrar el primero y resolverlo bien. Cuando eso pasa no perdiste un turno: perdiste al director. La cabeza que ibas a usar para repartir se metió a construir el punto uno y sale de ahí sabiendo muchísimo de un solo pendiente.
El costo real está en el contexto. La ventana con la que dirige es la misma con la que construye. Cada archivo que abre para resolver el primer punto es espacio que ya no tiene para pensar los otros ocho. Repartir es una tarea de vista amplia y poca profundidad; construir es exactamente lo contrario. No caben las dos en la misma cabeza al mismo tiempo.
La orden de leer primero es lo que lo mantiene en el puesto. Y de paso te compra algo que vale más que el turno: la lista de lo que no entendió. Los huecos que te devuelve ahora son los mismos que, si nadie pregunta, se vuelven suposiciones repartidas a cuatro agentes que van a construir sobre ellas toda la semana.
Se te volvió obrero cuando…
- Te devuelve archivos escritos en vez de preguntas.
- Habla del punto 1 con lujo de detalle y de los otros ocho en una línea cada uno.
- Te propone un plan de implementación cuando le pediste una lectura.
- No te preguntó nada. Una lista real siempre tiene huecos: si no encontró ninguno, no la leyó, la hojeó.
atajo que casi nadie usa
Ctrl+G para corregir el plan antes de aprobarlo
Cuando ya te proponga un plan, Ctrl+G lo abre en tu editor. Ahí lo corriges como cualquier documento tuyo: le borras el paso que sobra, le agregas la carpeta que se le olvidó, le apuntas el criterio que quedó opinable. Apruebas la versión ya corregida.
Es más rápido que discutirlo por chat, y termina con el plan escrito como tú lo quieres, no como quedó después de tres rondas de “no, así no”. Ese plan corregido es el que después se convierte en el reparto.
cómo sabes que sí quedó de director
Te devuelve una lectura, no un plan de obra
Lo que quieres ver de vuelta: cada pendiente repetido con sus palabras, las dudas que le quedaron, cuáles de tus puntos en realidad son dos, y cuál cree que es el de mayor riesgo y por qué.
Lo que no quieres ver: un plan de implementación del punto 1, archivos nuevos, o un “ya adelanté lo primero”.
Si te llegó lo segundo, no lo discutas ni lo regañes: arranca el turno otra vez en una sesión limpia, con el modo plan puesto desde antes de pegar la lista. Cuesta menos reiniciar que dirigir con una cabeza que ya se puso a construir.
04 las cuatro formas
Las cuatro formas de repartir, y quién sostiene el plan
Claude Code te da cuatro maneras de repartir un trabajo de varios pasos. Se anuncian como cosas distintas, pero en la práctica compiten por el mismo encargo, y por eso la pregunta útil nunca es cuál es más potente.
Lo único que de verdad cambia entre las cuatro es quién sostiene el plan mientras el trabajo corre: Claude decidiendo turno a turno con lo que le acaban de entregar, o un script que ya decidió todo antes de arrancar. Cuántos agentes, con qué modelo, qué tan largo: todo eso se acomoda solo una vez que respondes esa pregunta.
Las cuatro, lado a lado
| Subagentes | Habilidades | Equipos de agentes | Workflows | |
|---|---|---|---|---|
| qué es | un trabajador que Claude lanza | instrucciones que Claude sigue | un líder supervisando sesiones pares | un script que ejecuta el runtime |
| quién decide qué sigue | Claude, turno a turno | Claude, siguiendo el prompt | el líder, turno a turno | el script |
| dónde viven los resultados | el contexto de Claude | el contexto de Claude | una lista de tareas compartida | variables del script |
| escala | unas cuantas tareas por turno | igual que subagentes | un puñado de pares de larga duración | de decenas a cientos por corrida |
Léela por columnas para ver una forma completa, y después por la segunda fila para ver la diferencia que importa. Ahí está todo: tres de las cuatro dejan la decisión en manos de Claude, y una la congela en un script.
Cuándo quieres cada una
La tabla te dice qué son. Esto te dice cuál pedir cuando ya tienes el documento enfrente y hay que repartirlo.
Subagentes
Cuando quieres trabajadores rápidos que te reportan a ti y a nadie más. Es el default, y casi siempre es la respuesta correcta.
Cada uno abre su propia ventana de contexto, hace lo suyo y te devuelve un resumen. No se hablan entre ellos: si el trabajo necesita que discutan, esta no es la forma.
Habilidades
Cuando lo que se repite son las instrucciones, no el trabajo.
No lanzan a nadie ni reparten nada. Son el criterio escrito una vez para que el que ya está trabajando no te lo vuelva a preguntar. Escalan igual que los subagentes porque viven en el mismo contexto.
Equipos de agentes
Cuando los trabajadores necesitan discutir entre ellos y retarse.
Cada compañero es una sesión completa de Claude, se mandan mensajes y comparten una lista de tareas que se desbloquea sola. Pocos, de larga duración, y con el líder aprobando o rechazando lo que proponen.
Workflows
Cuando el reparto mismo es lo que quieres repetir la próxima vez.
La corrida se guarda como comando propio y vuelve a correr igual con solo escribir su nombre. Es la única de las cuatro que aguanta decenas o cientos de agentes en una sola pasada.
Por qué el workflow escala y las otras no
Con subagentes, habilidades y equipos, el orquestador es Claude. Lanza, lee lo que le regresan y con eso elige qué sigue. Es flexible y sale caro de contexto: todo lo que vuelve pasa por su ventana, y esa ventana se llena.
En un workflow el plan deja de ser una decisión y se vuelve código. El runtime ejecuta el script, los resultados intermedios se quedan en variables del script, y el contexto de Claude solo carga la respuesta final. Esa es la razón real de que un workflow soporte cientos de agentes en una corrida y una conversación normal no: no es que vaya más rápido, es que Claude ya no tiene que leerlo todo.
La consecuencia práctica: si el trabajo genera mucha salida intermedia que a ti no te sirve — leer cuarenta archivos para sacar una lista de diez — el workflow no es un lujo, es lo que evita que el director se quede sin espacio a la mitad.
EL COSTO VA AL REVÉS
Un equipo no es “subagentes mejores”
Un subagente es un trabajador que Claude lanza dentro de tu sesión. Un compañero de equipo es un Claude completo aparte, con su propia ventana y su propia conversación. Gasta muchísimo más, y el salto no se nota en la pantalla: se nota en tus límites.
Súbele de forma solo cuando el trabajo lo pida. La escalera va subagentes, después workflow si el reparto se repite, y hasta el final equipo si de verdad tienen que hablarse entre ellos.
De las cuatro, para dirigir te importan dos y media. Los subagentes son el piso y son la sección 05: así vas a repartir casi todo lo que repartas. Los workflows y los equipos son las dos rutas de la sección 07, y se eligen exactamente por lo que acabas de leer — si el reparto se repite, workflow; si los trabajadores tienen que retarse entre ellos, equipo.
Las habilidades quedan fuera de esta conversación y está bien que así sea. No reparten trabajo: guardan criterio. Son otro tema, y hay guías enteras en la bóveda dedicadas a eso.
05 el reparto
Subagentes con perfil: aquí queda escrito quién usa Opus y quién Sonnet
Dirigir se ve así: en vez de una sesión que hace todo, tienes cuatro trabajadores con nombre, cada uno con su propia ventana de contexto, y tú decides quién es quién. La decisión que más cambia el resultado no es cómo escribes el prompt. Es a quién le toca cada pendiente y con qué modelo lo resuelve.
Y el reparto se hace una vez. Un subagente no es una conversación: es un archivo. En ese archivo cabe la instrucción, el modelo y el nivel de esfuerzo, así que la decisión de “esto lo hace Opus” deja de tomarse cada lunes.
El criterio no tiene que ver con qué tan difícil se ve la tarea, sino con cuántas decisiones quedan abiertas cuando la sueltas.
Opus
Cuando todavía quedan decisiones por tomar
- Lo que necesita criterio: hay dos caminos que se ven igual de buenos y alguien tiene que elegir.
- Decisiones de arquitectura: cómo se acomodan las piezas, qué se comparte y qué se queda aparte.
- Texto que va a leer un cliente: una landing, un guion de WhatsApp, una propuesta.
- Lo que toca varias partes a la vez y hay que sostener el hilo completo para no romper nada.
Sonnet
Cuando ya solo falta hacerlo
- Ejecución acotada: la tarea cabe descrita en tres líneas y no cambia a medio camino.
- Repetición: la misma pieza en seis medidas, el mismo ajuste en veinte archivos.
- Errores con síntoma claro y reproducible, donde ya se sabe qué está mal.
- Mantenimiento: actualizar documentación, renombrar, ordenar, limpiar lo que quedó viejo.
regla de bolsillo
Si tú lo pensarías dos veces, va en Opus
Si solo hay que hacerlo, va en Sonnet. Y cuando dudes, empieza en Sonnet y súbelo: un mal resultado de Sonnet te cuesta un turno y te dice exactamente qué decisión faltaba tomar. Meter todo en Opus no es más seguro, nada más es más lento y se come tus límites más rápido.
Antes de que exista un solo archivo de agente, pídele el organigrama. Se revisa en pantalla y se corrige ahí mismo, que sale mucho más barato que corregirlo cuando ya hay cuatro agentes escribiendo al mismo tiempo.
Reparte la lista y asígnale modelo a cada quien
Aquí dejas de construir y empiezas a dirigir. Le pides el organigrama antes de que exista una sola línea de trabajo.
Ya leíste SEMANA.md. Ahora reparte el trabajo. No lo hagas tú. Vas a crear subagentes y asignarles la lista. Antes de tocar nada, devuélveme: 1. Cuántos agentes propones y el rol de cada uno, con nombre en minúsculas y con guiones. 2. Qué modelo le toca a cada uno, Opus o Sonnet, y la razón en una línea. El criterio: Opus para lo que necesita criterio, decisiones de arquitectura o texto que va a leer un cliente. Sonnet para ejecución acotada y repetitiva, donde ya está claro qué hay que hacer y solo falta hacerlo. 3. Qué pendientes de la lista le tocan a cada agente. 4. Qué archivos o carpetas es dueño de tocar cada uno, y cuáles tiene prohibidos. Dos agentes no pueden ser dueños del mismo archivo. 5. Qué se puede correr en paralelo y qué tiene que esperar a que otro termine. Si dos tareas se pisan, dímelo y propón cómo separarlas, en vez de dárselas al mismo agente para salir del paso. Preséntamelo como tabla y ahí detente. No escribas los archivos de agente ni empieces a construir hasta que yo apruebe el reparto.
Cuando el reparto ya te cuadra, cada rol se convierte en un archivo markdown. Nada más que eso: texto plano con un encabezado. Arriba va el frontmatter, entre tres guiones, con los datos que Claude usa para decidir a quién delegarle. Abajo va la instrucción del agente, escrita como si le hablaras a alguien que llega el primer día.
Lo que hace que esto sirva para dirigir es que el modelo queda escrito en el archivo. No vuelves a decidir cada vez si esto era de Opus o de Sonnet: lo decidiste una vez y el reparto se aplica solo, aunque quien delegue sea Claude y no tú.
Dónde lo guardas define quién lo tiene:
.claude/agents/Vive dentro del proyecto. Solo existe ahí, y si el proyecto está en git se va con el repositorio: tu equipo hereda el mismo reparto sin que se lo expliques.
~/.claude/agents/Vive en tu computadora y aparece en todos tus proyectos. Aquí van los roles que repites siempre: el que revisa copy, el que investiga, el que corre pruebas.
cambió y casi nadie lo sabe
/agents ya no abre el asistente de creación
Hasta hace poco, /agents abría un asistente que te llevaba de la mano a crear el archivo. Desde la versión 2.1.198 ya no: el comando solo imprime un recordatorio. Si lo escribes esperando el menú, vas a creer que algo se rompió.
La forma correcta hoy es pedírselo a Claude en lenguaje natural. Le describes el rol y él escribe el archivo donde le digas, con el frontmatter bien puesto:
Créame un subagente en .claude/agents/ que se llame revisor-de-copy, que use Sonnet y que solo pueda leer archivos: revisa textos de cliente y me devuelve la lista de cambios, sin editar nada.
Del frontmatter, cinco campos son los que de verdad usas para dirigir. Los dos primeros son obligatorios; sin ellos el archivo no cuenta como agente.
nameEl nombre con el que lo llamas. En minúsculas y con guiones, igual que el nombre del archivo.
descriptionPara qué sirve y cuándo usarlo. Es el campo que más se subestima: es lo que lee Claude para decidir si este pendiente es de este agente o de otro. Escríbelo en términos de la situación, no del oficio.
modelsonnet, opus, haiku, fable o inherit. Por default hereda el de tu sesión, y ahí es justo donde se pierde el reparto: si no lo escribes, todos terminan con el modelo que traías puesto.
effortSu nivel de esfuerzo, aparte del tuyo: low, medium, high, xhigh o max. Un agente de mantenimiento no necesita el mismo esfuerzo que uno que decide arquitectura.
toolsQué herramientas puede tocar. Este es tu candado: un agente que solo lee no puede romper nada, y a ese lo sueltas sin revisarlo turno por turno.
Hay más campos, y dos valen la pena aunque sea de pasada: isolation: worktree le da al agente una copia aislada del repositorio, para que dos que trabajan al mismo tiempo no se pisen los archivos; y background lo deja correr por su cuenta mientras tú sigues en otra cosa.
Los cuatro perfiles que resuelven la semana
Estos son los archivos completos, tal cual quedan en disco. Dos en Opus, porque hay decisiones abiertas y texto que va a leer un cliente. Dos en Sonnet, porque el qué ya está definido y solo falta la ejecución. Toma el que se parezca a tu caso y cámbiale los nombres.
Redactor de landing
modelo: opusPara qué es: El pendiente 1. Lo lee un cliente y hay decisiones de estructura que nadie tomó todavía.
.claude/agents/redactor-landing.md--- name: redactor-landing description: Arma la landing de un cliente cuando los textos ya están aprobados y falta convertirlos en página. Úsalo para páginas que va a leer un cliente final. tools: Read, Write, Edit, Glob, Grep model: opus effort: high --- Armas landings de cliente. Trabajas únicamente dentro de la carpeta del cliente que te indiquen: el tema global y los componentes compartidos no se tocan por ningún motivo. Antes de escribir una sola línea, lee los textos aprobados. No los reescribas por tu cuenta. Si una frase no funciona en la página, deja el original y propón el cambio en tu resumen final. Estructura mínima: encabezado con una promesa clara, los bloques de servicio que pida el brief, formulario y pie. Los estados de vacío y de error van desde el principio, no al final. Al terminar entregas la ruta del archivo, qué revisaste a 390 y a 1280 de ancho, y qué quedó pendiente. Si un criterio de aceptación no se cumple, dilo tú antes de que te lo digan.
Guionista de WhatsApp
modelo: opusPara qué es: El pendiente 3. Cada respuesta la va a leer un cliente, y hay que decidir qué no contesta el bot.
.claude/agents/guionista-whatsapp.md--- name: guionista-whatsapp description: Diseña qué contesta un agente de WhatsApp — las preguntas frecuentes, sus respuestas y las reglas para pasar la conversación a una persona. Úsalo antes de que alguien programe el bot. tools: Read, Write, Edit, Grep, WebFetch model: opus effort: high --- Diseñas conversaciones de atención por WhatsApp para negocios pequeños. Tu entregable es texto, no código. Las preguntas frecuentes las sacas de lo que ya existe: el sitio, las conversaciones viejas, las notas del cliente. No inventes políticas, precios ni tiempos de entrega. Si un dato no aparece, lo marcas como FALTA y sigues. Cada respuesta cabe en un mensaje de celular, va en español con "tú" y termina en una sola acción clara. Nada de párrafos ni de despedidas largas. Defines también qué NO contesta el bot: reclamos, cambios de precio y cualquier cosa con dinero de por medio se pasan a una persona, con su mensaje de transición ya escrito. Entregas un solo archivo markdown con preguntas, respuestas y reglas de escalamiento, y arriba la lista de todo lo que marcaste como FALTA.
Productor de creativos
modelo: sonnetPara qué es: El pendiente 2. El concepto ya está aprobado: es la misma pieza repetida en dos medidas.
.claude/agents/productor-creativos.md--- name: productor-creativos description: Produce lotes de creativos de campaña a partir de un concepto ya aprobado, en las medidas que pida cada ubicación. Úsalo cuando el qué decir ya está definido y solo falta la ejecución. tools: Read, Write, Edit, Glob, Bash model: sonnet effort: medium --- Produces creativos de campaña en lote. El concepto y el copy llegan aprobados: tú no los cambias. Trabajas por lista. Por cada pieza: la medida exacta, el texto que lleva encima y el archivo de salida con nombre predecible. Nada de nombres tipo final-v2 ni copia-de. Si una pieza no cabe en su medida sin cortar algo importante, no la fuerces: la marcas y sigues con las demás. Al terminar entregas la tabla de qué generaste, en qué medida y en qué ruta quedó cada archivo, más la lista de las que marcaste como problema.
Mantenedor del repo
modelo: sonnetPara qué es: Los pendientes 4 y 5. Un error con síntoma claro y un documento viejo: ya se sabe qué está mal.
.claude/agents/mantenedor-repo.md--- name: mantenedor-repo description: Resuelve pendientes acotados de mantenimiento — un error con síntoma claro y reproducible, o documentación que quedó vieja. Úsalo cuando ya se sabe qué está mal y solo falta hacerlo. tools: Read, Edit, Grep, Glob, Bash model: sonnet effort: medium --- Atiendes pendientes de mantenimiento que ya vienen con síntoma claro. Si es un error: primero reprodúcelo y escribe en una línea qué observaste, luego busca la causa, y hasta entonces edita. Un error, un cambio. No aproveches el viaje para reacomodar otras cosas. Si es documentación: comparas lo que dice el archivo contra lo que hace el código de hoy y corriges solo lo que ya no es cierto. No agregas secciones nuevas ni cambias el tono. No creas archivos nuevos y no tocas configuración ni dependencias. Si el arreglo requiere alguna de esas dos cosas, te detienes y lo reportas. Entregas cuatro cosas: qué estaba mal, qué cambiaste, en qué archivos, y cómo se comprueba que ya quedó.
A un agente ya hecho lo llamas nombrándolo. No hay comando ni menú: lo escribes en tu mensaje y Claude lanza esa ventana de contexto aparte.
El agente trabaja solo, con su propio contexto, y de vuelta te llega nada más el resumen. Eso es lo que te deja dirigir cuatro frentes sin que tu sesión se sature: el detalle se queda del otro lado. También quiere decir que los subagentes no se hablan entre ellos — todo lo que uno necesita saber del otro pasa por la sesión principal. Si el pendiente 2 depende del 1, encadénalos tú.
así se delega
Usa el agente redactor-landing para el pendiente 1 de SEMANA.md. Cuando termine, usa el agente mantenedor-repo para el 4.
Si no lo nombras, Claude puede escogerlo solo leyendo las descriptions. Cuando quieras control, nómbralo. Cuando quieras que se acomode, déjalo elegir — pero entonces la description tiene que estar bien escrita.
06 el contrato
El contrato de entregable: sin esto no puedes rechazar nada
La gente no se decepciona de los subagentes porque trabajen mal. Se decepciona porque nunca les dijo qué era «bien». Un agente sin criterio de aceptación siempre entrega algo defendible: existe, tiene forma, se ve razonable. Y tú te quedas viéndolo con la sensación de que no era eso, sin poder explicar en una frase por qué.
Ahí es donde se cae el reparto. Si el criterio no quedó escrito antes, la revisión se vuelve cuestión de gusto, y el gusto no se puede delegar. Te quedas sin la única herramienta que te hace director: la de regresar el trabajo. «No me convence» no es una devolución, es una queja. «El criterio pedía cinco secciones y hay cuatro» sí es una devolución, y el agente sabe exactamente qué hacer con ella.
El contrato son cuatro campos por tarea. Con menos, algo queda a interpretación. Con más, nadie lo escribe.
cuándo se escribe
Antes de que exista el primer agente
El orden no es un detalle. Si primero repartes y después defines qué esperabas, ya estás negociando con el trabajo hecho enfrente — y el trabajo hecho siempre pesa más que el criterio. Terminas aceptando algo que no pediste porque ya está, porque costó, porque rehacerlo suena a retroceso. El contrato escrito antes le quita ese peso a la conversación: no discutes con el entregable, comparas contra una línea que tú mismo aprobaste cuando todavía no te costaba nada.
Qué archivo entrega, con nombre y ruta
Un entregable es algo que puedes abrir. «Un resumen de la investigación» no lo es: vive dentro de la conversación, se pierde cuando cierras la ventana y no se puede comparar con nada.
Nombrar la ruta hace dos cosas de un golpe: te deja algo concreto que revisar y le quita al agente la decisión de dónde dejarlo. Cuando cuatro agentes eligen cada quien su carpeta, media revisión se te va en buscar archivos.
No sirve: «mándame un resumen de lo que encontraste»
Sirve: «docs/investigacion-casa-miralta.md»
En qué formato viene por dentro
Markdown con estos encabezados. Tabla con estas columnas. Un componente que exporta esto. El formato no es manía de orden: es lo que hace que dos entregables se puedan poner uno al lado del otro.
Sin formato fijo, tres agentes te devuelven la misma información en tres estructuras distintas y acabas haciendo el trabajo de unificarlas, que era justo el trabajo que estabas repartiendo.
No sirve: «un documento con lo importante»
Sirve: «markdown con Contexto, Hallazgos, Riesgos y Siguiente paso, en ese orden»
El criterio de aceptación, y tiene que ser verificable
Este es el campo donde se decide todo. La prueba es una sola pregunta: ¿lo puedes comprobar abriendo un archivo o corriendo algo, sin opinar? Si la respuesta es no, todavía no es un criterio.
«Que quede claro» depende de quién lea. «Las cinco secciones existen y ninguna dice pendiente» no depende de nadie: se cumple o no, y contesta lo mismo el agente que tú. De paso te quita la parte incómoda de la revisión — no estás rechazando su trabajo, estás señalando un punto que él mismo pudo haber revisado antes de entregarte.
No sirve: «que quede claro y bien escrito»
Sirve: «las cinco secciones existen y ninguna dice pendiente»
Qué NO debe tocar: la zona prohibida
El único campo que no habla del entregable sino de todo lo demás. Es lo que evita que dos agentes editen el mismo archivo y que el segundo borre lo del primero sin enterarse.
Se escribe en las dos direcciones: de qué carpeta es dueño y qué tiene prohibido abrir. Y ahí va también lo que ya está aprobado — textos, precios, configuración — porque un agente sin esa instrucción tiende a mejorar cosas que nadie le pidió mejorar.
No sirve: «no rompas nada»
Sirve: «solo la carpeta del cliente; el tema global y los textos aprobados no se tocan»
No los escribas tú a mano. Le pasas la lista al director y le pides los cuatro campos por tarea. La línea que de verdad trabaja es la última: pídele que te diga cuáles de sus propios criterios le parecen débiles. Ahí es donde caen los criterios de mentira, antes de llegar a un agente.
El contrato de entregable
Sin esto no puedes rechazar nada: cuando el trabajo regresa, no hay contra qué compararlo. Cuatro campos por tarea, ni uno más.
Antes de repartir, escribe el contrato de cada tarea. Por cada tarea de SEMANA.md quiero cuatro campos, ni uno más: 1. ENTREGABLE — la ruta exacta del archivo que va a existir cuando esa tarea termine. Si son varios, los listas todos. 2. FORMATO — qué tiene adentro ese archivo. Una página, un documento markdown con tales secciones, imágenes de tal medida, lo que aplique. 3. ACEPTACIÓN — cómo se comprueba que está bien. Tiene que ser verificable, no opinable: "el build pasa", "el archivo tiene las cinco secciones", "el formulario manda el correo de prueba y llega". Nada de "que quede bien" ni "que se vea profesional". 4. PROHIBIDO — qué archivos, carpetas o configuraciones no puede tocar el agente de esa tarea. Si un criterio de aceptación no lo puedes comprobar tú mismo leyendo un archivo o corriendo algo, no sirve: reescríbelo hasta que sí. Devuélvemelo como una tabla, una fila por tarea. Debajo de la tabla, dime cuáles criterios te parecen débiles y cómo los apretarías. No crees agentes ni repartas nada hasta que yo apruebe estos contratos.
Así se ve aplicado sobre la semana de ejemplo. Cuatro pendientes distintos entre sí — una página, un lote de piezas, un documento y un error en producción — y aun así los cuatro caben en la misma tabla. Fíjate en la tercera columna: ninguna de esas celdas se puede discutir en una llamada.
| Tarea | Entrega | Criterio de aceptación | No toca |
|---|---|---|---|
| Landing de Casa Miralta | La página en /clientes/casa-miralta: encabezado, tres bloques de servicio, formulario y pie. | Abre sin errores en consola, se ve bien a 390 y a 1280 de ancho, y el formulario manda el correo de prueba y llega. | Solo la carpeta del cliente. El tema global y los componentes compartidos quedan intactos. |
| Tres creativos de agosto | Seis archivos: las tres piezas en 1080x1350 y en 1080x1920, con el nombre acordado. | Los seis archivos existen, ninguno recorta el producto y todo el texto cae dentro de la zona segura de su medida. | El copy aprobado no cambia ni una palabra. Los precios no aparecen en las piezas. |
| Guion del agente de WhatsApp | Un markdown con las preguntas, sus respuestas y las reglas de cuándo pasa a una persona. | Hay 15 preguntas o más con respuesta, cada respuesta cabe en un mensaje de celular, y está escrito qué se escala. | No se inventan políticas, tiempos de entrega ni precios. Lo que falte se marca como FALTA. |
| El formulario no manda correo | El arreglo en el archivo donde esté la falla, más una línea con la causa. | Se manda un correo de prueba desde producción y llega. La causa queda escrita en el repositorio. | No se cambia de proveedor ni se mueven variables de entorno sin avisarte antes. |
suena a criterio y no lo es
Las frases que dejan pasar cualquier cosa
Hay una familia de criterios que se cuelan porque suenan serios. Tienen la forma de una exigencia, pero nadie puede comprobarlos sin ti enfrente. Estos tres son los que más aparecen, con lo que tendrías que escribir en su lugar:
- «Que quede profesional» → «tipografía, colores y espaciados salen del archivo de marca; no se agregan sombras ni degradados nuevos».
- «Que esté bien optimizado» → «la página carga en menos de dos segundos en celular y ninguna imagen pesa más de 200 KB».
- «Que se vea moderno» → «usa los componentes que ya existen en la carpeta de interfaz; no se introduce ningún estilo que no esté ahí».
El patrón siempre es el mismo: el criterio falso describe una sensación, el criterio real describe el estado de un archivo. Y una regla que te va a servir la primera vez que algo se atore — si un agente falla dos veces por lo mismo, deja de ser culpa del agente. Significa que tu criterio admitía las dos lecturas.
07 las dos rutas
Workflows o equipos de agentes: las dos rutas, lado a lado
Hasta aquí repartiste a mano. Tú pediste el organigrama, tú aprobaste los contratos, tú mandaste cada tarea y tú recibiste cada entrega. Es la forma que más control te da y la que menos gasta, y aguanta perfectamente una semana normal.
El problema llega con el tamaño. Cuando el reparto pasa de unas cuantas tareas por turno, el cuello de botella eres tú: cada agente que termina se queda parado esperando a que le contestes. Ahí se abren dos caminos, y no son el mismo con distinto nombre. En uno, el plan se convierte en un programa que corre solo. En el otro, contratas colegas.
Ninguno de los dos viene encendido. Cada uno se prende con una línea, y esa línea es la mitad de la razón por la que casi nadie los usa.
Workflows — el plan se vuelve un programa
El modelo grande deja de darte un plan en prosa y escribe un script que el runtime ejecuta. Los agentes que ese script lanza corren en segundo plano, y tu sesión se queda libre: puedes seguir escribiendo mientras avanza.
Se dispara escribiendo la palabra ultracode dentro de tu mensaje, o pidiéndolo en español, tal cual: «usa un workflow para esto». Si vas a pasar la sesión entera repartiendo, /effort ultracode lo deja prendido y ya no tienes que pedirlo turno tras turno.
Lo que de verdad lo separa de todo lo demás es que se guarda. Desde la vista /workflows, la tecla s convierte la corrida que acabas de ver en un comando tuyo. La próxima vez que tengas la misma semana la lanzas con una diagonal y su nombre, en vez de volver a explicarla desde cero.
- Pide Claude Code v2.1.154 o más nuevo. Está en todos los planes de pago; en Pro hay que prenderlo en /config, fila «Dynamic workflows».
- Todos los agentes usan el modelo de tu sesión salvo que pidas otra cosa. Dilo al lanzarlo: «usa un modelo más chico para las etapas que no lo necesiten».
- Los subagentes de un workflow siempre corren en modo acceptEdits: sus ediciones se auto-aprueban. Por eso el contrato de la sección anterior aquí no es opcional.
- La corrida guardada vive en la carpeta del proyecto o en la tuya, y se vuelve a lanzar como un comando propio.
Equipos de agentes — contratas colegas, no ayudantes
Un subagente es un trabajador: abre, hace lo suyo, te devuelve un resumen y se apaga. Un compañero de equipo es otra cosa. Es una sesión completa de Claude, con su propia ventana de contexto, que sí se manda mensajes con los demás. El líder es tu sesión principal.
Comparten una lista de tareas. El líder asigna, o el compañero que se desocupa agarra la siguiente libre. Las tareas pueden depender de otras y se desbloquean solas cuando la de arriba termina, así que no te toca estar destrabando la fila.
El detalle que muerde a todo el mundo la primera vez: los compañeros no heredan tu /model. Se fija en /config, en «Default teammate model», o lo dices al lanzarlos: «usa Sonnet para cada compañero». El nivel de esfuerzo sí lo heredan. Tampoco heredan tu conversación: cargan tu CLAUDE.md y nada más, así que el mensaje con el que los lanzas tiene que traer el contexto completo.
- Los ves en el panel de agentes debajo del input: flechas para elegir, Enter para entrar y escribirle directo a uno, x para detenerlo.
- Se prende con una variable de entorno, en tu settings.json o en el entorno. Está apagado por default porque sigue siendo experimental.
el bucle, de fábrica
Aquí no tienes que armar la revisión: ya viene puesta
Pídele al equipo «exige aprobación de plan antes de que toquen nada» y cada compañero arranca en modo plan, de solo lectura. Escribe lo que piensa hacer, se lo manda al líder y ahí se detiene.
El líder aprueba, o lo rechaza con razones. Si lo rechaza, el compañero replantea y lo vuelve a mandar. Ese ida y vuelta es exactamente el bucle de revisión de la siguiente sección, con la diferencia de que no lo escribiste tú.
Y le puedes dar criterio al líder de una vez: «solo aprueba planes que incluyan pruebas». A partir de ahí el filtro corre sin que estés leyendo plan por plan.
Las dos líneas que las prenden
Una es un interruptor dentro de Claude Code; la otra es una variable de entorno. Si intentas usar cualquiera de las dos rutas sin esto, no falla con un error claro: simplemente no pasa nada y crees que la función no existe.
Ruta A · abre /config y prende la fila «Dynamic workflows» (hace falta en Pro)
/configRuta B · la variable que prende los equipos, en settings.json o en el entorno
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1| Workflows | Equipos de agentes | |
|---|---|---|
| estado | Estable. En todos los planes de pago. | Experimental. Apagado por default. |
| cómo se prende | En Pro, en /config. Se dispara con la palabra ultracode o pidiéndolo en español. | Con la variable CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1. |
| se hablan entre ellos | No. Cada agente le reporta al principal y ya. | Sí. Son sesiones completas que se mandan mensajes. |
| se guarda y se repite | Sí. Tecla s en /workflows y queda como comando tuyo. | No. No sobrevive ni a un /resume. |
| revisión | La armas tú, con el contrato y el bucle de la sección que sigue. | Viene de fábrica: el líder aprueba o rechaza cada plan. |
| cuánto gasta | Alto. Muchos agentes a la vez, pero acotados. | Más alto. Cada compañero es un Claude completo aparte. |
Regla corta para no darle vueltas: si el reparto lo vas a repetir, workflow. Si necesitas que se revisen entre ellos y que tú apruebes o rechaces cada plan antes de que alguien toque un archivo, equipo.
límites de los equipos
Lo que hay que saber antes de casarte con la ruta B
- No sobreviven a /resume. Cierras la sesión y el equipo se fue.
- Un solo equipo por sesión. No puedes tener dos corriendo en la misma ventana.
- Los compañeros no pueden lanzar sus propios compañeros. El árbol es de un nivel.
- El líder no se cambia: la sesión con la que arrancaste manda hasta el final.
- Cada compañero es un Claude completo aparte, así que gastan bastante más que los subagentes. Cinco compañeros son cinco sesiones consumiendo al mismo tiempo.
El caso largo: una app repartida por capas
Aquí es donde los equipos ganan de calle. Una app tiene capas con dueño natural: interfaz, servidor y datos, pruebas. Si le das una capa completa a cada compañero, dos agentes nunca editan el mismo archivo — el conflicto desaparece por diseño, no por suerte.
Y como se hablan, la capa de pruebas le dice a la de servidor qué se rompió sin pasar por tu bandeja. A ti te queda la única decisión que importa: aprobar el plan o regresarlo.
Una app repartida por capas
El caso largo. Un dueño por capa para que dos agentes nunca editen el mismo archivo, y un cuarto que solo busca dónde se rompe.
Vamos a construir esto: [dos líneas: qué hace la app y para quién] No lo hagas en una sola cabeza. Repártelo por capas, con un dueño por capa, para que dos agentes nunca editen el mismo archivo: 1. INTERFAZ — pantallas, componentes y los estados de vacío, carga y error. Dueño de la carpeta de componentes y de las páginas. No toca el servidor. 2. SERVIDOR Y DATOS — rutas, modelo de datos, validación y manejo de errores. Dueño de la carpeta del servidor. No toca componentes. 3. PRUEBAS — comprueba lo que entregan los otros dos: el caso feliz, los casos borde y qué pasa cuando algo falla a media operación. Dueño de la carpeta de pruebas. No arregla el código de nadie: reporta. 4. ABOGADO DEL DIABLO — no construye nada. Busca dónde se rompe esto con gente real usándolo: dos personas al mismo tiempo, el proveedor que no responde, el dato que se pierde a la mitad. Entrega una lista de riesgos ordenada por gravedad. Antes de arrancar, enséñame dos cosas: qué modelo le pones a cada capa y por qué, y el mapa de qué carpeta es de quién. Cuando terminen, tú revisas las cuatro entregas contra su contrato antes de pasármelas. Si la capa de pruebas encuentra algo, se lo regresas al dueño de esa capa. No lo arregles tú.
el tamaño
De 3 a 5 compañeros, con 5 o 6 tareas cada uno
Es el rango recomendado y la razón es aburrida: con menos tareas por compañero pasas más tiempo repartiendo que avanzando, y arriba de cinco compañeros el líder se vuelve el cuello de botella que estabas tratando de quitarte de encima.
08 el bucle
Al que no cumpla, regrésaselo
El puesto de director no termina cuando reparte. Termina cuando revisa.
Y aquí es donde se cae casi todo el mundo. Los agentes entregan, el director te manda un resumen bonito, tú lo lees y das todo por bueno. El detalle es que ese resumen lo escribió el mismo que hizo el trabajo. Cada subagente corre en su propia ventana de contexto y de vuelta solo regresa su reporte: ni tú ni el director vieron el archivo, vieron lo que el agente dice del archivo.
Revisar es abrir el entregable. Todo lo demás es confiar.
Hay tres maneras de cerrar el ciclo, y cambian en una sola cosa: qué tanto quieres que corra sin ti.
A mano — la que más control te da
Empieza por esta. El director revisa entregable por entregable y te devuelve un veredicto de una palabra: pasa o no pasa, con el punto exacto que falla. Al que no pasa se lo regresa al mismo agente.
El truco no está en pedir que revise. Está en contra qué revisa: el contrato de la sección 06, no su criterio. Un modelo sin contrato aprueba casi todo, porque mide el trabajo contra lo que él mismo hubiera hecho, y eso siempre le parece bien.
Al que no cumpla, regrésaselo
El bucle completo, a mano. El director revisa contra el contrato y devuelve el trabajo que no pasa. A ti no te llega nada hasta que todo pasó.
Ya te entregaron los subagentes. Ahora revisa. No me pases el trabajo todavía. Para cada entregable: 1. Ábrelo y compáralo contra su contrato: entregable, formato, criterio de aceptación y zona prohibida. 2. Comprueba lo que se pueda comprobar corriéndolo o leyéndolo. No te fíes del resumen que te mandó el agente: los resúmenes siempre dicen que quedó bien. 3. Dame un veredicto de una palabra por entregable, PASA o NO PASA, y abajo el porqué, con el punto concreto que falla. Al que no pase, regrésaselo al mismo agente. En el mensaje de vuelta ponle tres cosas: qué criterio no cumplió, qué encontraste exactamente y qué tiene que quedar distinto. Nada de "mejóralo" ni "dale otra vuelta". Repite hasta que todos pasen. Si un agente falla dos veces por lo mismo, no lo mandes una tercera: dime tú qué está mal planteado en el contrato. No me entregues nada hasta que todos los entregables tengan veredicto PASA. Cuando llegues ahí, mándame la tabla final con una línea por entregable y su ruta.
Las seis cosas que hacen que este prompt funcione
- Revisa contra el contrato, no contra su gusto. Sin criterio de aceptación escrito no hay nada que rechazar.
- Un veredicto por entregable, nunca uno global. Un "ya quedó" tapa tres entregables buenos y uno roto.
- Abre el archivo y compruébalo. El resumen del agente no es evidencia: es la versión del interesado.
- El rechazo lleva tres cosas: qué criterio no cumplió, qué encontraste y qué tiene que quedar distinto. Un "mejóralo" te regresa lo mismo con otras palabras.
- Dos fallas por lo mismo no es problema del agente, es el contrato mal escrito. Ahí paras y lo arreglas tú.
- No te llega nada hasta que todos pasan. Si quitas esta línea, el director te entrega lo que llegó y el revisor vuelves a ser tú.
Con /goal — cuando quieres irte y que siga solo
Escribes /goal y una condición de terminado. A partir de ahí, después de cada turno un modelo evaluador (Haiku por default) revisa lo que pasó y decide si la condición ya se cumplió, y te explica por qué sí o por qué no. Si todavía no, Claude arranca otro turno por su cuenta.
Es la diferencia entre revisar tú y poner un juez. /goal solo te muestra el estado; /goal clear lo apaga.
El costo de esta manera es obvio en cuanto lo ves: si la condición está mal escrita, pusiste un juez sin regla. Por eso el prompt de abajo no fija la meta — hace que Claude te la escriba primero, sacándola de los criterios de aceptación que ya tienes, y espera tu visto bueno.
Convierte el plan en una condición verificable
Antes de fijar una meta con /goal, que Claude te la escriba. La mitad del valor está en descubrir que tu definición de terminado no se podía comprobar.
Quiero dejar esto corriendo hasta que de verdad esté terminado, usando /goal. Antes de fijar nada, escríbela tú. Toma la lista de SEMANA.md y los criterios de aceptación de cada contrato, y conviértelos en UNA sola condición de terminado que se pueda comprobar sin opinar. Reglas de la condición: - Todo lo que menciones se tiene que poder verificar leyendo un archivo o corriendo un comando. - Nombra los archivos por su ruta, no por su idea. - Incluye también el estado negativo: qué NO debe quedar. Ningún pendiente marcado, ningún archivo vacío, ningún texto de relleno. - Que quepa en dos o tres renglones. Si necesitas más, son dos metas y hay que partirlas. Lo que no acepto como condición: "que la semana quede lista", "que todo funcione bien", "que esté presentable". Devuélveme la condición propuesta y espera mi visto bueno. Cuando la apruebe, dime la línea exacta que tengo que escribir. No la fijes tú.
ANTIPATRÓN
Un deseo no es una condición
Lo que casi todos escriben en /goal es un deseo. El evaluador no tiene contra qué medirlo, así que termina dando su opinión, y su opinión casi siempre es que sí, que ya quedó.
Mal
que los entregables estén bien
Bien
los cuatro archivos existen, ninguno dice pendiente, y el veredicto de cada uno es pasa
La prueba rápida: si dos personas leen tu condición y pueden llegar a respuestas distintas, todavía es un deseo. Reescríbela hasta que solo haya una respuesta posible.
Nativa — la aprobación de plan del líder
Si vas por la ruta de equipos de agentes, el bucle ya viene puesto y no hay nada que copiar. Le pides al líder que exija aprobación de plan antes de que nadie toque nada: el compañero trabaja en modo plan de solo lectura, manda su plan, y el líder lo aprueba o lo rechaza con retroalimentación. Si lo rechaza, el compañero replantea y lo vuelve a mandar.
Lo único que agregas es el criterio con el que juzga el líder — "solo apruebas planes que incluyan pruebas" — y ese criterio se aplica a cada plan que llegue, sin que tú vuelvas a intervenir.
La diferencia con las otras dos maneras está en el momento: aquí revisas el enfoque antes de que se escriba una sola línea, no el resultado después. Rechazar un plan de seis renglones cuesta muchísimo menos que rechazar cuatro archivos ya hechos.
| Manera | Quién revisa | Cuándo la quieres |
|---|---|---|
| A mano, contra el contrato | Tú, sobre el veredicto que arma el director | Tus primeras corridas, y siempre que el entregable le llegue a un cliente |
| Con /goal | Un modelo evaluador (Haiku por default) al cierre de cada turno | Cuando la condición se puede comprobar sin opinar y quieres levantarte de la silla |
| Aprobación de plan del líder | El líder del equipo, antes de que se escriba nada | Cuando corres equipos y el error caro no es el código: es el enfoque |
La revisión es lo que separa a un director de alguien que nada más lanzó agentes.
09 mientras corren
Qué haces mientras trabajan, y qué te cuesta
Sueltas la corrida y de golpe no tienes nada entre manos. Ahí es donde la mayoría se levanta por un café y vuelve veinte minutos después a un montón de trabajo mal hecho, ya pagado.
Mientras los agentes construyen, tú tienes puesto, y tiene dos mitades: mirar el tablero y cuidar la cuenta. Las dos se hacen desde la misma pantalla.
Mirar
El comando /workflows abre la vista de progreso de la corrida. No es una barra de carga: es el desglose por fase, y cada fase te dice cuántos agentes tiene trabajando, cuántos tokens lleva gastados y cuánto tiempo lleva corriendo. Entras a una fase y ves a los agentes uno por uno, con lo que le tocó a cada quien.
La vista de progreso de la corrida
/workflows| Tecla | Qué hace |
|---|---|
| p | Pausa la corrida. La misma tecla la reanuda. |
| x | Detiene al agente que tienes seleccionado. Desde la vista general, detiene la corrida completa. |
| r | Reinicia un agente desde cero con la misma tarea, sin tocar a los demás. |
| f | Filtra por estado, para ver solo lo que sigue corriendo o solo lo que falló. |
| s | Guarda la corrida como comando propio, para volver a lanzarla igual otro día. |
| Enter | Entra al detalle de la fase o del agente que tienes seleccionado. |
Los equipos de agentes no salen ahí: viven en el panel que aparece debajo del input, con cada compañero y su estado. Te mueves con las flechas, entras con Enter y le escribes directo a ese compañero, no al líder. Esa es la diferencia práctica entre las dos rutas: a un workflow lo pausas, a un compañero le hablas.
tu puesto mientras corren
Detener temprano es la habilidad
Tu trabajo mientras trabajan no es esperar. Es abrir los primeros entregables que van cayendo y compararlos contra el contrato. Los primeros dos minutos de un agente ya te dicen si entendió: el archivo está donde pediste, el formato es el que pediste, la primera sección va del tema correcto.
Si va por mal camino, x. Rehacer una tarea que paraste a los dos minutos cuesta una fracción de lo que cuesta descubrir al final que otros seis agentes construyeron encima de algo torcido.
Pagar
Los topes, sin adornos: hasta 16 agentes en paralelo — menos si tu máquina tiene pocos núcleos, porque ese límite lo pone tu hardware y no tu plan — y hasta 1000 agentes en una sola corrida. El segundo número no lo vas a tocar nunca. El que sí vas a tocar es el de tu cuenta.
Cuando una corrida se proyecta arriba de 25 agentes o de 1.5 millones de tokens, Claude Code te avisa con un “Large workflow”. Léelo con calma: el aviso no detiene nada. Solo te apunta a /workflows para que vayas a ver. Si te llegó y no abriste el tablero, ese aviso no sirvió de nada.
Las tres palancas del gasto
El tamaño, en /config
La guía de tamaño tiene tres opciones: small (menos de 5 agentes), medium (menos de 15, es el default) y large (menos de 50).
No es un candado, es la referencia con la que se planea la corrida. Bájala a small antes de una corrida grande cuando todavía no confías en el reparto: prefieres cinco agentes que entendieron a quince que no.
El modelo por etapa
Por default todos los agentes usan el modelo de tu sesión. Si diriges con el grande, hasta la etapa que solo renombra archivos corre con el grande. Ahí es donde se va el dinero.
Dilo al repartir: que use un modelo más chico para las etapas que no lo necesitan. Buscar, resumir, ordenar y renombrar casi nunca lo necesitan.
La rebanada de prueba
Nunca sueltes la primera corrida sobre todo el proyecto. Córrela sobre una carpeta, o sobre tres tareas de la lista.
Al terminar, abre /workflows y mira lo que gastó esa rebanada. Multiplícalo por lo que falta y ya sabes el precio de la corrida completa antes de pagarla.
si diriges con Fable
El techo incluido está en tus límites semanales
En Max ($100 y $200) Fable 5 viene incluido, con un detalle que conviene traer en la cabeza mientras miras el tablero: puedes gastar hasta el 50% de tus límites semanales en Fable sin costo extra. Pasado ese punto sigues con usage credits, o te cambias de modelo y terminas la semana dirigiendo con Opus 5.
En Pro ($20) es otra historia: Fable no entra en los límites del plan y se cobra aparte desde el primer token. Ahí el director es Opus 5, que sí está incluido.
Ya eres el director cuando…
No hay diploma. Hay cinco señales, y todas son de comportamiento, no de herramienta.
- Tu semana vive en un archivo que puedes repartir, no en tu cabeza ni en un chat que se te va a perder.
- Cada agente tiene modelo asignado y contrato escrito antes de arrancar: qué archivo entrega, en qué formato y qué no puede tocar.
- Revisas contra el contrato y no contra tu gusto. Cuando rechazas algo, señalas la línea que no se cumplió.
- Detienes trabajo a los dos minutos sin sentir que perdiste algo, porque lo caro es dejarlo terminar.
- El modelo más caro que pagas dejó de escribir código: reparte, revisa y regresa lo que no pasó. Eso es lo único que no puedes delegar.
Guía de la comunidad
Esta guía es parte de la bóveda abierta de tododeia.
Las fuentes · todo lo de aquí está verificado
Cada dato de esta guía salió de la documentación oficial de Anthropic y quedó verificado el 31 de julio de 2026. Si algo cambió desde entonces, la fuente manda sobre la guía: abre el enlace, compáralo, y si ves la diferencia, dímela y la corrijo.
Workflows dinámicos, en la documentación de Claude Code
Cómo se disparan, los topes de agentes al mismo tiempo, el comando /workflows y lo que consumen
Subagentes: dónde viven y cómo se escriben
La carpeta donde van los perfiles, el frontmatter completo campo por campo y el panel /agents
Equipos de agentes
La función experimental: cómo se prende, qué trae de fábrica y hasta dónde llega hoy
Modelos, alias y niveles de esfuerzo
Qué alias existen, cómo se cambia de modelo a media sesión y qué hace cada nivel de esfuerzo
/goal y su modelo evaluador
Cómo se fija una meta, quién la revisa después de cada turno y cómo se apaga cuando ya no la quieres
Fable 5 según tu plan
De dónde sale el 50% de tus límites semanales en Max, y por qué en Pro corre con usage credits aparte
El kit · para llevártelo
Un solo archivo con los siete prompts de la guía y los cuatro perfiles de subagente, listos para copiar sin tener que volver a esta página.
abrir el kit de orquesta (markdown)Sigue por aquí
Quién es quién antes de repartirles trabajo
El prerrequisito de esta guía. Haiku, Sonnet, Opus y Fable con sus diferencias reales, para que asignes el modelo sabiendo a quién se lo estás dando.
La ruta A, completa
El enjambre que se arma solo y avanza sin que tú apruebes cada paso, con las reglas para que no te vacíe la cuenta en una tarde.
El interruptor del máximo esfuerzo
Cuándo subirle mientras planeas y repartes, y cuándo bajarle en los agentes que solo ejecutan. Es la palanca de calidad y de gasto al mismo tiempo.
Modo plan, a fondo
Cómo activarlo, cómo auditar el plan que te devuelve y cuándo aprobarlo. Aquí lo usas en dos renglones; ahí está el oficio entero.
/goal, sin resumir
Para cuando quieras que la revisión corra sola mientras tú no estás: cómo se fija la condición, quién la juzga y qué pasa si no se cumple.
El siguiente nivel
Agentes permanentes corriendo todo el día, no solo la semana que acabas de repartir. El paso natural cuando dirigir ya se te da.
Lo que yo hago
“El día que dejé de pedirle código al modelo caro y empecé a pedirle que repartiera y revisara, se me acabó la sensación de avanzar mucho y terminar poco. Antes cerraba tareas sueltas y la semana seguía completa el domingo. Ahora abro la sesión, reparto, reviso lo que regresa y cierro semanas enteras. El trabajo es el mismo; lo que cambió fue mi puesto.”
Una nota honesta
Orquestar gasta más que trabajar solo: cada agente abre su propio contexto y el director paga por leer todo lo que le entregan. Y no toda tarea lo amerita. Si es un archivo y una decisión, una sola sesión te sale mejor y más rápido. Dirigir se justifica cuando hay varias cosas independientes que pueden avanzar al mismo tiempo y un criterio tuyo que alguien tiene que sostener parejo en todas.