Imagina que necesitas procesar 210 archivos de una sola vez: revisar código, extraer metadatos, generar informes. Hacerlo en secuencia llevaría horas. Con un workflow dinámico, el orquestador activa un subagente por archivo, todos al mismo tiempo, cada uno en su propia ventana, y recibes el consolidado en minutos. El diagrama de abajo muestra lo que ocurre internamente.
Contenido detallado
🌐 Qué es un workflow dinámico
En Claude Code, un workflow dinámico es una orquestación en la que el
el número de subagentes no está fijado en el prompt — se determina en
tiempo de ejecución por el orquestador. El maestro recibe la lista de elementos, decide cuántos agentes va a necesitar
y los lanza todos mediante Task tool, uno para cada elemento.
Qué es
Una estructura de ejecución en la que el orquestador genera dinámicamente N tareas paralelas según la entrada, ya sea una lista de archivos, una lista de URLs, una lista de capítulos o cualquier colección iterable. Cada elemento se convierte en un subagente independiente.
Por qué aprender
Entender los workflows dinámicos es lo que permite ejecutar jobs que serían imposibles en secuencia dentro de una sola sesión. Es la diferencia entre procesar 5 archivos y procesar 200, con el mismo esfuerzo de prompt. Sin este conocimiento, subutilizas la herramienta más poderosa de la plataforma.
Conceptos clave
🚀 El disparador: de "workflow" a ultracode
La palabra mágica cambió. Durante mucho tiempo, el prompt predeterminado para activar la orquestación masiva era
workflow. Con las versiones más recientes de
Claude Code, el disparador recomendado pasó a ser ultracode.
El comportamiento es el mismo, pero el token cambió. Saberlo evita frustraciones cuando sigues tutoriales antiguos.
Qué es
ultracode es una instrucción al orquestador
para que use la máxima capacidad paralela disponible. Cuando incluyes este token en el prompt, el maestro sabe que
puede (y debe) activar tantos subagentes como sea necesario, sin limitar la cantidad de forma artificial.
Por qué aprender
El token correcto cambia la estrategia de ejecución del modelo. Sin él, Claude puede optar por procesar en secuencia o con menos agentes. Con él, declaras explícitamente: "usa una orquestación masiva aquí". Es el interruptor entre el modo normal y el modo de escala total.
Conceptos clave
ultracode
workflow
📈 Escala: decenas y cientos de agentes
Claude Code fue diseñado para admitir la orquestación en escala real. No hablamos de 3 a 5 subagentes, sino de decenas a cientos ejecutándose en paralelo. Cada subagente tiene su propia sesión, usa tokens independientes y puede usar un modelo distinto al del orquestador.
Qué es
La plataforma no impone un límite estricto de subagentes por workflow. El límite práctico está en tu cuenta de API (límites de tasa), el presupuesto disponible y la capacidad de consolidar los resultados sin hacer que el contexto del orquestador se dispare. Los jobs con más de 40 agentes simultáneos son comunes en escenarios de auditoría masiva.
Por qué aprender
Saber cuál es la escala posible cambia tu arquitectura de prompts. Si no sabes que puedes lanzar 100 agentes, seguirás diseñando soluciones secuenciales para problemas que se pueden paralelizar. Conocer el límite real permite diseñar workflows correctos desde el principio.
Conceptos clave
💸 Costo y límite de sesión
Los flujos de trabajo dinámicos son costosos por diseño. Cada subagente consume tokens de forma independiente, y el costo de un workflow con 200 agentes es aproximadamente 200× el costo de un único agente ejecutando la misma tarea. Además del costo financiero, está el límite de sesión: el orquestador todavía necesita suficiente contexto para leer todos los informes.
Qué es
El costo de un workflow es la suma de los tokens de cada subagente más los tokens del orquestador al consolidar. El orquestador necesita contexto para recibir los informes: si cada agente devuelve 500 tokens y tienes 200 agentes, son 100 000 tokens solo en los informes, antes de cualquier análisis.
Por qué aprender
Planificar el costo antes de ejecutar evita sorpresas. Un workflow mal dimensionado puede consumir todo el presupuesto mensual en minutos. Entender la estructura de costos permite decidir: ¿vale la pena usar Haiku en los subagentes? ¿Conviene pedir resúmenes ultracortos? ¿Conviene dividir el trabajo en lotes más pequeños?
Conceptos clave
- • Usar Haiku en los subagentes cuando sea posible
- • Pedir un resumen breve (no un volcado en bruto)
- • Procesar en lotes de 20–40 a la vez
- • Probar con 5 elementos antes de escalar
- • Pedir un output largo de cada agente
- • Usar Opus en todos los subagentes
- • Lanzar 200 agentes sin probar antes
- • Ignorar el costo de consolidación
🔬 El caso real: 41 y 210 subagentes
Dos números se convirtieron en referencia en la comunidad de Claude Code para workflows a escala real: 41 subagentes (caso de auditoría de codebase) y 210 subagentes (procesamiento de documentos masivos). Estos no son límites de la herramienta; son casos documentados que demuestran que la arquitectura admite escalar sin fallas estructurales.
Qué es
Cada subagente analizó un módulo diferente. El orquestador consolidó los hallazgos en un único informe de seguridad.
Cada subagente procesó una sección de un documento extenso. Fan-out completo en una sola llamada al orquestador.
Por qué aprender
Estos casos demuestran que los workflows dinámicos no son teoría: son práctica. También definen una escala de referencia: si tu problema tiene menos de 40 elementos en paralelo, estás dentro del rango cómodo. Si tiene más de 100, necesitas planificar los costos de forma explícita.
Conceptos clave
✅ Cuándo conviene usar workflows dinámicos
No todos los trabajos paralelos necesitan un workflow dinámico. La regla práctica: si el procesamiento de cada elemento es independiente, la lista tiene más de 10 elementos e el contexto explotaría al procesar en secuencia — entonces los workflows dinámicos son la opción correcta.
Qué es
El criterio de decisión tiene tres dimensiones: independencia (los elementos no dependen unos de otros), volumen (una lista lo suficientemente larga como para justificar la sobrecarga de orquestación) y riesgo de contexto (procesarlo todo en el maestro haría estallar la ventana de contexto).
Por qué aprender
El error más común es usar workflow para todo, incluso en tareas pequeñas donde la secuencia sería más eficiente y barata. Aprender el criterio correcto evita desperdiciar tokens y agregar complejidad innecesaria.
Conceptos clave
- • Revisar más de 20 archivos de código
- • Procesar secciones de un documento largo
- • Generar un informe para N repositorios
- • Analizar N contratos en paralelo
- • Traducir N páginas simultáneamente
- • Trabajo con 2–3 elementos (basta con una secuencia)
- • Elementos que dependen unos de otros
- • Cuando el costo supera el ahorro de tiempo
- • Tareas creativas que necesitan coherencia
- • Pipeline con estado compartido
⚠️ Precauciones: qué puede salir mal
La orquestación masiva trae riesgos que no existen en trabajos simples. Los tres más críticos: explosión de contexto en el consolidador, costo inesperado e fallas silenciosas — un subagente que devuelve un resultado vacío sin avisar.
Qué es
Cada riesgo tiene una causa específica: el orquestador recibe informes demasiado grandes (explosión del contexto); el modelo no tiene una visión previa del costo total antes de ejecutar (sorpresa financiera); un subagente se bloquea o devuelve un error silencioso, lo que contamina el consolidado sin que el orquestador se dé cuenta.
Por qué aprender
Los flujos de trabajo que fallan silenciosamente son los más peligrosos: el orquestador entrega un informe incompleto sin indicar que 3 de los 40 subagentes no devolvieron nada. Conocer el riesgo permite agregar instrucciones explícitas de validación en el prompt del orquestador.
Conceptos clave: mitigaciones
Ejemplo conceptual
Abajo tienes el modelo mental de un workflow para procesar 15 capítulos de un libro técnico en paralelo. Observa que el orquestador no necesita leer los 15 capítulos: cada agente lee el suyo y devuelve solo lo esencial.
ORQUESTRADOR recebe: lista de 15 capítulos
PARA CADA capítulo em paralelo (ultracode):
SUBAGENTE recebe: "Leia capitulo_X.md e me traga:
1. Tese central (1 frase)
2. Principais conceitos (3 bullets)
3. Pontos confusos para revisão (máx 2)
Resposta: máx 100 tokens."
ORQUESTRADOR consolida: 15 resumos → relatório final
→ identifica capítulos com mais pontos confusos
→ sugere ordem de revisão prioritáriaClave del diseño: cada subagente devuelve un máximo de 100 tokens. Con 15 agentes, el orquestador recibe ~1 500 tokens de input — manejable. Sin ese límite, 15 capítulos largos podrían devolver 50 000 tokens y hacer estallar el contexto.
Prompts listos (copia y pega)
Tres prompts para activar workflows dinámicos con control de costos. En todos, fíjate en el patrón: declara el volumen, limita el output de cada agente e pide validación en el consolidado.
Use ultracode para auditar os arquivos em src/.
Para cada arquivo, abra um subagente com Haiku.
Cada subagente deve retornar APENAS:
- Arquivo: nome
- Problemas: lista de até 3 items
- Severidade: baixa/média/alta
Máximo 80 tokens por resposta.
Ao final, consolide quantos arquivos retornaram
vazio e liste os de severidade alta primeiro.Tenho 80 contratos em /docs/contratos/.
ANTES de rodar, estime quantos subagentes serão
criados e o custo aproximado se cada agente usar
~2 000 tokens.
Se aprovado, use ultracode: abra um subagente por
contrato, extraia só: partes, valor total, cláusula
de rescisão. Resposta máx 60 tokens cada.
Relatório final: tabela resumida.Tenho 200 URLs em urls.txt. Processe em LOTES
de 20 URLs por vez (não todas de uma vez).
Cada lote: use ultracode, abra 20 subagentes em
paralelo, cada um faz: título + resumo em 2 linhas.
Após cada lote, mostre progresso (lote X/10 concluído).
Ao final, consolide tudo em uma lista numerada.Pantalla simulada: workflow ejecutando 6 subagentes
Así aparece un workflow de auditoría en la terminal de Claude Code: el orquestador lanzó 6 agentes simultáneos, cada uno en su propia sesión. La línea de estado del orquestador muestra solo ~8% del contexto usado — el trabajo pesado quedó a cargo de los subagentes.
Ejercicio: ¿workflow o secuencia?
Para cada escenario a continuación, decide: workflow dinámico o procesamiento secuencial? Justifica tu respuesta con base en los tres criterios: independencia, volumen y riesgo para el contexto.
Revisar 3 archivos de configuración para verificar si hay variables de entorno expuestas.
Consejo: piensa en el volumen y en el overhead de orquestación.
Generar un resumen de 50 artículos científicos para una revisión de literatura. Cada artículo tiene ~10 000 palabras.
Consejo: ¿qué pasa con el contexto si procesas en secuencia?
Refactorizar un módulo grande por etapas: primero extraer clases, después renombrar variables y luego agregar pruebas.
Consejo: piensa en la dependencia entre las etapas.
Criterio de evaluación
A — Secuencial: solo 3 archivos; la sobrecarga del flujo de trabajo no se justifica. El costo y la complejidad superan el beneficio del paralelismo.
B — Workflow dinámico: 50 artículos independientes, cada uno con 10k palabras. Procesarlos en secuencia desbordaría el contexto. La solución correcta es distribuirlos entre 50 agentes y pedir un resumen breve.
C — Secuencial: las etapas dependen unas de otras (no se puede cambiar el nombre antes de extraer). El paralelismo no se aplica a los pipelines con dependencia de estado.
✅ Resumen del módulo
- ▸ Flujo de trabajo dinámico = el orquestador activa N subagentes según la entrada; N se determina en tiempo de ejecución.
- ▸ El token de activación actual es
ultracode(era "workflow" en las versiones antiguas). - ▸ La plataforma admite decenas o cientos de agentes simultáneos: el límite práctico es el presupuesto.
- ▸ Costo = suma de los tokens de todos los subagentes + consolidación. Calcúlalo antes de ejecutar.
- ▸ Casos de referencia: 41 agentes (auditoría) y 210 agentes (procesamiento de documentos).
- ▸ Úsalo cuando haya elementos independientes, un volumen alto y riesgo de que el contexto se acumule en secuencia.
- ▸ Mitigaciones: resultado breve por agente, prueba con un lote pequeño, validación en el consolidador.