Workflows Complejos

Domina patrones avanzados de orquestación de múltiples agentes, ejecución paralela, y workflows complejos de producción.

Requisito: Debes entender la arquitectura de agentes antes de implementar workflows complejos.

Patrones de Orquestación

1. Sequential Chaining

Los agentes se ejecutan en secuencia, pasando información entre ellos.

graph LR
    A[Planner] --> B[Researcher]
    B --> C[Developer]
    C --> D[Tester]
    D --> E[Code Reviewer]

Uso típico:

# Planning completo con research previo
claude plan "Feature compleja"
claude cook "Implementar según plan"

Características:

• ✅ Fácil de entender y debuggear
• ✅ Cada agente puede usar output del anterior
• ❌ Más lento que paralelo
• ❌ Un agente bloquea al siguiente

2. Parallel Execution

Múltiples agentes trabajan simultáneamente en tareas independientes.

graph TD
    A[User Request] --> B[Researcher 1]
    A --> C[Researcher 2]
    A --> D[Researcher 3]
    B --> E[Planner]
    C --> E
    D --> E

Uso típico:

# Research paralelo de múltiples tecnologías
claude plan "Microservices architecture" --parallel

Características:

• ✅ Mucho más rápido
• ✅ Ideal para investigación independiente
• ❌ Más complejo de coordinar
• ❌ Requiere tareas verdaderamente independientes

3. Agent Teams

Sesiones coordinadas con múltiples agentes con roles definidos.

graph TD
    A[Team Lead] --> B[Frontend Dev]
    A --> C[Backend Dev]
    A --> D[Database Architect]
    B --> E[Integration]
    C --> E
    D --> E

Uso típico:

# Equipo completo trabajando
claude cook "Feature completa" --parallel --team

Características:

• ✅ Coordinación automática
• ✅ Especialización por rol
• ❌ Requiere más recursos
• ❌ Complejidad de comunicación

4. Hybrid Pattern

Combinación de sequential y parallel según la tarea.

graph TD
    A[Research Parallel] --> B[1: Planner]
    A --> C[2: Planner]
    B --> D[Implementation Sequential]
    C --> D
    D --> E[Test Parallel]
    E --> F[F: Tester]
    E --> G[G: Tester]

Uso típico:

# Research paralelo → Implementación secuencial → Tests paralelos
claude plan "Arquitectura sistema" --parallel
claude cook "Implementar según plan"
claude test --parallel

Workflows de Producción

Workflow 1: Feature Development Completo

1. Planning con Research Paralelo

   • Múltiples researchers investigan tecnologías
   • Planner sintetiza findings
   • Se crea plan detallado

2. Implementación Coordinada

   • Frontend y backend trabajan en paralelo
   • Database architect define schema
   • Team lead coordina integración

3. Testing Paralelo

   • Unit tests y E2E tests simultáneos
   • Performance testing en paralelo
   • Security testing independiente

4. Code Review Multi-agente

   • Security agent revisa vulnerabilidades
   • Performance agent analiza optimización
   • Style agent verifica estándares

5. Documentation Automática

   • Docs manager actualiza arquitectura
   • API docs se generan automáticamente
   • Changelog se actualiza

Implementación:

# Paso 1: Planning con research paralelo
claude plan "Sistema de notificaciones en tiempo real" --parallel

# Paso 2: Implementación con equipo
claude cook "Implementar según plan" --team

# Paso 3: Testing paralelo
claude test --parallel --coverage

# Paso 4: Code review multi-agente
claude review --security --performance --style

# Paso 5: Documentación
claude docs update

Workflow 2: Hotfix de Producción

1. Análisis de Emergencia

   • Debug agent identifica problema
   • Log analyzer encuentra raíz
   • Impact assessor evalúa severidad

2. Solución Rápida

   • Fix agent implementa solución
   • Tester valida fix localmente
   • No regression tests

3. Deployment Urgente

   • CI/CD pipeline acelerado
   • Monitoring continuo post-deploy
   • Rollback plan ready

Implementación:

# Paso 1: Análisis rápido
claude debug "Checkout timeout en producción" --urgent

# Paso 2: Fix rápido
claude cook "Fix payment timeout" --fast --no-test

