Constructor de Workflows Multiagente

Pipeline 3-Stage
Shopify Product Optimizer

Workflow Claude Code generado para automatizar la optimización de 47 fichas de producto de café de especialidad: auditoría SEO/CRO, reescritura de copy y validación de calidad.

Premium · 5€ Avanzado Automatizacion Claude Code
Terroir Specialty Coffee
Tienda Shopify D2C · Café de especialidad · 47 referencias activas
Conv. rate actual 1.8%
Media del sector 3.2%
Productos a procesar 47
Output por producto JSON ✓
1 — Motor de Recomendacion de Topologia
Tarea descrita por el cliente
"Auditar SEO y CRO de cada ficha de producto Shopify, reescribir el copy con storytelling de origen y notas de cata, validar calidad con checklist y marcar como lista para publicar. Lista conocida de 47 productos. Output estructurado JSON para importar vía API."
Topologia recomendada
⟶ pipeline
Etapas ordenadas donde cada ítem avanza en cuanto está listo, sin barrera. Más rápido que parallel-per-stage para colas conocidas.
Runner-up
barrier
Útil si una fase posterior necesita todos los resultados anteriores a la vez. No aplica aquí: cada producto es independiente.
Output estructurado
Sí — schema JSON
El cliente necesita datos estructurados por producto para importar vía Shopify API.
Budget guard
Opcional
Topología fija con 47 ítems — no hay riesgo de bucle descontrolado. Sin límite estricto de tokens.
2 — Arquitectura del Workflow
Input
47 productos
args.products · CSV import
Stage 1
Audit SEO/CRO
haiku
schema: AUDIT_SCHEMA
alta velocidad · bajo coste
Stage 2
Rewrite Copy
sonnet
storytelling · SEO · bullets
contexto = audit anterior
Stage 3
QA Validation
sonnet
schema: QA_SCHEMA
checklist 10 criterios
Output
JSON por producto
filter(Boolean)
listo para Shopify API

Cada ítem fluye de forma independiente a través de las 3 etapas (pipeline). No hay barrier: un producto no bloquea a otro.

3 — Plan de Modelos y Topologias Evaluadas
🧠
Plan de Modelos
Asignación óptima coste/calidad por etapa
haiku
Stage 1 · Audit SEO/CRO
Clasificación de primer paso — barato y alto volumen. 47 auditorías en paralelo.
sonnet
Stage 2 · Rewrite Copy
Creación de texto de calidad — requiere juicio, creatividad y conocimiento de marca.
sonnet
Stage 3 · QA Validation
Evaluación estructurada con schema — requiere razonamiento y output fiable.
Topologias Disponibles
La recomendada en verde
pipeline
Cada ítem avanza solo por etapas ordenadas.
Seleccionada ✓
barrier
Espera todos antes de pasar a siguiente fase.
Runner-up
fan-out
Divide en subtareas paralelas independientes.
No aplica
loop
Itera hasta condición con budget guard.
No aplica
4 — Workflow Generado y Validado
.claude/workflows/terroir-product-optimizer.js
PASS — 0 issues
// Pipeline multiagente — 3 etapas — 47 productos Shopify

export const meta = {
  name: 'terroir-product-optimizer',
  description: 'Audita, reescribe y valida fichas de producto Shopify
               para Terroir Specialty Coffee — SEO y CRO',
  phases: [
    { title: 'Audit SEO/CRO' },
    { title: 'Rewrite Copy' },
    { title: 'QA Validation' }
  ]
}

// Schemas de output estructurado
const AUDIT_SCHEMA = {
  type: 'object', required: ['product_id', 'seo_score_before', 'seo_issues', 'cro_issues'],
  properties: {
    product_id:       { type: 'string' },
    seo_score_before: { type: 'number', minimum: 0, maximum: 100 },
    seo_issues:       { type: 'array', items: { type: 'string' } },
    cro_issues:       { type: 'array', items: { type: 'string' } }
  }
}

const QA_SCHEMA = {
  type: 'object', required: ['product_id', 'quality_score', 'passed', 'flags'],
  properties: {
    product_id:    { type: 'string' },
    quality_score: { type: 'number', minimum: 0, maximum: 100 },
    passed:        { type: 'boolean' },
    flags:         { type: 'array', items: { type: 'string' } }
  }
}

// Lista de productos (en producción: args?.products desde CSV)
const PRODUCTS = args?.products ?? [
  { id: 'gid://shopify/Product/7301', title: 'Ethiopia Yirgacheffe', ... },
  { id: 'gid://shopify/Product/7302', title: 'Colombia Huila Washed', ... },
  // ... 44 más
]

