drm-core 1.0.0 → 1.2.0

package/scaffold/.drm-core/workflows/campanha-trafego.yaml

@@ -0,0 +1,465 @@
+# =============================================================================
+# CAMPANHA TRAFEGO — Workflow de Criacao de Campanha (6 Fases)
+# Pipeline: objetivo → conceito C.A.S.H. → ads → producao → compliance → campanha
+# =============================================================================
+
+workflow:
+  id: campanha-trafego
+  name: "Campanha de Trafego"
+  version: "1.0"
+  description: >
+    Pipeline completo para criacao de campanha de trafego pago no Meta Ads.
+    Desde a definicao do objetivo ate a configuracao final com bid strategy
+    BIDCAP, publicos, kill rules e testes A/B.
+
+  trigger: manual
+  estimated_duration: "3-5 dias uteis"
+  priority: high
+
+  # ---------------------------------------------------------------------------
+  # FASES
+  # ---------------------------------------------------------------------------
+  phases:
+    - phase_1: "Objetivo e Briefing"
+    - phase_2: "Conceito Criativo (C.A.S.H.)"
+    - phase_3: "Copy dos Anuncios"
+    - phase_4: "Producao de Criativos"
+    - phase_5: "Compliance de Ads"
+    - phase_6: "Configuracao da Campanha"
+
+  # ---------------------------------------------------------------------------
+  # SEQUENCIA DE STEPS
+  # ---------------------------------------------------------------------------
+  sequence:
+
+    # =========================================================================
+    # FASE 1 — OBJETIVO E BRIEFING (@atena)
+    # =========================================================================
+    - step: definir_objetivo
+      phase: 1
+      agent: "@atena"
+      action: "*definir-objetivo-campanha"
+      description: >
+        Define objetivo da campanha: conversao, leads, trafego, awareness.
+        Especifica KPIs alvo (CPA, CPL, ROAS, CTR), budget disponivel,
+        periodo da campanha, produto/oferta a ser promovido, destino
+        do trafego (LP, VSL, WhatsApp, formulario).
+      inputs:
+        - "Produto/oferta a promover"
+        - "Budget disponivel"
+        - "Historico de campanhas (se existir)"
+        - "docs/estrategia/avatar-profile.md (se existir)"
+      outputs:
+        - "docs/trafego/briefing-campanha.md"
+      requires: null
+      next: briefing_criativo
+      on_failure: "Solicitar informacoes minimas: objetivo, budget, produto"
+      validation:
+        type: checklist
+        criteria: >
+          Deve conter: objetivo da campanha (1 primario), KPIs alvo
+          com valores numericos, budget diario e total, periodo,
+          produto descrito, URL de destino, publico-alvo resumido.
+
+    - step: briefing_criativo
+      phase: 1
+      agent: "@atena"
+      action: "*briefing-criativo"
+      description: >
+        Prepara briefing criativo para a equipe: tom de comunicacao,
+        referencias visuais, do's and don'ts, mensagem-chave, USP,
+        restricoes de plataforma (Meta Ads policies relevantes).
+      inputs:
+        - "docs/trafego/briefing-campanha.md"
+        - "docs/estrategia/posicionamento.md (se existir)"
+      outputs:
+        - "docs/trafego/briefing-criativo.md"
+      requires: definir_objetivo
+      next: conceito_cash
+      on_failure: "Definir minimo: tom, mensagem-chave, 2 referencias"
+      validation:
+        type: checklist
+        criteria: >
+          Briefing com: tom de comunicacao definido, mensagem-chave
+          em 1 frase, 3+ referencias visuais, do's and don'ts,
+          restricoes de plataforma listadas.
+
+    # =========================================================================
+    # FASE 2 — CONCEITO CRIATIVO C.A.S.H. (@zeus)
+    # =========================================================================
+    - step: conceito_cash
+      phase: 2
+      agent: "@zeus"
+      action: "*conceito-cash"
+      description: >
+        Desenvolve conceito criativo usando framework C.A.S.H.:
+        Conceito (ideia central), Angulo (perspectiva de abordagem),
+        Estilo (formato visual/narrativo), Hook (gancho de atencao).
+        Gera 3-5 angulos de ataque distintos.
+      inputs:
+        - "docs/trafego/briefing-criativo.md"
+        - "docs/trafego/briefing-campanha.md"
+        - "docs/estrategia/avatar-profile.md (se existir)"
+      outputs:
+        - "docs/trafego/conceito-cash.md"
+      requires: briefing_criativo
+      next: validar_hooks
+      on_failure: "Gerar mais angulos partindo de dores diferentes do avatar"
+      validation:
+        type: checklist
+        criteria: >
+          Deve conter: 1 Conceito central definido, 3-5 Angulos
+          distintos (cada um com justificativa), Estilo por angulo
+          (UGC, talking head, motion graphics, etc), 3+ Hooks
+          por angulo (gancho textual e visual).
+        cash_framework:
+          conceito: "Ideia central unica que diferencia a campanha"
+          angulo: "Perspectiva emocional/racional de abordagem"
+          estilo: "Formato visual e narrativo do criativo"
+          hook: "Primeiros 3 segundos que capturam atencao"
+
+    - step: validar_hooks
+      phase: 2
+      agent: "@zeus"
+      action: "*validar-hooks"
+      description: >
+        Valida e rankeia hooks gerados: avalia poder de atencao (scroll
+        stop), relevancia para o avatar, alinhamento com angulo,
+        compliance preliminary. Seleciona top 3-5 para producao.
+      inputs:
+        - "docs/trafego/conceito-cash.md"
+        - "docs/trafego/briefing-campanha.md"
+      outputs:
+        - "docs/trafego/hooks-validados.md"
+      requires: conceito_cash
+      next: escrever_ads
+      on_failure: "Gerar novos hooks com tecnicas alternativas (curiosidade, medo, desejo)"
+      validation:
+        type: checklist
+        criteria: >
+          Cada hook com: score de atencao (1-10), score de relevancia
+          (1-10), formato (texto/visual/audio), variante A/B sugerida,
+          compliance flag (verde/amarelo/vermelho).
+
+    # =========================================================================
+    # FASE 3 — COPY DOS ANUNCIOS (@apolo)
+    # =========================================================================
+    - step: escrever_ads
+      phase: 3
+      agent: "@apolo"
+      action: "*escrever-ads"
+      description: >
+        Escreve 3-5 variacoes de anuncios por angulo selecionado.
+        Cada variacao com: primary text (3 tamanhos: curto/medio/longo),
+        headline, description, CTA. Formatos: feed, stories, reels.
+      inputs:
+        - "docs/trafego/conceito-cash.md"
+        - "docs/trafego/hooks-validados.md"
+        - "docs/trafego/briefing-criativo.md"
+        - "docs/estrategia/avatar-profile.md (se existir)"
+      outputs:
+        - "docs/trafego/ads-copy-completa.md"
+      requires: validar_hooks
+      next: producao_video_ads
+      on_failure: "Revisar com @zeus — ajustar hook ou angulo"
+      validation:
+        type: checklist
+        criteria: >
+          Minimo 3 variacoes por angulo, cada uma com: primary text
+          (curto <=125 chars, medio <=250, longo <=500), headline
+          <=40 chars, description <=30 chars, CTA selecionado,
+          angulo e hook identificados.
+
+    # =========================================================================
+    # FASE 4 — PRODUCAO DE CRIATIVOS (PARALELO: @hefesto + @afrodite)
+    # =========================================================================
+    - step: producao_video_ads
+      phase: 4
+      agent: "@hefesto"
+      action: "*produzir-video-ads"
+      parallel_with: producao_estatico_ads
+      description: >
+        Produz briefing de video para cada variacao de anuncio: roteiro
+        de video (15s, 30s, 60s), instrucoes de edicao, storyboard
+        simplificado, assets necessarios, formato por posicionamento
+        (9:16 stories/reels, 1:1 feed, 4:5 feed).
+      inputs:
+        - "docs/trafego/ads-copy-completa.md"
+        - "docs/trafego/hooks-validados.md"
+        - "docs/trafego/briefing-criativo.md"
+      outputs:
+        - "docs/trafego/producao/video-ads-briefing.md"
+        - "docs/trafego/producao/storyboards-ads.md"
+      requires: escrever_ads
+      next: compliance_ads
+      on_failure: "Simplificar para formatos estaticos com motion minimo"
+      validation:
+        type: checklist
+        criteria: >
+          Cada video com: roteiro timestamped, formato de aspecto
+          definido, duracao (15s/30s/60s), hook visual nos primeiros
+          3s, CTA visual no final, assets listados.
+
+    - step: producao_estatico_ads
+      phase: 4
+      agent: "@afrodite"
+      action: "*produzir-estatico-ads"
+      parallel_with: producao_video_ads
+      description: >
+        Cria briefing de criativos estaticos e carrossel: layout por
+        formato (1:1, 4:5, 9:16), hierarquia visual, texto na imagem
+        (regra 20% Meta), cores, tipografia, CTA visual.
+      inputs:
+        - "docs/trafego/ads-copy-completa.md"
+        - "docs/trafego/hooks-validados.md"
+        - "docs/trafego/briefing-criativo.md"
+      outputs:
+        - "docs/trafego/producao/estatico-ads-briefing.md"
+        - "docs/trafego/producao/carrossel-ads-briefing.md"
+      requires: escrever_ads
+      next: compliance_ads
+      on_failure: "Reduzir texto na imagem e simplificar layout"
+      validation:
+        type: checklist
+        criteria: >
+          Cada estatico com: layout definido, texto <=20% da imagem,
+          hierarquia visual clara, CTA visivel, versoes por formato
+          (1:1, 4:5, 9:16), carrossel com 3-5 cards.
+
+    # =========================================================================
+    # FASE 5 — COMPLIANCE DE ADS (@temis)
+    # =========================================================================
+    - step: compliance_ads
+      phase: 5
+      agent: "@temis"
+      action: "*compliance-ads-review"
+      description: >
+        Revisao de compliance especifica para Meta Ads: politicas de
+        publicidade, claims verificaveis, imagens/video permitidos,
+        targeting restrictions, special ad categories, disclaimers,
+        texto na imagem (regra 20%).
+      inputs:
+        - "docs/trafego/ads-copy-completa.md"
+        - "docs/trafego/producao/video-ads-briefing.md"
+        - "docs/trafego/producao/estatico-ads-briefing.md"
+        - "docs/trafego/producao/carrossel-ads-briefing.md"
+      outputs:
+        - "docs/trafego/compliance/ads-compliance-report.md"
+        - "docs/trafego/compliance/alteracoes-obrigatorias.md"
+      requires:
+        - producao_video_ads
+        - producao_estatico_ads
+      next: aplicar_compliance_ads
+      on_failure: "Bloquear ads com violacoes criticas, permitir ajustes menores"
+      validation:
+        type: verdict
+        criteria: >
+          APROVADO: Todos os ads em compliance com Meta Ads policies.
+          AJUSTES: Alteracoes menores necessarias (listadas).
+          BLOQUEADO: Violacoes que causariam rejeicao ou ban.
+        meta_policies_check:
+          - "Sem claims de saude nao verificados"
+          - "Sem promessas de renda/resultado financeiro garantido"
+          - "Sem before/after proibidos"
+          - "Texto na imagem <=20%"
+          - "Sem conteudo sensacional ou clickbait extremo"
+          - "Special ad category verificada (se aplicavel)"
+          - "Landing page consistente com ad"
+
+    - step: aplicar_compliance_ads
+      phase: 5
+      agent: "@apolo"
+      action: "*aplicar-correcoes-ads"
+      description: >
+        Aplica correcoes de compliance nos ads mantendo eficacia e
+        persuasao. Reformula claims, ajusta headlines, adiciona disclaimers.
+      inputs:
+        - "docs/trafego/compliance/alteracoes-obrigatorias.md"
+        - "docs/trafego/ads-copy-completa.md"
+      outputs:
+        - "docs/trafego/ads-copy-completa.md (atualizado)"
+        - "docs/trafego/compliance/compliance-applied-log.md"
+      requires: compliance_ads
+      next: estrutura_campanha
+      on_failure: "Escalar para @temis re-revisao"
+      validation:
+        type: checklist
+        criteria: >
+          Todas as correcoes aplicadas, log documentado, sem
+          violacoes remanescentes.
+
+    # =========================================================================
+    # FASE 6 — CONFIGURACAO DA CAMPANHA (@hermes)
+    # =========================================================================
+    - step: estrutura_campanha
+      phase: 6
+      agent: "@hermes"
+      action: "*estruturar-campanha"
+      description: >
+        Define estrutura completa da campanha no Meta Ads Manager:
+        nivel campanha (objetivo, special ad category, budget type),
+        nivel ad set (publicos, posicionamentos, bid strategy, schedule),
+        nivel ad (criativos, formatos, tracking).
+      inputs:
+        - "docs/trafego/briefing-campanha.md"
+        - "docs/trafego/ads-copy-completa.md"
+        - "docs/trafego/producao/video-ads-briefing.md"
+        - "docs/trafego/producao/estatico-ads-briefing.md"
+      outputs:
+        - "docs/trafego/campanha/estrutura-campanha.md"
+      requires: aplicar_compliance_ads
+      next: bid_strategy
+      on_failure: "Simplificar estrutura para 1 campanha, 2-3 ad sets"
+      validation:
+        type: checklist
+        criteria: >
+          Estrutura com: objetivo alinhado ao briefing, naming convention
+          definida, hierarquia campanha>adset>ad documentada, budget
+          allocation por ad set.
+
+    - step: bid_strategy
+      phase: 6
+      agent: "@hermes"
+      action: "*configurar-bid-strategy"
+      description: >
+        Configura bid strategy BIDCAP: define bid cap por objetivo
+        (CPA alvo ou CPL alvo), logica de escalonamento, regras de
+        aumento/reducao de bid baseado em performance.
+      inputs:
+        - "docs/trafego/campanha/estrutura-campanha.md"
+        - "docs/trafego/briefing-campanha.md"
+      outputs:
+        - "docs/trafego/campanha/bid-strategy.md"
+      requires: estrutura_campanha
+      next: publicos_targeting
+      on_failure: "Fallback para Lowest Cost com budget control"
+      validation:
+        type: checklist
+        criteria: >
+          BIDCAP definido com: bid cap inicial, regra de aumento
+          (+10-20% se delivery baixo), regra de reducao (-10% se CPA
+          acima do alvo), periodo de aprendizado respeitado (48-72h),
+          fallback strategy se BIDCAP nao performar.
+        bidcap_config:
+          initial_bid: "CPA alvo * 0.8"
+          increase_rule: "+10-20% se delivery < 80% do budget"
+          decrease_rule: "-10% se CPA > 120% do alvo"
+          learning_period: "48-72h sem alteracoes"
+          fallback: "Lowest Cost com Daily Budget"
+
+    - step: publicos_targeting
+      phase: 6
+      agent: "@hermes"
+      action: "*configurar-publicos"
+      description: >
+        Define publicos para cada ad set: Lookalike (seeds, %), Custom
+        Audiences (website, engagement, customer list), Interests,
+        Broad (sem targeting). Exclusoes definidas.
+      inputs:
+        - "docs/trafego/campanha/estrutura-campanha.md"
+        - "docs/trafego/briefing-campanha.md"
+        - "docs/estrategia/avatar-profile.md (se existir)"
+      outputs:
+        - "docs/trafego/campanha/publicos-targeting.md"
+      requires: bid_strategy
+      next: kill_rules
+      on_failure: "Comecar com broad e refinar apos dados iniciais"
+      validation:
+        type: checklist
+        criteria: >
+          Minimo 3 publicos distintos: 1 Lookalike, 1 Interest-based,
+          1 Broad/Open. Cada publico com: nome, tipo, tamanho estimado,
+          exclusoes, ad set associado.
+
+    - step: kill_rules
+      phase: 6
+      agent: "@hermes"
+      action: "*definir-kill-rules"
+      description: >
+        Define kill rules para cada nivel (campanha, ad set, ad):
+        metricas de corte, thresholds, periodo de avaliacao, acoes
+        automaticas, regras de escalonamento.
+      inputs:
+        - "docs/trafego/campanha/estrutura-campanha.md"
+        - "docs/trafego/campanha/bid-strategy.md"
+        - "docs/trafego/briefing-campanha.md"
+      outputs:
+        - "docs/trafego/campanha/kill-rules.md"
+      requires: publicos_targeting
+      next: teste_ab
+      on_failure: "Usar kill rules conservadoras padrao"
+      validation:
+        type: checklist
+        criteria: >
+          Kill rules por nivel com metricas e thresholds definidos.
+        kill_rules_default:
+          ad_level:
+            - "CTR < 1% apos 1000 impressoes → pausar ad"
+            - "CPA > 150% do alvo apos 48h → pausar ad"
+            - "Frequencia > 3 em 7 dias → pausar ad"
+            - "Hook rate < 25% (video) → pausar ad"
+          adset_level:
+            - "CPA > 130% do alvo apos 72h → reduzir budget 50%"
+            - "0 conversoes apos 2x CPA em spend → pausar ad set"
+            - "CPM > 2x media da conta → investigar"
+          campaign_level:
+            - "ROAS < 1.0 apos 7 dias → avaliar pivot"
+            - "Budget > 80% gasto sem conversoes → pausar campanha"
+
+    - step: teste_ab
+      phase: 6
+      agent: "@hermes"
+      action: "*planejar-teste-ab"
+      description: >
+        Planeja estrutura de teste A/B: variaveis a testar (hook, copy,
+        criativo, publico, bid), hipoteses, tamanho de amostra, duracao
+        do teste, criterio de vitoria, sequencia de testes.
+      inputs:
+        - "docs/trafego/campanha/estrutura-campanha.md"
+        - "docs/trafego/ads-copy-completa.md"
+        - "docs/trafego/campanha/publicos-targeting.md"
+      outputs:
+        - "docs/trafego/campanha/teste-ab-plan.md"
+      requires: kill_rules
+      next: null
+      on_failure: "Comecar com teste simples: 1 variavel (hook)"
+      validation:
+        type: checklist
+        criteria: >
+          Plano com: variavel isolada por teste, hipotese documentada,
+          tamanho de amostra minimo (100 conversoes ou 1000 cliques),
+          duracao minima (7 dias), metrica de vitoria (CPA ou CTR),
+          sequencia de testes priorizada (hook > copy > criativo >
+          publico > bid).
+        teste_sequence:
+          - priority: 1
+            variable: "Hook (primeiros 3 segundos)"
+            metric: "Hook rate, CTR"
+          - priority: 2
+            variable: "Copy (primary text)"
+            metric: "CTR, CPA"
+          - priority: 3
+            variable: "Criativo (formato)"
+            metric: "CTR, CPM"
+          - priority: 4
+            variable: "Publico"
+            metric: "CPA, ROAS"
+          - priority: 5
+            variable: "Bid strategy"
+            metric: "CPA, Delivery"
+
+  # ---------------------------------------------------------------------------
+  # CONFIGURACAO GLOBAL
+  # ---------------------------------------------------------------------------
+  config:
+    default_bid_strategy: "BIDCAP"
+    min_ads_per_angle: 3
+    max_angles: 5
+    compliance_blocking: true
+    parallel_production: true
+    learning_period_hours: 72
+
+  failure_handling:
+    global_escalation: "@atena"
+    max_retries_per_step: 2
+    on_critical_failure: "Pausar campanha, revisar estrategia com @atena"