# Paso 3: Deploy inmediato
git push origin main && git push --tags

Workflow 3: Refactorización Segura

1. Análisis de Código Legacy

   • Scout agent mapea arquitectura
   • Dependency analyzer encuentra acoplamientos
   • Code smell detector identifica problemas

2. Planificación de Refactor

   • Architect agent propone nueva estructura
   • Risk assessor identifica peligros
   • Migration planner define pasos

3. Refactor Incremental

   • Small steps con tests entre cada uno
   • Feature flags para rollbacks
   • A/B testing de nuevo código

4. Validación Completa

   • Regression tests completos
   • Performance comparison
   • User acceptance testing

Implementación:

# Paso 1: Análisis
claude scout "Analizar sistema de autenticación"

# Paso 2: Planificación
claude plan "Migrar de sessions a JWT"

# Paso 3: Refactor incremental
claude cook "Paso 1: Implementar JWT endpoints"
claude test "authentication"
claude cook "Paso 2: Migrar usuarios gradualmente"
claude test "authentication migration"

# Paso 4: Validación
claude test --regression --performance

Workflow 4: Code Review Multi-Agente

1. Análisis Paralelo por Especialistas

   • Security agent: OWASP Top 10
   • Performance agent: Optimizaciones
   • Style agent: Linting y formatos
   • Test agent: Cobertura de tests

2. Síntesis de Findings

   • Team lead agrupa issues por severidad
   • Prioriza fixes críticos primero
   • Crea action items

3. Reporte Consolidado

   • Issues categorizados
   • Recomendaciones específicas
   • Ejemplos de fixes

Implementación:

# Code review completo con múltiples agentes
claude review --parallel --team --security --performance --style --test

# Output:
# - security-issues.md
# - performance-issues.md
# - style-issues.md
# - test-coverage.md
# - consolidated-report.md

Workflow 5: Deployment Pipeline Inteligente

1. Pre-Deployment Checks

   • Security scan: Vulnerabilidades
   • Dependency check: Versiones
   • Config validation: Settings

2. Build y Test

   • Unit tests en paralelo
   • Integration tests
   • E2E tests

3. Deployment Staging

   • Deploy a staging
   • Smoke tests
   • Performance validation

4. Production Deployment

   • Blue-green deployment
   • Health checks
   • Monitoring activo

5. Post-Deployment

   • Log monitoring
   • Error tracking
   • Rollback plan listo

Implementación:

# Pipeline automatizado
claude deploy --staging --checks
claude test --smoke
claude deploy --production --blue-green
claude monitor --logs --errors --rollback-plan

Patrones Avanzados

Pattern 1: Fan-Out / Fan-In

graph TD
    A[Coordinator] --> B[Worker 1]
    A --> C[Worker 2]
    A --> D[Worker 3]
    B --> E[Aggregator]
    C --> E
    D --> E
    E --> F[Final Output]

Uso: Procesar datos en paralelo y combinar resultados

# Ejemplo: Análisis de múltiples repositorios
claude cook "Analizar 10 repos en paralelo y generar reporte consolidado"

Pattern 2: Map-Reduce

graph TD
    A[Input Data] --> B[Map Phase]
    B --> C[Worker 1]
    B --> D[Worker 2]
    B --> E[Worker 3]
    C --> F[Reduce Phase]
    D --> F
    E --> F
    F --> G[Output]

Uso: Procesar grandes volúmenes de datos

# Ejemplo: Analizar logs de múltiples servidores
claude cook "Map-reduce analysis de server logs"

Pattern 3: Pipeline Parallel

graph TD
    A[Stage 1] --> B[Stage 2]
    A --> C[Stage 2 Alt]
    B --> D[Stage 3]
    C --> D

Uso: Múltiples caminos de ejecución

# Ejemplo: CI/CD con múltiples estrategias de test
claude test --parallel-strategies

Pattern 4: Orchestrator-Worker

graph TD
    A[Orchestrator] --> B[Worker Pool]
    B --> C[Worker 1]
    B --> D[Worker 2]
    B --> E[Worker 3]
    C --> B
    D --> B
    E --> B
    B --> F[Results]

