El workflow: una cadena de montaje

Qué es y por qué importa

Cuando le pido a Claude una función nueva en un solo mensaje, lo hace todo él, de corrido: busca, decide, escribe y al final me dice «hecho». Para las cosas pequeñas está bien. En una función de verdad, en cambio, los pasos se mezclan. Busca a medias, planifica mientras escribe, y el control lo hace quien acaba de escribir el código.

Un workflow pone orden. Es un script que Claude escribe para tu tarea y que Claude Code ejecuta en segundo plano: lanza varios subagentes, cada uno con su trabajo, y pasa los resultados de uno a otro. El plan ya no está en la cabeza de Claude, está en el script. Y tú, mientras tanto, puedes seguir usando la sesión.

Yo lo uso como una cadena de montaje. Cinco puestos, un agente por puesto, una sola tarea cada uno. Cada agente recibe la pieza del paso anterior y, antes de trabajar en ella, comprueba que esté bien hecha. Si no lo está, la cadena se para.

Por qué importa: quien intenta romper el código no es quien lo ha escrito, así que busca justo los agujeros que el autor no ve. Y si la lista de archivos o el plan están mal, te das cuenta enseguida, antes de que nadie construya encima.

1. La primera vez: pide un workflow

El script no lo escribes tú. Basta con pedirlo con tus palabras, por ejemplo «usa un workflow»: Claude escribe el script y lo pone en marcha. También funciona la palabra ultracode en el prompt, pero no hace falta: una petición directa vale igual.

Este es el prompt que pego en Claude Code. En lugar de los corchetes pon la función que quieres, descrita como se la contarías a una persona.

Usa un workflow de cinco pasos para: [describe la función]. Cada paso es un agente distinto, con una sola tarea, y recibe el resultado del paso anterior.
1. BUSCA: encuentra en el código los archivos y las funciones que tienen que ver, con el porqué.
2. PLAN: comprueba que la lista sea correcta y completa, luego escribe un plan por puntos: qué cambia, en qué orden, cómo se comprueba.
3. CONSTRUYE: comprueba que el plan se sostenga, luego síguelo y ejecuta los tests.
4. ROMPE: intenta romper lo que se ha construido (datos vacíos, usuario sin iniciar sesión, doble clic, móvil). Si encuentras un error, devuélvelo al paso 3 con la descripción y vuelve a intentarlo, como mucho dos veces.
5. RESUMEN: comprueba que los tests pasen, luego escribe qué ha cambiado, qué se ha probado y qué queda por hacer.
Si un paso encuentra un problema en el paso anterior, se para y lo dice: nada sigue adelante hasta que esté arreglado.
Llama al workflow "cadena" y lee de args la función que hay que construir.

Qué hace cada puesto:

• BUSCA no toca nada. Solo trae la lista de archivos, con el motivo de cada uno.
• PLAN primero comprueba la lista y luego escribe qué cambia, en qué orden y cómo se comprueba.
• CONSTRUYE comprueba que el plan se sostenga, lo sigue y ejecuta los tests.
• ROMPE es el puesto que marca la diferencia. Prueba los casos que sueles olvidar: datos vacíos, usuario sin iniciar sesión, doble clic, móvil. Si encuentra un error lo devuelve a CONSTRUYE, como mucho dos veces, para que la vuelta no siga hasta el infinito.
• RESUMEN comprueba que los tests pasen y te dice qué ha cambiado, qué se ha probado y qué queda por hacer.

La línea «Si un paso encuentra un problema…» es la que lo mantiene todo unido. Sin ella, una lista equivocada en el primer paso se convierte en un plan equivocado, y luego en código equivocado que pasa los tests.

La última línea, en cambio, sirve para después, cuando la guardes. El nombre del comando sale del script, así que le pides ya que lo llame cadena. Y la función la lee de args, es decir, de la entrada que le pasas al lanzarlo: así la misma cadena trabaja cada vez en una función distinta, en lugar de repetir la de la primera vez.

Antes de arrancar, normalmente Claude Code te pide permiso y te enseña las fases previstas. Desde ahí también puedes abrir el script y leerlo antes de decir que sí.

2. Síguela mientras trabaja

La cadena funciona en segundo plano, así que puedes seguir escribiendo en la sesión. Para ver por dónde va:

