drm-core 1.0.0 → 1.2.0

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

@@ -0,0 +1,468 @@
+# =============================================================================
+# REATIVACAO CYCLE — Workflow de Reativacao (4 Fases)
+# Pipeline: identificacao cohorts → estrategia por cohort → copy → execucao
+# =============================================================================
+
+workflow:
+  id: reativacao-cycle
+  name: "Ciclo de Reativacao"
+  version: "1.0"
+  description: >
+    Ciclo de reativacao de clientes e leads inativos. @cronos identifica
+    cohorts por tempo de inatividade, @atena define estrategia e oferta
+    por cohort, @apolo escreve sequencias de win-back por email e WhatsApp,
+    @temis valida compliance, @hermes configura retargeting, @cronos
+    mede resultados.
+
+  trigger: manual
+  estimated_duration: "3-5 dias uteis (setup) + 30 dias (execucao)"
+  priority: medium
+
+  # ---------------------------------------------------------------------------
+  # FASES
+  # ---------------------------------------------------------------------------
+  phases:
+    - phase_1: "Identificacao de Cohorts Inativos"
+    - phase_2: "Estrategia por Cohort"
+    - phase_3: "Copy de Reativacao"
+    - phase_4: "Execucao e Medicao"
+
+  # ---------------------------------------------------------------------------
+  # DEFINICAO DE COHORTS
+  # ---------------------------------------------------------------------------
+  cohort_definitions:
+    - cohort: "inativo_30d"
+      label: "Inativos 30 dias"
+      criteria: "Sem compra nos ultimos 30 dias"
+      sub_criteria:
+        - "Comprou mas nao recomprou"
+        - "Lead que nao converteu"
+      tamanho_esperado: "40-60% da base"
+
+    - cohort: "inativo_60d"
+      label: "Inativos 60 dias"
+      criteria: "Sem compra nos ultimos 60 dias"
+      sub_criteria:
+        - "Sem abrir email nos ultimos 30 dias"
+        - "Sem engajar WhatsApp nos ultimos 30 dias"
+      tamanho_esperado: "20-35% da base"
+
+    - cohort: "inativo_90d"
+      label: "Inativos 90 dias"
+      criteria: "Sem compra nos ultimos 90 dias"
+      sub_criteria:
+        - "Sem nenhuma interacao nos ultimos 60 dias"
+        - "Sem abrir email nos ultimos 60 dias"
+      tamanho_esperado: "10-20% da base"
+
+    - cohort: "email_frio"
+      label: "Email Frio"
+      criteria: "Sem abrir email nos ultimos 30 dias"
+      sub_criteria:
+        - "Ainda nao deu unsubscribe"
+        - "Email valido (nao bounced)"
+      tamanho_esperado: "30-50% da lista"
+
+    - cohort: "whatsapp_frio"
+      label: "WhatsApp Frio"
+      criteria: "Sem engajar WhatsApp nos ultimos 30 dias"
+      sub_criteria:
+        - "Numero valido"
+        - "Nao deu opt-out"
+      tamanho_esperado: "20-40% da lista"
+
+  # ---------------------------------------------------------------------------
+  # SEQUENCIA DE STEPS
+  # ---------------------------------------------------------------------------
+  sequence:
+
+    # =========================================================================
+    # FASE 1 — IDENTIFICACAO DE COHORTS INATIVOS (@cronos)
+    # =========================================================================
+    - step: identificar_cohorts
+      phase: 1
+      agent: "@cronos"
+      action: "*identificar-cohorts-inativos"
+      description: >
+        Analisa a base de clientes e leads para identificar cohorts
+        inativos. Segmenta por: tempo de inatividade (30d, 60d, 90d),
+        tipo de inatividade (sem compra, sem abrir email, sem engajar
+        WhatsApp), valor historico do cliente (LTV), ultimo produto
+        comprado.
+      inputs:
+        - "Base de clientes (CRM, gateway de pagamento)"
+        - "Metricas de email (opens, clicks por contato)"
+        - "Metricas de WhatsApp (respostas, engajamento)"
+        - "Historico de compras"
+      outputs:
+        - "docs/reativacao/cohorts-inativos.md"
+        - "docs/reativacao/cohorts-stats.md"
+      requires: null
+      next: analise_valor_cohort
+      on_failure: "Segmentar por tempo de inatividade apenas (sem LTV)"
+      validation:
+        type: checklist
+        criteria: >
+          Cohorts identificados com: quantidade por cohort, valor
+          medio do cliente (se disponivel), ultimo ponto de contato,
+          canal preferido, produto mais recente comprado.
+
+    - step: analise_valor_cohort
+      phase: 1
+      agent: "@cronos"
+      action: "*analisar-valor-cohorts"
+      description: >
+        Analisa valor potencial de cada cohort: receita estimada se
+        reativado, custo estimado de reativacao, ROI esperado por
+        cohort, prioridade de reativacao. Define quais cohorts
+        valem o investimento.
+      inputs:
+        - "docs/reativacao/cohorts-inativos.md"
+        - "docs/reativacao/cohorts-stats.md"
+        - "Custos de aquisicao originais (CAC historico)"
+      outputs:
+        - "docs/reativacao/analise-valor-cohorts.md"
+      requires: identificar_cohorts
+      next: estrategia_30d
+      on_failure: "Priorizar por tamanho do cohort"
+      validation:
+        type: checklist
+        criteria: >
+          Cada cohort com: receita potencial estimada, custo de
+          reativacao estimado, ROI esperado, prioridade (alta/media/baixa),
+          recomendacao (reativar/manter/limpar).
+
+    # =========================================================================
+    # FASE 2 — ESTRATEGIA POR COHORT (@atena)
+    # =========================================================================
+    - step: estrategia_30d
+      phase: 2
+      agent: "@atena"
+      action: "*estrategia-cohort-30d"
+      description: >
+        Define estrategia de reativacao para cohort 30 dias: oferta de
+        conteudo exclusivo (video, ebook, template premium). Abordagem
+        suave focada em valor — esses leads ainda estao quentes.
+        Tom: "sentimos sua falta, olha o que preparamos pra voce".
+      inputs:
+        - "docs/reativacao/analise-valor-cohorts.md"
+        - "docs/estrategia/avatar-profile.md (se existir)"
+        - "Catalogo de conteudos/recursos disponiveis"
+      outputs:
+        - "docs/reativacao/estrategia-30d.md"
+      requires: analise_valor_cohort
+      next: estrategia_60d
+      on_failure: "Usar conteudo existente reempacotado"
+      validation:
+        type: checklist
+        criteria: >
+          Estrategia com: oferta definida (conteudo exclusivo), canal
+          primario (email + WhatsApp), tom de comunicacao, sequencia
+          de touchpoints (3-5), metricas de sucesso (re-engajamento
+          rate, conversao), timeline (7 dias).
+        oferta_30d:
+          tipo: "Conteudo exclusivo / valor gratuito"
+          exemplos:
+            - "Video/aula exclusiva nao publicada"
+            - "Template/ferramenta util"
+            - "Ebook com conteudo premium"
+            - "Acesso antecipado a novo conteudo"
+          tom: "Valor-first, sem pressao de venda"
+
+    - step: estrategia_60d
+      phase: 2
+      agent: "@atena"
+      action: "*estrategia-cohort-60d"
+      description: >
+        Define estrategia de reativacao para cohort 60 dias: oferta de
+        desconto moderado (15-30%) no produto principal ou em produto
+        complementar. Abordagem mais direta com incentivo financeiro.
+        Tom: "oferta especial para voce voltar".
+      inputs:
+        - "docs/reativacao/analise-valor-cohorts.md"
+        - "docs/estrategia/oferta-completa.md (se existir)"
+      outputs:
+        - "docs/reativacao/estrategia-60d.md"
+      requires: estrategia_30d
+      next: estrategia_90d
+      on_failure: "Oferecer bonus extra em vez de desconto"
+      validation:
+        type: checklist
+        criteria: >
+          Estrategia com: oferta definida (desconto + justificativa),
+          percentual de desconto, produto alvo, canal primario,
+          sequencia de touchpoints (3-5), deadline da oferta,
+          metricas de sucesso.
+        oferta_60d:
+          tipo: "Desconto moderado com deadline"
+          exemplos:
+            - "15-30% de desconto no produto principal"
+            - "Produto complementar com desconto"
+            - "Upgrade com preco reduzido"
+            - "Bundle exclusivo por tempo limitado"
+          tom: "Oferta especial com urgencia moderada"
+
+    - step: estrategia_90d
+      phase: 2
+      agent: "@atena"
+      action: "*estrategia-cohort-90d"
+      description: >
+        Define estrategia de reativacao para cohort 90 dias: oferta
+        irrecusavel (maior desconto, bonus extras, condicao unica).
+        Ultima tentativa antes de considerar o lead perdido.
+        Tom: "ultima chance" com urgencia real.
+      inputs:
+        - "docs/reativacao/analise-valor-cohorts.md"
+        - "docs/estrategia/oferta-completa.md (se existir)"
+      outputs:
+        - "docs/reativacao/estrategia-90d.md"
+      requires: estrategia_60d
+      next: copy_email_reativacao
+      on_failure: "Considerar lista cleaning em vez de reativacao"
+      validation:
+        type: checklist
+        criteria: >
+          Estrategia com: oferta irrecusavel definida, justificativa
+          do desconto agressivo, deadline curto (48-72h), canais
+          multiplos (email + WhatsApp + retargeting), metricas,
+          plano para quem nao reativar (limpeza de lista).
+        oferta_90d:
+          tipo: "Oferta irrecusavel — ultima tentativa"
+          exemplos:
+            - "40-60% de desconto (maior possivel)"
+            - "Bonus exclusivos nao disponibilizados antes"
+            - "Condicao de pagamento especial"
+            - "Garantia estendida"
+          tom: "Urgencia real, ultima oportunidade, FOMO"
+          post_nao_reativacao: "Mover para lista fria / limpeza"
+
+    # =========================================================================
+    # FASE 3 — COPY DE REATIVACAO (@apolo)
+    # =========================================================================
+    - step: copy_email_reativacao
+      phase: 3
+      agent: "@apolo"
+      action: "*escrever-email-reativacao"
+      description: >
+        Escreve sequencias de email de reativacao para cada cohort.
+        Cada sequencia com 3-5 emails progressivos. Cohort 30d:
+        valor. Cohort 60d: desconto. Cohort 90d: ultima chance com
+        countdown e FOMO.
+      inputs:
+        - "docs/reativacao/estrategia-30d.md"
+        - "docs/reativacao/estrategia-60d.md"
+        - "docs/reativacao/estrategia-90d.md"
+        - "docs/estrategia/avatar-profile.md (se existir)"
+      outputs:
+        - "docs/reativacao/copy/emails-30d.md"
+        - "docs/reativacao/copy/emails-60d.md"
+        - "docs/reativacao/copy/emails-90d.md"
+      requires: estrategia_90d
+      next: copy_whatsapp_reativacao
+      on_failure: "Reduzir para 2 emails por cohort (abertura + ultima chance)"
+      validation:
+        type: checklist
+        criteria: >
+          Cada cohort com 3-5 emails: subject line, preview text,
+          body copy, CTA, timing entre emails, personalizacao com
+          variaveis (nome, ultimo produto, data ultima compra).
+        email_sequences:
+          cohort_30d:
+            emails: 3
+            tom: "Valor e reconexao"
+            progressao: "Valor → mais valor → convite suave"
+          cohort_60d:
+            emails: 4
+            tom: "Oferta e incentivo"
+            progressao: "Reconexao → oferta → lembrete → deadline"
+          cohort_90d:
+            emails: 5
+            tom: "Urgencia e ultima chance"
+            progressao: "Reconexao → oferta forte → countdown → last chance → despedida"
+            countdown: true
+            last_chance: true
+
+    - step: copy_whatsapp_reativacao
+      phase: 3
+      agent: "@apolo"
+      action: "*escrever-whatsapp-winback"
+      description: >
+        Escreve mensagens de WhatsApp win-back para cada cohort.
+        Mensagens curtas, pessoais, com variantes. Cohort 90d inclui
+        countdown e mensagem "last chance" com timer.
+      inputs:
+        - "docs/reativacao/estrategia-30d.md"
+        - "docs/reativacao/estrategia-60d.md"
+        - "docs/reativacao/estrategia-90d.md"
+      outputs:
+        - "docs/reativacao/copy/whatsapp-30d.md"
+        - "docs/reativacao/copy/whatsapp-60d.md"
+        - "docs/reativacao/copy/whatsapp-90d.md"
+      requires: copy_email_reativacao
+      next: compliance_reativacao
+      on_failure: "Focar WhatsApp apenas no cohort 90d (maior urgencia)"
+      validation:
+        type: checklist
+        criteria: >
+          Cada cohort com 2-3 mensagens WhatsApp: texto curto (max 300
+          chars), emojis estrategicos, variaveis de personalizacao,
+          formatacao WhatsApp, CTA claro, opt-out respeitado.
+        whatsapp_sequences:
+          cohort_30d:
+            mensagens: 2
+            conteudo: "Link para conteudo exclusivo + check-in"
+          cohort_60d:
+            mensagens: 2
+            conteudo: "Oferta com deadline + lembrete"
+          cohort_90d:
+            mensagens: 3
+            conteudo: "Oferta forte + countdown + last chance com timer"
+            countdown: true
+            timer_message: "{{nome}}, sua oferta expira em {{horas}} horas"
+
+    # =========================================================================
+    # FASE 4 — EXECUCAO E MEDICAO
+    # =========================================================================
+    - step: compliance_reativacao
+      phase: 4
+      agent: "@temis"
+      action: "*compliance-reativacao"
+      description: >
+        Revisao de compliance de todas as sequencias de reativacao:
+        LGPD (base legal para recontato), frequencia de envio,
+        mecanismo de opt-out, claims nas ofertas, WhatsApp policies.
+      inputs:
+        - "docs/reativacao/copy/emails-30d.md"
+        - "docs/reativacao/copy/emails-60d.md"
+        - "docs/reativacao/copy/emails-90d.md"
+        - "docs/reativacao/copy/whatsapp-30d.md"
+        - "docs/reativacao/copy/whatsapp-60d.md"
+        - "docs/reativacao/copy/whatsapp-90d.md"
+      outputs:
+        - "docs/reativacao/compliance/compliance-report.md"
+        - "docs/reativacao/compliance/alteracoes-obrigatorias.md"
+      requires: copy_whatsapp_reativacao
+      next: aplicar_compliance_reativacao
+      on_failure: "Bloquear envio ate compliance resolvido"
+      validation:
+        type: verdict
+        criteria: >
+          APROVADO: Todas as sequencias em compliance.
+          AJUSTES: Correcoes menores listadas.
+          BLOQUEADO: Violacoes de LGPD ou anti-spam criticas.
+        compliance_checks:
+          - "Base legal para recontato (LGPD Art. 7)"
+          - "Opt-out funcional em todo email"
+          - "Opt-out respeitado no WhatsApp"
+          - "Frequencia de envio dentro do aceitavel"
+          - "Claims de desconto verdadeiros (CDC)"
+          - "Countdown/timer com deadline real"
+          - "Dados pessoais usados com consentimento"
+
+    - step: aplicar_compliance_reativacao
+      phase: 4
+      agent: "@apolo"
+      action: "*aplicar-correcoes-reativacao"
+      description: >
+        Aplica correcoes de compliance nas sequencias de reativacao.
+      inputs:
+        - "docs/reativacao/compliance/alteracoes-obrigatorias.md"
+        - "Todos os assets de copy afetados"
+      outputs:
+        - "docs/reativacao/compliance/compliance-applied-log.md"
+      requires: compliance_reativacao
+      next: configurar_retargeting
+      on_failure: "Escalar para @temis re-revisao"
+      validation:
+        type: checklist
+        criteria: "Todas as correcoes aplicadas e documentadas."
+
+    - step: configurar_retargeting
+      phase: 4
+      agent: "@hermes"
+      action: "*configurar-retargeting-reativacao"
+      description: >
+        Configura campanhas de retargeting no Meta Ads para cada cohort:
+        Custom Audiences por cohort, criativos alinhados com a oferta
+        de cada cohort, bid strategy, budget por cohort, frequencia
+        controlada.
+      inputs:
+        - "docs/reativacao/estrategia-30d.md"
+        - "docs/reativacao/estrategia-60d.md"
+        - "docs/reativacao/estrategia-90d.md"
+        - "docs/reativacao/copy/emails-30d.md (para alinhamento de mensagem)"
+      outputs:
+        - "docs/reativacao/retargeting/campanha-retargeting.md"
+        - "docs/reativacao/retargeting/publicos-custom.md"
+      requires: aplicar_compliance_reativacao
+      next: medir_resultado_reativacao
+      on_failure: "Focar retargeting apenas no cohort 90d"
+      validation:
+        type: checklist
+        criteria: >
+          Campanha com: Custom Audience por cohort, criativos alinhados
+          com oferta do cohort, bid strategy conservadora (cohort frio =
+          bid mais baixo), frequencia max 2/semana, budget proporcional
+          ao valor do cohort, exclusoes entre cohorts.
+
+    - step: medir_resultado_reativacao
+      phase: 4
+      agent: "@cronos"
+      action: "*medir-resultado-reativacao"
+      description: >
+        Mede resultado das campanhas de reativacao apos 30 dias:
+        taxa de reativacao por cohort, receita recuperada, custo de
+        reativacao, ROI por cohort, leads que devem ser limpos da base.
+      inputs:
+        - "docs/reativacao/cohorts-stats.md (baseline)"
+        - "Metricas de email (opens, clicks, conversoes por cohort)"
+        - "Metricas de WhatsApp (respostas, conversoes por cohort)"
+        - "Metricas de retargeting (impressoes, cliques, conversoes)"
+        - "Receita atribuida a reativacao"
+      outputs:
+        - "docs/reativacao/resultado-reativacao.md"
+        - "docs/reativacao/recomendacoes-pos-ciclo.md"
+      requires: configurar_retargeting
+      next: null
+      on_failure: "Gerar report parcial com dados disponiveis"
+      validation:
+        type: checklist
+        criteria: >
+          Report com: taxa de reativacao por cohort, receita recuperada
+          total, custo total da campanha, ROI por cohort, comparacao
+          com benchmark, recomendacoes (quais cohorts continuar, quais
+          limpar), aprendizados para proximo ciclo.
+        metricas_report:
+          por_cohort:
+            - "Taxa de reativacao (%)"
+            - "Receita recuperada (R$)"
+            - "Custo de reativacao (R$)"
+            - "ROI do cohort"
+            - "Canal mais efetivo (email/WhatsApp/retargeting)"
+          global:
+            - "Total reativado"
+            - "Receita total recuperada"
+            - "ROI global do ciclo"
+            - "Leads para limpeza de base"
+          recomendacoes:
+            - "Cohorts para proximo ciclo"
+            - "Ofertas que funcionaram melhor"
+            - "Canais mais efetivos por cohort"
+            - "Frequencia ideal de ciclos de reativacao"
+
+  # ---------------------------------------------------------------------------
+  # CONFIGURACAO GLOBAL
+  # ---------------------------------------------------------------------------
+  config:
+    cohort_periods: [30, 60, 90]
+    measurement_period: "30 dias"
+    compliance_blocking: true
+    multi_channel: true
+    channels: ["email", "whatsapp", "retargeting"]
+    cycle_frequency: "trimestral"
+
+  failure_handling:
+    global_escalation: "@atena"
+    max_retries_per_step: 2
+    on_critical_failure: "Pausar envios, preservar lista, notificar usuario"
+    on_lgpd_violation: "BLOQUEAR IMEDIATAMENTE — risco legal"