drm-core 1.0.0 → 1.2.0

package/scaffold/.drm-core/workflows/copy-review-loop.yaml

@@ -0,0 +1,333 @@
+# =============================================================================
+# COPY REVIEW LOOP — Workflow Iterativo (Loop Max 3)
+# Pipeline: @apolo escreve → @zeus valida → @temis compliance → loop/escala
+# =============================================================================
+
+workflow:
+  id: copy-review-loop
+  name: "Copy Review Loop"
+  version: "1.0"
+  description: >
+    Loop iterativo de revisao de copy com max 3 iteracoes. @apolo escreve,
+    @zeus valida usando copy-quality-gate (score 1-15), @temis revisa
+    compliance. Se score insuficiente, volta para @apolo com feedback
+    especifico. Na 3a falha, escala para @atena que decide entre
+    reescrever do zero, aprovar com ressalvas ou pivotar angulo.
+
+  trigger: manual
+  estimated_duration: "1-2 dias uteis"
+  priority: high
+  type: iterative_loop
+
+  # ---------------------------------------------------------------------------
+  # FASES
+  # ---------------------------------------------------------------------------
+  phases:
+    - phase_1: "Escrita Inicial"
+    - phase_2: "Validacao de Qualidade"
+    - phase_3: "Revisao de Compliance"
+    - phase_loop: "Iteracao de Ajustes (max 3)"
+    - phase_escalation: "Escalacao para @atena"
+
+  # ---------------------------------------------------------------------------
+  # CONFIGURACAO DO LOOP
+  # ---------------------------------------------------------------------------
+  loop_config:
+    max_iterations: 3
+    current_iteration: 0
+    loop_start_step: escrever_copy
+    loop_end_step: compliance_review
+    exit_conditions:
+      - "Score >= 10 E compliance aprovado"
+      - "max_iterations atingido (escala para @atena)"
+    state_file: "docs/copy-review/loop-state.yaml"
+
+  # ---------------------------------------------------------------------------
+  # SCORING
+  # ---------------------------------------------------------------------------
+  scoring:
+    system: "copy-quality-gate"
+    scale: "1-15"
+    dimensions:
+      - name: "Clareza"
+        weight: 1
+        description: "Mensagem clara e facilmente compreensivel"
+      - name: "Persuasao"
+        weight: 2
+        description: "Poder de convencimento e gatilhos emocionais"
+      - name: "Mecanismo"
+        weight: 2
+        description: "Mecanismo unico bem explicado e convincente"
+      - name: "Proof Elements"
+        weight: 1
+        description: "Provas sociais, dados, cases, autoridade"
+      - name: "CTA"
+        weight: 1
+        description: "Call-to-action claro, urgente e especifico"
+      - name: "Consistencia"
+        weight: 1
+        description: "Tom e narrativa consistentes do inicio ao fim"
+      - name: "Hook"
+        weight: 2
+        description: "Poder de atencao nos primeiros 30 segundos"
+    thresholds:
+      aprovado:
+        min_score: 10
+        action: "Prosseguir para compliance"
+        label: "APROVADO"
+      ajustes:
+        min_score: 7
+        max_score: 9
+        action: "Retornar para @apolo com feedback especifico"
+        label: "AJUSTES"
+      reescrever:
+        min_score: 0
+        max_score: 6
+        action: "Escalar para @atena"
+        label: "REESCREVER"
+
+  # ---------------------------------------------------------------------------
+  # SEQUENCIA DE STEPS
+  # ---------------------------------------------------------------------------
+  sequence:
+
+    # =========================================================================
+    # FASE 1 — ESCRITA INICIAL (@apolo)
+    # =========================================================================
+    - step: escrever_copy
+      phase: 1
+      agent: "@apolo"
+      action: "*escrever-copy"
+      description: >
+        Escreve a copy solicitada seguindo o briefing, posicionamento e
+        avatar definidos. Na primeira iteracao, escreve do zero. Nas
+        iteracoes subsequentes, aplica o feedback especifico do @zeus
+        sobre os pontos fracos identificados.
+      inputs:
+        - "Briefing da copy (tipo: VSL, ad, email, pagina)"
+        - "docs/estrategia/avatar-profile.md (se existir)"
+        - "docs/estrategia/posicionamento.md (se existir)"
+        - "docs/copy-review/feedback-iteration-{n}.md (se iteracao > 1)"
+      outputs:
+        - "docs/copy-review/copy-draft-v{n}.md"
+      requires: null
+      next: validar_copy
+      on_failure: "Usar template de copy padrao como base"
+      validation:
+        type: checklist
+        criteria: >
+          Copy completa conforme tipo solicitado, todas as secoes
+          presentes, mecanismo unico articulado, CTA definido.
+      iteration_behavior:
+        first_iteration: "Escrever do zero seguindo briefing"
+        subsequent_iterations: >
+          Aplicar feedback especifico de docs/copy-review/feedback-iteration-{n-1}.md.
+          Focar nas dimensoes com score mais baixo. NAO reescrever
+          secoes que ja atingiram score alto.
+
+    # =========================================================================
+    # FASE 2 — VALIDACAO DE QUALIDADE (@zeus)
+    # =========================================================================
+    - step: validar_copy
+      phase: 2
+      agent: "@zeus"
+      action: "*copy-quality-gate"
+      description: >
+        Avalia a copy usando o sistema de scoring copy-quality-gate.
+        Score de 1-15 baseado em 7 dimensoes. Gera feedback detalhado
+        e especifico para cada dimensao abaixo do esperado.
+      inputs:
+        - "docs/copy-review/copy-draft-v{n}.md"
+        - "docs/estrategia/avatar-profile.md (se existir)"
+        - "docs/estrategia/posicionamento.md (se existir)"
+      outputs:
+        - "docs/copy-review/quality-report-v{n}.md"
+        - "docs/copy-review/feedback-iteration-{n}.md (se score < 10)"
+      requires: escrever_copy
+      next: decision_gate
+      on_failure: "Gerar report com score minimo e feedback generico"
+      validation:
+        type: verdict
+        criteria: >
+          Score >= 10: APROVADO — prosseguir para compliance.
+          Score 7-9: AJUSTES — gerar feedback especifico por dimensao.
+          Score < 7: REESCREVER — escalar se 3a iteracao.
+
+    - step: decision_gate
+      phase: 2
+      agent: "@zeus"
+      action: "*decision-gate"
+      description: >
+        Ponto de decisao baseado no score e numero de iteracoes.
+        Roteia o fluxo para o proximo passo correto: compliance
+        (se aprovado), loop (se ajustes), ou escalacao (se 3a falha
+        ou score muito baixo).
+      inputs:
+        - "docs/copy-review/quality-report-v{n}.md"
+        - "Numero da iteracao atual"
+      outputs:
+        - "docs/copy-review/decision-log.md (append)"
+      requires: validar_copy
+      next: "condicional"
+      on_failure: "Escalar para @atena em caso de erro no gate"
+      validation:
+        type: routing
+        criteria: >
+          Roteamento baseado em score e iteracao.
+        routing_rules:
+          - condition: "score >= 10"
+            next: compliance_review
+            log: "APROVADO — prosseguindo para compliance"
+          - condition: "score 7-9 AND iteracao < 3"
+            next: escrever_copy
+            log: "AJUSTES — iteracao {n+1}, feedback enviado para @apolo"
+            feedback_required:
+              - "Dimensoes com score abaixo da media"
+              - "Exemplo concreto do problema"
+              - "Sugestao especifica de melhoria"
+              - "Secao exata que precisa de ajuste"
+          - condition: "score < 7 AND iteracao < 3"
+            next: escrever_copy
+            log: "REESCREVER — problemas graves identificados"
+            feedback_required:
+              - "Listagem completa de problemas"
+              - "Recomendacao de reescrita por secao"
+              - "Referencia ao briefing original"
+          - condition: "iteracao >= 3 AND score < 10"
+            next: escalacao_atena
+            log: "ESCALACAO — 3 iteracoes sem aprovacao"
+
+    # =========================================================================
+    # FASE 3 — REVISAO DE COMPLIANCE (@temis)
+    # =========================================================================
+    - step: compliance_review
+      phase: 3
+      agent: "@temis"
+      action: "*compliance-copy-review"
+      description: >
+        Revisao de compliance da copy aprovada: claims verificaveis,
+        promessas legais, disclaimers necessarios, CONAR, CDC,
+        politicas da plataforma de destino (Meta, Google, WhatsApp).
+      inputs:
+        - "docs/copy-review/copy-draft-v{n}.md (versao aprovada)"
+        - "docs/copy-review/quality-report-v{n}.md"
+        - "Plataforma de destino (Meta Ads, Google Ads, email, WhatsApp)"
+      outputs:
+        - "docs/copy-review/compliance-report.md"
+        - "docs/copy-review/copy-final.md (se aprovado)"
+        - "docs/copy-review/compliance-fixes.md (se ajustes necessarios)"
+      requires: decision_gate
+      next: finalizar_copy
+      on_failure: "Listar violacoes e retornar para @apolo corrigir"
+      validation:
+        type: verdict
+        criteria: >
+          APROVADO: Copy em compliance total — gerar copy final.
+          AJUSTES: Correcoes menores de compliance — @apolo aplica.
+          BLOQUEADO: Violacoes criticas — retornar para ajustes.
+        compliance_checks:
+          - "Claims de resultado com evidencia ou disclaimer"
+          - "Garantia conforme CDC"
+          - "Sem linguagem discriminatoria"
+          - "Politica de plataforma respeitada"
+          - "Disclaimers obrigatorios presentes"
+
+    - step: finalizar_copy
+      phase: 3
+      agent: "@apolo"
+      action: "*finalizar-copy"
+      description: >
+        Aplica ajustes finais de compliance (se houver) e gera a versao
+        final da copy pronta para uso. Mantem a eficacia da copy
+        enquanto atende todas as exigencias de compliance.
+      inputs:
+        - "docs/copy-review/compliance-fixes.md (se existir)"
+        - "docs/copy-review/copy-draft-v{n}.md"
+      outputs:
+        - "docs/copy-review/copy-final.md"
+        - "docs/copy-review/loop-summary.md"
+      requires: compliance_review
+      next: null
+      on_failure: "Gerar copy final com disclaimers mesmo sem ajustes perfeitos"
+      validation:
+        type: checklist
+        criteria: >
+          Copy final com: todas as correcoes de compliance aplicadas,
+          score de qualidade mantido, versao final marcada, log de
+          iteracoes documentado.
+
+    # =========================================================================
+    # FASE ESCALACAO — DECISAO @atena
+    # =========================================================================
+    - step: escalacao_atena
+      phase: escalation
+      agent: "@atena"
+      action: "*decidir-escalacao-copy"
+      description: >
+        @atena recebe o historico completo das 3 iteracoes, scores,
+        feedbacks e decide entre 3 opcoes: reescrever do zero com novo
+        angulo, aprovar com ressalvas documentadas, ou pivotar o angulo
+        estrategico completamente.
+      inputs:
+        - "docs/copy-review/copy-draft-v1.md"
+        - "docs/copy-review/copy-draft-v2.md"
+        - "docs/copy-review/copy-draft-v3.md"
+        - "docs/copy-review/quality-report-v1.md"
+        - "docs/copy-review/quality-report-v2.md"
+        - "docs/copy-review/quality-report-v3.md"
+        - "docs/copy-review/decision-log.md"
+        - "docs/estrategia/posicionamento.md (se existir)"
+      outputs:
+        - "docs/copy-review/escalation-decision.md"
+      requires: decision_gate
+      next: "condicional"
+      on_failure: "Aprovar com ressalvas como fallback minimo"
+      validation:
+        type: decision
+        criteria: >
+          @atena deve escolher uma das 3 opcoes com justificativa.
+        options:
+          - id: reescrever_zero
+            label: "Reescrever do Zero"
+            description: >
+              Descarta todas as versoes e reinicia o loop com novo
+              angulo estrategico. Reset do contador de iteracoes.
+            next_step: escrever_copy
+            resets_iteration: true
+            max_resets: 1
+            requires: "Novo angulo definido por @atena"
+
+          - id: aprovar_ressalvas
+            label: "Aprovar com Ressalvas"
+            description: >
+              Aprova a melhor versao (maior score) com ressalvas
+              documentadas. Segue para compliance com notas.
+            next_step: compliance_review
+            requires: "Lista de ressalvas documentada"
+
+          - id: pivotar_angulo
+            label: "Pivotar Angulo"
+            description: >
+              Muda completamente o angulo estrategico. Requer novo
+              posicionamento antes de reiniciar o loop.
+            next_step: null
+            triggers_workflow: "Novo briefing estrategico necessario"
+            requires: "Justificativa do pivot e novo angulo sugerido"
+
+  # ---------------------------------------------------------------------------
+  # CONFIGURACAO GLOBAL
+  # ---------------------------------------------------------------------------
+  config:
+    max_iterations: 3
+    max_resets: 1
+    scoring_system: "copy-quality-gate"
+    approval_threshold: 10
+    adjustment_threshold: 7
+    compliance_required: true
+    track_iteration_history: true
+
+  failure_handling:
+    global_escalation: "@atena"
+    on_max_iterations: "Escalar para @atena com historico completo"
+    on_compliance_block: "Retornar para @apolo com fixes especificos"
+    on_critical_failure: "Pausar loop, preservar estado, notificar usuario"