/workflows

• Ves las fases una debajo de otra, cada una con sus agentes.
• Con las flechas eliges una fase, con Intro entras y ves qué ha hecho cada agente: la tarea que ha recibido, las herramientas que ha usado, el resultado. Con Esc vuelves atrás.
• p pone en pausa y reanuda la vuelta, x detiene el agente seleccionado, o toda la vuelta si tienes seleccionada la vuelta.

3. Guárdala una vez

Cuando una vuelta te ha gustado, no tienes que volver a pegar el prompt cada vez. La guardas como comando:

1. Escribe /workflows y selecciona la vuelta que quieres conservar.
2. Pulsa s: se abre la ventana para guardarla.
3. Con Tab eliges dónde: .claude/workflows/ en el proyecto, o ~/.claude/workflows/ en tu carpeta personal.
4. Pulsa Intro.

En .claude/workflows/ la cadena vale para ese proyecto, y si haces commit también la tiene quien clone el repositorio. En ~/.claude/workflows/ la tienes en todos tus proyectos, y solo la ves tú.

Lo que guardas es el script de la vuelta, no el prompt. Así que cada vez la cadena hace los mismos pasos, en el mismo orden, con los mismos controles. Y el comando toma el nombre escrito en el script: por eso en el prompt le pediste que lo llamara cadena.

4. Lánzala cuando quieras

Desde la sesión siguiente basta con una línea, con la función nueva:

Ejecuta /cadena para: añade el inicio de sesión con Google

Lo que escribes después de «para:» llega al script en args, y la cadena trabaja en esa función. El trabajo lo sigues siempre desde /workflows, fase por fase.

5. Antes de usarla en serio

Consume más tokens

Un workflow lanza varios agentes, así que una vuelta consume más tokens que una petición normal, y cuenta en los límites de tu plan. Pruébalo primero con algo pequeño. En /workflows ves cuántos tokens consume cada agente mientras trabaja, y puedes detener la vuelta cuando quieras.

Si /workflows no aparece

Los workflows están en todos los planes de pago, pero en el plan Pro hay que activarlos: abre /config y busca la fila Dynamic workflows. Si ahí están desactivados, no funcionan ni /workflows ni los comandos guardados.

La misma cadena, sin workflow

Como alternativa, pon el mismo texto en .claude/skills/cadena/SKILL.md. Se convierte en una skill, y la lanzas con /cadena. Tres retoques: en lugar de [describe la función] escribe $ARGUMENTS, así Claude Code pone ahí lo que escribes después del comando; la primera frase conviértela en «Sigue estos cinco pasos para:»; la última línea, la de cadena y args, quítala. Luego pide a Claude que use un subagente distinto para cada paso. Y usa un camino o el otro, no los dos con el mismo nombre: así siempre sabes qué /cadena estás lanzando.

Ejecuta /cadena para: añade el inicio de sesión con Google. Usa un subagente distinto para cada paso.

Los pasos son los mismos. Cambia quién lleva el hilo: con la skill es Claude quien pasa el trabajo de un ayudante a otro, y los resultados pasan por tu conversación. Con el workflow lo hace el script, y a ti solo te llega el resumen final.

Errores comunes

• Usar la cadena para un texto o un color. Cinco agentes para una línea son solo espera y tokens: para las cosas pequeñas basta con un mensaje normal.
• Quitar la línea «Si un paso encuentra un problema…». Sin control entre un paso y otro, un error del principio llega hasta el final: déjala siempre.
• Quitar la línea de cadena y args. Sin ella, el comando toma otro nombre y puede repetir siempre la función de la primera vez: déjala en el prompt.
• Empezar directamente con una función grande. La primera vez pruébala con algo pequeño y mira en /workflows cuántos tokens consume.
• Fiarse del resumen sin mirar. Lee lo que queda por hacer y prueba tú la función, al menos una vez desde el móvil.

Lista de comprobación

• El prompt tiene los cinco pasos y la línea de control
• La función está descrita en lugar de los corchetes
• El workflow se llama cadena y lee la función de args
• Primera prueba con algo pequeño
• Sigo la vuelta desde /workflows
• Guardada con s, en el proyecto o en ~/.claude/workflows/
• He leído el resumen y he probado yo la función

Preguntas frecuentes