drm-core 1.0.0 → 1.3.0

package/scaffold/.drm-core/workflows/otimizacao-cycle.yaml

@@ -0,0 +1,394 @@
+# =============================================================================
+# OTIMIZACAO CYCLE — Workflow Iterativo (Loop)
+# Pipeline: diagnostico → decisao → execucao → compliance → medicao → loop
+# =============================================================================
+
+workflow:
+  id: otimizacao-cycle
+  name: "Ciclo de Otimizacao"
+  version: "1.0"
+  description: >
+    Ciclo continuo de otimizacao de funil e campanha. @cronos diagnostica
+    gargalos comparando metricas reais vs benchmarks, @atena decide qual
+    agente deve intervir usando decision tree, o agente designado executa
+    a correcao, @temis revisa se compliance foi afetado, @cronos mede
+    resultado antes/depois. Loop continua ate meta atingida ou hipoteses
+    esgotadas.
+
+  trigger: manual
+  estimated_duration: "continuo (ciclos de 3-7 dias)"
+  priority: high
+  type: iterative_loop
+
+  # ---------------------------------------------------------------------------
+  # FASES
+  # ---------------------------------------------------------------------------
+  phases:
+    - phase_1: "Diagnostico de Performance"
+    - phase_2: "Decisao e Roteamento"
+    - phase_3: "Execucao da Correcao"
+    - phase_4: "Compliance (se aplicavel)"
+    - phase_5: "Medicao de Resultado"
+    - phase_loop: "Loop ate meta ou hipoteses esgotadas"
+
+  # ---------------------------------------------------------------------------
+  # CONFIGURACAO DO LOOP
+  # ---------------------------------------------------------------------------
+  loop_config:
+    max_iterations: 10
+    current_iteration: 0
+    min_measurement_period: "72h"
+    exit_conditions:
+      - "Meta de KPI atingida"
+      - "Todas as hipoteses testadas sem melhoria"
+      - "max_iterations atingido"
+      - "Budget esgotado"
+    state_file: "docs/otimizacao/cycle-state.yaml"
+
+  # ---------------------------------------------------------------------------
+  # BENCHMARKS DE REFERENCIA
+  # ---------------------------------------------------------------------------
+  benchmarks:
+    funil:
+      opt_in_rate: "25-40%"
+      vsl_view_rate: "30-50%"
+      vsl_completion_rate: "15-30%"
+      checkout_conversion: "3-8%"
+      bump_take_rate: "20-40%"
+      upsell_take_rate: "10-25%"
+      downsell_take_rate: "15-30%"
+    trafego:
+      ctr_link: "1-3%"
+      cpc: "R$ 0.50-2.00"
+      cpl: "R$ 3-15"
+      cpa: "Varia por ticket"
+      roas: ">= 2.0"
+      hook_rate: "25-40%"
+      hold_rate: "15-25%"
+      frequency_max: 3
+    email:
+      open_rate: "20-35%"
+      click_rate: "2-5%"
+      unsubscribe_rate: "< 0.5%"
+    whatsapp:
+      response_rate: "40-70%"
+      conversion_rate: "5-15%"
+
+  # ---------------------------------------------------------------------------
+  # DECISION TREE
+  # ---------------------------------------------------------------------------
+  decision_tree:
+    - gargalo: "Hook rate baixo (< 25%)"
+      problema: "Criativo nao para o scroll"
+      agente: "@zeus"
+      acao: "Reescrever hooks com novos angulos"
+      prioridade: "P0"
+
+    - gargalo: "CTR baixo (< 1%) com hook rate OK"
+      problema: "Copy do ad nao converte clique"
+      agente: "@apolo"
+      acao: "Reescrever primary text e headline"
+      prioridade: "P0"
+
+    - gargalo: "CPA alto com CTR OK"
+      problema: "Publico ou bid strategy inadequados"
+      agente: "@hermes"
+      acao: "Ajustar publicos, bid cap, exclusoes"
+      prioridade: "P0"
+
+    - gargalo: "Opt-in rate baixo (< 25%)"
+      problema: "Pagina de captura nao converte"
+      agente: "@afrodite"
+      acao: "Redesenhar LP acima da dobra"
+      co_agente: "@apolo"
+      co_acao: "Reescrever headline e CTA da captura"
+      prioridade: "P1"
+
+    - gargalo: "VSL view rate baixo (< 30%)"
+      problema: "Lead nao assiste a VSL"
+      agente: "@apolo"
+      acao: "Reescrever pre-frame e headline da pagina VSL"
+      prioridade: "P1"
+
+    - gargalo: "VSL completion rate baixo (< 15%)"
+      problema: "VSL perde audiencia no meio"
+      agente: "@apolo"
+      acao: "Identificar ponto de queda e reescrever secao"
+      prioridade: "P1"
+
+    - gargalo: "Checkout conversion baixo (< 3%)"
+      problema: "Funil perde no checkout"
+      agente: "@poseidon"
+      acao: "Otimizar fluxo de checkout, reduzir friccao"
+      co_agente: "@apolo"
+      co_acao: "Melhorar microcopy e urgencia no checkout"
+      prioridade: "P0"
+
+    - gargalo: "Email open rate baixo (< 20%)"
+      problema: "Subject lines fracas"
+      agente: "@apolo"
+      acao: "Reescrever subject lines com A/B test"
+      prioridade: "P2"
+
+    - gargalo: "WhatsApp response rate baixo (< 40%)"
+      problema: "Mensagens nao engajam"
+      agente: "@apolo"
+      acao: "Reescrever mensagens com tom mais pessoal"
+      prioridade: "P2"
+
+    - gargalo: "Frequencia alta (> 3)"
+      problema: "Criativo saturado"
+      agente: "@zeus"
+      acao: "Desenvolver novo conceito C.A.S.H."
+      co_agente: "@hefesto"
+      co_acao: "Produzir novos criativos"
+      prioridade: "P0"
+
+  # ---------------------------------------------------------------------------
+  # SEQUENCIA DE STEPS
+  # ---------------------------------------------------------------------------
+  sequence:
+
+    # =========================================================================
+    # FASE 1 — DIAGNOSTICO DE PERFORMANCE (@cronos)
+    # =========================================================================
+    - step: coletar_metricas
+      phase: 1
+      agent: "@cronos"
+      action: "*coletar-metricas"
+      description: >
+        Coleta metricas de performance de todas as etapas do funil e campanha:
+        Meta Ads (CTR, CPC, CPL, CPA, ROAS, frequencia, hook rate),
+        funil (opt-in rate, view rate, completion rate, checkout CVR),
+        email (open rate, click rate), WhatsApp (response rate, CVR).
+      inputs:
+        - "Meta Ads Manager (via Meta MCP)"
+        - "Plataforma de funil (analytics)"
+        - "Plataforma de email (metricas)"
+        - "Plataforma de WhatsApp (metricas)"
+        - "docs/otimizacao/cycle-state.yaml (estado anterior)"
+      outputs:
+        - "docs/otimizacao/metricas-atuais.md"
+      requires: null
+      next: diagnosticar_gargalo
+      on_failure: "Coletar metricas disponiveis, marcar indisponiveis"
+      validation:
+        type: checklist
+        criteria: >
+          Metricas coletadas de todas as fontes disponiveis, periodo
+          definido (ultimos 3-7 dias), dados comparados com periodo
+          anterior (se existir).
+
+    - step: diagnosticar_gargalo
+      phase: 1
+      agent: "@cronos"
+      action: "*diagnosticar-gargalo"
+      description: >
+        Compara metricas atuais com benchmarks de referencia. Identifica
+        gargalo principal (metrica mais distante do benchmark), gargalos
+        secundarios, e prioriza por impacto no resultado final (ROAS).
+        Calcula impacto estimado se gargalo for resolvido.
+      inputs:
+        - "docs/otimizacao/metricas-atuais.md"
+        - "Benchmarks de referencia (definidos no workflow)"
+        - "docs/otimizacao/historico-diagnosticos.md (se existir)"
+      outputs:
+        - "docs/otimizacao/diagnostico-v{n}.md"
+      requires: coletar_metricas
+      next: decisao_roteamento
+      on_failure: "Listar todos os gargalos sem priorizar"
+      validation:
+        type: checklist
+        criteria: >
+          Diagnostico com: gargalo principal identificado, metrica
+          atual vs benchmark, impacto estimado no ROAS, prioridade
+          (P0/P1/P2), gargalos secundarios listados.
+
+    # =========================================================================
+    # FASE 2 — DECISAO E ROTEAMENTO (@atena)
+    # =========================================================================
+    - step: decisao_roteamento
+      phase: 2
+      agent: "@atena"
+      action: "*decisao-otimizacao"
+      description: >
+        Analisa diagnostico e usa decision tree para rotear a correcao
+        ao agente correto. Define: qual agente corrige, qual acao
+        especifica, hipotese a testar, metrica de sucesso, prazo
+        de medicao.
+      inputs:
+        - "docs/otimizacao/diagnostico-v{n}.md"
+        - "Decision tree (definido no workflow)"
+        - "docs/otimizacao/historico-decisoes.md (se existir)"
+      outputs:
+        - "docs/otimizacao/decisao-v{n}.md"
+        - "docs/otimizacao/briefing-correcao-v{n}.md"
+      requires: diagnosticar_gargalo
+      next: executar_correcao
+      on_failure: "Testar hipotese mais conservadora primeiro"
+      validation:
+        type: checklist
+        criteria: >
+          Decisao com: agente designado, acao especifica, hipotese
+          documentada ("Se X, entao Y"), metrica de sucesso com
+          threshold, prazo de medicao (minimo 72h).
+        decision_output:
+          agente_designado: "Baseado no decision tree"
+          acao: "Descricao especifica da correcao"
+          hipotese: "Se [correcao], entao [metrica] deve [melhorar em X%]"
+          metrica_sucesso: "Metrica especifica com threshold"
+          prazo_medicao: "72h minimo"
+
+    # =========================================================================
+    # FASE 3 — EXECUCAO DA CORRECAO (AGENTE DESIGNADO)
+    # =========================================================================
+    - step: executar_correcao
+      phase: 3
+      agent: "dinamico (definido em decisao_roteamento)"
+      action: "dinamico (definido em decisao_roteamento)"
+      description: >
+        O agente designado na Fase 2 executa a correcao especifica
+        conforme o briefing. Pode ser: @apolo (copy), @zeus (hooks/conceito),
+        @hermes (campanha/bid), @poseidon (funil), @afrodite (design),
+        @hefesto (criativo).
+      inputs:
+        - "docs/otimizacao/briefing-correcao-v{n}.md"
+        - "docs/otimizacao/diagnostico-v{n}.md"
+        - "Assets atuais que serao modificados"
+      outputs:
+        - "docs/otimizacao/correcao-v{n}.md"
+        - "Assets modificados (varia por agente)"
+      requires: decisao_roteamento
+      next: compliance_check
+      on_failure: "Documentar bloqueio e escalar para @atena"
+      validation:
+        type: checklist
+        criteria: >
+          Correcao executada conforme briefing, assets modificados
+          documentados, versao anterior preservada para rollback,
+          hipotese mantida na correcao.
+
+    # =========================================================================
+    # FASE 4 — COMPLIANCE (SE APLICAVEL) (@temis)
+    # =========================================================================
+    - step: compliance_check
+      phase: 4
+      agent: "@temis"
+      action: "*compliance-check-otimizacao"
+      description: >
+        Verifica se a correcao afetou compliance. So executa revisao
+        completa se a correcao envolveu copy ou criativo. Para
+        correcoes tecnicas (bid, publico, funil flow) faz check rapido.
+      inputs:
+        - "docs/otimizacao/correcao-v{n}.md"
+        - "Assets modificados"
+        - "docs/compliance/compliance-report.md (original)"
+      outputs:
+        - "docs/otimizacao/compliance-check-v{n}.md"
+      requires: executar_correcao
+      next: medir_resultado
+      on_failure: "Bloquear publicacao da correcao ate compliance OK"
+      validation:
+        type: conditional
+        criteria: >
+          Se correcao envolve copy/criativo: revisao completa de compliance.
+          Se correcao e tecnica: check rapido (politicas de plataforma).
+          APROVADO: Prosseguir para medicao.
+          AJUSTES: Corrigir antes de publicar.
+        conditions:
+          copy_or_creative_change:
+            review_type: "full"
+            checks: ["claims", "disclaimers", "Meta policies", "CONAR"]
+          technical_change:
+            review_type: "quick"
+            checks: ["Meta policies basicas"]
+
+    # =========================================================================
+    # FASE 5 — MEDICAO DE RESULTADO (@cronos)
+    # =========================================================================
+    - step: medir_resultado
+      phase: 5
+      agent: "@cronos"
+      action: "*medir-resultado-otimizacao"
+      description: >
+        Apos periodo minimo de medicao (72h), coleta novas metricas e
+        compara com baseline (antes da correcao). Calcula variacao
+        percentual, significancia estatistica (se volume suficiente),
+        impacto no ROAS global.
+      inputs:
+        - "docs/otimizacao/metricas-atuais.md (baseline)"
+        - "docs/otimizacao/decisao-v{n}.md (hipotese e metrica)"
+        - "Dados pos-correcao (minimo 72h)"
+      outputs:
+        - "docs/otimizacao/resultado-v{n}.md"
+        - "docs/otimizacao/historico-diagnosticos.md (append)"
+      requires: compliance_check
+      next: avaliar_continuidade
+      on_failure: "Estender periodo de medicao para 7 dias"
+      validation:
+        type: comparison
+        criteria: >
+          Comparacao antes/depois com: metrica alvo, valor antes,
+          valor depois, variacao percentual, significancia
+          (volume minimo: 100 conversoes ou 1000 cliques), impacto
+          no ROAS, veredicto (MELHOROU / NEUTRO / PIOROU).
+
+    - step: avaliar_continuidade
+      phase: 5
+      agent: "@atena"
+      action: "*avaliar-continuidade-ciclo"
+      description: >
+        Avalia se o ciclo deve continuar: meta atingida? Hipoteses
+        restantes? Budget disponivel? Decide entre: continuar loop
+        (proximo gargalo), manter correcao e escalar, ou encerrar
+        ciclo com report final.
+      inputs:
+        - "docs/otimizacao/resultado-v{n}.md"
+        - "docs/otimizacao/cycle-state.yaml"
+        - "KPIs alvo do projeto"
+      outputs:
+        - "docs/otimizacao/continuidade-v{n}.md"
+        - "docs/otimizacao/cycle-state.yaml (atualizado)"
+      requires: medir_resultado
+      next: "condicional"
+      on_failure: "Encerrar ciclo com report do que foi tentado"
+      validation:
+        type: routing
+        criteria: >
+          Roteamento baseado em resultado e estado do ciclo.
+        routing_rules:
+          - condition: "Meta de KPI atingida"
+            next: null
+            action: "Encerrar ciclo com report de sucesso"
+          - condition: "Melhoria detectada mas meta nao atingida"
+            next: coletar_metricas
+            action: "Novo ciclo com proximo gargalo"
+          - condition: "Sem melhoria e hipoteses restantes"
+            next: coletar_metricas
+            action: "Novo ciclo com hipotese alternativa"
+          - condition: "Sem melhoria e sem hipoteses"
+            next: null
+            action: "Encerrar ciclo — pivotar estrategia"
+          - condition: "Piorou"
+            next: executar_correcao
+            action: "Rollback para versao anterior"
+          - condition: "max_iterations atingido"
+            next: null
+            action: "Encerrar ciclo com report completo"
+
+  # ---------------------------------------------------------------------------
+  # CONFIGURACAO GLOBAL
+  # ---------------------------------------------------------------------------
+  config:
+    max_iterations: 10
+    min_measurement_period: "72h"
+    rollback_enabled: true
+    compliance_on_copy_changes: true
+    track_all_iterations: true
+    preserve_baselines: true
+
+  failure_handling:
+    global_escalation: "@atena"
+    on_max_iterations: "Gerar report final com todos os testes e resultados"
+    on_critical_failure: "Rollback para ultimo estado estavel"
+    on_regression: "Rollback imediato + investigacao da causa"