@lucapimenta/copy-chief-black 1.0.0

package/framework/skills/helix-system-agent/references/core/metodologias.md

@@ -0,0 +1,201 @@
+# Metodologias Integradas do HELIX System
+
+O HELIX integra 4 metodologias de copywriting de elite para criar briefings estratégicos completos.
+
+## RMBC Method
+
+Autor: Stefan Georgi — Taxa de sucesso de 80% vs média de mercado de 30-40%.
+
+### Estrutura Core
+
+Research -> Mechanism -> Brief -> Copy
+
+### MUP (Mecanismo Único do Problema)
+
+A razão REAL pela qual o problema existe — a causa raiz que ninguém fala.
+
+Componentes:
+- Nova Causa Tangível: Vilão/inimigo específico e nomeável
+- Novo Paradigma: Shift de perspectiva que muda tudo
+- Metáfora/Analogia: Explicação visual que gruda na mente
+
+3 Critérios de Validação:
+1. Facilmente digerível e transferível? (Explicável em 1-2 frases)
+2. Genuinamente interessante e único? (Gera reação "wow")
+3. Intuitivamente E empiricamente provável? (Faz sentido lógico + tem base)
+
+### MUS (Mecanismo Único da Solução)
+
+Por que ESTE método/produto resolve o problema diferente de tudo que existe.
+
+Espelho do MUP: MUS deve endereçar diretamente o MUP. Se o MUP é "toxinas bloqueiam receptores", o MUS deve ser "desbloqueia receptores removendo toxinas".
+
+### Background Story
+
+História pessoal que conecta emocionalmente, estabelece credibilidade, demonstra o mecanismo em ação e faz transição natural para a solução.
+
+### Horror Stories
+
+Histórias de consequências de NÃO agir. Amplificam urgência, mostram o que acontece se ignorar o problema, usam linguagem visceral do avatar.
+
+## 16-Word Sales Letter
+
+Autor: Evaldo Albuquerque — Gênio da copy de saúde.
+
+### Fórmula One Belief
+
+```
+"[NOVA OPORTUNIDADE] é a chave para [DESEJO] e só é alcançável através de [MEU MECANISMO]."
+```
+
+Teste de validação: Se acreditar nisso, VAI comprar. Se não acreditar, não comprará.
+
+### 10 Perguntas Sequenciais
+
+1. Qual o DESEJO mais profundo?
+2. Qual o MAIOR MEDO relacionado?
+3. Qual a FRUSTRAÇÃO dominante com soluções anteriores?
+4. Qual a CRENÇA LIMITANTE que impede ação?
+5. Qual a NOVA OPORTUNIDADE que apresento?
+6. Qual o MECANISMO que prova que funciona?
+7. Qual o VILÃO que causa o problema?
+8. Qual a PROVA de que minha solução funciona?
+9. Qual a URGÊNCIA para agir agora?
+10. Qual o RISCO de não comprar?
+
+### Vilão/Inimigo Externo
+
+Tira culpa do avatar (não é sua culpa), cria "nós vs eles" (aliança com prospect), dá permissão para tentar de novo, deve ter nome chiclete memorável.
+
+### Pattern Interrupt
+
+Quebra de padrão nos primeiros segundos que desarma ceticismo, captura atenção e diferencia de outras VSLs.
+
+## Quick Start System
+
+Autor: Clayton Makepeace — Lenda viva do DR copy.
+
+### DRE (Dominant Resident Emotion)
+
+A emoção que MORA no avatar ANTES de ver sua copy.
+
+Identificação:
+- Qual emoção ele sente ao acordar pensando no problema?
+- Qual emoção você vai AMPLIFICAR na copy?
+- Qual emoção vai TRANSFORMAR em ação de compra?
+
+Manifestações específicas:
+- Físicas (sensações corporais)
+- Comportamentais (o que faz/evita)
+- Relacionais (como afeta convivência)
+- Mentais (pensamentos recorrentes)
+
+### Arsenal de Provas (7 Categorias)
+
+1. Estudos científicos — Pesquisas, dados, estatísticas
+2. Depoimentos/casos — Histórias reais de transformação
+3. Credenciais do especialista — Formação, experiência, reconhecimento
+4. Demonstrações — Antes/depois, testes, comparações
+5. Lógica/razão — Explicações que fazem sentido
+6. Autoridades externas — Citações de especialistas, mídia
+7. Garantias — Reversão de risco
+
+### Processo A-B-C
+
+Progressão lógica de argumentação:
+- Attention (Atenção): Gancho que captura
+- Bridge (Ponte): Conexão emocional + credibilidade
+- Close (Fechamento): Oferta irresistível + CTA
+
+### 6-Question Litmus Test (Headlines)
+
+1. Oferece RECOMPENSA por ler?
+2. Tem ESPECÍFICOS que intrigam?
+3. Dispara EMOÇÃO FORTE existente?
+4. Tem elemento de INTRIGA?
+5. É CLARA e simples?
+6. Conecta com EVENTOS ATUAIS?
+
+Meta: Passar em pelo menos 4 das 6.
+
+## Puzzle Pieces
+
+Autor: Diogo Ramalho — Framework brasileiro de alta conversão.
+
+### 7 Passos do Briefing
+
+1. Nicho + Linguagem específica
+2. Formato + Tom + Personagens
+3. Problema + Vilão + Mecanismo Único
+4. Reason Why do Produto
+5. Hack de Oferta
+6. Elementos do Fechamento
+7. Validação Final
+
+### 4 Camadas do Mecanismo
+
+1. Hero Ingredient: O componente principal que faz funcionar
+2. Gimmick Name: Nome chiclete (curiosidade + prova implícita)
+3. Origin Story: De onde veio, como foi descoberto (credibilidade)
+4. Authority Hook: Gancho de autoridade derivado
+
+### Fórmula do Gancho da Solução
+
+```
+"Já ouviu falar desse [GIMMICK NAME] que [ORIGEM] estão usando secretamente para [DESEJO]? Já estão chamando isso de [AUTHORITY HOOK]."
+```
+
+### Reason Why do Produto
+
+Justificativas que respondem:
+- Por que esse produto existe?
+- Por que esse formato específico?
+- Por que esse preço?
+- Por que disponível agora?
+
+### Hack de Oferta
+
+Elementos que aumentam percepção de valor: Bônus estratégicos (relacionados, não aleatórios), ancoragem de preço, urgência genuína, escassez real.
+
+## Integração das Metodologias
+
+### Por Fase do Briefing
+
+Fase 1-2: RMBC (Research) + Puzzle Pieces (Nicho + Linguagem)
+Fase 3: 16-Word (10 Perguntas) + Quick Start (DRE)
+Fase 5: RMBC (MUP) + 16-Word (Vilão) + Puzzle Pieces (Problema + Mecanismo)
+Fase 6: RMBC (MUS) + 16-Word (Mecanismo) + Quick Start (Arsenal de Provas) + Puzzle Pieces (4 Camadas)
+Fase 7: Puzzle Pieces (Reason Why + Hack)
+Fase 8: Quick Start (Processo A-B-C) + Puzzle Pieces (Fechamento)
+Fase 9: 16-Word (Pattern Interrupt) + Quick Start (6-Question Test) + Puzzle Pieces (Fórmula do Gancho)
+Fase 10: RMBC (Background Story) + 16-Word (One Belief)
+
+### Checklist de Validação Integrado
+
+<rmbc_checklist>
+- MUP passa nos 3 critérios?
+- MUS é espelho do MUP?
+- Horror stories presentes?
+- Background story conecta?
+</rmbc_checklist>
+
+<16word_checklist>
+- One Belief completo e testável?
+- Vilão com nome chiclete?
+- 10 Perguntas respondidas?
+- Pattern Interrupt planejado?
+</16word_checklist>
+
+<quickstart_checklist>
+- DRE identificada com manifestações?
+- Arsenal de provas por categoria?
+- 6-Question Test passa em 4+?
+- Processo A-B-C mapeado?
+</quickstart_checklist>
+
+<puzzle_checklist>
+- 4 Camadas do Mecanismo completas?
+- Fórmula do Gancho preenchida?
+- Reason Why do Produto?
+- Hack de Oferta considerado?
+</puzzle_checklist>

