create-bk-agent 0.21.2 → 0.22.1

package/README.md

@@ -1,5 +1,7 @@
 # create-bk-agent
 
+> **Status: `stable`** — Maintained and production-ready. No new features during the pilot phase.
+
 CLI scaffolding tool for the BackendKit Labs agent framework. Generates a fully configured TypeScript agent project in seconds — choose your architecture, deployment mode, and LLM provider, and get a working project with all dependencies wired.
 
 ## Usage

package/dist/src/index.js

@@ -58,6 +58,7 @@ function describeChoices(choices) {
         autonomous: 'Autonomous daemon',
         minimal: 'Minimal / embedded',
         enterprise: 'Enterprise (local LLM + RAG)',
+        orchestrator: 'Orchestrator',
     };
     const deploy = {
         repl: 'Terminal REPL',
@@ -68,6 +69,10 @@ function describeChoices(choices) {
         web: 'Web Server (chat + kanban)',
     };
     const archLabel = arch[choices.architecture] ?? choices.architecture;
+    if (choices.architecture === 'orchestrator') {
+        const tmpl = choices.workflowTemplate ?? 'blank';
+        return `${archLabel} — ${tmpl} template`;
+    }
     if (!choices.deployMode)
         return archLabel;
     return `${archLabel} — ${deploy[choices.deployMode] ?? choices.deployMode}`;
@@ -82,6 +87,23 @@ function buildNextSteps(choices) {
         return ['Configure triggers in src/index.ts', 'npm run dev'];
     if (arch === 'minimal')
         return ['Implement your LLM provider in src/index.ts', 'npm run dev'];
+    // Orchestrator
+    if (arch === 'orchestrator') {
+        const tmpl = choices.workflowTemplate ?? 'blank';
+        const testCmd = tmpl === 'ventas'
+            ? 'node test-flow.mjs calificacion-lead   # or propuesta-comercial'
+            : tmpl === 'marketing'
+                ? 'node test-flow.mjs articulo-blog       # or campana-leads'
+                : tmpl === 'soporte'
+                    ? 'node test-flow.mjs atencion-ticket     # or incidente-critico'
+                    : '# Define your flows in flows/ and run: node test-flow.mjs';
+        return [
+            'Add your API key to .env',
+            'Edit orchestrator.yaml to customize agents for your domain',
+            tmpl !== 'blank' ? 'Review and adapt vault/ knowledge files to your company' : 'Define your agents and flows in orchestrator.yaml',
+            testCmd,
+        ];
+    }
     // Enterprise — local LLM + RAG
     if (arch === 'enterprise') {
         if (mode === 'web') {
@@ -149,11 +171,14 @@ async function main(argv) {
     console.log('Installing dependencies...\n');
     (0, scaffold_1.installDeps)(targetDir);
     const steps = buildNextSteps(choices);
+    const envLine = choices.architecture === 'orchestrator'
+        ? '   # .env created — add your API key'
+        : '   cp .env.example .env      # add your API key';
     console.log(`
 ✅  Done! Your agent is ready.
 
    cd ${choices.projectName}
-   cp .env.example .env      # add your API key
+${envLine}
 ${steps.map(s => `   ${s}`).join('\n')}
 
 Documentation: https://github.com/BackendKit-labs/backendkit-agent-framework

package/dist/src/prompts.js

@@ -38,6 +38,11 @@ const ARCHITECTURE_CHOICES = [
         value: 'enterprise',
         description: 'Business agent with RAG over your company docs, runs 100% on-premise',
     },
+    {
+        title: p('Orchestrator', 22) + 'Multi-step workflows with specialist agents and approval gates',
+        value: 'orchestrator',
+        description: 'Static flows triggered by task patterns + dynamic LLM planning as fallback',
+    },
 ];
 const SKILL_PACK_CHOICES = [
     { title: p('Node.js / TypeScript', 24) + 'npm, jest, tsc, eslint', value: 'node' },
@@ -83,6 +88,29 @@ const PROVIDER_CHOICES = [
     { title: p('DeepSeek / OpenAI-compatible', 32) + 'deepseek-chat or any OpenAI-compatible endpoint', value: 'deepseek' },
     { title: p('Ollama (local)', 32) + 'llama3.2, codellama — no API key needed', value: 'ollama' },
 ];
+// ── Workflow template choices (orchestrator only) ─────────────────────────────
+const WORKFLOW_TEMPLATE_CHOICES = [
+    {
+        title: p('Ventas B2B', 22) + 'Lead qualification (BANT) + commercial proposal with approval gates',
+        value: 'ventas',
+        description: '6 agents: lead, proposal, pricing, legal, CRM, writer',
+    },
+    {
+        title: p('Marketing', 22) + 'Blog articles + lead gen campaigns with parallel steps',
+        value: 'marketing',
+        description: '6 agents: content strategist, copywriter, SEO, social, campaign, analytics',
+    },
+    {
+        title: p('Soporte al cliente', 22) + 'Ticket triage, L1/L2/L3 escalation and critical incident management',
+        value: 'soporte',
+        description: '6 agents: triage, support L1, technical L2, escalation L3, communication, knowledge',
+    },
+    {
+        title: p('Blank', 22) + 'Empty orchestrator.yaml — define your own agents and flows',
+        value: 'blank',
+        description: 'Start from scratch with a minimal config stub',
+    },
+];
 // ── Conditional question helpers ──────────────────────────────────────────────
 const NEEDS_SKILLS = ['multi-agent', 'single'];
 const NEEDS_DEPLOY = ['multi-agent', 'single', 'coding', 'enterprise'];
@@ -93,6 +121,8 @@ const whenSkills = (_prev, v) => NEEDS_SKILLS.includes(v.architecture) ? 'multis
 const whenDeploy = (_prev, v) => NEEDS_DEPLOY.includes(v.architecture) ? 'select' : null;
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 const whenVault = (_prev, v) => v.architecture === 'enterprise' ? 'text' : null;
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+const whenWorkflowTemplate = (_prev, v) => v.architecture === 'orchestrator' ? 'select' : null;
 // ── Main question flow ────────────────────────────────────────────────────────
 async function askQuestions(defaultName) {
     const raw = await (0, prompts_1.default)([
@@ -135,6 +165,14 @@ async function askQuestions(defaultName) {
             initial: '',
             validate: (v) => v.trim().length > 0 || 'Vault path is required for enterprise agents',
         },
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        {
+            type: whenWorkflowTemplate,
+            name: 'workflowTemplate',
+            message: 'Workflow template:',
+            choices: WORKFLOW_TEMPLATE_CHOICES,
+            initial: 0,
+        },
         {
             type: 'select',
             name: 'provider',
@@ -152,5 +190,6 @@ async function askQuestions(defaultName) {
         deployMode: (raw.deployMode ?? undefined),
         provider: raw.provider,
         vaultPath: (raw.vaultPath ?? undefined),
+        workflowTemplate: (raw.workflowTemplate ?? undefined),
     };
 }

package/dist/src/scaffold.js

@@ -160,11 +160,68 @@ function injectSkillPack(targetDir, pack) {
     ].join('\n');
     fs.appendFileSync(engineFile, block + '\n');
 }
+const ORCHESTRATOR_PROVIDERS = {
+    deepseek: { id: 'deepseek', keyVar: 'DEEPSEEK_API_KEY', model: 'deepseek-chat', baseUrl: 'https://api.deepseek.com/v1' },
+    anthropic: { id: 'anthropic', keyVar: 'ANTHROPIC_API_KEY', model: 'claude-sonnet-4-6' },
+    openai: { id: 'openai', keyVar: 'OPENAI_API_KEY', model: 'gpt-4o', baseUrl: 'https://api.openai.com/v1' },
+    ollama: { id: 'ollama', keyVar: '', model: 'llama3.2', baseUrl: 'http://localhost:11434' },
+};
+function buildProvidersBlock(provider) {
+    const p = ORCHESTRATOR_PROVIDERS[provider];
+    const lines = ['providers:', `  ${p.id}:`];
+    if (p.keyVar)
+        lines.push(`    api_key: \${${p.keyVar}}`);
+    if (p.baseUrl)
+        lines.push(`    base_url: ${p.baseUrl}`);
+    lines.push(`    model: ${p.model}`);
+    return lines.join('\n');
+}
+function scaffoldOrchestrator(choices, targetDir) {
+    const orchDir = path.join(BASE_DIR, 'orchestrator');
+    const commonDir = path.join(orchDir, '_common');
+    const template = (choices.workflowTemplate ?? 'blank');
+    const tmplDir = path.join(orchDir, template);
+    // 1. Common files: package.json, .gitignore, .env.example
+    copyDir(commonDir, targetDir);
+    // 2. Template files: orchestrator.yaml, flows/, vault/, test-flow.mjs
+    copyDir(tmplDir, targetDir);
+    // 3. Patch orchestrator.yaml — replace __PROVIDER_ID__ and __PROVIDERS_BLOCK__
+    const orchYaml = path.join(targetDir, 'orchestrator.yaml');
+    if (fs.existsSync(orchYaml)) {
+        let content = fs.readFileSync(orchYaml, 'utf-8');
+        const providerId = ORCHESTRATOR_PROVIDERS[choices.provider].id;
+        const providersBlock = buildProvidersBlock(choices.provider);
+        content = content.replace(/__PROVIDER_ID__/g, providerId);
+        content = content.replace('__PROVIDERS_BLOCK__', providersBlock);
+        fs.writeFileSync(orchYaml, content);
+    }
+    // 4. Patch package.json name
+    const pkgPath = path.join(targetDir, 'package.json');
+    if (fs.existsSync(pkgPath)) {
+        const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
+        pkg.name = choices.projectName;
+        fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + '\n');
+    }
+    // 5. Write .env from .env.example (inject active provider key)
+    const envExample = path.join(targetDir, '.env.example');
+    const envFile = path.join(targetDir, '.env');
+    if (fs.existsSync(envExample) && !fs.existsSync(envFile)) {
+        const p = ORCHESTRATOR_PROVIDERS[choices.provider];
+        const keyLine = p.keyVar
+            ? `${p.keyVar}=your-api-key-here`
+            : `# No API key needed for Ollama\nOLLAMA_BASE_URL=${p.baseUrl}`;
+        fs.writeFileSync(envFile, `# Generated by create-bk-agent\n${keyLine}\n`);
+    }
+}
 // ── Main scaffold ─────────────────────────────────────────────────────────────
 function scaffold(choices, targetDir) {
     if (fs.existsSync(targetDir)) {
         throw new Error(`Directory already exists: ${targetDir}`);
     }
+    if (choices.architecture === 'orchestrator') {
+        scaffoldOrchestrator(choices, targetDir);
+        return;
+    }
     const isLayered = LAYERED.includes(choices.architecture);
     // 1. Base layer — always copied
     const baseDir = path.join(BASE_DIR, choices.architecture);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-bk-agent",
-  "version": "0.21.2",
+  "version": "0.22.1",
   "description": "Create a new BackendKit agent project",
   "main": "dist/src/index.js",
   "bin": {

package/templates/base/orchestrator/_common/.env.example

@@ -0,0 +1,14 @@
+# Add your LLM provider API key
+# Uncomment the one matching the provider in orchestrator.yaml
+
+# DeepSeek (recommended — cost-effective reasoning)
+DEEPSEEK_API_KEY=sk-...
+
+# Anthropic Claude
+# ANTHROPIC_API_KEY=sk-ant-...
+
+# OpenAI
+# OPENAI_API_KEY=sk-...
+
+# Ollama (local — no API key needed)
+# OLLAMA_BASE_URL=http://localhost:11434

package/templates/base/orchestrator/_common/package.json

@@ -0,0 +1,16 @@
+{
+  "name": "my-orchestrator",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "start": "node node_modules/@backendkit-labs/orchestrator-agent/dist/server.js",
+    "test:flow": "node test-flow.mjs"
+  },
+  "dependencies": {
+    "@backendkit-labs/orchestrator-agent": "^0.2.3"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  }
+}

package/templates/base/orchestrator/blank/orchestrator.yaml

@@ -0,0 +1,34 @@
+version: 1
+
+orchestrator:
+  name: "My Orchestrator"
+  provider: __PROVIDER_ID__
+  vault:
+    path: ./vault
+    embedder: simple          # or "ollama" for semantic search (requires Ollama running)
+
+__PROVIDERS_BLOCK__
+
+# Optional: define static flows triggered by regex patterns on the task string.
+# If no flow matches, the orchestrator plans steps dynamically using the LLM.
+#
+# flows:
+#   - id: my-flow
+#     file: ./flows/my-flow.yaml
+#     trigger: "keyword1|keyword2|phrase to match"
+
+# Define your specialist agents below.
+# Each agent = the same LLM called with a different system prompt.
+# gate: true means the output requires human approval before the flow continues.
+agents:
+  - id: my-agent
+    name: "My Specialist Agent"
+    description: >
+      Describe what this agent does and what tasks it handles.
+      Be specific — the orchestrator uses this description to decide
+      which agent to assign each step to.
+    capabilities: [list, your, keywords, here]
+    provider: __PROVIDER_ID__
+    # gate: true
+    # gate_criteria:
+    #   - "Criterion that must be met before continuing"

package/templates/base/orchestrator/marketing/flows/articulo-blog.yaml

@@ -0,0 +1,97 @@
+id: articulo-blog
+name: "Creación de Artículo de Blog"
+description: >
+  Pipeline completo para crear y distribuir un artículo de blog técnico.
+  Desde el brief estratégico hasta los posts de redes sociales para distribución.
+
+steps:
+  - id: s1-brief
+    agent: content-strategist
+    task: |
+      Crear el brief editorial completo para el artículo de blog.
+
+      PARÁMETROS:
+      - Tema: {{payload.tema}}
+      - Objetivo: {{payload.objetivo}}
+      - Audiencia: {{payload.audiencia}}
+      - Keywords objetivo: {{payload.keywords}}
+      - Tono: {{payload.tono}}
+
+      El brief debe incluir:
+      1. Ángulo editorial y propuesta de valor única (por qué este artículo, por qué ahora)
+      2. Estructura sugerida con H2 y H3 (mínimo 6 secciones)
+      3. Buyer persona primario al que apunta y en qué etapa del funnel está
+      4. 3-5 puntos clave que el lector debe llevarse
+      5. Llamado a la acción recomendado al final del artículo
+      6. Longitud recomendada (palabras)
+    depends_on: []
+
+  - id: s2-redaccion
+    agent: copywriter
+    task: |
+      Redactar el artículo de blog completo siguiendo el brief estratégico.
+
+      BRIEF:
+      {{steps.s1-brief.output}}
+
+      PARÁMETROS ORIGINALES:
+      - Tema: {{payload.tema}}
+      - Tono: {{payload.tono}}
+      - Audiencia: {{payload.audiencia}}
+
+      Requisitos de redacción:
+      - Seguir exactamente la estructura del brief
+      - Incluir ejemplos concretos y datos cuando sea posible
+      - Párrafos cortos (máximo 3-4 líneas) para buena legibilidad web
+      - Incluir al menos 2 listas o tablas para scanabilidad
+      - CTA al final según lo indicado en el brief
+      - Incluir propuesta de título principal (H1) y subtítulo
+    depends_on: [s1-brief]
+
+  - id: s3-seo
+    agent: seo-agent
+    gate: true
+    task: |
+      Revisar y optimizar el artículo para SEO. Proponer mejoras específicas y concretas.
+
+      ARTÍCULO REDACTADO:
+      {{steps.s2-redaccion.output}}
+
+      KEYWORDS OBJETIVO: {{payload.keywords}}
+
+      Entregables:
+      1. Meta título (50-60 caracteres) con keyword principal
+      2. Meta descripción (140-160 caracteres) con CTA
+      3. Lista de mejoras SEO on-page con prioridad (alta/media/baja)
+      4. Sugerencias de internal linking
+      5. Densidad de keyword actual vs recomendada
+      6. Artículo revisado con las mejoras de alta prioridad aplicadas
+    depends_on: [s2-redaccion]
+
+  - id: s4-redes
+    agent: social-media-agent
+    task: |
+      Crear el plan de distribución en redes sociales para el artículo publicado.
+
+      ARTÍCULO (optimizado para SEO):
+      {{steps.s3-seo.output}}
+
+      TEMA: {{payload.tema}}
+      AUDIENCIA: {{payload.audiencia}}
+
+      Crear para cada plataforma:
+
+      LinkedIn (principal):
+      - Post de lanzamiento (hook poderoso + 3-5 insights + CTA)
+      - Post de seguimiento a los 7 días (punto de vista diferente del mismo tema)
+      - Formato: texto largo nativo, link en comentarios
+
+      Twitter/X:
+      - Hilo de 5-7 tweets con los puntos más destacados
+      - Tweet individual de impacto (el insight más potente)
+
+      Calendario sugerido:
+      - Día 0: LinkedIn lanzamiento + Twitter hilo
+      - Día 3: Twitter tweet individual
+      - Día 7: LinkedIn seguimiento
+    depends_on: [s3-seo]

package/templates/base/orchestrator/marketing/flows/campana-leads.yaml

@@ -0,0 +1,115 @@
+id: campana-leads
+name: "Campaña de Generación de Leads"
+description: >
+  Diseño completo de una campaña de lead generation: estrategia, copies,
+  optimización SEO del contenido ancla, y definición de métricas y tracking.
+
+steps:
+  - id: s1-estrategia
+    agent: campaign-agent
+    gate: true
+    task: |
+      Diseñar la estrategia completa de la campaña de lead generation.
+
+      PARÁMETROS DE LA CAMPAÑA:
+      - Servicio/producto a promocionar: {{payload.servicio}}
+      - Segmento objetivo: {{payload.segmento}}
+      - Objetivo de la campaña: {{payload.objetivo}}
+      - Presupuesto disponible: {{payload.presupuesto}}
+      - Duración: {{payload.duracion}}
+      - Canal principal: {{payload.canal}}
+
+      La estrategia debe incluir:
+      1. Objetivo SMART con número concreto de leads esperados
+      2. Segmento primario y secundario con criterios ICP detallados
+      3. Propuesta de valor central de la campaña (el "gancho")
+      4. Mapa de canales: qué rol juega cada canal
+      5. Contenido ancla propuesto (lead magnet, webinar, artículo, etc.)
+      6. Journey del lead: touchpoints desde el primer contacto hasta MQL
+      7. Presupuesto sugerido por canal
+      8. Cronograma de activación semana a semana
+      9. Hipótesis principal y cómo la validaremos
+    depends_on: []
+
+  - id: s2-copies
+    agent: copywriter
+    task: |
+      Redactar todos los copies necesarios para la campaña aprobada.
+
+      ESTRATEGIA DE CAMPAÑA:
+      {{steps.s1-estrategia.output}}
+
+      SERVICIO: {{payload.servicio}}
+      SEGMENTO: {{payload.segmento}}
+
+      Entregar copies para:
+
+      1. ANUNCIOS (LinkedIn Ads o Google Ads según canal definido):
+         - 3 variantes de headline (hasta 150 caracteres)
+         - 3 variantes de descripción (hasta 300 caracteres)
+         - 1 copy largo para sponsored content en LinkedIn
+
+      2. LANDING PAGE:
+         - Headline principal (H1)
+         - Subtítulo de soporte
+         - 3-5 bullets de propuesta de valor
+         - Copy del formulario
+         - CTA button copy (3 variantes)
+
+      3. EMAIL DE BIENVENIDA (post-conversión):
+         - Subject line (3 variantes)
+         - Preheader
+         - Cuerpo del email de bienvenida (300-400 palabras)
+
+      4. SECUENCIA DE NURTURING (3 emails):
+         - Email 2 (día 3): entregar valor, sin vender
+         - Email 3 (día 7): caso de uso relevante
+         - Email 4 (día 14): propuesta directa con CTA a reunión
+    depends_on: [s1-estrategia]
+
+  - id: s3-seo-contenido
+    agent: seo-agent
+    task: |
+      Optimizar el contenido ancla de la campaña para SEO orgánico.
+
+      ESTRATEGIA DE CAMPAÑA:
+      {{steps.s1-estrategia.output}}
+
+      SERVICIO: {{payload.servicio}}
+      SEGMENTO: {{payload.segmento}}
+
+      Entregar:
+      1. 5-10 keywords relacionadas ordenadas por prioridad
+      2. Estructura SEO para el contenido ancla
+      3. Meta título y meta descripción para la landing page
+      4. Recomendaciones de link building
+      5. Estimación de timeline para resultados orgánicos
+    depends_on: [s1-estrategia]
+
+  - id: s4-metricas
+    agent: analytics-agent
+    task: |
+      Definir el plan de medición completo para la campaña.
+
+      ESTRATEGIA APROBADA:
+      {{steps.s1-estrategia.output}}
+
+      COPIES CREADOS:
+      {{steps.s2-copies.output}}
+
+      SEO Y KEYWORDS:
+      {{steps.s3-seo-contenido.output}}
+
+      SERVICIO: {{payload.servicio}}
+      PRESUPUESTO: {{payload.presupuesto}}
+      DURACIÓN: {{payload.duracion}}
+
+      Entregar:
+      1. KPIs primarios (máximo 3, vinculados al objetivo de negocio)
+      2. KPIs secundarios por canal (CTR, CPC, CPL, tasa de conversión)
+      3. Benchmarks de referencia por canal
+      4. Plan de tracking: qué eventos configurar en GA4 / pixel de LinkedIn
+      5. Dashboard sugerido: métricas a reportar semanalmente
+      6. Criterios de optimización: cuándo pausar un anuncio, cuándo escalar
+      7. ROI target: CPL máximo aceptable para que la campaña sea rentable
+    depends_on: [s2-copies, s3-seo-contenido]

package/templates/base/orchestrator/marketing/orchestrator.yaml

@@ -0,0 +1,92 @@
+version: 1
+
+orchestrator:
+  name: "Orquestador de Marketing"
+  provider: __PROVIDER_ID__
+  vault:
+    path: ./vault
+    embedder: simple          # change to "ollama" in production for better semantic search
+
+__PROVIDERS_BLOCK__
+
+flows:
+  - id: articulo-blog
+    file: ./flows/articulo-blog.yaml
+    trigger: "artículo|blog|post|contenido|publicación|nota técnica"
+
+  - id: campana-leads
+    file: ./flows/campana-leads.yaml
+    trigger: "campaña|lead generation|generación de leads|demand gen|adquisición"
+
+agents:
+  - id: content-strategist
+    name: "Estratega de Contenido"
+    description: >
+      Define la estrategia de contenido: estructura, ángulo editorial, keywords objetivo,
+      buyer persona al que apunta, qué problema resuelve y cómo encaja en el funnel.
+      Produce un brief detallado que guía al resto del equipo.
+    capabilities: [estrategia, brief, editorial, funnel, buyer-persona, keywords, estructura]
+    provider: __PROVIDER_ID__
+    domain: marketing
+
+  - id: copywriter
+    name: "Copywriter"
+    description: >
+      Redacta contenido de alta calidad: artículos de blog, emails, copies para ads,
+      landing pages y newsletters. Adapta tono, extensión y formato al canal y a la
+      audiencia indicada en el brief. Sigue la guía de marca y voz de la empresa.
+    capabilities: [redaccion, copywriting, blog, email, ads, landing-page, newsletter]
+    provider: __PROVIDER_ID__
+    domain: marketing
+
+  - id: seo-agent
+    name: "Especialista SEO"
+    description: >
+      Optimiza contenido para motores de búsqueda. Revisa densidad de keywords, estructura
+      de headings, meta descripción, alt text, internal linking y legibilidad. Propone
+      mejoras concretas y valida que el contenido responda la intención de búsqueda.
+    capabilities: [seo, keywords, meta, headings, optimizacion, busqueda, ranking]
+    provider: __PROVIDER_ID__
+    domain: marketing
+    gate: true
+    gate_criteria:
+      - "El título y H1 contienen la keyword principal de forma natural"
+      - "La meta descripción tiene entre 140-160 caracteres con CTA claro"
+      - "El contenido responde completamente la intención de búsqueda del keyword objetivo"
+      - "Hay al menos 2 oportunidades de internal linking identificadas"
+
+  - id: social-media-agent
+    name: "Especialista en Redes Sociales"
+    description: >
+      Crea la estrategia de distribución en redes sociales. Adapta el contenido a LinkedIn,
+      Instagram y Twitter/X con el formato, tono y hashtags apropiados para cada plataforma.
+      Propone el calendario de publicación y horarios óptimos.
+    capabilities: [linkedin, instagram, twitter, redes, distribucion, hashtags, calendario]
+    provider: __PROVIDER_ID__
+    domain: marketing
+
+  - id: campaign-agent
+    name: "Especialista en Campañas"
+    description: >
+      Diseña campañas de marketing: objetivo, segmento, canales, mensajes clave, presupuesto
+      sugerido, cronograma y métricas de éxito. Define el journey del lead desde el awareness
+      hasta la conversión. Propone A/B tests y criterios de optimización.
+    capabilities: [campañas, lead-gen, funnel, presupuesto, segmentacion, journey, abtesting]
+    provider: __PROVIDER_ID__
+    domain: marketing
+    gate: true
+    gate_criteria:
+      - "El objetivo de la campaña es SMART (específico, medible, alcanzable, relevante, temporal)"
+      - "El segmento objetivo está definido con criterios de ICP claros"
+      - "El presupuesto propuesto está dentro de los rangos históricos de la empresa"
+      - "Los KPIs incluyen métricas de negocio (leads calificados) y no solo métricas de vanidad"
+
+  - id: analytics-agent
+    name: "Analista de Marketing"
+    description: >
+      Define métricas, configura el tracking y analiza resultados de campañas y contenido.
+      Calcula CPL, CAC, ROI y LTV. Identifica qué funciona, qué no, y propone optimizaciones
+      basadas en datos. Genera reportes ejecutivos para dirección.
+    capabilities: [analytics, metricas, roi, cpl, cac, ltv, reporting, optimizacion, datos]
+    provider: __PROVIDER_ID__
+    domain: marketing