Uso: Balanceo de carga entre workers

# Ejemplo: Batch processing con workers
claude cook "Procesar 100 archivos con pool de workers"

Configuración de Workflows

Configuración en .claude/workflows/

.claude/workflows/feature-development.yml

name: "Feature Development Workflow"
description: "Workflow completo para desarrollo de features"

stages:
  - name: "Planning"
    parallel: true
    agents:
      - name: "researcher-tech"
        role: "Investigar tecnologías principales"
      - name: "researcher-alternatives"
        role: "Investigar alternativas"
      - name: "researcher-risks"
        role: "Identificar riesgos"
    output: "research-report.md"

  - name: "Implementation"
    parallel: false
    agents:
      - name: "developer-frontend"
        role: "Implementar frontend"
      - name: "developer-backend"
        role: "Implementar backend"
      - name: "database-architect"
        role: "Definir schema"
    output: "implementation-report.md"

  - name: "Testing"
    parallel: true
    agents:
      - name: "tester-unit"
        role: "Unit tests"
      - name: "tester-e2e"
        role: "E2E tests"
      - name: "tester-performance"
        role: "Performance tests"
    output: "test-report.md"

  - name: "Review"
    parallel: true
    agents:
      - name: "reviewer-security"
        role: "Security review"
      - name: "reviewer-performance"
        role: "Performance review"
      - name: "reviewer-style"
        role: "Code style review"
    output: "review-report.md"

Uso del Workflow

# Ejecutar workflow completo
claude workflow feature-development "Nueva feature de autenticación"

# Ejecutar stage específico
claude workflow feature-development --stage "Testing"

# Ejecutar con agents específicos
claude workflow feature-development --agents "researcher-tech,researcher-alternatives"

Error Handling en Workflows

Estrategias de Manejo de Errores

1. Retry con Backoff

retry:
  maxAttempts: 3
  backoff: "exponential"
  initialDelay: 1000

2. Fallback Agents

agents:
  - name: "primary-agent"
    fallback: "secondary-agent"

3. Circuit Breaker

circuitBreaker:
  failureThreshold: 5
  timeout: 60000
  halfOpenAttempts: 1

4. Dead Letter Queue

deadLetter:
  queue: "failed-tasks"
  retry: true
  maxRetries: 3

Optimización de Workflows

1. Reducir Latencia

# Usar parallel cuando sea posible
claude plan "Feature" --parallel

# Cache de resultados
claude plan "Feature" --cache

# Reuse context
claude cook "Feature" --context-from-plan

2. Mejorar Throughput

# Aumentar paralelismo
claude test --parallel --workers=8

# Batch processing
claude cook "Process 100 files" --batch-size=10

3. Optimizar Uso de Tokens

# Context limit por agente
claude cook "Feature" --context-limit=50000

# Compress output
claude cook "Feature" --compress-output

# Streaming responses
claude cook "Feature" --stream

Monitoreo de Workflows

Métricas Clave

metrics:
  - name: "workflow_duration"
    type: "timer"
    description: "Duración del workflow"
  - name: "agent_duration"
    type: "timer"
    description: "Duración por agente"
  - name: "token_usage"
    type: "gauge"
    description: "Tokens usados"
  - name: "error_rate"
    type: "counter"
    description: "Tasa de errores"

Dashboard de Monitoreo

# Ver métricas en tiempo real
claude metrics --workflow feature-development

# Exportar métricas
claude metrics --export prometheus

Siguientes Pasos

Ahora que dominas workflows complejos:

1. Practicar - Implementa workflows reales en tus proyectos
2. Experimentar - Prueba diferentes patrones de orquestación
3. Optimizar - Mide y mejora performance de tus workflows
4. Documentar - Crea plantillas de workflows para tu equipo

Recursos Adicionales

• Ejemplos de Workflows - Proyectos completos con workflows
• Referencia de Comandos - Todos los comandos disponibles
• Agentes Disponibles - Catálogo de agentes

---

¿Listo para la producción? Practica estos patrones con proyectos reales antes de usarlos en producción críticas.

¿Preguntas? Usa claude ask "tu pregunta sobre workflows" en cualquier momento.