package/framework/skills/helix-system-agent/references/core/output_format.md

@@ -0,0 +1,339 @@
+# Formato de Output HELIX
+
+Especificação de outputs intermediários otimizados para consumo por humanos E outros agentes Claude.
+
+## Princípios de Output
+
+### 1. Dual-Purpose Design
+
+Todo output deve ser:
+- Legível por humano: Estrutura clara, campos descritivos
+- Parseável por agente: YAML válido, schema consistente, tipos explícitos
+
+### 2. Checkpoints Obrigatórios
+
+Cada fase produz checkpoint que serve de input para próxima fase.
+
+```
+Fase N -> checkpoint_faseN.yaml -> Fase N+1
+```
+
+### 3. Confidence Scoring
+
+Todo output inclui nível de confiança:
+
+- 0.9-1.0: Extraído diretamente de fonte primária
+- 0.7-0.9: Inferido com alta certeza
+- 0.5-0.7: Inferido com incerteza
+- Menor que 0.5: Especulativo (requer validação)
+
+## Schema de Checkpoint por Fase
+
+### Fase 1: Identificação
+
+```yaml
+meta:
+  phase: "01_identificacao"
+  timestamp: "2026-01-06T14:30:00Z"
+  status: complete
+  confidence: 0.95
+
+oferta:
+  nome_produto: "string"
+  nicho: "ED|EMAG|FINANCAS|RELACIONAMENTO|CONCURSOS|OUTRO"
+  subnicho: "string"
+  modelo_negocio: "Infoproduto|SaaS|Fisico|Hibrido"
+  ticket: "R$ number"
+  
+cliente:
+  nome: "string"
+  empresa: "string|null"
+  materiais_recebidos:
+    - tipo: "briefing|pesquisa|vsl_referencia|reviews"
+      arquivo: "path/to/file"
+      processado: true
+
+next_phase_inputs:
+  nicho_definido: true
+  materiais_organizados: true
+  gaps_criticos: []
+```
+
+### Fase 2: Mineração (Checkpoint Principal)
+
+```yaml
+meta:
+  phase: "02_mineracao"
+  timestamp: "2026-01-06T14:30:00Z"
+  status: complete
+  confidence: 0.85
+  total_ads_processados: 312
+  total_competidores_encontrados: 45
+
+competidores_top10:
+  - rank: 1
+    page_name: "string"
+    page_id: "string"
+    
+    scale_score: 42.5
+    ads_same_url: 12
+    ads_same_video: 8
+    days_running: 45
+    
+    top_url: "https://..."
+    ad_library_link: "https://www.facebook.com/ads/library/?id=..."
+    
+    funnel_type: "VSL|TSL|Quiz|Hibrido"
+    checkout_platform: "Hotmart|Kiwify|Monetizze|Eduzz|Cakto|Proprio"
+    
+    cloaking_detected: false
+    cloaking_evidence: []
+    
+    headline: "string|null"
+    promise_central: "string|null"
+    mup_apparent: "string|null"
+    mus_apparent: "string|null"
+    
+    weaknesses:
+      - "string"
+    
+    data_confidence: 0.85
+
+competidores_cloaked:
+  - page_name: "string"
+    page_id: "string"
+    scale_score: 38.0
+    cloaking_evidence:
+      - "content_mismatch"
+      - "fingerprint_scripts"
+    extracted_from_ad:
+      headline: "string"
+      body_copy: "string"
+    bypass_recommendation: "Anti-detect + residential proxy"
+
+analise_mercado:
+  saturacao_geral: "ALTA|MEDIA|BAIXA"
+  formato_dominante: "VSL|TSL|Quiz"
+  ticket_medio: "R$ number"
+  mup_patterns:
+    - pattern: "string"
+      frequency: 3
+  mus_patterns:
+    - pattern: "string"
+      frequency: 2
+  gaps_identificados:
+    - "string"
+  oportunidades:
+    - "string"
+
+next_phase_inputs:
+  top3_para_modelar:
+    - "page_name_1"
+    - "page_name_2"
+    - "page_name_3"
+  linguagem_voc_extraida: true
+  angulos_validados:
+    - "string"
+  angulos_saturados:
+    - "string"
+```
+
+### Fase 3: Avatar e Psicologia
+
+```yaml
+meta:
+  phase: "03_avatar"
+  timestamp: "2026-01-06T14:30:00Z"
+  status: complete
+  confidence: 0.80
+
+avatar:
+  nome_persona: "string"
+  idade_range: "25-45"
+  genero: "M|F|Ambos"
+  
+  situacao_atual:
+    profissional: "string"
+    financeira: "string"
+    relacionamento: "string"
+    saude: "string"
+  
+  dre: "string"
+  dre_intensidade: 0.85
+  
+  medos_primarios:
+    - medo: "string"
+      intensidade: 0.9
+    - medo: "string"
+      intensidade: 0.7
+      
+  desejos_primarios:
+    - desejo: "string"
+      intensidade: 0.9
+    - desejo: "string"
+      intensidade: 0.8
+  
+  crencas_limitantes:
+    - crenca: "string"
+      origem: "string"
+  
+  one_belief_target: "string"
+  
+  vocabulario_real:
+    - "frase exata de review/comentario"
+  
+  expressoes_comuns:
+    - "expressao"
+
+next_phase_inputs:
+  dre_definida: true
+  one_belief_definido: true
+  linguagem_mapeada: true
+```
+
+### Fase 5: MUP (Mecanismo Único do Problema)
+
+```yaml
+meta:
+  phase: "05_mup"
+  timestamp: "2026-01-06T14:30:00Z"
+  status: complete
+  confidence: 0.90
+
+mup:
+  statement: "string (1-2 frases)"
+  
+  componentes:
+    causa_raiz: "string"
+    paradigm_shift: "string"
+    vilao_externo: "string"
+  
+  validacao_rmbc:
+    facilmente_digerivel: true
+    genuinamente_unico: true
+    intuitivamente_provavel: true
+    
+  origem: "CRIADO|MODELADO|REF:swipe_nome"
+  
+  conexao_dre: "Como o MUP amplifica a DRE"
+  conexao_one_belief: "Como o MUP prepara a mudanca de crenca"
+
+next_phase_inputs:
+  mup_validado: true
+  vilao_definido: true
+  pronto_para_mus: true
+```
+
+### Fase 6: MUS (Mecanismo Único da Solução)
+
+```yaml
+meta:
+  phase: "06_mus"
+  timestamp: "2026-01-06T14:30:00Z"
+  status: complete
+  confidence: 0.90
+
+mus:
+  statement: "string (1-2 frases)"
+  
+  quatro_camadas:
+    hero_ingredient:
+      nome: "string"
+      descricao: "string"
+      proof_path: "string"
+    
+    gimmick_name:
+      nome: "string"
+      memorabilidade: 0.9
+    
+    origin_story:
+      narrativa_curta: "string"
+      credibilidade: 0.85
+    
+    authority_hook:
+      autoridade: "string"
+      tipo: "Pessoal|Cientifica|Social|Celebridade"
+  
+  validacao_rmbc:
+    facilmente_digerivel: true
+    genuinamente_unico: true
+    intuitivamente_provavel: true
+  
+  espelhamento_mup:
+    mup_statement: "string"
+    mus_statement: "string"
+    conexao_direta: true
+    
+  origem: "CRIADO|MODELADO|REF:swipe_nome"
+
+next_phase_inputs:
+  mus_validado: true
+  espelhamento_confirmado: true
+  pronto_para_big_offer: true
+```
+
+## Formato de Output Final (Fase Completa)
+
+Quando uma fase é completada e entregue ao usuário:
+
+```markdown
+# Fase [N]: [Nome da Fase]
+
+## Status
+- Preenchimento: Completo
+- Confianca: 85%
+- Origem: [EXTRAIDO|MODELADO|CRIADO]
+
+## Output Principal
+
+[Conteudo do template preenchido 1:1]
+
+## Checkpoint Salvo
+
+Arquivo: checkpoint_fase[N].yaml
+Pronto para: Fase [N+1]
+
+## Gaps Identificados (se houver)
+
+- [Gap 1 - requer input manual]
+- [Gap 2 - requer validacao]
+
+## Self-Critique
+
+### O que esta forte:
+- [Ponto forte 1]
+- [Ponto forte 2]
+
+### O que pode melhorar:
+- [Ponto de melhoria 1]
+- [Ponto de melhoria 2]
+
+### Teste de Acionabilidade:
+"Um copywriter junior conseguiria escrever uma VSL so com este briefing?"
+Resposta: [SIM/PARCIALMENTE/NAO] - [Justificativa]
+```
+
+## Marcadores de Origem
+
+- [REF: swipe_nome]: Padrão extraído de SWIPE validada
+- [BASE: fundamento]: Conceito de material teórico
+- [MODELADO: fonte]: Estrutura adaptada (não copiada)
+- [CRIADO]: Elemento original HELIX
+- [EXTRAIDO: fonte]: Dado extraído diretamente
+- [PREENCHER: motivo]: Último recurso, requer input manual
+
+## Validação de Output
+
+Antes de entregar qualquer fase, verificar:
+
+```yaml
+checklist_entrega:
+  estrutura_1_1: true
+  especificidade: true
+  modelagem_nao_copia: true
+  dados_nao_inventados: true
+  mup_mus_espelhados: true
+  self_critique_feita: true
+  checkpoint_salvo: true
+  proximo_passo_claro: true
+```

