Orquestación de Tareas

Más Allá de las Preguntas Sueltas

🔄 Repaso rápido: En la lección anterior, aprendimos a manejar el contexto estratégicamente — dándole a Claude exactamente la información que necesita. Ahora usaremos ese contexto bien organizado para dirigir flujos de trabajo completos.

La mayoría de usuarios de Claude Code hacen preguntas sueltas. Está bien para ayuda rápida. Pero para desarrollo serio, quieres orquestar flujos de trabajo completos.

Esto significa dirigir a Claude a través de tareas de múltiples pasos — descomponiendo trabajo complejo, secuenciándolo lógicamente e iterando hasta que esté bien.

La Mentalidad de Orquestación

Piénsate como un tech lead dirigiendo a un desarrollador capaz.

Mal tech lead: “Construye la feature.” Buen tech lead: “Vamos a descomponer esto. Primero, plantea el enfoque. Luego implementamos la capa de datos. Luego la API. Luego tests.”

Lo mismo con Claude. Pedidos vagos y grandes producen outputs vagos y grandes. Dirección estructurada produce resultados de calidad.

Descomposición de Tareas

Cualquier tarea compleja se puede dividir en piezas:

Tarea original: “Agrega autenticación de usuarios a la app”

Descompuesta:

1. Diseñar el flujo de auth (qué sucede dónde)
2. Crear el modelo de usuario y schema de base de datos
3. Implementar endpoints de login/logout
4. Agregar hashing de passwords
5. Crear manejo de sesiones
6. Agregar middleware de rutas protegidas
7. Escribir tests

Cada pieza es concreta. Cada pieza tiene un estado claro de “terminado”.

El Loop de Orquestación

┌─────────────────────────────────────┐
│  1. Definir la tarea claramente     │
│     ¿Cuál es la meta? ¿Qué es      │
│     "terminado"?                    │
└───────────────┬─────────────────────┘
                │
                ▼
┌─────────────────────────────────────┐
│  2. Proveer contexto                │
│     Agregar archivos e info         │
│     relevante                       │
└───────────────┬─────────────────────┘
                │
                ▼
┌─────────────────────────────────────┐
│  3. Solicitar el trabajo            │
│     Pedido específico y accionable  │
└───────────────┬─────────────────────┘
                │
                ▼
┌─────────────────────────────────────┐
│  4. Revisar el output               │
│     ¿Cumple con la meta?           │
└───────────────┬─────────────────────┘
                │
        ┌───────┴───────┐
        │               │
        ▼               ▼
┌───────────────┐ ┌───────────────────┐
│   ¿Bien?      │ │   ¿Necesita       │
│   → Siguiente │ │   trabajo?        │
│   tarea       │ │   → Da feedback   │
│               │ │   → Itera         │
└───────────────┘ └───────────────────┘

Patrones Prácticos de Orquestación

Patrón: Planear Antes de Construir

No saltes directo a implementar.

> Necesito agregar una capa de caching a las respuestas de la API.
> Primero, plantea el enfoque. Considera:
> - Qué se debería cachear
> - Estrategia de invalidación de caché
> - Redis vs en memoria
> No escribas código todavía — solo el plan.

Revisa el plan. Discute alternativas. Luego:

> Buen plan. Implementemos la opción 2 con Redis.
> Empieza con las funciones utilitarias de caché.

Patrón: Implementación Incremental

Construye en capas, verificando cada una.

# Paso 1
> Crea los modelos de datos para el carrito de compras.
> Solo los modelos, sin API todavía.

# Revisas, luego...

# Paso 2
> Ahora agrega el servicio de carrito con operaciones de agregar,
> eliminar y vaciar.
> Usa los modelos que acabamos de crear.

# Revisas, luego...

# Paso 3
> Ahora crea los endpoints de API que usen el servicio de carrito.

# Revisas, luego...

# Paso 4
> Agrega tests para el servicio de carrito.

Cada paso construye sobre el anterior. Atrapas problemas temprano.

✅ Revisión Rápida: ¿Por qué es mejor implementar en capas incrementales en vez de pedir toda la feature de una vez?

Patrón: Refinar a Través de Iteración

El primer output de Claude rara vez es perfecto. Y eso está bien.

> Crea una función para parsear archivos CSV con estas columnas:
> nombre, email, fecha_creacion

# El output está cerca pero no perfecto

> Buen inicio, pero:
> - Maneja celdas vacías devolviendo null en vez de string vacío
> - Agrega validación de que el formato de email sea correcto
> - El parseo de fechas debería manejar tanto formato ISO como DD/MM/YYYY

Feedback específico es más rápido que re-explicar toda la tarea.

Patrón: Planificación Panorámica

Para features grandes, planea el alcance completo primero.

> Necesitamos construir un sistema de notificaciones. Antes de codear, describe:
> 1. Qué componentes se necesitan
> 2. Cómo interactúan
> 3. En qué orden construirlos
> 4. Qué servicios externos están involucrados

Ten la foto completa. Luego ejecuta las piezas sistemáticamente.

Continuidad de Conversación

Claude recuerda tu sesión. Aprovéchalo.

Bien:

> Ahora agrega manejo de errores a la función que acabamos de crear.

Claude sabe cuál función.

Innecesario:

> Ahora agrega manejo de errores a la función parseCSV
> que recibe un file path y devuelve un array de objetos
> con nombre, email y fecha_creacion que creamos antes.

No re-expliques lo que ya está en contexto.

Cuando las Tareas Salen Mal

Claude se desvía

> Para. Eso no es lo que pedí.
> Necesito X, no Y.
> Específicamente: [replanteamiento claro]

Sé directo. Redirige con claridad.

Claude se atora

> Demos un paso atrás. ¿Qué es confuso de esta tarea?
> ¿Qué información ayudaría?

A veces Claude necesita orientación sobre lo que le falta.

El output es parcialmente correcto

> La primera parte está bien. Quédate con eso.
> Cambia solo la lógica de validación: [fix específico]

No tires a la basura trabajo bueno. Señala exactamente qué necesita cambio.

Calibración de Complejidad

Ajusta tu esfuerzo de orquestación a la complejidad de la tarea.

Ejercicio: Orquesta una Feature

Practica orquestando esta tarea:

Meta: Agregar una feature de “artículos vistos recientemente” a un sitio de e-commerce.

Descompónla:

1. ¿Cuál es el modelo de datos?
2. ¿Dónde se guarda la data (cookie, localStorage, base de datos)?
3. ¿Qué endpoints de API se necesitan?
4. ¿Qué componentes de UI?
5. ¿Cuál es el orden de implementación?

Escribe la secuencia de prompts de Claude Code que usarías.

Conclusiones Clave

• Divide tareas complejas en pasos claros y verificables
• Planea antes de implementar para cualquier cosa no trivial
• Itera con feedback específico en vez de reiniciar
• Usa la continuidad de conversación — Claude recuerda el contexto
• Ajusta el esfuerzo de orquestación a la complejidad de la tarea

Lo que sigue: operaciones de archivos. Cómo trabajar con archivos de forma segura y eficiente.

Siguiente: En la próxima lección, nos sumergiremos en las Operaciones de Archivos.