// Pipeline: 3 etapas, cada producto fluye de forma independiente
const results = await pipeline(
  PRODUCTS,

  // Stage 1 — Audit SEO/CRO (haiku — barato, 47 auditorías en paralelo)
  (product, _orig, i) => agent(
    `Audita la ficha: "${product.title}" contra checklist SEO y CRO...`,
    { label: `audit:${product.id}`, phase: 'Audit SEO/CRO',
      model: 'haiku', schema: AUDIT_SCHEMA }
  ),

  // Stage 2 — Rewrite copy (sonnet — creatividad y storytelling de origen)
  (audit) => agent(
    `Reescribe el copy usando los datos de origen y los problemas detectados...`,
    { label: `rewrite:${audit?.product_id}`, phase: 'Rewrite Copy',
      model: 'sonnet' }
  ),

  // Stage 3 — QA validation (sonnet — checklist 10 criterios, schema)
  (rewrite) => agent(
    `Valida el copy generado contra 10 criterios de calidad...`,
    { label: `qa:${parsed?.product_id}`, phase: 'QA Validation',
      model: 'sonnet', schema: QA_SCHEMA }
  )
)

log(`Procesados: ${results.filter(Boolean).length}/47 productos`)
return results.filter(Boolean)
5 — Resultado del Validador
validate_workflow.py — PASS
terroir-product-optimizer.js · 0 issues encontrados
  • meta es literal puro y primer statement — sin template strings, spreads ni function calls
  • Sin no-determinismo — no hay Date.now(), Math.random() ni new Date()
  • Sin APIs de Node — no hay require(), fs.*, process.* ni fetch() en el orquestador
  • parallel() recibe thunks — no promesas directas
  • Sin bucles desprotegidos — no hay while(true) sin guard
  • filter(Boolean) presente — agentes fallidos/saltados filtrados
  • Hay llamadas agent() en el workflow
📋
Reglas Criticas Aplicadas
El validador las comprueba automáticamente
meta literal puro — primer statement, sin variables ni llamadas
Sin no-determinismo — timestamps via args para garantizar reanudabilidad
Sin Node APIs — todo el I/O delega en agent() prompts
Thunks en parallel() — () => agent(...) no bare promises
Guard en loops — counter o budget.remaining() si hay while
6 — Ejemplo de Output por Producto

Resultado simulado del workflow para el producto Ethiopia Yirgacheffe — antes (ficha original) vs. después (copy generado por el workflow).

Antes — Ficha original
Titulo Shopify
Ethiopia Yirgacheffe
Descripcion
"Café de Etiopía. Tostado medio. 250g. Muy bueno."
SEO Score
28 / 100
Problemas detectados (Stage 1)
  • Título sin keyword de intención de compra
  • Sin meta description
  • Descripción < 10 palabras
  • Sin notas de cata ni storytelling
  • Sin bullets de beneficios
Despues — Workflow output
new_title (62 chars)
"Café Ethiopia Yirgacheffe Natural | Arándanos y Jazmín | Terroir"
new_meta_description (148 chars)
"Descubre el Ethiopia Yirgacheffe natural de la finca Kochere, a 1.950 m. Notas de arándano, jazmín y chocolate blanco en cada taza. Envío en 24h."
new_bullets (Stage 2 · sonnet)
  • Seleccionado en microlotes de la finca Kochere, Sidama, Etiopía
  • Procesado natural sun-dried para máxima expresión frutal
  • Tueste medio-claro que preserva florales y acidez brillante
  • Ideal para V60, Chemex y aeropress — extrae todo el potencial
  • Trazabilidad completa desde finca hasta tu taza
QA Score (Stage 3 · sonnet)
88
PASSED · listo para Shopify API
7 — QA Dashboard — Muestra de 3 Productos
Puntuaciones de calidad del Stage 3 para los 3 productos de ejemplo. Un score ≥ 70 pasa automáticamente a la cola de publicación.
Ethiopia Yirgacheffe
88
PASS
Colombia Huila Washed
82
PASS
Kenya AA Nyeri
91
PASS
Promedio QA: 87 / 100
Passed: 3 / 3
Listos para publicar: 100%
Estimado 47 productos: ~92% pass rate
8 — Como Ejecutar el Workflow
1
Activar feature
Variable de entorno
export CLAUDE_CODE_WORKFLOWS=1
2
Guardar el archivo
Ruta del proyecto
.claude/workflows/
terroir-product-optimizer.js
3
Lanzar
Claude Code CLI
/workflows
# P = pause/resume
# X = skip agente