La semana pasada, lanzamos flujos de trabajo dinámicos en Claude Code. Claude ahora puede escribir su propio entorno sobre la marcha, creado a la medida para la tarea en cuestión.
Si bien el entorno predeterminado de Claude Code está diseñado para codificar, también es útil para muchos otros tipos de tareas porque, como resulta, muchas tareas se parecen a las tareas de codificación. Pero hay ciertas clases de tareas para las que hemos tenido que construir entornos personalizados sobre Claude Code para lograr un rendimiento óptimo, como Investigación, análisis de seguridad, equipos de agentes o Revisión de código.
Los flujos de trabajo te permiten crear entornos dinámicamente que le permiten a Claude resolver todos esos problemas y más de forma nativa dentro de Claude Code. También puedes compartir y reutilizar estos flujos de trabajo con otras personas.
En este artículo, cubriré mis experiencias y aprendizajes iniciales con los flujos de trabajo para que puedas aprovecharlos al máximo.
Dicho esto, ¡las mejores prácticas aún están en desarrollo! Los flujos de trabajo dinámicos a menudo usan más tokens, así que piensa cuidadosamente cuándo y cómo usarlos.
Nota: esta publicación también está disponible en el Blog de Claude
Ejemplos de indicaciones
Antes de sumergirnos en los detalles técnicos, me gustaría comenzar con algunos ejemplos de indicaciones para que empieces a pensar en las posibilidades con los flujos de trabajo:
- "Esta prueba falla quizás 1 de cada 50 ejecuciones. Configura un flujo de trabajo para reproducirla, formular teorías y probarlas adversarialmente en worktrees /goal no te detengas hasta que una teoría funcione."
- "Usando un flujo de trabajo, revisa mis últimas 50 sesiones y extrae las correcciones que sigo haciendo y convierte las recurrentes en reglas de CLAUDE.md"
- "Usa un flujo de trabajo para indagar en #incidents de Slack de los últimos seis meses y encuentra causas raíz recurrentes donde nadie ha creado un ticket."
- "Toma mi plan de negocios y ejecuta un flujo de trabajo donde diferentes agentes lo critiquen desde la perspectiva de un inversor, un cliente y un competidor."
- "Aquí hay una carpeta con 80 currículums, usa un flujo de trabajo para clasificarlos para el puesto de backend y verifica dos veces los diez primeros. Entrevístame usando la herramienta AskUserQuestion para una rúbrica."
- "Necesito un nombre para esta herramienta CLI. Usa un flujo de trabajo para generar muchas opciones y ejecuta un torneo para elegir las 3 mejores."
- "Usa un flujo de trabajo para renombrar nuestro modelo User a Account en todas partes."
- "Revisa el borrador de mi publicación de blog y, usando un flujo de trabajo, verifica cada afirmación técnica contra el código base, no quiero publicar nada incorrecto."
Cómo funcionan los flujos de trabajo dinámicos
Los flujos de trabajo dinámicos ejecutan un archivo JavaScript con algunas funciones especiales que ayudan a generar y coordinar subagentes:
Los flujos de trabajo dinámicos también incluyen funciones estándar de JavaScript como JSON, Math y Array, para ayudar a procesar datos.
Es particularmente útil saber que los flujos de trabajo dinámicos pueden decidir qué modelos usa un agente y si los subagentes se ejecutan en su propio worktree, permitiendo que Claude elija el nivel de inteligencia y aislamiento necesarios.
Si un flujo de trabajo se interrumpe, por ejemplo por una acción del usuario o al cerrar la terminal, reanudar la sesión permitirá que el flujo de trabajo continúe desde donde se quedó.
Por qué usar flujos de trabajo dinámicos
Cuando le pides al entorno predeterminado de Claude Code que realice una tarea, necesita tanto planificar como ejecutar en la misma ventana de contexto. Para muchas tareas de codificación, esto es muy efectivo, pero a veces puede fallar en tareas adversariales de larga duración, masivamente paralelas y/o altamente estructuradas.
Esto se debe a que cuanto más tiempo trabaja Claude en una tarea compleja en una sola ventana de contexto, más susceptible se vuelve a algunos modos de falla específicos:
- Pereza agentiva se refiere a cuando Claude se detiene antes de terminar una tarea particularmente compleja de varias partes y declara el trabajo terminado después de un progreso parcial, por ejemplo, abordando 20 de los 50 elementos en una revisión de seguridad.
- Sesgo de autopreferencia se refiere a la tendencia de Claude a preferir sus propios resultados o hallazgos, especialmente cuando se le pide verificarlos o juzgarlos contra una rúbrica.
- Desviación de objetivo se refiere a la pérdida gradual de fidelidad al objetivo original a lo largo de muchos turnos, especialmente después de la compactación. Cada paso de resumen tiene pérdidas, y detalles como requisitos de casos extremos o restricciones de "no hagas X" pueden perderse.
Crear un flujo de trabajo ayuda a combatir esto orquestando Claudes separados con sus propias ventanas de contexto y objetivos enfocados y aislados.
Flujos de trabajo dinámicos vs. estáticos
Es posible que hayas creado previamente un flujo de trabajo estático usando el SDK de Agente de Claude o claude -p para coordinar múltiples instancias de Claude Code juntas.
Pero debido a que los flujos de trabajo estáticos necesitan funcionar para todos los casos extremos, generalmente son más genéricos. Con Claude Opus 4.8 y los flujos de trabajo dinámicos, Claude ahora es lo suficientemente inteligente como para escribir un entorno personalizado hecho a la medida para tu caso de uso.
Patrones útiles al usar flujos de trabajo dinámicos
Puedes comenzar a usar flujos de trabajo dinámicos simplemente pidiéndole a Claude que cree uno, o usando la palabra clave "ultracode" para asegurarte de que Claude Code cree un flujo de trabajo.
Pero construir un modelo mental de cómo funcionan los flujos de trabajo dinámicos te ayudará a entender cuándo usarlos y cómo podrías guiar a Claude a través de indicaciones.
Hay algunos patrones comunes que Claude podría usar y combinar al construir flujos de trabajo:
Clasificar y actuar
Usa un agente clasificador para decidir el tipo de tarea y luego enruta a diferentes agentes o comportamientos según la tarea. O, usa un clasificador al final para determinar la salida.
Distribuir y sintetizar
Divide una tarea en muchos pasos más pequeños, ejecuta un agente en cada paso y luego sintetiza esos resultados. Esto es particularmente útil cuando hay un gran número de pasos pequeños, o cuando cada paso se beneficia de su propia ventana de contexto limpia para que no interfieran o se contaminen entre sí. El paso de síntesis es una barrera: espera a todos los agentes distribuidos, luego fusiona sus salidas estructuradas en un solo resultado.
Verificación adversarial
Para cada agente generado, ejecuta un agente generado separado para verificar adversarialmente su salida contra una rúbrica o criterios.
Generar y filtrar
Genera una serie de ideas sobre un tema y luego fíltralas por una rúbrica o por verificación, elimina duplicados y devuelve solo las ideas de mayor calidad y probadas.
Torneo
En lugar de dividir el trabajo, haz que los agentes compitan en él. Genera N agentes que cada uno intente la misma tarea usando diferentes enfoques. Luego, las indicaciones o modelos juzgan los resultados de forma pareada usando un agente juez hasta que tengas un ganador.
Bucle hasta terminar
Para tareas con una cantidad de trabajo desconocida, sigue generando agentes en bucle hasta que se cumpla una condición de parada (sin nuevos hallazgos, o sin más errores en los registros) en lugar de un número fijo de pasadas.
Casos de uso
Piensa creativamente en cuándo y cómo pedirle a Claude Code que cree flujos de trabajo dinámicos. He descubierto que los flujos de trabajo a veces son incluso más útiles para trabajos no técnicos.
Migraciones y refactorizaciones
Bun fue reescrito de Zig a Rust usando flujos de trabajo. Puedes leer más sobre cómo se hizo en el hilo de X de Jarred.
La clave es desglosar la tarea en una serie de pasos que deben ejecutarse, por ejemplo, en sitios de llamada, pruebas fallidas, módulos, etc. Genera un subagente para cada corrección en un worktree para hacer la corrección, luego haz que otro agente la revise adversarialmente y fusiónala. Considera decirle al agente que no use comandos que consuman muchos recursos para que puedas paralelizar al máximo sin quedarte sin recursos en tu máquina.
Investigación profunda
Publicamos una habilidad de investigación profunda (/deep-research) dentro de Claude Code que usa flujos de trabajo dinámicos. Específicamente, distribuye búsquedas web, obtiene fuentes, verifica adversarialmente sus afirmaciones y sintetiza un informe citado.
Pero puedes hacer este tipo de investigación para más que solo búsquedas web. Por ejemplo, pedirle a Claude que compile un informe de estado a partir del contexto en Slack o que investigue cómo funciona una característica explorando un código base en profundidad.
Verificación profunda
Por otro lado, si tienes un informe en el que deseas verificar y rastrear cada afirmación fáctica que referencia, es posible que desees generar un flujo de trabajo que tenga un agente que identifique todas las afirmaciones fácticas y luego genere un subagente para verificar cada una en detalle. También podrías tener un agente de verificación que revise al subagente de la fuente para asegurarse de que su fuente sea de alta calidad.
Clasificación
Es posible que tengas una lista de elementos que deseas clasificar por alguna medida cualitativa que creas que Claude Code es bueno evaluando, por ejemplo: tickets de soporte clasificados por gravedad del error. Pero si intentas clasificar más de 1000 filas en una sola indicación, la calidad se degrada y no cabrá en el contexto. En su lugar, ejecuta un torneo, un pipeline de agentes de comparación por pares (el juicio comparativo es más confiable que la puntuación absoluta), o clasifica por grupos en paralelo y luego fusiona. Cada comparación es su propio agente, por lo que el bucle determinista mantiene el bracket y solo el orden de ejecución permanece en el contexto.
Memoria y adherencia a reglas
Si tienes un conjunto particular de reglas que Claude parece omitir o con las que tiene dificultades, incluso cuando se colocan en los CLAUDE.md, crea un flujo de trabajo con una lista de reglas que deben ser verificadas por agentes verificadores: un verificador por regla. Crear un subagente con personalidad escéptica para revisar las reglas y asegurarse de que estén alineadas ayudará a evitar demasiados falsos positivos.
La dirección inversa también funciona: extrae tus sesiones recientes y comentarios de revisión de código para encontrar correcciones que sigues haciendo, agrúpalas con agentes paralelos, verifica adversarialmente cada candidato (¿esta regla habría prevenido un error real?), y luego destila los supervivientes de vuelta a un CLAUDE.md.
Investigación de causa raíz
La depuración funciona mejor cuando se te ocurren varias hipótesis independientes y las pruebas, pero si solo usas una ventana de contexto, Claude puede caer en el sesgo de autopreferencia.
Un flujo de trabajo puede prevenir estructuralmente esto generando agentes para crear hipótesis a partir de evidencia inconexa. Por ejemplo, agentes separados para registros, archivos y datos. Cada hipótesis puede luego enfrentarse a un panel de verificadores y refutadores.
Esto no es solo para código. Los flujos de trabajo se pueden usar para ventas (¿por qué cayeron las ventas en marzo?), ingeniería de datos (¿por qué falló este pipeline?), o cualquier ejercicio de análisis post-mortem.
Triaje a escala
Cada equipo tiene una cola de soporte, informes de errores o algún otro backlog que los humanos no pueden procesar por completo.
Un flujo de trabajo de triaje clasifica cada elemento, elimina duplicados contra lo que ya está rastreado y toma medidas. Esto podría significar intentar la corrección o escalar a un usuario humano.
Un patrón útil para los flujos de trabajo de triaje es la cuarentena. Esto implica impedir que los agentes que leen contenido público no confiable tomen acciones de alto privilegio, que en su lugar son realizadas por los agentes encargados de actuar sobre la información.
Combina los flujos de trabajo de triaje con /loop para que Claude haga esto continuamente.
Exploración y gusto
Los flujos de trabajo pueden ser útiles al explorar diferentes enfoques para una solución, especialmente cuando se basa en el gusto, como el diseño o la nomenclatura, y se beneficiaría de una rúbrica.
Intenta pedirle a Claude que explore un montón de soluciones y dale a un agente de revisión una rúbrica de cómo se ve una buena solución. La tarea se completa cuando el agente de revisión siente que ha cumplido con los criterios. Las soluciones también se pueden ordenar o seleccionar mediante un torneo basado en la rúbrica.
Evaluaciones
Puedes ejecutar evaluaciones ligeras para tareas particulares generando agentes separados en un worktree y luego generando agentes de comparación para comparar y calificar las salidas específicas contra una rúbrica. Por ejemplo, evaluar y luego refinar una habilidad que has creado contra un criterio particular.
Enrutamiento de modelo e inteligencia
Crea un agente clasificador ajustado a tus tareas que decida qué modelo usar. Esto puede ser útil cuando tu tarea implicará muchas llamadas a herramientas y realizar una investigación previa a la ejecución puede identificar el mejor modelo para el trabajo.
Por ejemplo, el mejor modelo para la tarea "explica cómo funciona el módulo de autenticación" depende de cuántos archivos haya en el módulo de autenticación y la forma del código base. Un agente clasificador puede hacer esta investigación y luego enrutar a Sonnet u Opus según la complejidad esperada de la tarea.
Cuándo no usar flujos de trabajo dinámicos
Los flujos de trabajo son nuevos. Si bien hay muchos casos de uso en los que crearán resultados excepcionales, no son necesarios para cada tarea y pueden terminar usando significativamente más tokens.
Es mejor usar flujos de trabajo de forma creativa para impulsar a Claude Code de maneras que no hayas hecho antes. Para tareas de codificación regulares, intenta preguntarte: ¿realmente necesita más cómputo? Por ejemplo, la mayoría de las tareas de codificación tradicionales no necesitan un panel de 5 revisores.
Consejos para construir flujos de trabajo dinámicos
Creación de indicaciones
Las indicaciones detalladas, utilizando las técnicas específicas que describimos anteriormente, para flujos de trabajo dinámicos crean los mejores resultados.
Los flujos de trabajo no son solo para tareas grandes. Puedes indicarle al modelo que use un "flujo de trabajo rápido". Por ejemplo, puedes crear una revisión adversarial rápida de una suposición.
Combínalo con /goal y /loop
Al usar flujos de trabajo que se pueden repetir, por ejemplo, triaje, investigación o verificación, combínalos con /loop para que se ejecuten a intervalos regulares y con /goal para establecer un requisito de finalización estricto.
Presupuestos de uso de tokens
Puedes establecer presupuestos de uso de tokens explícitos para flujos de trabajo dinámicos para limitar cuántos tokens usa una tarea. Puedes indicarlo con un presupuesto como: "usa 10k tokens", lo que establecerá el límite.
Guardar y compartir flujos de trabajo dinámicos
Puedes guardar flujos de trabajo presionando "s" en el menú de flujos de trabajo. Puedes guardarlos en ~/.claude/workflows o distribuirlos a través de una habilidad.
Para compartirlos a través de una habilidad, coloca tus archivos de flujo de trabajo JavaScript en la carpeta de la habilidad y refieréelos en el SKILL.MD. Para permitir más flexibilidad, es posible que desees indicarle a Claude que considere los flujos de trabajo en la habilidad como una plantilla en lugar de un script que debe ejecutarse al pie de la letra.
Un mundo completamente nuevo
Los flujos de trabajo son una nueva forma útil de extender Claude Code. Te animo a pensar en esto como un punto de partida, todavía hay mucho por descubrir sobre cómo usarlos mejor. Cuéntanos qué encuentras.
Thariq Shihipar y Sid Bidasaria (@sidbid) son miembros del personal técnico de Anthropic, trabajando en Claude Code.