package/framework/skills/helix-system-agent/references/core/session_management.md

@@ -0,0 +1,146 @@
+# Gestão de Sessões do HELIX System
+
+## Divisão em 3 Sessões
+
+Para evitar degradação de contexto em briefings completos, divida em 3 sessões:
+
+Sessão 1 - Fundação: Fases 1-4 (Identificação, Pesquisa, Avatar, Níveis de Consciência). Output: HELIX-STATE.json + Briefing Parcial.
+
+Sessão 2 - Mecanismos: Fases 5-7 (MUP, MUS, Big Offer). Output: HELIX-STATE.json + Briefing Parcial.
+
+Sessão 3 - Execução: Fases 8-10 (Fechamento, Leads/Ganchos, Progressão Emocional). Output: Briefing Final Completo.
+
+## HELIX-STATE.json
+
+Arquivo de handoff entre sessões que preserva contexto crítico.
+
+### Formato
+
+```json
+{
+  "projeto": {
+    "cliente": "",
+    "oferta": "",
+    "nicho": "",
+    "sessao_atual": 1
+  },
+  "fases_completas": [],
+  "fases_parciais": [],
+  "gaps_pendentes": [],
+  "decisoes_chave": {
+    "mup": "",
+    "mus": "",
+    "one_belief": "",
+    "vilao": "",
+    "dre": ""
+  },
+  "swipes_referenciados": [],
+  "conexoes_criticas": [],
+  "ultima_atualizacao": ""
+}
+```
+
+### Campos Explicados
+
+- projeto: Identificação básica do projeto
+- fases_completas: Lista de fases já entregues
+- fases_parciais: Fases com pendências
+- gaps_pendentes: O que falta preencher
+- decisoes_chave: Elementos estratégicos definidos
+- swipes_referenciados: SWIPEs consultados nesta sessão
+- conexoes_criticas: Conexões entre fases que devem ser mantidas
+- ultima_atualizacao: Timestamp da última modificação
+
+## Início de Nova Sessão
+
+1. Solicite HELIX-STATE.json se não fornecido
+2. Carregue contexto das fases anteriores
+3. Confirme entendimento antes de prosseguir
+4. Identifique o que precisa ser revisitado
+
+### Prompt de Continuação
+
+```
+Continuando Sessão [N].
+
+Estado carregado:
+- Projeto: [cliente] - [oferta]
+- Fases completas: [lista]
+- Decisões-chave preservadas:
+  - MUP: [resumo]
+  - MUS: [resumo]
+  - DRE: [resumo]
+
+Próximas fases: [lista]
+
+Posso prosseguir ou há algo para revisar?
+```
+
+## Fim de Cada Sessão
+
+1. Atualize HELIX-STATE.json com novos dados
+2. Liste gaps pendentes
+3. Prepare handoff para próxima sessão
+4. Forneça instruções claras para continuação
+
+### Output de Encerramento
+
+```
+SESSAO [N] COMPLETA
+
+Fases entregues:
+- briefing_fase0X_nome.md [OK]
+- briefing_fase0X_nome.md [OK]
+
+Confiança geral: [Alta/Média/Baixa]
+SWIPEs referenciados: [lista]
+Conexões críticas estabelecidas: [lista]
+
+HELIX-STATE.json atualizado:
+[JSON atualizado]
+
+Para continuar na Sessão [N+1]:
+1. Abra um novo chat
+2. Cole o HELIX-STATE.json acima
+3. Diga "Continuar Sessão [N+1]"
+```
+
+## Conexões Entre Sessões
+
+### Sessão 1 -> Sessão 2
+
+Decisões que DEVEM ser preservadas:
+- DRE (Fase 3): Usada em Fase 5 e 10
+- Vilão identificado (Fase 3): Desenvolvido em Fase 5
+- Linguagem do avatar: Usada em todas as fases seguintes
+- Nível de consciência: Define abordagem do mecanismo
+
+### Sessão 2 -> Sessão 3
+
+Decisões que DEVEM ser preservadas:
+- MUP completo: Referenciado no fechamento
+- MUS com 4 camadas: Base para leads e ganchos
+- Arsenal de provas: Usado no fechamento
+- Estrutura da oferta: Base para pitch
+
+## Recuperação de Contexto Perdido
+
+Se o HELIX-STATE.json não for fornecido:
+
+1. Pergunte por briefings já preenchidos
+2. Identifique decisões-chave nos materiais
+3. Reconstrua HELIX-STATE.json antes de continuar
+4. Valide com usuário antes de prosseguir
+
+### Prompt de Recuperação
+
+```
+Não recebi o HELIX-STATE.json da sessão anterior.
+
+Posso continuar de duas formas:
+
+1. Cole o JSON da sessão anterior (recomendado)
+2. Cole os briefings já preenchidos para que eu reconstrua o contexto
+
+Qual prefere?
+```