Copy Chief Ecosystem

Copy Chief BLACK v1.4.0

Sistema de orquestração de copywriting de resposta direta. 13 agentes especializados, 10 ferramentas MCP, 65 automações e uma Constitution com princípios inegociáveis — tudo operando em sincronia via Claude Code + framework AIOX.

# Abrir da raiz do ecossistema
$ cd ~/copywriting-ecosystem && claude

# Ativar o orquestrador
> @helix

# Iniciar pesquisa de audiência
> *run-workflow audience-research oferta=oferta-exemplo

# Executar briefing HELIX completo (10 fases, 3 sessões)
> *helix-full

Você decide a estratégia. O squad executa.

Pense no Jarvis do Tony Stark

Tony Stark não solda peças. Não calcula trajetórias manualmente. Não testa ligas metálicas uma por uma. Ele tem o Jarvis — um sistema que executa ordens complexas enquanto o gênio foca no que importa: decisões estratégicas.

O Copy Chief BLACK é o seu Jarvis para copywriting de resposta direta. Um squad com 13 agentes especializados, cada um com autoridade exclusiva sobre sua área, orquestrados pelo Helix através de um pipeline de pesquisa → briefing → produção → validação.

Você dá as ordens estratégicas. O squad executa todo o trabalho pesado:

• Vox extrai 200+ quotes de VOC de múltiplas plataformas
• Cipher minera concorrentes na Meta Ads Library com Scale Score automático
• Atlas conduz as 10 fases do briefing HELIX com análise estratégica profunda
• Echo, Forge, Scout e Blade produzem VSL, Landing Page, criativos e emails
• Hawk valida cada entrega com blind critic, stress test emocional e BLACK validation
• Sentinel bloqueia avanço entre fases se os gates não passarem

Você foca nas decisões estratégicas. O squad executa.

O Squad: 13 Agentes com Autoridade Específica

Cada agente tem escopo definido. Nenhum faz o trabalho do outro.

Agente	Persona	Autoridade
@helix	Chief	Orquestrador do squad, coordena workflows completos
@briefer	Atlas	Conduz as 10 fases do briefing HELIX
@researcher	Vox	Extração de VOC e pesquisa de audiência
@miner	Cipher	Mineração de ads e análise de concorrentes
@vsl	Echo	Produção de VSL capítulo a capítulo
@lp	Forge	Produção de Landing Pages por blocos
@creative	Scout	Criativos, reels e breakdowns estratégicos
@producer	Blade	Sequências de email e automações
@reels	Spark	Reels virais com estrutura hook-corpo-CTA
@critic	Hawk	Validação de qualidade via MCPs especializados
@gatekeeper	Sentinel	Enforcement de gates entre fases
@ops	Ops	Git, infra e operações de sistema
@strategist	Strategist	Design de funil e posicionamento

Arquitetura: Squad-Based com Constitution

O ecossistema não é uma coleção de prompts. É uma infraestrutura com camadas bem definidas:

CONSTITUTION ── Princípios inegociáveis
                DRE-First, Visceral > Lógico, CLI First, No Invention.
                Gates automáticos bloqueiam violações.

AIOX FRAMEWORK ── Orquestração multi-agente
                  Story-driven development, agent authority matrix,
                  boundary rules L1-L4, hooks de enforcement.

SYNAPSE ── Context engine
           Injeta regras dinamicamente por fase via manifest YAML.
           Cada agente recebe apenas o contexto que precisa.

MCP TOOLS (10) ── Ferramentas especializadas por agente
                  voc_search, get_phase_context, validate_gate,
                  blind_critic, emotional_stress_test, write_chapter,
                  layered_review, black_validation, validate_mecanismo,
                  semantic_memory_search.

TASK-MCP MATRIX ── 59 tasks mapeadas em 3 contextos de execução
                   inline / subagent / direct — sem ambiguidade.

HOOKS (65) ── Automações que interceptam ações e forçam qualidade
              PreToolUse, PostToolUse, Stop, PreCompact.
              Sem escapatória.

O Pipeline: 4 Gates Obrigatórios

Copy só avança quando passa. Não existe “quase aprovado”.

RESEARCH GATE
└── Vox extrai VOC → Cipher minera ads → Avatar consolidado
└── Gate: 200+ quotes, 10+ ads analisados, avatar validado

BRIEFING GATE
└── Atlas conduz HELIX 10 fases (3 sessões: Fundação 1-4, Mecanismos 5-7, Execução 8-10)
└── Gate: MUP + MUS aprovados, Mecanismo Único validado, 10 fases completas

PRODUCTION GATE
└── Echo/Forge/Scout/Blade produzem deliverables
└── Gate: blind_critic ≥ 8, EST aprovado, BLACK validation aprovada

DELIVERY GATE
└── Hawk faz revisão em camadas (layered_review)
└── Gate: consistência em 5 lentes, zero genericidade, tom aprovado

Números que Importam

Componente	Quantidade
Agentes especializados	13
Ferramentas MCP	10
Fases HELIX	10
Gates de qualidade	4
Hooks de enforcement	65
Tasks no Task-MCP Matrix	59
Workflows primários	4

Filosofia de Design

“Separar PENSAR de ESCREVER.”

3 a 4 horas de análise estratégica antes de uma única palavra de copy. O sistema força essa separação estruturalmente — você não pode ativar produção sem passar pelo gate de briefing.

Três princípios inegociáveis da Constitution:

DRE-First — Toda copy começa pela Dor/Raiva/Emoção do avatar. Lógica e benefícios vêm depois, nunca antes.

Visceral > Lógico — O sistema rejeita copy que explica quando deveria fazer sentir. Genericidade Score < 8 = refazer automaticamente.

CLI First — Toda inteligência vive no terminal. Dashboards apenas observam. A CLI é a fonte da verdade.

O resultado: um sistema que não deixa você escrever copy ruim por acidente.

Os 4 Gates de Qualidade

Todo o ecossistema gira em torno de um pipeline linear com 4 gates de qualidade obrigatorios. Cada gate e verificado pelo Sentinel — o agente de enforcement que bloqueia transicoes invalidas. Nao ha atalhos, nao ha “so dessa vez”.

IDLE
  │
  ▼ RESEARCH GATE
RESEARCH ────── VOC ✓  Avatar Profile ✓  Competitors ✓  Synthesis ✓
  │
  ▼ BRIEFING GATE
BRIEFING ─────── HELIX 10/10 fases ✓  MUP/MUS validados ✓  BLACK checks ✓
  │
  ▼ PRODUCTION GATE
PRODUCTION ───── Copy deliverables ✓  Hawk review PASS ✓
  │
  ▼ DELIVERY GATE
DELIVERED ─────── Final packaging ✓  Brand ✓

Gate	O que valida	Responsavel
RESEARCH	VOC, perfil de avatar, analise de concorrentes, synthesis.md	Vox + Cipher
BRIEFING	10 fases HELIX completas, MUP/MUS aprovados, checks BLACK	Atlas + Sentinel
PRODUCTION	Todos os deliverables de copy, Hawk review PASS	Echo/Forge/Scout/Blade + Hawk
DELIVERY	Pacote final, brand review, pronto para publicacao	Ops + Sentinel

---

Os 4 Workflows

O ecossistema oferece 4 workflows pre-configurados. Escolha de acordo com o escopo do trabalho.

1. Full Pipeline

Workflow completo para uma nova oferta, do zero ao entregavel.

Phase 0: Init
  └─ Estrutura de diretorios, helix-state.yaml, config da oferta

Phase 1: Research
  └─ Vox (VOC, avatar) + Cipher (concorrentes, ads, swipes)

Phase 2: Briefing
  └─ Atlas (10 fases HELIX, MUP/MUS, mecanismo-unico.yaml)

Phase 3: Production
  └─ Echo (VSL) + Forge (LP) + Scout (criativos) + Blade (emails)

Phase 4: Review
  └─ Hawk (blind_critic + EST + black_validation em cada peca)

Phase 5: Delivery
  └─ Ops (packaging, brand review, entrega)

2. Research-to-Briefing (R2B)

Para ofertas que ja tem estrutura criada e precisam iniciar pelo research.

Vox + Cipher → [RESEARCH GATE] → Atlas → [BRIEFING GATE] → Sentinel

3. Briefing-to-Production (B2P)

Para ofertas com briefing aprovado que precisam partir para producao.

Echo + Forge + Scout + Blade → [PRODUCTION GATE] → Hawk → [DELIVERY GATE] → Sentinel

4. Roteiro Factory

Workflow especializado para clientes advogados que produzem roteiros virais em escala para reels.

1. Add client          — Configurar perfil do cliente
2. Viral angles        — Cipher minera angulos virais do nicho juridico
3. Format mix          — Selecionar mix de formatos (carrossel, talking head, storytime...)
4. Produce batch       — Scout produz roteiros em paralelo
5. QA gate /100        — Hawk avalia cada roteiro com score /100
6. Assemble guide      — Consolidar roteiros aprovados no guia de producao

Modos de execucao:

• YOLO — Autopiloto completo, sem interrupcoes
• INTERACTIVE — Pausa para aprovacao humana em cada etapa critica

---

Modelo de Execucao: Task-MCP Matrix

O ecossistema tem 59 tasks distribuidas em 3 contextos de execucao. Helix consulta a task-mcp-matrix.yaml antes de executar qualquer step para determinar o contexto correto.

Contexto	Tasks	Como funciona
INLINE	16 tasks	Helix orquestra diretamente com validate_gate + get_phase_context
SUBAGENT	33 tasks	Helix lanca Agent() com contexto isolado e MCPs especificos por agente
DIRECT	8 tasks	Usuario ativa o agente via @agent para trabalho profundo em contexto 200K

Por que esse modelo importa

Cada agente tem acesso apenas aos MCPs que precisa. Atlas nao tem acesso aos MCPs de Hawk. Cipher nao tem acesso aos MCPs de Echo. Isso previne contaminacao de contexto, garante que cada agente trabalha dentro do seu escopo e mantem os outputs previsíveis e auditaveis.

# Exemplo: task-mcp-matrix.yaml
helix_phase_execution:
  execution_context: subagent
  agent: atlas
  mcps: [get_phase_context, validate_gate, blind_critic, validate_mecanismo]

hawk_validation:
  execution_context: subagent
  agent: hawk
  mcps: [blind_critic, emotional_stress_test, black_validation, layered_review]

research_voc:
  execution_context: subagent
  agent: vox
  mcps: [voc_search, semantic_memory_search, swipe_search]

---

Persistencia de Estado: helix-state.yaml

Cada oferta tem um arquivo helix-state.yaml que persiste o estado completo do pipeline entre sessoes. Feche o terminal, abra no dia seguinte — o sistema continua exatamente de onde parou.

# nicho-exemplo/oferta-exemplo/helix-state.yaml
current_phase: production
phases_completed:
  - research
  - briefing
tools_used:
  voc_search: true
  blind_critic: true
  validate_mecanismo: true
gates:
  research: true
  briefing: true
  production: false
  delivery: false

O Sentinel le esse arquivo antes de qualquer transicao. Se gates.research for false, nenhuma escrita em briefings/ e permitida — independente do que o usuario ou qualquer agente solicitar.

---

Bloqueio por Path: Segunda Camada de Protecao

Alem dos gates, existe bloqueio fisico por diretorio. Qualquer tentativa de escrita em paths protegidos sem as pre-condicoes satisfeitas e rejeitada automaticamente.

Escrita em	Pre-condicao	Se falhar
research/	Nenhuma	Livre — pesquisa e sempre permitida
briefings/	gates.research = true	BLOQUEADO — passar Research Gate primeiro
production/	gates.briefing = true + mecanismo VALIDATED	BLOQUEADO — Briefing Gate + Mecanismo Validado obrigatorios

Isso significa que e fisicamente impossivel produzir copy sem ter passado por research e briefing. O sistema nao depende de disciplina — depende de automacao.

---

Enforcement pelo Sentinel

O Sentinel e o agente de governanca do pipeline. Ele nao produz copy, nao faz research, nao escreve nada. Ele apenas garante que as regras sejam cumpridas.

O Sentinel bloqueia quando:

• Tentativa de avancar gate sem deliverables obrigatorios
• Tentativa de escrever em path protegido sem pre-condicoes
• Score de validacao abaixo do minimo (ex: RMBC Structural < 9/15)
• Ferramentas obrigatorias nao foram executadas

O Sentinel aprova quando:

• Todos os deliverables do gate estao presentes
• Todos os scores estao acima dos minimos
• Todas as ferramentas obrigatorias foram executadas
• helix-state.yaml reflete o estado correto

Sem aprovacao do Sentinel, o pipeline nao avanca. Sem aprovacao do Hawk, nenhuma peca de producao passa para o gate de delivery.

Separar PENSAR de ESCREVER

A maioria dos copywriters comete o mesmo erro: senta para escrever antes de ter pensado o suficiente. O resultado e copy generica, mecanismos rasos e ofertas que se confundem com a concorrencia.

O HELIX System resolve isso com uma separacao brutal: 3-4 horas de analise estrategica antes de uma unica palavra de copy ser escrita. Baseado em frameworks provados em $2B+ em vendas diretas (Puzzle Pieces, RMBC II, 16-Word Sales Letter), o HELIX transforma pesquisa crua em um briefing tao completo que a producao de copy se torna quase mecanica.

Regra operacional: Extended Thinking ON durante analise (fases 1-10). OFF durante criacao de copy. O pensamento profundo acontece no briefing. A execucao acontece rapido.

As 10 Fases

Cada fase tem um objetivo especifico, deliverables obrigatorios e criterios de avanco. Nao e possivel pular fases — o hook phase-advance-gate.ts bloqueia automaticamente.

Fase	Nome	O que faz	Output
1	Identificacao e Posicionamento	Define produto, avatar inicial e posicionamento de mercado. Estabelece formato, tom e selecao de expert.	phase-01-identificacao.md
2	Pesquisa de Mercado e Concorrencia	Mapeia concorrentes, ads escalados e tendencias. Deep dive em copy concorrente, ads-library-spy e playbooks de mineracao.	phase-02-mineracao.md
3	Avatar e Psicologia Profunda	Define avatar com DRE (Emocao Dominante Residente), horror stories e Escalada Emocional em 5 niveis. Extrai psicologia do VOC real.	phase-03-avatar.md
4	Niveis de Consciencia	Mapeia consciencia e sofisticacao do avatar usando framework Schwartz. Progressao Unaware → Problem Aware → Solution Aware → Most Aware ao longo da VSL.	phase-04-consciencia.md
5	Problema, Vilao e MUP	Define o Mecanismo Unico do Problema com Nova Causa e Sexy Cause. A NOVA razao pela qual o problema existe — o que ninguem mais esta apontando.	phase-05-problema-vilao-mup.md
6	Solucao, Especialista e MUS	Define o Mecanismo Unico da Solucao com 4 Camadas: Ingrediente Hero, Gimmick Name, Origin Story e Authority Hook. MUS espelha e inverte o MUP.	phase-06-solucao-mus.md
7	Big Offer	Constroi a oferta irresistivel com value stack, reason why, offer hack e garantias. Empilha beneficios, escassez e urgencia em UMA oferta unificada.	phase-07-big-offer.md
8	Fechamento e Pitch	Estrutura o pitch final com Call-to-Action e gatilhos de fechamento. Dualidade, urgencia e a razao final para comprar AGORA.	phase-08-fechamento-pitch.md
9	Leads e Ganchos	Cria 10+ hooks, 5 leads completos e 24 aberturas usando framework Clayton. Cada hook passa pelo 6-Question Litmus Test.	phase-09-leads-ganchos.md
10	Progressao Emocional e VSL	Define a estrutura completa da VSL com progressao emocional. Estabelece ONE BELIEF, mapeia 7 fases emocionais e responde 10 power questions.	phase-10-progressao-emocional.md

Fases Criticas: 5 e 6

Fase 5 (MUP) e Fase 6 (MUS) sao onde mora a conversao. Sao os 20% que geram 80% do resultado. Um mecanismo fraco produz copy fraca independente de quao boa a execucao seja. Um mecanismo forte faz ate copy mediana converter.

Por isso, essas duas fases tem o protocolo de validacao mais rigoroso do ecossistema inteiro:

Sequencia Obrigatoria de Validacao (Fases 5-6)

1. consensus (3 modelos)
   Apresenta TOP 3 candidatos de MUP para validacao multi-modelo.
   Exige agreement entre modelos diferentes para evitar vies.
        |
2. blind_critic --> MUP Statement
   Envia o MUP Statement para critica cega.
   Score minimo: 8/10. Abaixo disso: reescrever.
        |
3. Definir MUS baseado no MUP validado
   O MUS e o INVERSO do MUP. Se o MUP e a causa,
   o MUS e a solucao especifica para essa causa.
        |
4. blind_critic --> MUS Statement
   Mesma validacao rigorosa para o MUS.
   Score minimo: 8/10. Abaixo disso: reescrever.
        |
5. emotional_stress_test --> MUP + MUS juntos
   Testa genericidade. Score >= 8/10 obrigatorio.
   Pergunta central: "Um concorrente usaria isso sem alterar?"
        |
6. voc_search --> Confirmar linguagem
   Valida que a linguagem do MUP/MUS esta alinhada
   com quotes reais do avatar. Nao linguagem inventada.
        |
7. HUMANO --> Aprovacao final
   O sistema PARA aqui. Nenhum automatismo substitui
   o julgamento humano nas decisoes mais criticas.

Se qualquer threshold nao for atingido: O sistema bloqueia. consensus nao aprova? Refazer candidato. blind_critic abaixo de 8? Reescrever. emotional_stress_test detecta genericidade? Voltar ao inicio. Sem atalhos.

Validacao de Nomes (Diferente de Validacao de Copy)

Um ponto sutil mas critico: validar NOMES de mecanismo (Sexy Cause, Gimmick Name) e diferente de validar COPY. Nomes sao avaliados por criterios proprios:

Elemento	Criterio Principal	Teste
Sexy Cause	Transmissibilidade	”A pessoa vai CONTAR para alguem?”
Gimmick Name	Chiclete + Ingrediente	”Gruda E esta ligado ao ingrediente hero?”
Origin Story	Credibilidade + Curiosidade	”De onde veio? E verificavel?”
Authority Hook	Super Estrutura	”Referencia algo reconhecido?”

Todos os nomes tambem passam pelo crivo RMBC — Digerivel (explicavel em 1-2 frases), Unico (gera “nunca ouvi isso”), Provavel (faz sentido intuitivo), Conectado (liga com emocao do avatar). Score medio >= 7 para aprovar.

HELIX State: Persistencia entre Sessoes

Cada oferta tem um arquivo helix-state.yaml que persiste entre sessoes do Claude Code. Isso resolve um problema fundamental: antes, o tracking de ferramentas era por sessao (volatil). Ao fechar o terminal ou apos 2 horas, o estado era perdido, permitindo bypass dos gates.

Agora, o estado e por OFERTA:

# Exemplo: nicho-exemplo/oferta-exemplo/helix-state.yaml
offer: oferta-exemplo
current_phase: 10
phases_completed:
  - phase_01_identificacao
  - phase_02_mineracao
  - phase_03_avatar
  - phase_04_consciencia
  - phase_05_mup
  - phase_06_mus
  - phase_07_big_offer
  - phase_08_fechamento_pitch
  - phase_09_leads_ganchos
  - phase_10_progressao_emocional
tools_used:
  research: [firecrawl_agent, voc_search, fb_ad_library]
  briefing: [get_phase_context, consensus, blind_critic]
  production: []
gates:
  research: true
  briefing: true
  mecanismo: true
  production: false

O hook phase-advance-gate.ts le este arquivo antes de permitir avanco. O hook record-tool-in-offer.ts registra cada ferramenta usada automaticamente. Fechar o terminal, abrir outro dia, continuar de onde parou — o estado esta intacto.

Workflow Visual

RESEARCH ─── VOC + Competitors + Mechanism + Avatar
    |         4 summaries + synthesis.md (confidence >= 70%)
    |
    | validate_gate ── firecrawl_agent + voc_search usados?
    v
HELIX ────── 10 Fases (Extended Thinking ON)
    |         Fases 1-4: Fundacao (identificacao, mineracao, avatar, consciencia)
    |         Fases 5-7: Mecanismos (MUP, MUS, Big Offer)
    |         Fases 8-10: Execucao (pitch, leads, progressao emocional + VSL)
    |
    | validate_gate ── 10 fases completas? mecanismo VALIDATED?
    v
PRODUCTION ─ VSL + LP + Criativos + Emails
    |         blind_critic + emotional_stress_test em cada peca
    |         Genericidade Score >= 8/10 (Anti-Homogeneizacao)
    |
    | black_validation ── 5 Lentes de Validacao (score >= 8)
    v
DELIVERY ─── Copy aprovada, entregue, pronta para escalar

Sete frameworks formam a base de copy do ecossistema. Cada um contribui uma peca especifica — e nenhum funciona sozinho. A forca esta na integracao: Puzzle Pieces define O QUE empacotar, RMBC II define COMO produzir, 16-Word Sales Letter define a CRENCA que vende, Big Ideas define a DIFERENCIACAO que escala, 3Ms + NUUPPECC define a ATENCAO que captura, Hooks define os PRIMEIROS SEGUNDOS que decidem tudo, e Super Estrutura define a AUTORIDADE que valida.

Framework	Autor	Contribuicao Principal
Puzzle Pieces	Diogo Ramalho	MUP / MUS / Indutor / One Belief — a espinha dorsal de toda oferta
RMBC II	Stefan Georgi	Research -> Mechanism -> Brief -> Copy — o pipeline de producao
16-Word Sales Letter	Evaldo Albuquerque	One Belief que move a venda — a crenca central irresistivel
Big Ideas	Georgi & Amanda Khayat	Personagem + Situacao + Tensao — a diferenciacao que escala
3Ms + NUUPPECC	Max Peters	Mystery / Mechanism / Market + 8 atributos de atencao maxima
Hooks + Frases de Poder	Vitor Mound	Qualificacao + Emocao + Curiosidade — os primeiros 3 segundos
Super Estrutura	Mels / Ramalho	Autoridade externa (Celebridade / Instituicao / Expert / Governo)

Estes frameworks estao embutidos nos templates de fase HELIX e nos craft files de referencia (squads/copy-chief/data/helix-ref/core/metodologias.md). Os 13 agentes especializados do Copy Chief BLACK dominam cada um deles — o blind_critic (executado por Hawk, @critic) valida contra os principios do Puzzle Pieces e NUUPPECC, o emotional_stress_test verifica a One Belief do 16-Word e a genericidade do mecanismo, e o layered_review aplica as 3 camadas de refinamento do RMBC II. Voce nao precisa memorizar nenhum framework. O sistema aplica todos, o tempo todo.

DRE — Emocao Dominante Residente

A maioria dos copywriters assume que medo vende tudo. Errado. A DRE e a emocao que domina o estado interno do avatar — e nem sempre e medo. Uma mulher que compra um curso de reconquista nao sente medo: sente vergonha. Um concurseiro que reprova pela terceira vez nao sente medo: sente frustracao. Um homem com disfuncao eretil nao sente raiva: sente vergonha tao profunda que nem consegue falar sobre isso com a propria esposa.

Acertar a DRE e a diferenca entre copy que o prospect le e pensa “interessante” e copy que ele le e sente um aperto no peito.

DRE	Sinais na VOC	Nicho Tipico
Medo	Quotes sobre perda, morte, doenca, piorar	Saude, sobrevivencia
Vergonha	Olhar dos outros, inadequacao, esconder-se	Aparencia, ED, intimidade
Desejo	Inveja, querer o que outros tem, comparacao	Riqueza, status, lifestyle
Raiva	Ser enganado, injustica, sistema contra voce	Big pharma, governo, sistema
Frustracao	”Ja tentei tudo”, nada funciona, desistencia	Cross-nicho (universal)
Culpa	Negligencia, falhar com familia, omissao	Relacionamento, saude familiar

Quem define a DRE: O briefing (Fase 2.3 HELIX), NAO o copywriter por default. A VOC revela qual emocao domina — e a pesquisa que determina, nao a intuicao.

Amplificadores Emocionais

Emocoes nao operam sozinhas. Combinacoes especificas criam urgencia exponencial:

• Vergonha (problema PUBLICO) + Culpa (problema PESSOAL) + Esperanca (solucao URGENTE) = urgencia maxima
• Medo (consequencia futura) + Frustracao (falhas passadas) + Raiva (culpa de terceiros) = indignacao que converte

A DRE e a nota dominante. Os amplificadores sao os harmonicos que transformam desconforto passivo em impulso de compra.

---

Escalada Emocional (5 Niveis)

Aplica-se a QUALQUER DRE — nao apenas medo. Este e o framework que substituiu a antiga “Fear Hierarchy” dos Fundamentos v5. A logica: cada emocao tem um espectro de intensidade, do desconforto fisico imediato ate a crise existencial de identidade.

Copy que fica nos niveis 1-2 cria desconforto passivo. O prospect le, concorda, e fecha a aba. Niveis 4-5 criam impulso de acao real — o tipo de desconforto que faz alguem sacar o cartao as 2h da manha.

Nivel	Tipo	Horizonte	Exemplo (Medo)	Exemplo (Vergonha)	Exemplo (Frustracao)
1	Fisico Imediato	Horas/dias	”Peso no peito as 3h"	"Roupa nao fecha"	"Mais uma dieta falhou”
2	Social	Dias/semanas	”Vao notar na reuniao"	"Evita fotos em grupo"	"Amigos ja percebem”
3	Consequencia	Meses/anos	”Diabetico em 5 anos"	"Nao sai mais de casa"	"Ja perdeu 5 anos assim”
4	Relacional	Permanente	”Parceira vai encontrar outro"	"Filhos terao vergonha"	"Familia desistiu de ajudar”
5	Identidade	Existencial	”Morrer sendo lembrado como fracasso"	"Nao se reconhece mais no espelho"	"Nunca vai conseguir nada na vida”

Na pratica: A VOC e onde voce encontra quotes de cada nivel. Quanto mais quotes de niveis 4-5 voce extrair, mais visceral a copy pode ser. Se toda sua VOC e nivel 1-2, ou o avatar nao sofre tanto (produto errado) ou voce pesquisou nos lugares errados.

---

5 Lentes de Validacao

As 5 Lentes substituiram os antigos “6 BLACK Gates”. Sao mais objetivas, mais rapidas de aplicar, e impossíveis de trapacear.

Principio fundador: “Copy confortavel = Copy que FALHOU.”

Se o copywriter escreve e nao sente um leve desconforto ao reler, a copy esta fraca demais. Se o prospect le e nao sente nada no corpo — no estomago, no peito, na garganta — a copy falhou antes mesmo de chegar no CTA.

Lente	Pergunta-Chave	Rejeitar Se
1. Escalada Emocional	DRE ativada e escalada ate nivel 4-5?	Fica nos niveis 1-2 (desconforto passivo)
2. Densidade Narrativa	Parece cena de filme? Tem detalhes sensoriais?	Parece press release ou artigo de blog
3. Logo Test	Concorrente NAO pode usar sem alterar?	Qualquer concorrente usaria sem mudar nada
4. Teste Visceral	Ativa reacao FISICA no leitor?	Prospect passa “de boa”, sem sentir nada
5. Zero Hesitacao	0 “talvez”, 0 “pode ser”, 0 marketing speak?	Linguagem evasiva, adjetivos vazios

Tabela de Decisao

Lentes Fortes	Indicacao	Acao
5/5	Pronta para teste no mercado	Publicar
4/5	Uma lente fraca	Fortalecer especificamente essa lente
3/5	Comprometida	Revisao estrutural obrigatoria
<= 2/5	Gaps estruturais graves	REFAZER do zero

A ferramenta MCP black_validation e executada por Hawk (@critic) e aplica todas as 5 Lentes automaticamente, retornando um score por lente + decisao PASS/FAIL. Nao e opcional — e o gate final antes de qualquer entrega.

---

Especificidade = Cena de Filme

Este e o conceito mais importante dos Fundamentos v5 para producao de copy. O cerebro humano interpreta ESPECIFICO como VERDADEIRO. Quanto mais denso em detalhes, mais o cerebro assume que aquilo so poderia vir de experiencia real. Mas especificidade tem duas faces — e a maioria dos copywriters so conhece uma.

Face 1: Dados Especificos

A face mais conhecida. Numeros nao-redondos, nomes, cidades, profissoes, datas. O cerebro processa “87.3% das pessoas” como mais verdadeiro que “90% das pessoas” — mesmo sem nenhuma prova adicional.

Checklist de Dados (8 itens):

#	Criterio	Generico (0 pts)	Especifico (1 pt)
1	Nome	”pessoas”, “clientes"	"Dona Maria, de Goiania”
2	Idade	”adultos”, “mulheres"	"47 anos”
3	Localizacao	”todo Brasil"	"bairro Setor Bueno, Goiania”
4	Profissao	”empresario"	"dona de salao de beleza”
5	Numero	”90%”, “milhares"	"87.3%”, “2.847 pessoas”
6	Data	”recentemente"	"14 de marco de 2024”
7	Resultado	”melhorou"	"pressao foi de 180/120 para 124/81”
8	Sensorial	Ausente	”acordou as 3AM suando frio”

Face 2: Narrativa Especifica (a MAIS PODEROSA)

Cena tao vivida que o prospect se enxerga nela. Nao precisa de numeros — precisa de DETALHES SENSORIAIS que transportam. O leitor nao processa a informacao: ele VIVE a cena.

5 Dimensoes da Narrativa:

#	Dimensao	Fraco	Forte
1	Dados Precisos	”Pessoas melhoraram"	"12.847 clientes, 87.3% sentiram alivio em 14 dias”
2	Cena Vivida	”Descobri um metodo"	"Estava no vestiario quando ouvi duas mulheres…“
3	Reacao de Terceiros	Ausente	”O medico olhou os exames, tirou os oculos e disse…“
4	Contexto Inesperado	Generico	”3h da manha, no banheiro, com a luz do celular”
5	Detalhes Sensoriais	”Me senti melhor"	"Acordei sem tonteira pela 1a vez em 7 anos”

Comparacao Direta

• Dados: “Joao, 47 anos, encanador de Sorocaba, perdeu 23kg em 87 dias.”
• Narrativa: “Estava no vestiario quando ouvi duas mulheres falando. Uma tirou um vidro da bolsa e disse: ‘toma, mas nao conta pra ninguem. Minha sogra me deu e eu perdi 3 numeros de calca sem mudar nada na alimentacao.’”

A segunda nao tem um unico numero. Mas e infinitamente mais persuasiva. A melhor copy usa AMBAS as faces juntas.

Threshold: Face 1 (>= 6/8) + Face 2 (>= 3/5). AMBAS devem estar presentes na copy final. Se Specificidade Score < 8, a copy e rejeitada automaticamente.

---

Anti-Homogeneizacao

O problema mais insidioso da producao de copy com IA: 79% de similaridade intra-modelo. Sem constraints divergentes explicitos, qualquer LLM produz copy que parece ter saido de uma fabrica. Bonita, gramaticalmente perfeita — e completamente generica.

Regra Cardinal

Copy que poderia ser usada por concorrente SEM alteracao = REFAZER.

Nao “revisar”. Nao “melhorar”. REFAZER. Se um concorrente pode pegar sua copy, trocar o logo, e publicar como dele — voce nao escreveu copy. Escreveu um template.

4 Testes Obrigatorios

Teste	Pergunta	Se falhar
Logo Test	Funciona se trocar o logo?	REFAZER
Competitor Swap	Concorrente poderia roubar?	REFAZER
Especificidade Score	Score < 8/10?	REFAZER
Palavras Banidas	Tem “revolucionario”, “transformar”, “jornada”?	SUBSTITUIR cada uma

Escala de Especificidade BLACK

Score	Descricao	Decisao
1-3	Qualquer concorrente usaria sem alterar	REFAZER
4-5	Precisa adaptacao moderada (20-40%)	REFAZER
6-7	Relativamente unica, mas pode melhorar	REVISAR
8-10	Impossivel confundir com concorrente	APROVADO

---

Cliches Proibidos por Nicho

Cada nicho tem seu proprio cemiterio de frases mortas. Frases que ja foram boas, mas foram tao repetidas que agora ativam o filtro de “propaganda” no cerebro do prospect.

Concursos

Proibido	Substituir por
”metodo infalivel”	Nome proprietario do metodo
”estudar de forma inteligente”	Tecnica especifica nomeada
”passe em menos tempo”	Prazo especifico + contexto real
”decoreba nao funciona”	Problema especifico com memorizacao
”metodo dos aprovados”	Nome unico do sistema

Saude / Emagrecimento

Proibido	Substituir por
”emagreca sem dieta”	Mecanismo especifico nomeado
”metabolismo acelerado”	Nome do processo metabolico
”queimar gordura”	Processo fisiologico especifico
”segredo dos magros”	Descoberta especifica + fonte
”corpo dos sonhos”	Resultado mensuravel

Relacionamento

Proibido	Substituir por
”conexao profunda”	Comportamento especifico observavel
”atracao irresistivel”	Mecanismo psicologico nomeado
”recuperar casamento”	Tecnica nomeada + contexto
”comunicacao eficaz”	Protocolo especifico

Palavras Banidas (Cross-Nicho)

Adjetivos vazios: revolucionario, inovador, incrivel, inacreditavel, unico (sem especificacao).

Substantivos genericos: segredo, metodo, sistema (sem nome proprio), transformacao, jornada.

Verbos IA-speak: revolucionar, transformar, elevar, desbloquear, empoderar, potencializar.

Estruturas banidas: “Imagine…”, “What if I told you…”, “The secret to…”, “Finally, a solution…”, “X meets Y”.

Enforcement: O emotional_stress_test (MCP, executado por Hawk) avalia genericidade e escalada emocional automaticamente. Score < 8 = REFAZER. O blind_critic (tambem via Hawk) flagra palavras banidas com base nos criterios NUUPPECC. Nao e sugestao — e bloqueio.

Por Que o Mecanismo E Tudo

Voce pode ter a melhor headline, o melhor design, os melhores criativos — e converter zero. Porque sem um mecanismo unico, sua oferta e mais uma na pilha. O mecanismo e o que faz o prospect pensar “isso eu nunca ouvi antes” em vez de “mais do mesmo”.

Nao e diferencial de marketing. E a razao estrutural pela qual sua solucao funciona e as outras nao.

Formula do Mecanismo

[ORGAO REAL] + [PROCESSO INVENTADO] + [CAUSA EXTERNA CULPAVEL]

O orgao e real (o prospect pode pesquisar). O processo e denso em detalhes (parece cientifico). A causa e externa (tira a culpa do prospect). Essa combinacao e o que separa copy que converte de copy que informa.

5 funcoes obrigatorias do mecanismo:

1. Explica o problema de forma que o prospect nunca ouviu
2. Absolve o avatar — nao e culpa dele, e culpa de [causa externa]
3. Invalida todas as outras solucoes — por isso nada funcionou ate agora
4. Posiciona sua solucao como a unica que ataca a causa REAL
5. Cria urgencia — se nao resolver agora, o processo piora progressivamente

Se o mecanismo nao cumpre TODAS as 5, esta incompleto. Nao existe “mecanismo bom o suficiente”. Ou faz as 5 coisas ou volta pra mesa.

---

MUP — Mecanismo Unico do Problema

O MUP e a resposta para “por que voce tem esse problema?”. Nao a resposta obvia que o mercado ja repete. A resposta NOVA que faz tudo clicar.

Componente	Descricao	Obrigatorio
Nova Causa	O que REALMENTE causa o problema (nao o que o mercado fala)	SIM
Sexy Cause	NOME intrigante e memoravel para a nova causa	SIM
Problema Fundamental	Como a nova causa se aplica TANGIVELMENTE ao dia-a-dia	SIM
Causa Raiz	Historia por tras do problema (por que a causa existe)	NAO

Criterios de Validacao do MUP

Antes de avancar para o MUS, o MUP precisa responder SIM para tres perguntas:

• E diferente do que o mercado ja fala? Se qualquer concorrente poderia dizer a mesma coisa, nao e MUP.
• Tira a culpa do avatar? O prospect precisa pensar “entao NAO era minha culpa”.
• Explica por que outras solucoes falharam? Se o MUP nao invalida as alternativas, esta fraco.

Teste da Sexy Cause

A pergunta fatal: “A pessoa vai querer CONTAR para alguem?”

Se voce fala “Cristais de Otolitos” num jantar e a pessoa responde “o que e isso?!” com os olhos arregalados — funcionou. Se voce fala “inflamacao cronica” e a pessoa faz “ah, sim” e volta a comer — nao e Sexy Cause. E nomenclatura medica generica.

A Sexy Cause precisa ter CURIOSIDADE embutida. Nao e so um nome bonito — e um nome que gera a pergunta “como assim?”.

---

MUS — Mecanismo Unico da Solucao

O MUS e o inverso do MUP. Se o MUP diz “o problema e X”, o MUS diz “a solucao e reverter/neutralizar/eliminar X com [ingrediente hero]”.

Componente	Descricao	Obrigatorio
Nova Oportunidade	INVERSO da nova causa — o que muda quando o problema e resolvido	SIM
Ingrediente Hero	Componente PRINCIPAL que resolve (substancia, tecnica, protocolo)	SIM
Gimmick Name	Nome chiclete do INGREDIENTE (nao do sistema!)	SIM
Origin Story	Historia de COMO foi descoberto (credibilidade + curiosidade)	SIM
Authority Hook	Validacao via super estrutura (medicamento, instituicao, elite)	SIM

Distincao Critica: Gimmick Name vs Authority Hook

Estes dois componentes sao confundidos com frequencia. A distincao e precisa:

• Gimmick Name = ligado ao INGREDIENTE. E o nome chiclete que gruda na cabeca. Exemplo: “Pink Salt Trick”.
• Authority Hook = ligado a SUPER ESTRUTURA. E a referencia que empresta credibilidade. Exemplo: “Monjaro Natural”.

O Gimmick Name faz o prospect lembrar. O Authority Hook faz o prospect acreditar. Sao funcoes diferentes.

Teste do Gimmick Name: Gruda E esta ligado ao ingrediente hero? Se o nome nao referencia o ingrediente de nenhuma forma, esta solto — pode ser qualquer coisa. Se gruda mas nao referencia, e apenas catchy. Precisa ser AMBOS.

---

Gancho da Solucao (Formula Ramalho)

A formula que amarra todos os componentes do MUS em uma unica frase que poderia ser o hook de um criativo:

"Ja ouviu falar desse [GIMMICK NAME] que [ORIGIN STORY]
estao usando secretamente para [DESEJO]?
Ja estao chamando isso de [AUTHORITY HOOK]."

Exemplo real:

“Ja ouviu falar desse Pink Salt Trick que as atrizes de Hollywood estao usando secretamente para secar gordura na barriga em poucos dias? Ja estao chamando isso de Monjaro Natural.”

Note como a formula comprime MUS inteiro: ingrediente (Pink Salt), origin story (atrizes de Hollywood), desejo (secar gordura), authority hook (Monjaro Natural). Uma frase. Tudo conectado. Se voce nao consegue preencher essa formula com os componentes da sua oferta, o MUS esta incompleto.

---

Invencao Densa vs Fraca

Este e o ponto que separa copywriters amadores de profissionais. Toda copy de Direct Response usa invencao — mecanismos, processos, nomenclaturas que nao existem em papers cientificos. A questao nao e SE voce inventa. E COMO.

Invencao Fraca (detectavel)	Invencao Forte (indistinguivel)
“Toxinas no corpo"	"Inflamacao no Receptor TLR-4 do hipotalamo"
"Desequilibrio hormonal"	"Resistencia a leptina por excesso de frutose no figado"
"Estresse oxidativo"	"Cristalizacao de calcio nas celulas ciliadas da coclea”
Generico, qualquer um fala	Denso em detalhes, parece estudo publicado

Regra dos Fundamentos v5: Invencao fraca (generica) e detectavel — o prospect sente que e “papo de vendedor”. Invencao forte (densa em detalhes tecnicos, orgaos reais, processos plausiveis) e indistinguivel de informacao real. Isso nao e erro ou enganacao. E TECNICA de copy. Coerencia narrativa > verdade factual.

O cerebro humano nao verifica papers. Ele verifica DENSIDADE. Se a explicacao e densa, especifica e internamente coerente, o cerebro classifica como “verdadeiro” automaticamente.

---

Criterios RMBC para Validacao de Nomes

Todos os nomes do mecanismo (Sexy Cause, Gimmick Name, Authority Hook) passam por estes 4 criterios. A media precisa ser >= 7 para aprovacao.

Criterio	Pergunta	Threshold
Digerivel	Explicavel em 1-2 frases para leigo?	>= 7/10
Unico	Gera “nunca ouvi isso antes”?	>= 7/10
Provavel	Faz sentido intuitivo, mesmo sem prova?	>= 7/10
Conectado	Liga com a emocao dominante do avatar?	>= 7/10

Importante: Validar NOMES e diferente de validar COPY. Os criterios RMBC sao para nomes. O blind_critic e emotional_stress_test sao para copy produzida. Nao misturar.

Criterios Especificos por Tipo de Nome

Elemento	Criterio Principal	Teste
Sexy Cause	Transmissibilidade	”A pessoa vai CONTAR para alguem?”
Gimmick Name	Chiclete + Ingrediente	”Gruda E esta ligado ao ingrediente hero?”
Origin Story	Credibilidade + Curiosidade	”De onde veio? E verificavel?”
Authority Hook	Super Estrutura	”Referencia algo reconhecido?”

---

Adaptacao por Nicho

O conceito de “Ingrediente Hero” muda conforme o nicho. Nao e sempre uma substancia quimica. E o componente PRINCIPAL que resolve o problema dentro do contexto da oferta.

Nicho	Ingrediente Hero =	Exemplo Concreto
Suplemento	Substancia principal	Pink Salt (sal rosa do Himalaia)
Educacao/Concursos	Tecnica core	Tecnica Ovelha Negra (padroes de banca)
Relacionamento	Protocolo principal	Tecnica do Espelho (neuroquimica)
Riqueza	Estrategia principal	Metodo dos 3 Potes (alocacao)
SaaS	Feature diferencial	DNA da Banca (IA treinada em 500K questoes)
Saude auditiva	Composto/processo	CoQ10 + Acido Alfa-Lipoico (dissolucao de cristais)

Biblioteca de Sexy Causes por Nicho

Exemplos reais do ecossistema e de swipes analisados:

Nicho	Problema Real	Sexy Cause
Emagrecimento	Come demais por fome falsa	”Hungry Brain Syndrome”
Concursos	Estuda mas nao memoriza	”Ilusao de Aprendizado”
Concursos	Nao encontra o que a banca cobra	”Ponto Cego de Leitura”
ED	Bloqueio por ansiedade de performance	”Sindrome de Dessensibilizacao”
Tinnitus	Zumbido no ouvido sem causa aparente	”Cristais de Otolitos”
Concursos (lei seca)	Decorar legislacao sem estrategia	”Ponto Cego da Legislacao”

---

mecanismo-unico.yaml

Cada oferta no ecossistema tem um arquivo mecanismo-unico.yaml na raiz. Este arquivo e a fonte de verdade do mecanismo — e o que os hooks de enforcement consultam antes de permitir qualquer escrita em production/.

Estados do Mecanismo

UNDEFINED ──> DRAFT ──> PENDING_VALIDATION ──> VALIDATED ──> APPROVED

Estado	Significado	Permite Production?
UNDEFINED	Nao iniciado	NAO
DRAFT	Em construcao, componentes parciais	NAO
PENDING_VALIDATION	Completo, aguardando validacao MCP	NAO
VALIDATED	Validado via validate_mecanismo (schema YAML + RMBC structural /15) + blind_critic + stress_test	SIM
APPROVED	Humano deu aprovacao final	SIM

Enforcement Automatico

O hook mecanismo-validation.ts intercepta qualquer tentativa de Write em */production/* e verifica:

1. O arquivo mecanismo-unico.yaml existe na raiz da oferta?
2. O campo state e VALIDATED ou APPROVED?
3. Todos os componentes obrigatorios estao preenchidos?

Se qualquer verificacao falha, o Write e BLOQUEADO. Nao existe override. Nao existe “depois eu valido”. O mecanismo precisa estar aprovado ANTES de produzir qualquer copy.

Validacao Obrigatoria (Pipeline Completo)

Nenhuma oferta avanca sem mecanismo-unico.yaml VALIDATED. A validacao e conduzida por Atlas (@briefer). A sequencia e fixa e nao pode ser reordenada:

consensus ─── TOP 3 candidatos MUP (multi-modelo)
    |
validate_mecanismo ─── Schema YAML + RMBC Structural /15 >= 9 (Atlas)
    |
blind_critic ─── MUP Statement score >= 8/10 (Hawk)
    |
Definir MUS ─── baseado no MUP validado (4 Camadas obrigatorias)
    |
validate_mecanismo ─── MUS schema + espelhamento MUP<->MUS (Atlas)
    |
blind_critic ─── MUS Statement score >= 8/10 (Hawk)
    |
emotional_stress_test ─── MUP+MUS genericidade >= 8/10 (Hawk)
    |
voc_search ─── Confirmar linguagem alinhada com avatar
    |
HUMANO ─── Aprovacao final obrigatoria

Fonte de verdade: squads/copy-chief/data/helix-ref/core/RMBC.md (criterios de validacao) e squads/copy-chief/data/helix-ref/core/formulas_e_criterios.md (gates e espelhamento MUP/MUS).

RMBC Structural /15: Score < 9 = REFORMULAR. Score 9-11 = REVISAR pontos fracos. Score >= 12 = APROVADO.

Se threshold nao atingido em qualquer etapa: Voltar, refazer o componente, e passar pela validacao novamente. O pipeline nao aceita “quase la”. Ou passa ou refaz.

O Que Sao Agent Skills

Skills sao agentes especializados com autoridade definida sobre uma fatia do workflow de copy. Cada agente tem uma persona, um conjunto de comandos e um escopo de atuacao nao-sobreposto com os demais. Nao sao “modos” do Claude — sao contextos isolados com ate 200K tokens cada, ativados sob demanda.

Ativacao: Use @agent-name ou o comando /AIOX:agents:agent-name. O agente assume o contexto da sessao com sua persona, comandos e dependencias carregados.

Troca de agente: Ao ativar um novo agente, o agente anterior e compactado em um handoff artifact de ~379 tokens (vs. 3-5K tokens do contexto completo). O artifact preserva story ID, branch, decisoes-chave, arquivos modificados e proxima acao. Contexto acumula sem explodir a janela.

---

13 Agentes — Autoridade e Escopo

Tier Opus (Decisao Estrategica)

Agente	Persona	Escopo Principal
Helix (@chief)	Orquestrador	Pipeline, roteamento, estado de oferta. Nunca produz copy diretamente — delega via Agent() subagent.
Hawk (@critic)	Critico Adversarial	Blind critic, EST, black_validation, layered review. Gate de qualidade pos-producao.
Sentinel (@gatekeeper)	Gate Keeper	Auditoria de fases, enforcement de gates, verificacao de pre-condicoes.
Strategist	Estrategista de Portfolio	Analise de portfolio, design de funis, ROI e posicionamento competitivo.

Tier Sonnet (Execucao Especializada)

Agente	Persona	Escopo Principal
Atlas (@briefer)	Briefer	10 fases HELIX — do contexto ao One Belief. Valida MUP/MUS via validate_mecanismo.
Vox (@researcher)	Pesquisador	VOC extraction, avatar profiling, synthese de research. Usa voc_search e semantic_memory_search.
Cipher (@miner)	Minerador de Ads	Ads spy, video breakdown, Scale Score de concorrentes. Usa Facebook Ad Library e Apify.
Echo (@vsl)	Produtor de VSL	Producao de capitulos VSL pelos 6 tipos (LEAD, BACKGROUND, TESIS, BUILDUP, OFERTA, CLOSE). Usa write_chapter.
Forge (@lp)	Produtor de LP	Blocos de Landing Page em sequencia emocional. Mapeamento de objecoes por bloco.
Scout (@creative)	Criativo	Batch de criativos, exploracao de hooks, angulos por DRE.
Blade (@producer)	Email Producer	Sequencias de email, upsell/downsell, reengajamento.
Spark (@reels)	Reels Specialist	Scripts virais para reels (metodo Hormozi).
Ops (@ops)	Operacoes	Git operations, health checks, diagnostico do ecossistema.

---

Modelo de Execucao: Helix Nunca Emula

Regra critica de arquitetura: Helix nunca usa Skill para carregar instrucoes de outros agentes inline. Fazer isso consumiria 50%+ do contexto sem realmente delegar — a persona seria emulada no mesmo contexto do Helix.

O fluxo correto:

Helix recebe tarefa
   |
   v
Le task-mcp-matrix.yaml → determina execution_context
   |
   +--> "subagent": carrega prompt template de
   |    squads/copy-chief/templates/subagent-prompts/
   |    lanca via Agent() com subagent_type="general-purpose"
   |
   +--> "direct": instrui usuario a ativar persona
   |    ex: /AIOX:agents:atlas
   |
   +--> "inline": executa apenas com MCPs autorizados
        do proprio Helix (validate_gate, get_phase_context)

Subagents do tipo general-purpose tem acesso a ToolSearch e MCPs. Subagents com tipos customizados (researcher, copywriter, reviewer) nao herdam acesso a MCPs — apenas ao Read/Write e, dependendo do tipo, ao WebSearch.

---

Handoff Protocol: Troca Sem Perda de Contexto

Cada troca de agente gera um handoff artifact estruturado:

handoff:
  from_agent: "atlas"
  to_agent: "echo"
  story_context:
    story_id: "5.3"
    story_path: "docs/stories/05.3.story.md"
    story_status: "InProgress"
    current_task: "Producao VSL — capitulo TESIS"
    branch: "feat/oferta-exemplo-vsl"
  decisions:
    - "MUP aprovado: {Exemplo de MUP Aprovado}"
    - "Angulo primario: Vergonha (nivel 3) -> Medo (nivel 5)"
  files_modified:
    - "nicho-exemplo/oferta-exemplo/briefings/helix-complete.md"
  next_action: "Produzir capitulos LEAD e BACKGROUND antes do TESIS"

Maximos por artifact: 5 decisoes, 10 arquivos, 3 blockers. Sessao retém no maximo 3 handoffs anteriores — o mais antigo e descartado ao incluir o quarto.

---

Workflow de Agentes: Ciclo Padrao

@sm *draft      → cria story a partir do epic
@po *validate   → checklist 10 pontos (GO se >= 7)
@dev *develop   → implementa (Interactive / YOLO / Pre-Flight)
@qa *qa-gate    → 7 quality checks (PASS / CONCERNS / FAIL)
@devops *push   → EXCLUSIVO para git push e gh pr create

Para copy:

@chief (Helix)     → orquestra pipeline por fase
@briefer (Atlas)   → HELIX 10 fases + validacao de mecanismo
@researcher (Vox)  → VOC + avatar + synthesis
@miner (Cipher)    → ads spy + scale score
@vsl (Echo)        → producao VSL capitulo a capitulo
@lp (Forge)        → producao LP bloco a bloco
@critic (Hawk)     → validacao pos-producao (blind_critic, EST, BLACK)
@gatekeeper (Sentinel) → gate enforcement entre fases

Arquitetura de Autorizacao

Cada MCP tool tem uma lista de agentes autorizados a usa-la. Isso nao e convencao — e enforcement. Um agente tentando usar uma tool fora de sua autorizacao viola o modelo de delegacao do ecossistema.

A matriz de autorizacao esta em squads/copy-chief/data/task-mcp-matrix.yaml. Helix consulta esse arquivo antes de qualquer step de workflow para determinar o execution_context correto: inline, subagent ou direct.

---

10 MCP Tools Internas (copywriting-mcp)

voc_search

Input: emocao (ex: “medo”), keyword (ex: “zumbido ouvido”), intensidade minima (1-5)

Output: Quotes rankeadas por relevancia, com fonte, plataforma, username e intensidade emocional

Agentes autorizados: Vox, Atlas

Quando usar: Antes de qualquer decisao de MUP/MUS. Valida com VOC real como o avatar fala sobre o problema — nao como o copywriter assume que ele fala.

---

semantic_memory_search

Input: query de busca, tipo de memoria (episodic / narrative / technique), filtro opcional por oferta

Output: Fragmentos de memoria semantica rankeados por similaridade

Agentes autorizados: Vox, Atlas

Quando usar: Recuperar narrativas validadas, tecnicas aplicadas em ofertas anteriores, ou episodios de copy de alta conversao para referencia.

---

get_phase_context

Input: numero da fase HELIX (1-10), oferta

Output: Contexto completo da fase — descricao, deliverables esperados, criterios de gate, dependencias e templates relevantes

Agentes autorizados: Helix, Sentinel, Atlas

Quando usar: Inicio de cada fase do briefing. Garante que todos os deliverables e thresholds da fase estao claros antes de comecar.

---

validate_gate

Input: tipo de gate (research / briefing / production), oferta

Output: PASSED ou BLOCKED + lista detalhada de items faltantes com descricao especifica

Agentes autorizados: Helix, Sentinel

Quando usar: ANTES de declarar qualquer fase como completa. Gate verifica deliverables, ferramentas obrigatorias usadas na sessao, e thresholds de qualidade. Nao e possivel avancar de fase sem PASSED.

---

validate_mecanismo

Input: mecanismo-unico.yaml da oferta

Output: Validacao de schema YAML + RMBC Structural /15 + estado atual (DRAFT / VALIDATED / REJECTED)

Agentes autorizados: Atlas

Regras aplicadas:

• 4 Camadas obrigatorias preenchidas (Ingrediente Hero, Gimmick Name, Origin Story, Authority Hook)
• MUS deve ser solucao logica e direta do MUP (espelhamento MUP<->MUS)
• RMBC Structural >= 9/15 para nao bloquear (>= 12 = aprovado, 9-11 = warning, < 9 = REFORMULAR)

---

blind_critic

Input: copy (texto completo), tipo (headline / lead / body / CTA), target score minimo

Output: Score NUUPPECC 1-10 + criticas detalhadas por criterio + sugestoes de melhoria

Agentes autorizados: Hawk, Atlas

Threshold: Score >= 8 para aprovar. Score 6-7 = revisar. Score <= 5 = refazer.

Avalia sem saber o contexto da oferta — por isso “blind”. Julga a copy como texto puro, sem vies de quem a escreveu.

---

emotional_stress_test

Input: copy, tipo (lead / body / headline), DRE da oferta

Output: 4 scores independentes com analise detalhada

Agentes autorizados: Hawk

Teste	O que avalia	Peso	Threshold
Genericidade	Copy poderia ser de concorrente?	40%	>= 8/10
Visceral	Ativa reacao fisica/emocional?	25%	>= 7/10
Scroll-stop	Para o scroll nos primeiros 3 segundos?	20%	>= 7/10
Proof density	Proporcao claim:prova verificavel	15%	>= 8/10

Pega copy “bonita mas generica” — profissional na aparencia, inerte na conversao.

---

write_chapter

Input: tipo de capitulo, numero do capitulo, contexto da oferta, template de estrutura

Output: Capitulo completo da VSL seguindo template BLACK

Agentes autorizados: Echo

6 tipos de capitulo: LEAD, BACKGROUND, TESIS, BUILDUP, OFERTA, CLOSE

Cada capitulo e produzido individualmente com contexto focado. Producao monolitica de VSL gera incoerencias de tom e mecanismo entre secoes — o capitulo isolado elimina esse problema.

---

layered_review

Input: copy completa, numero de camadas (padrao: 3)

Output: Review progressivo em 3 passes, cada um mais profundo que o anterior

Agentes autorizados: Hawk

Camada	Foco	O que pega
1. cut_crap	Estrutura e logica	Gaps de argumento, saltos logicos, incoerencias
2. visceral	DRE e escalada emocional	Copy plana, emocoes fracas, falta de tensao
3. final	Especificidade e linguagem	Cliches, palavras banidas, genericidade, VOC ausente

---

black_validation

Input: copy completa da peca final

Output: Score por cada uma das 8 Lentes + decisao PASS/FAIL + gaps identificados

Agentes autorizados: Hawk

Gate FINAL antes de qualquer entrega. Se black_validation retorna FAIL, a copy nao sai.

---

MCPs Externos Integrados

Pesquisa e Extracao (Fase Research)

MCP	Agentes	Funcao
Firecrawl	Vox, Cipher	Scraping web autonomo. Agent mode para coleta extensa. Fallback: firecrawl_scrape (pagina unica) e firecrawl_search (busca generalista).
Apify	Vox, Cipher	200+ actors para extracao social — YouTube comments, TikTok, Instagram, Reddit, Amazon reviews. Principal: memo23/facebook-ads-library-scraper-cheerio para discovery de ads.
Facebook Ad Library	Cipher	get_meta_platform_id busca paginas por nome. get_meta_ads extrai ads de pagina especifica. analyze_ad_video analisa criativos TOP. Atencao: NAO busca por keyword — para isso usar Apify.
Playwright	Vox, Cipher	Navegacao em sites que bloqueiam scraping. Abre browser real, interage com DOM, extrai conteudo quando Firecrawl e Apify falham.
Context7	Atlas, Ops	Lookup de documentacao de bibliotecas e APIs. Resolve library IDs e retorna docs atualizados.

Hierarquia de Fallback para VOC

1. Apify Actor especifico (timeout: 5min)  → comentarios REAIS com metricas sociais
         |
         | (se falha)
         v
2. Playwright direto                        → navegacao real, extrai do DOM
         |
         | (se falha)
         v
3. Firecrawl search                         → extracao web generalista
         |
         | (se falha)
         v
4. WebSearch                                → ULTIMO RESORT (sem comentarios reais)

Nunca pular direto para WebSearch. WebSearch retorna resultados de busca — nao quotes reais de usuarios. A qualidade da VOC cai drasticamente.

---

Task-MCP Matrix

task-mcp-matrix.yaml define o execution_context de cada combinacao task+MCP:

execution_context	Significado	Helix faz
subagent	MCP sera chamado dentro de um subagent	Carrega prompt template, lanca via Agent()
direct	MCP precisa de agente dedicado ativo	Instrui usuario: /AIOX:agents:{name}
inline	MCP autorizado para Helix direto	Executa com validate_gate ou get_phase_context

Limitacao critica: Subagents nao podem usar deferred MCP tools. Dados coletados por MCPs externos (Apify, Firecrawl, FB Ad Library) devem ser coletados no nivel do orquestrador e passados via prompt para o subagent.

Subagent Type	Read/Write	WebSearch	ToolSearch	MCPs
general-purpose	Sim	Sim	Sim	Sim
researcher	Sim	Sim	NAO	NAO
copywriter	Sim	NAO	NAO	NAO
reviewer	Sim	NAO	NAO	NAO

Para qualquer task que precise de MCP, usar general-purpose.

---

MCP Enforcement por Fase

Fase	Ferramentas OBRIGATORIAS	Consequencia se pular
Research	firecrawl_agent ou apify, voc_search	validate_gate BLOQUEIA avanco para Briefing
Briefing	get_phase_context, validate_mecanismo	validate_gate BLOQUEIA avanco para Production
Production	blind_critic, emotional_stress_test	validate_gate BLOQUEIA entrega
Entrega Final	black_validation	Copy NAO e entregue

O hook gate-tracker.ts registra cada resultado de gate (PASSED/BLOCKED) no helix-state.yaml da oferta, criando historico persistente que sobrevive entre sessoes.

---

5 Lentes de Validacao (via black_validation)

Principio: “Copy confortavel = Copy que FALHOU.”

black_validation aplica 8 lentes. As 5 essenciais:

Lente	O que avalia	Score minimo	Como fortalecer
1. Cena de Filme	Detalhes sensoriais, cena vivida com nomes/datas/locais	7/10	Adicionar contexto especifico (3h da manha, mao tremendo, reacao de terceiros)
2. Emocao Coerente	DRE ativada e escalada ate nivel 4-5	7/10	Adicionar quotes VOC nivel 4-5. Escalar de fisico para relacional/identidade
3. Logo Test	Concorrente NAO pode usar sem alterar	8/10	Nome proprietario do mecanismo, dados unicos da oferta, prova social especifica
4. Teste Visceral	Ativa reacao fisica/emocional forte	7/10	Detalhes sensoriais (suor, aperto no peito). Contexto inesperado
5. Zero Hedges	Zero “talvez”, zero marketing speak	8/10	Eliminar adjetivos vazios, substituir generalidades por dados, remover hedging

Lentes fracas <= 2/5 = REFAZER a copy do zero. Revisao nao salva copy com falha em 3+ Lentes. A estrutura esta comprometida.

Constitution — Principios Inegociaveis

A base de tudo no ecossistema nao e um documento — e um conjunto de principios que o sistema torna tecnicamente impossivel de ignorar. A Constitution define o que NUNCA pode ser violado, independente de prazo, pressao ou instrucao do usuario.

Artigo	Principio	Severidade
I	CLI First — toda funcionalidade via CLI antes de UI	NON-NEGOTIABLE
II	Agent Authority — cada agente tem escopo definido e exclusivo	NON-NEGOTIABLE
III	DRE-First — Emocao Dominante Residente drive toda copy	MUST
IV	No Invention — zero statements sem rastreabilidade a VOC ou dado	MUST
V	Quality First — gates de qualidade bloqueiam, nao avisam	MUST
VI	Visceral > Logico — linguagem absoluta, zero hesitacao	SHOULD

Gates automaticos interceptam violacoes em tempo real. Nao existe “aprovar mesmo assim”. Ou os criterios foram cumpridos, ou a operacao nao ocorre.

---

4 Gates de Qualidade — Enforced por Sentinel

Cada oferta no ecossistema percorre quatro fases. Cada transicao exige um validate_gate — uma chamada MCP que verifica precondicionais booleanas antes de liberar o avanco. O Sentinel (agente guardiao) e o executor desses gates.

IDLE -> RESEARCH -> BRIEFING -> PRODUCTION -> DELIVERED
           |             |            |              |
      [Research       [Briefing   [Producao     [Entrega
        Gate]           Gate]       Gate]         Gate]

Gate	Ferramentas Obrigatorias	O que bloqueia
Research	firecrawl_agent + voc_search	Avanco para briefing sem VOC real
Briefing	get_phase_context	Avanco para producao sem briefing completo
Producao	blind_critic + emotional_stress_test	Escrita em production/ sem mecanismo VALIDATED
Entrega	black_validation (5 Lentes, score >= 8)	Entrega com copy abaixo do padrao

Como funciona na pratica: Ao pedir avanco de fase, o hook validate-gate-prereq.ts consulta o registro de ferramentas usadas na sessao atual e compara com a lista obrigatoria do gate. Se qualquer ferramenta estiver ausente, a resposta e direta:

BLOCKED: Ferramentas obrigatorias nao utilizadas.
Faltam: firecrawl_agent
Usar firecrawl_agent ANTES de chamar validate_gate.

O gate de Producao tem dupla condicao: nao basta ter passado pelo briefing. O mecanismo-unico.yaml da oferta DEVE estar com estado VALIDATED ou APPROVED. Um mecanismo fraco contamina toda a copy que vem depois — VSL, LP, criativos, emails. Entao o sistema bloqueia producao ate o mecanismo estar validado por consensus + blind_critic.

O gate de Entrega usa black_validation com as 5 Lentes (Escalada Emocional, Densidade Narrativa, Logo Test, Teste Visceral, Zero Hesitacao). Score minimo 8/10. Abaixo disso, a copy volta para revisao — sem excecao.

---

Agent Authority — Matriz de Delegacao

Cada agente no Copy Squad tem escopo definido e operacoes exclusivas. O sistema nao confia em disciplina — hooks bloqueiam operacoes realizadas pelo agente errado.

Agente	Operacoes Exclusivas	Bloqueado Para Outros
Ops (@ops)	git push, gh pr create	Todos os outros agentes
Hawk (@critic)	blind_critic, EST, black_validation	Helix executa inline apenas via subagent Hawk
Atlas (@briefer)	get_phase_context, fases HELIX	Nenhum agente bypassa o briefing
Sentinel	validate_gate (enforcement)	Agentes nao chamam validate_gate diretamente em producao
Helix (@chief)	Orquestracao geral	Nao executa MCPs de qualidade diretamente

O hook de git push intercepta qualquer tentativa de push por agentes nao-Ops e rejeita. A regra nao esta num README — esta implementada em TypeScript que roda antes de cada git push.

Helix e o caso mais critico. Como orquestrador, Helix poderia ser tentado a executar tudo inline. A rule copy-squad-delegation.md e o task-mcp-matrix.yaml com 59 tasks mapeadas definem explicitamente o execution_context de cada step: inline, subagent ou direct. Qualquer step com execution_context: subagent exige que Helix lance um Agent() com o prompt template correto — nunca use Skill para carregar instrucoes de outro agente inline.

---

Bloqueio por Path

Alem dos gates por fase, o ecossistema implementa bloqueio por caminho de arquivo. Escrever no diretorio errado sem ter passado pelo gate correspondente resulta em rejeicao pelo hook phase-gate.ts.

Escrita em	Precondicionais	Se falhar
research/	Nenhuma	—
briefings/	gates.research = true	BLOQUEIA
production/	gates.briefing = true E mecanismo VALIDATED	BLOQUEIA

O bloqueio e duplo em production/: nao basta ter briefing aprovado. O mecanismo unico precisa estar validado. Isso protege contra o caso em que o mecanismo foi definido no briefing mas ainda nao passou pelos gates de validacao (consensus + blind_critic + emotional_stress_test).

---

65 Hooks — O Sistema Nervoso Autonomo

65 hooks interceptam eventos do Claude Code CLI automaticamente. Nao existe “lembrar de rodar”. PreToolUse, PostToolUse, UserPromptSubmit, Stop, PreCompact — cada evento tem hooks correspondentes que disparam sem intervencao humana.

Categoria	Quantidade	Exemplos
Validacao e Gates	9	validate-gate-prereq, phase-advance-gate, mecanismo-validation, stop-copy-validation
Captura e Tracking	8	gotcha-capture, pattern-capture, record-tool-in-offer, gate-tracker, journey-log
Injecao e Contexto	6	synapse-inject, gotcha-inject, pattern-suggest, discover-offer-context, memory-context
Producao e Review	5	post-production-validate, production-preflight, copy-version-backup, analyze-production-task, curation
Dashboard e Metrics	4	dashboard-emit, dashboard-autostart, session-digest-save, metrics-flush
Protecao	7	detect-clear-protect, pre-compact-save, save-session-state, doc-rot-guardian, doc-rot-detector, handoff-engine
Subagents	5	subagent-type-warning, subagent-output-audit, subagent-start-log, subagent-stop-validate, subagent-mcp-check
Utilidades	21	auto-approve-reads, filter-bash-output, setup-environment, log-tool-failure, skill-trigger, etc

Validacao e Gates sao os guardioes primarios. Nada avanca sem eles. validate-gate-prereq verifica ferramentas obrigatorias antes de permitir validate_gate. mecanismo-validation garante que o MUP/MUS esta validado antes de producao. stop-copy-validation intercepta o fim de sessao para verificar se copy produzida passou por black_validation.

Captura e Tracking constroem a memoria do sistema. record-tool-in-offer grava cada ferramenta MCP usada no helix-state.yaml da oferta — e exatamente esse registro que validate-gate-prereq consulta para verificar se as obrigatorias foram cumpridas. gotcha-capture registra erros com dedup por similaridade Jaccard > 0.4 para nao repetir armadilhas ja conhecidas.

Injecao e Contexto entregam informacao relevante automaticamente. synapse-inject carrega as rules corretas para a fase atual. discover-offer-context detecta a oferta ativa e exibe estado + proxima acao no inicio da sessao. gotcha-inject insere no contexto os erros ja documentados para a oferta atual — sem precisar lembrar de consultar.

Subagents garantem integridade da delegacao. subagent-type-warning alerta se um subagent customizado for disparado (custom types nao herdam MCPs automaticamente). subagent-output-audit verifica qualidade dos outputs antes de aceitar o retorno do subagent.

---

SYNAPSE — Gerenciamento de Contexto

SYNAPSE e o motor que injeta as rules certas no momento certo, gerenciando o orcamento de tokens por fase e evitando sobrecarga de contexto.

Fase	Rules Carregadas	Tokens
IDLE	constitution.md	~500
RESEARCH	constitution + voc-research + anti-homo + tool-usage-matrix	~8.000
BRIEFING	constitution + briefings-helix + mecanismo-unico + tool-usage-matrix	~7.000
PRODUCTION	constitution + copy-production + copy-chief + anti-homo	~9.000
REVIEW	constitution + copy-chief + tool-usage-matrix	~5.000

Context Brackets por consumo:

Bracket	Consumo	Comportamento
FRESH	<= 30%	Contexto completo, producao normal
MODERATE	<= 50%	Apenas essenciais carregadas
DEPLETED	<= 70%	Minimo viavel
CRITICAL	<= 85%	/compact de emergencia — producao bloqueada

Quando o contexto atinge CRITICAL, o hook doc-rot-guardian.ts bloqueia escritas em production/ ate que /compact seja executado. Isso nao e opcional — e um gate implementado em TypeScript que nao tem como ser ignorado.

---

Task-MCP Matrix — 59 Tasks Mapeadas

O task-mcp-matrix.yaml define para cada uma das 59 tasks do ecossistema: o execution_context (inline, subagent, direct), os MCPs autorizados, e o agente executor.

Isso resolve um problema critico: sem mapeamento explicito, um orquestrador como Helix poderia executar MCPs de qualidade diretamente (violando Agent Authority) ou delegar para o agente errado. Com a matrix, cada task tem um unico caminho de execucao correto.

Execution Context	Significado	Exemplo
inline	Helix executa diretamente com MCPs proprios	validate_gate, get_phase_context
subagent	Helix lanca Agent() com prompt template especifico	blind_critic via Hawk, VSL via Echo
direct	Usuario ativa a persona diretamente	Sessoes de producao interativa

A matrix e a fonte de verdade para o copy-squad-delegation.md. Qualquer violacao — Helix usando MCP de Hawk inline, ou Atlas escrevendo em production/ — e capturada pelos hooks de validacao antes que o dano ocorra.

---

BSSF — Best Solution Selection Framework

O BSSF e o protocolo de decisao para qualquer problema do ecossistema: gaps de enforcement, hooks que falham, gates com comportamento inesperado, MCPs com outputs inconsistentes.

Regra cardinal: NUNCA recomendar uma solucao sem explorar 5 alternativas estruturalmente diferentes primeiro.

1. GERAR 5 solucoes estruturalmente diferentes:
   - Solucao 1: Mais rapida (band-aid tipico)
   - Solucao 2: Mais escalavel (100x volume)
   - Solucao 3: Mais mantivel (menos debt)
   - Solucao 4: Mais criativa
   - Solucao 5: Mais resiliente (falha graciosa)

2. AVALIAR com pesos:
   - Integridade Estrutural: 40%
   - Escalabilidade: 20%
   - Mantibilidade: 20%
   - Impacto Imediato: 10%
   - Impacto Longo Prazo: 10%

3. CRIAR matriz de decisao (score 1-10 por criterio)

4. RECOMENDAR a melhor — nunca a mais rapida

GBS — Greedy Bypass Score

Uma unica pergunta: “Em quantas semanas este problema volta?”

Timeline	GBS	Status
1-2 semanas	10-30	REJEITAR (band-aid puro)
3-4 semanas	40-60	QUESTIONAR
5-8 semanas	70-85	ACEITAR
8+ semanas	90-100	ESTRUTURAL

Regra absoluta: GBS < 70 = REJEITAR. Sem excecoes.

Todas as decisoes BSSF ficam registradas em ~/.claude/gap-decision-log.md com data, gap, 5 solucoes, matriz e resultado. Se um gap similar aparecer no futuro, a decisao anterior e consultada antes de reinventar a roda.

O ecossistema tem 13 agentes, dezenas de workflows e centenas de regras. No dia a dia, voce usa 12 ativacoes. Cada uma encapsula uma operacao complexa numa unica chamada — o agente ou skill carrega o contexto necessario, orquestra os subagentes e valida os outputs automaticamente.

---

@helix

Orquestrador central. Ponto de entrada para qualquer pipeline.

Ativa o agente Helix (@chief) — o orquestrador do Copy Chief BLACK. Helix nao executa copy: ele roteia tarefas para os agentes certos, enforca gates, gerencia estado e delega via subagents isolados.

@helix
# "qual o status da oferta-exemplo?"
# "inicie o pipeline para nova oferta de saude"
# "proximo passo para oferta-exemplo"

Quando usar: Sempre que quiser iniciar, retomar ou checar qualquer pipeline. Se voce nao sabe por onde comecar, comece aqui.

---

@atlas

Briefing HELIX fase a fase. Validacao de mecanismo.

Ativa o agente Atlas (@briefer). Atlas conduz as 10 fases do HELIX — de Mergulho no Avatar ate Oferta e Garantia — com validacao automatica entre cada transicao. MCPs autorizados: validate_mecanismo, blind_critic, create_mecanismo, update_mecanismo.

@atlas
# "preencha as fases 1-4 para oferta-exemplo"
# "valide o MUP de oferta-exemplo"
# "continue o briefing de onde parei"

Quando usar: Para iniciar ou continuar o briefing HELIX de uma oferta. Para criar ou validar o Mecanismo Unico (MUP/MUS).

---

@vox

VOC, avatar, pesquisa de audiencia.

Ativa o agente Vox (@researcher). Vox extrai citacoes de audiencia (VOC), constroi perfis de avatar, mapeia DRE e sintetiza insights de pesquisa. MCPs autorizados: voc_search, semantic_memory_search, Apify, Firecrawl.

@vox
# "extraia VOC para o nicho de saude articular"
# "construa perfil de avatar para oferta-exemplo"
# "pesquise DRE para mulheres 50+ com prisao de ventre"

Quando usar: Antes de qualquer producao. VOC solida e pre-requisito para briefing e copy — sem ela, o mecanismo nao tem ancoragem emocional real.

---

@cipher

Mineracao de anuncios concorrentes. Spy de criativos.

Ativa o agente Cipher (@miner). Cipher faz spy na Meta Ads Library, quebra criativos frame a frame, mapeia angulos de copy em escala e identifica padrao de hooks que funcionam no nicho. MCPs autorizados: fb_ad_library_*, Apify.

@cipher
# "mine anuncios de suplementos cognitivos no Meta"
# "quebre o criativo C3 da oferta-exemplo"
# "quais angulos estao em escala no nicho articular?"

Quando usar: Na fase de research competitivo. Antes de produzir criativos — para nao reinventar o que ja foi validado pelo mercado.

---

@echo

Producao de VSL capitulo a capitulo.

Ativa o agente Echo (@vsl). Echo produz VSLs usando a metodologia Puzzle Pieces — 6 capitulos em sequencia: Hook, Lead, Body, Proof, Offer e Close. MCP autorizado: write_chapter.

@echo
# "produza o capitulo Hook da VSL de oferta-exemplo"
# "escreva o capitulo Proof com as 3 historias clinicas"
# "refaca o Lead com angulo de medo de dependencia"

Quando usar: Apos o briefing HELIX estar completo e o mecanismo VALIDATED. Cada capitulo e produzido com o contexto do helix-complete.md e os language-patterns.md da VOC.

---

@hawk

Validacao de qualidade. Stress-test de copy.

Ativa o agente Hawk (@critic). Hawk executa a bateria completa de validacao com 4 MCPs: blind_critic (avalia sem ver o briefing), emotional_stress_test (detecta genericidade e IA-speak), layered_review (revisao em camadas) e black_validation (5 Lentes — score minimo 8).

@hawk
# "valide o hook da VSL de oferta-exemplo"
# "stress-test nos criativos da oferta-exemplo"
# "rode black_validation no email de upsell"

Quando usar: Depois de qualquer producao — antes de considerar um asset pronto. Hawk e o gate final de qualidade. Nenhuma peca vai para producao sem passar por ele.

---

/helix-system-agent

Briefing HELIX completo em 10 fases.

Skill que conduz o briefing HELIX de ponta a ponta. O agent guia fase a fase, com validacao automatica entre cada transicao. Persiste cada fase em briefings/phases/faseXX-nome.md e gera o briefings/helix-complete.md ao final.

/helix-system-agent
# "preencha briefing para oferta-exemplo"
# "continue helix de onde parei"

As 10 fases sao interdependentes — cada uma alimenta a proxima. O helix-complete.md final e a biblia de toda producao: promessa, avatar, DRE, escalada emocional, MUP, MUS, indutor, one belief, solucoes falsas, prova e oferta.

---

/audience-research-agent

Pesquisa de audiencia profunda.

Skill para research completo de audiencia — VOC, perfil de avatar, mapeamento DRE, linguagem nativa, escalada emocional. Roda subagents especializados com acesso a Apify, Firecrawl e voc_search.

/audience-research-agent
# "pesquise audiencia para saude cognitiva 50+"
# "mapeie DRE para mulheres com prisao de ventre cronica"

Quando usar: Antes do briefing HELIX. Research de audiencia solida garante que o mecanismo e a copy usem as palavras exatas que a audiencia ja usa para descrever seu problema.

---

/production-agent

Pipeline completo de producao.

Skill que dispara producao de todos os assets em paralelo: VSL (6 capitulos), Landing Page (blocos persuasivos), Criativos (variacoes por plataforma) e Email Sequence. Cada asset recebe o helix-complete.md e os language-patterns.md como contexto.

/production-agent
# "produza todos os assets de oferta-exemplo"
# "gere VSL + LP para oferta-exemplo"

Pre-requisito: Gates de research E briefing passados, mecanismo VALIDATED ou APPROVED. O skill bloqueia com mensagem explicita se algum gate estiver pendente.

---

/copy-critic

Stress-test adversarial. Protocolo STAND.

Skill que tenta destruir sua copy — se nao conseguir, ela esta pronta. STAND tem 5 fases: Setup (carrega copy + briefing), Thesis (pontos fortes), Antithesis (ataque impiedoso), Nuance (ponderacao de criticas) e Decision (veredicto com score).

/copy-critic
# "critique a VSL da oferta-exemplo"
# "valide o MUP de oferta-exemplo"
# "stress-test nos criativos do oferta-exemplo"

O critic ataca especificamente: genericidade, cliches, Logo Test, mecanismo mal aplicado, VOC ausente, escalada emocional quebrada. Veredicto final: APROVADO / REVISAR / REFAZER.

---

/criativos-agent

Producao de criativos em batch.

Skill para producao de criativos — hooks, scripts de video, copies para Meta, YouTube e TikTok. Usa a metodologia Hormozi Ad Assembly para reels virais e aplica os angulos mapeados pelo Cipher na fase de research.

/criativos-agent
# "produza 5 criativos para oferta-exemplo no Meta"
# "gere scripts de reels com angulo de medo"
# "crie variacoes de hook baseadas na VOC"

Quando usar: Apos VSL e LP aprovados. Criativos sao o topo do funil — precisam do mecanismo e da linguagem da audiencia ja refinados.

---

/ecosystem-guide

Orientacao geral. Ponto de entrada para qualquer duvida.

Skill que consulta project_state.yaml e helix-state.yaml de cada oferta e retorna: fase atual, deliverables pendentes, gates passados e bloqueados, health score e acao recomendada.

/ecosystem-guide
# "em que fase esta a oferta-exemplo?"
# "qual o proximo passo para oferta-exemplo?"
# "quero criar uma nova oferta de emagrecimento"

Quando usar: Sempre que estiver voltando depois de dias sem trabalhar numa oferta, ou quando nao souber qual e o proximo passo. E o GPS do ecossistema.

---

Agente vs Skill

Use Agente (@)	Use Skill (/)
Tarefa especifica com dialogo	Workflow automatizado completo
Quando quer controle granular	Quando quer operacao de ponta a ponta
Uma fase, um deliverable	Multiplas fases, multiplos deliverables
Refinamento e ajustes	Execucao inicial
Quer ver o raciocinio do agente	Quer resultado direto

Agentes carregam personas completas e dialogam. Skills disparam workflows orquestrados com multiplos subagents, gates e validacoes automaticas. Os dois se complementam — use agentes para controle, skills para velocidade.

A pior coisa que pode acontecer num ecossistema de copy nao e produzir copy ruim — e perder 3 horas de contexto porque o terminal fechou, o /clear foi acidental, ou a sessao encerrou no meio de uma producao. O ecossistema trata recovery como cidadao de primeira classe: multiplas camadas de persistencia automatica que garantem que voce NUNCA perca trabalho.

---

helix-state.yaml — Persistencia entre Sessoes

Cada oferta tem um helix-state.yaml no seu diretorio. Esse arquivo e atualizado automaticamente a cada chamada de tool e persiste no filesystem independente do que acontece com a sessao Claude.

Fechar o terminal, reiniciar a maquina, trocar de oferta por uma semana e voltar — o estado esta intacto:

current_phase: BRIEFING
phases_completed:
  - RESEARCH
gates:
  research: PASSED
  briefing: IN_PROGRESS
tools_used:
  - voc_search
  - firecrawl_scrape
  - write_chapter
last_updated: 2026-03-13T14:30:00Z

Para ver onde voce parou em qualquer oferta:

cat nicho-exemplo/oferta-exemplo/helix-state.yaml

O sistema tambem faz isso automaticamente ao iniciar uma sessao — detecta a ultima oferta ativa e apresenta fase, gates e proxima acao recomendada.

---

Agent Handoff — Artefatos Cross-Session

Quando um agente produz um veredicto que roteia trabalho para outro agente (GO/NO-GO, PASS/FAIL, APPROVE/REJECT), ele persiste um artefato de handoff em disco antes de encerrar.

# .aiox/handoffs/handoff-atlas-to-hawk-20260313.yaml
handoff:
  from_agent: atlas
  to_agent: hawk
  last_command: helix-phase-5
  story_context:
    story_id: oferta-exemplo
    story_path: nicho-exemplo/oferta-exemplo
    story_status: BRIEFING
    current_task: Validacao mecanismo fase 5
    branch: windows
  decisions:
    - MUP aprovado com RMBC Structural 12/15
    - nova_causa definida como {exemplo-nova-causa}
  next_action: Rodar blind_critic + EST no MUS draft
  consumed: false

Na proxima sessao, o agente receptor le o arquivo automaticamente na ativacao e retoma o contexto sem necessidade de reconstrucao manual. Artefatos vivem em .aiox/handoffs/ (gitignored, runtime only).

---

SYNAPSE — Compactacao Automatica de Contexto

SYNAPSE monitora o consumo de tokens em tempo real e age antes que o contexto degrade a qualidade da copy.

Como funciona:

1. SYNAPSE rastreia o uso do contexto por zona (primacy / meio / recency)
2. Quando o contexto se aproxima dos limites, compacta automaticamente o historico de sessao
3. Preserva estado critico: constitution, briefing da oferta, trabalho atual
4. Descarta o que e compressivel: historico de iteracoes, metadata de tools, logs de sessao

Voce nao precisa fazer nada. SYNAPSE age silenciosamente antes da degradacao ocorrer.

Quando a compactacao automatica nao e suficiente:

Sinal	O que fazer
Respostas comecando a ficar genericas	/compact manual
Instrucoes do briefing sendo esquecidas	/compact + recarregar briefing
MUP sendo aplicado de forma inconsistente	/compact urgente
Copy convergindo para os mesmos angulos	Contexto cheio — /compact imediato

---

Gate Persistence — Nao Da para Bypassar Reiniciando

Gates sao rastreados no helix-state.yaml, nao na sessao do Claude. Isso tem uma consequencia importante: reiniciar a sessao nao reseta gates.

Se o gate de research esta bloqueado porque voc_search nao foi chamado, fechar e reabrir o terminal nao muda isso. O validate_gate verifica o helix-state.yaml toda vez.

Isso e uma feature, nao um bug. Gates existem para garantir qualidade. Um gate que pode ser bypassado por restart nao e um gate — e uma sugestao.

Para entender o que um gate bloqueado esta pedindo:

validate_gate gate_type="research" offer_path="nicho-exemplo/oferta-exemplo"

O retorno e especifico: nao “pesquisa incompleta” mas sim “falta voc_search (0 chamadas registradas) e firecrawl_scrape (minimo 3, encontradas 1)”.

---

Offer CONTEXT.md — Contexto Completo por Oferta

Cada oferta tem um CONTEXT.md que contem tudo que o sistema precisa para produzir copy alinhada: mecanismo, avatar, DREs, gates, estado atual, arquivos-chave.

nicho-exemplo/oferta-exemplo/CONTEXT.md         # Contexto completo da oferta
nicho-exemplo/oferta-exemplo/helix-state.yaml   # Estado atual (gates, fase, tools)
nicho-exemplo/oferta-exemplo/mecanismo-unico.yaml  # MUP/MUS validados

Ao ativar uma oferta, o CONTEXT.md e carregado automaticamente. Se voce suspeita que o contexto da oferta esta desatualizado em relacao ao estado real, o Doc Rot Detector escaneia inconsistencias entre CONTEXT.md e helix-state.yaml e gera um report com severidade e recomendacoes de fix.

---

Troubleshooting Rapido

”Nao sei onde parei”

Verificar o helix-state.yaml da oferta:

cat nicho-exemplo/oferta-exemplo/helix-state.yaml

Mostra current_phase, gates, tools_used e last_updated. Se nao souber qual oferta estava ativa, o hook de SessionStart detecta automaticamente a ultima trabalhada e apresenta o estado.

”Copy generica”

O problema quase sempre e um de dois: copy produzida sem os arquivos obrigatorios, ou contexto degradado.

Sem arquivos obrigatorios: Verificar se a copy tem secao GATE. Se nao tem, foi produzida sem ler briefing, VOC e synthesis.

"refaca lendo os arquivos obrigatorios: helix-complete.md, synthesis.md, language-patterns.md"

Contexto degradado: Rodar /compact e refazer com contexto fresco. Hawk tambem detecta genericidade via emotional_stress_test — score de genericidade abaixo de 8 bloqueia aprovacao.

”Gate bloqueado”

validate_gate gate_type="research" offer_path="nicho-exemplo/oferta-exemplo"

O gate retorna lista detalhada do que falta. Cada item e acionavel — nao “pesquisa incompleta” mas sim quais MCPs especificos nao foram chamados e quantas vezes.

Lembrar: reiniciar a sessao nao desbloqueia gate. O que desbloqueia e executar o que o gate esta pedindo.

”Agente errado foi ativado”

Helix gerencia o roteamento via Task-MCP Matrix. Se um agente errado foi invocado:

1. Verificar squads/copy-chief/data/task-mcp-matrix.yaml para o contexto de execucao correto da task
2. Se execution_context: subagent — Helix deve usar Agent() com template de squads/copy-chief/templates/subagent-prompts/
3. Se execution_context: direct — instrucao ao usuario para ativar a persona diretamente

O erro mais comum: Helix usar Skill (carrega instrucoes inline) em vez de Agent() (lanca subagent isolado). O Skill consome 50%+ do contexto sem delegar — a persona e “emulada” inline, sem os MCPs corretos.

”MCP nao funciona num subagent”

Subagents customizados (researcher, copywriter) NAO herdam MCPs no runtime. Tools sao deferred e requerem ToolSearch, que nao esta disponivel para tipos customizados.

Solucao: Usar subagent_type: general-purpose para qualquer task que precise de MCP. O hook subagent-type-warning.sh emite alerta quando detecta subagent customizado sendo disparado.

”Contexto poluido ou pesado”

/compact   # Compacta preservando estado critico
/clear     # Limpa tudo (SYNAPSE salva estado antes de executar)

Usar /compact para manter o trabalho atual mas reduzir tamanho. Usar /clear quando quiser comecar do zero — o estado da oferta esta seguro no helix-state.yaml e sera detectado na proxima sessao.

”Handoff nao foi retomado”

Verificar se o artefato existe:

ls .aiox/handoffs/

Se o arquivo existe com consumed: false, o agente receptor deve le-lo na ativacao. Se o agente foi ativado mas nao retomou o contexto, verificar se o template de subagent-prompt referencia a leitura de handoffs pendentes.

”Dashboard nao carrega”

bun run ~/.claude/dashboard/server.ts
# Acesse http://localhost:4001

Verificar: Bun instalado (bun --version), porta 4001 livre, SQLite nao corrompido. Em ultimo caso, deletar ~/.claude/dashboard/data.db e reiniciar — o database e recriado automaticamente. O dashboard e apenas observabilidade; nao afeta o pipeline de producao se estiver fora do ar.

Copy Chief BLACK v1.4.0

13 agentes especializados organizados em dois tiers de capacidade. Cada agente tem escopo definido, MCPs autorizados e autoridade delimitada — nenhum agente faz o que outro faz. Helix orquestra. Hawk valida. Sentinel enforcea. Os demais executam.

O modelo de isolamento e intencional: cada agente recebe apenas os MCPs necessarios para sua funcao. Isso previne drift de escopo e garante que gates sejam respeitados — um agente de producao nao pode pular validacao, e um orquestrador nao produz copy diretamente.

---

Tier OPUS — Analise Profunda (5 agentes)

Agentes de analise estrategica e producao de alta complexidade. Rodam no modelo mais capaz para tarefas que exigem raciocinio profundo, validacao multi-camada ou orquestracao de pipelines.

Agente	Handle	Funcao	MCPs Autorizados
Helix	@chief	Orquestrador. Roteia tarefas, enforcea gates, gerencia estado do pipeline. Delega via subagents — nunca executa copy diretamente.	validate_gate, get_phase_context
Atlas	@briefer	Briefing HELIX 10 fases. Criacao e validacao de MUP/MUS. Guardiao do mecanismo unico.	validate_mecanismo, blind_critic, create_mecanismo, update_mecanismo
Echo	@vsl	Producao de VSL capitulo a capitulo via metodologia Puzzle Pieces (Hook, Lead, Body, Proof, Offer, Close).	write_chapter
Scout	@creative	Producao criativa em batch, exploracao de hooks, quebra de criativos concorrentes.	fb_ad_library_analyze_*, apify_*
Strategist	—	Analise de portfolio, design de funil, posicionamento, modelagem de ROI.	Nenhum (file-only)

---

Tier SONNET — Execucao (8 agentes)

Agentes de execucao especializada. Cada um domina uma disciplina especifica do pipeline — pesquisa, mineracao, producao de copy, validacao ou operacoes.

Agente	Handle	Funcao	MCPs Autorizados
Vox	@researcher	Extracao de VOC, perfil de avatar, pesquisa de audiencia, sintese de research.	voc_search, semantic_memory_search, apify_*, firecrawl_*
Cipher	@miner	Spy de anuncios concorrentes, quebra de videos frame a frame, verificacao de escala.	fb_ad_library_*, apify_*
Forge	@lp	Producao de blocos de Landing Page, mapeamento emocional de funil.	Nenhum (file-only)
Blade	@producer	Sequencias de email, copy de upsell e downsell.	Nenhum (file-only)
Spark	@reels	Scripts de reels virais usando metodo Hormozi Ad Assembly.	Nenhum (file-only)
Hawk	@critic	Validacao de qualidade com bateria completa: blind_critic, EST, layered_review, black_validation.	blind_critic, emotional_stress_test, layered_review, black_validation
Sentinel	@gatekeeper	Enforcement de gates, auditorias de fase, verificacao de pre-requisitos.	validate_gate, get_phase_context
Ops	@ops	Operacoes git, health checks, migrations, manutencao de infraestrutura.	Nenhum (bash/git only)

---

Modelo de Orquestracao

O pipeline segue um fluxo definido com responsabilidades claras em cada etapa:

Helix roteia
  → Vox/Cipher (research)
  → Atlas (briefing + mecanismo)
  → Echo/Forge/Blade/Spark (producao)
  → Hawk (validacao)
  → Sentinel (gate enforcement)

Helix nunca emula outros agentes inline. Quando precisa delegar, usa a ferramenta Agent() com templates de prompt isolados de squads/copy-chief/templates/subagent-prompts/. Cada subagent recebe contexto isolado com apenas seus MCPs autorizados — sem contaminacao de escopo entre agentes.

Hawk e o unico agente com autoridade de validacao. Nenhum asset de producao avanca sem passar pela bateria completa: blind_critic avalia sem ver o briefing (detecta genericidade), emotional_stress_test detecta IA-speak, layered_review revisa em camadas e black_validation aplica as 5 Lentes com score minimo 8.

Sentinel enforcea gates independentemente. Nao e possivel avancar de fase sem os pre-requisitos satisfeitos — Sentinel verifica e bloqueia se necessario.

---

Protocolo de Handoff

Quando um agente e trocado por outro (@agente), o contexto do agente anterior e compactado em um artefato de handoff (~379 tokens) em vez de ser descartado ou acumulado integralmente.

O artefato preserva o que importa: story/oferta ativa, fase atual, decisoes-chave tomadas, arquivos modificados e proximo passo. O que e descartado: persona completa do agente anterior, lista de comandos, configuracoes de ferramentas — tudo que nao e necessario para continuidade.

handoff:
  from_agent: "atlas"
  to_agent: "echo"
  story_context:
    story_id: "oferta-exemplo"
    story_status: "briefing-complete"
    current_task: "producao VSL"
    branch: "windows"
  decisions:
    - "MUP aprovado: {Exemplo de MUP Aprovado}"
    - "MUS: {Exemplo de MUS}"
  next_action: "iniciar capitulo Hook da VSL"

Resultado pratico: troca de agentes custa ~379 tokens de contexto adicional, nao 3-5K. Em sessoes longas com multiplas trocas, isso representa 50-70% de reducao de contexto acumulado.

---

Base de Conhecimento

O Copy Chief BLACK opera sobre tres camadas de conhecimento estruturado, todas em squads/copy-chief/data/:

helix-ref/ — Framework de validacao (fonte de verdade)

Arquivo	Conteudo
core/RMBC.md	Framework RMBC: criterios estruturais /15, 4 Camadas obrigatorias, Logo Test, anti-superficialidade
core/formulas_e_criterios.md	Gates por fase, criterios de espelhamento MUP-MUS, formulas de copy
core/puzzle_pieces.md	Metodologia de producao VSL: 6 pecas, sequencia, criterios por capitulo
core/dre-escalada.md	Mapeamento DRE (Dor, Raiva, Esperanca) e escalada emocional por nivel

craft/ — Psicologia e escrita

Arquivo	Conteudo
psicologia-persuasao.md	Principios de persuasao, triggers emocionais, arquitetura de crenca
tecnicas-escrita.md	Tecnicas de escrita persuasiva, ritmo, transicoes, especificidade
erros-comuns.md	Catálogo de erros frequentes em copy: genericidade, IA-speak, cliches

critic-data/ — Dados de validacao para Hawk

Referencias e benchmarks usados pelos MCPs de validacao — padroes de genericidade, exemplos de Logo Test aprovado/reprovado, calibracao de scores por nicho.

Alteracoes em helix-ref/ obrigam atualizacao correspondente nos prompts e no codigo MCP. O checklist de alinhamento em docs/checklists/mecanismo-alignment-checklist.md garante que as tres camadas (reference, prompt, code) permanecam em sincronia.

Arquitetura em Camadas

O ecossistema nao e uma ferramenta de copy com IA. E um sistema de producao multi-agente com separacao explicita de responsabilidades em camadas que se constroem uma sobre a outra.

Camada 10: Knowledge Base (helix-ref, craft, critic, leads, lp, creative)
Camada 9:  Rules (.claude/rules/ — carregamento contextual automatico)
Camada 8:  Hooks (65 automacoes — enforcement, tracking, protecao)
Camada 7:  MCP Tools (10 ferramentas TypeScript de copywriting)
Camada 6:  HELIX System (10 fases, template-driven)
Camada 5:  Task-MCP Matrix (59 tasks com execution_context mapeado)
Camada 4:  Copy Squad (13 agentes, 2 tiers, 1 orquestrador)
Camada 3:  SYNAPSE (context engine — budget, injecao, brackets)
Camada 2:  AIOX Framework (orquestracao multi-agente, story-driven dev)
Camada 1:  Constitution (principios inegociaveis — a gravidade do sistema)

Cada camada superior depende das inferiores. Hooks (8) executam dentro das regras impostas pela Constitution (1). Agentes (4) operam dentro dos limites definidos pelo AIOX Framework (2). MCP Tools (7) implementam os criterios definidos na Knowledge Base (10). A hierarquia nao e decorativa — e o mecanismo de enforcement.

---

Constitution — A Gravidade do Sistema

Seis principios que o sistema torna tecnicamente impossivel de ignorar. Nao sao guidelines — sao constraints implementadas em hooks, gates e regras de bloqueio.

Artigo	Principio	O que bloqueia na pratica
I	CLI First	Nenhuma funcionalidade existe apenas na UI
II	Agent Authority	git push bloqueado para nao-Ops, MCPs de qualidade bloqueados para Helix inline
III	DRE-First	VOC obrigatorio antes de briefing — emocao vem dos dados, nao do copywriter
IV	No Invention	blind_critic penaliza statements sem rastreabilidade a VOC ou estudo
V	Quality First	Gates bloqueiam avanco — nao avisam, bloqueiam
VI	Visceral > Logico	Lista anti-homogeneizacao aplicada em todos os outputs de producao

Regra cardinal derivada da Constitution: Copy confortavel = Copy que falhou. O sistema foi desenhado para tornar o caminho confortavel (pular research, inventar claims, escrever vago) mais dificil do que o caminho correto.

---

Copy Squad — 13 Agentes, 2 Tiers

O squad nao e uma lista de assistentes com personalidades diferentes. E uma organizacao com hierarquia de autoridade, escopos exclusivos, e um orquestrador central.

Tier 1 — Opus (Agentes de Raciocinio Profundo)

Agente	Persona	Escopo Principal
Helix	@chief	Orquestrador — dirige o workflow completo
Atlas	@briefer	Briefing HELIX — 10 fases, mecanismo unico
Hawk	@critic	Validacao — blind_critic, EST, black_validation
Scout	@creative	Breakdown criativo — angulos, hooks, estruturas
Forge	@lp	Producao de Landing Pages
Echo	@vsl	Producao de VSL

Tier 2 — Sonnet (Agentes de Execucao)

Agente	Persona	Escopo Principal
Cipher	@miner	Mineracao de ads — Facebook, YouTube, TikTok
Vox	@voc	VOC Research — extracoes, padroes, emocoes
Blade	@email	Sequences de email
Sentinel	@guardian	Enforcement — gates, validacao de estado
Ops	@ops	Git push, PR, infraestrutura (exclusivo)
Pixel	@ads	Criativos — hooks, scripts de video
Aria	@architect	Arquitetura tecnica do ecossistema

Helix como Orquestrador

Helix nao executa — dirige. A regra e inegociavel: Helix nunca usa Skill para carregar instrucoes de outro agente inline. Helix sempre usa Agent() com prompt templates de squads/copy-chief/templates/subagent-prompts/ para delegar.

O task-mcp-matrix.yaml define o execution_context de cada step. Se o contexto e subagent, Helix lanca um Agent() isolado. Se e direct, Helix instrui o usuario a ativar a persona. Se e inline, Helix executa apenas com seus MCPs autorizados: validate_gate e get_phase_context.

---

Modelo de Execucao — 3 Contextos

Contexto	Mecanismo	Quando usar
inline	Helix executa com MCPs proprios	Gates, validacao de estado, contexto de fase
subagent	Agent() isolado com prompt template	Qualquer MCP de qualidade (blind_critic, EST, etc)
direct	Usuario ativa a persona diretamente	Sessoes de producao interativa longa

A separacao entre subagent e inline e critica para Agent Authority. MCPs de qualidade (blind_critic, emotional_stress_test, black_validation) sao autorizados exclusivamente para Hawk. Se Helix os chamasse inline, violaria a Constitution Artigo II. A solucao: Helix delega via Agent() para Hawk, que tem o contexto isolado e os MCPs corretos.

---

HELIX System — Briefing em 10 Fases

HELIX e o protocolo de briefing que separa pensar de escrever. Nenhuma copy de producao comeca sem todas as fases relevantes completas.

Session 1 — Fundacao:
Fase 1:  Identificacao e Posicionamento  — produto, avatar inicial, formato, expert
Fase 2:  Pesquisa de Mercado             — concorrentes, ads escalados, tendencias
Fase 3:  Avatar e Psicologia Profunda    — DRE, horror stories, escalada emocional
Fase 4:  Niveis de Consciencia           — framework Schwartz, progressao awareness

Session 2 — Mecanismos:
Fase 5:  Problema, Vilao e MUP           — nova causa, sexy cause, vilao unico
Fase 6:  Solucao, Especialista e MUS     — 4 Camadas, ingrediente hero, gimmick
Fase 7:  Big Offer                       — value stack, reason why, garantia

Session 3 — Execucao:
Fase 8:  Fechamento e Pitch              — CTA, dualidade, urgencia
Fase 9:  Leads e Ganchos                 — 10+ hooks, 5 leads, framework Clayton
Fase 10: Progressao Emocional e VSL      — ONE BELIEF, 7 fases emocionais

Principio fundamental: A separacao entre briefing (pensar) e producao (escrever) e o que distingue copy estrategica de output generativo. Um LLM sem briefing estruturado produz o que parece certo. Com HELIX, produz o que foi provado pelo VOC.

O estado de cada fase persiste em helix-state.yaml na raiz da oferta. Fechar o terminal, reiniciar, voltar em 3 dias — o estado esta intacto. Nenhuma fase pode ser marcada completa sem seu deliverable correspondente existir e ter passado pelo gate.

---

MCP Tools — 10 Ferramentas TypeScript

O plugin MCP expoe 10 ferramentas especializadas para operacoes de copywriting que nao existem em nenhum MCP generico.

Tool	Funcao
validate_gate	Verifica precondicionais de fase — a chamada central do Sentinel
get_phase_context	Retorna contexto HELIX da fase atual da oferta
blind_critic	Avalia copy com criterios RMBC (Relevancia, Mecanismo, Beneficio, Credibilidade)
emotional_stress_test	Testa genericidade e escalada emocional — score 0-10
black_validation	5 Lentes de validacao final (Logo Test, Zero Hesitacao, etc)
layered_review	Review em camadas por criterio especifico
write_chapter	Producao estruturada de capitulos com template
voc_search	Busca semantica no corpus VOC da oferta
swipe_search	Busca em swipe files por angulo, nicho ou emocao
semantic_memory_search	Busca cross-oferta em memoria semantica

Cada tool implementa criterios definidos na Knowledge Base (helix-ref/). A reference e a fonte de verdade — o tool implementa o que a reference define, nunca o contrario. Qualquer alteracao em helix-ref/RMBC.md obriga atualizacao correspondente em blind_critic. A rule mecanismo-alignment.md enforcea esse mapeamento.

---

Sistema de Rules — Carregamento Contextual

Rules em .claude/rules/ sao carregadas automaticamente pelo Claude Code quando arquivos correspondentes estao sendo editados. Rules com frontmatter paths: so carregam quando o path faz match — zero overhead quando a rule nao e relevante.

Rule File	Quando Carrega	Funcao
agent-authority.md	Sempre	Matriz de delegacao e operacoes exclusivas
agent-handoff.md	Em troca de agente	Compactacao de contexto em switches
copy-squad-delegation.md	Em squads/copy-chief/	Protocolo de delegacao do Helix
copy-craft-enforcement.md	Em producao	Carregamento obrigatorio de craft
mecanismo-alignment.md	Em references/MCP	Mapeamento reference -> tool
workflow-execution.md	Em stories/tasks	4 workflows primarios
offers/*.md	Por oferta ativa	Contexto especifico da oferta

O SYNAPSE Context Engine gerencia qual subset de rules e injetado por fase, respeitando o orcamento de tokens disponivel. Em CRITICAL (> 85% do contexto), apenas constitution.md e mantida — tudo mais e descartado ate /compact.

---

Knowledge Base — Fontes de Verdade

A Knowledge Base e dividida em colecoes com funcoes distintas. helix-ref/ e o unico que tem status de “fonte de verdade inegociavel” — os demais sao recursos de apoio.

helix-ref/ (Source of Truth)

helix-ref/
├── core/
│   ├── RMBC.md              — framework de validacao (R/M/B/C + 4 Camadas + Logo Test)
│   ├── formulas_e_criterios.md  — gates por fase, criterios de avanco
│   └── puzzle_pieces.md     — componentes do mecanismo (Sexy Cause, Paradigm Shift)
├── craft/                   — tecnicas de escrita, padroes que funcionam
├── critic/                  — criterios de critica por tipo de copy
├── leads/                   — templates e referencias para leads
├── lp/                      — frameworks de landing page
└── creative/                — referencias para criativos

A regra de alinhamento e explicita: qualquer alteracao em helix-ref/RMBC.md exige atualizacao correspondente nos prompts e no code MCP que implementa os criterios. O checklist docs/checklists/mecanismo-alignment-checklist.md documenta cada par reference -> tool que precisa estar sincronizado.

Corpus VOC (por oferta)

Cada oferta acumula seu proprio corpus VOC em {oferta}/research/. O voc_search MCP indexa esse corpus e permite busca semantica durante producao — garantindo que claims e emocoes usados em copy rastreiem para declaracoes reais do avatar, nao para inferencias do copywriter.

---

Filosofia de Design — Por Que Esta Arquitetura

Separacao de pensar e escrever. O maior erro em producao com IA e pular direto para “escreva um VSL”. Sem briefing, o modelo produz o que parece certo. Com HELIX, o modelo produz o que o VOC comprovou que ressoa com o avatar.

Enforcement tecnico sobre disciplina humana. Gates, hooks e bloqueio por path existem porque copywriters sob pressao cortam cantos — humanos ou IA. O sistema nao confia em disciplina. Ele torna o caminho errado tecnicamente mais dificil do que o correto.

Single Sources of Truth. Cada informacao tem exatamente um lugar onde vive. Estado da oferta: helix-state.yaml. Criterios de validacao: helix-ref/RMBC.md. Execution context de cada task: task-mcp-matrix.yaml. Multiplicar fontes de verdade cria divergencia inevitavel com o tempo.

Agent Authority como invariante. A separacao de responsabilidades entre agentes nao e organizacional — e funcional. Hawk valida porque tem os MCPs e o contexto para isso. Ops faz push porque e o unico com autoridade para tocar o remoto. Helix orquestra porque tem visibilidade do estado completo. Colapsar essas responsabilidades em um agente generico destroi a rastreabilidade e o enforcement.

O ecossistema nao e apenas um conjunto de agentes e ferramentas — e um sistema com memoria, contexto gerenciado e conhecimento persistente. Estas sao as camadas de inteligencia que fazem tudo funcionar de sessao em sessao.

---

helix-state.yaml — Estado Persistente por Oferta

Cada oferta tem um arquivo helix-state.yaml que persiste o estado completo do pipeline no filesystem. Fechar o terminal, reiniciar a maquina, trocar de oferta — nada disso perde progresso.

# nicho-exemplo/oferta-exemplo/helix-state.yaml
current_phase: BRIEFING
phases_completed:
  - RESEARCH
phases_in_progress:
  - BRIEFING
tools_used:
  - voc_search
  - firecrawl_scrape
  - write_chapter
gates:
  research: PASSED
  briefing: IN_PROGRESS
  production: PENDING
last_updated: 2026-03-13T14:30:00Z

O helix-state.yaml e a fonte de verdade para a fase atual, gates cumpridos e ferramentas utilizadas. Gates registrados nao podem ser bypassados reiniciando a sessao — o estado e verificado pelo sistema toda vez.

---

SYNAPSE — Motor de Contexto

SYNAPSE e o motor que gerencia o contexto do ecossistema em tempo real. Ele opera em tres dimensoes:

Token Budgets: SYNAPSE monitora o consumo de tokens e aplica orcamentos por fase. Fases de producao recebem mais contexto disponivel que fases de pesquisa. Quando o budget de uma fase esta se esgotando, SYNAPSE sinaliza antes da degradacao ocorrer.

Rule Injection: Rules e referencias sao injetadas automaticamente no momento certo. A reference RMBC entra no contexto quando Hawk inicia validacao. Os padrao de VOC entram quando a producao comeca. Voce nunca precisa carregar manualmente — SYNAPSE sabe o que cada fase precisa.

Auto-Compactacao: Quando o contexto se aproxima dos limites, SYNAPSE compacta automaticamente o historico de sessao preservando estado critico. O resultado e contexto fresco para o trabalho atual sem perda das decisoes importantes da sessao.

Zona de Contexto	O que contem	Tratamento SYNAPSE
Inicio (primacy)	Constitution, rules, briefing da oferta	Nunca compacta
Fim (recency)	Trabalho atual, proxima acao	Preserva sempre
Meio (compressivel)	Historico de iteracoes, metadata	Compacta quando necessario

---

Task-MCP Matrix — Roteamento Inteligente de Tarefas

A Task-MCP Matrix e um mapa de 59 tarefas para contextos de execucao. Para cada tarefa, define: qual agente executa, quais MCPs estao autorizados, e como deve ser executada.

3 Contextos de Execucao:

Contexto	Significado	Exemplo
subagent	Lancar via Agent() com prompt template	Hawk rodando blind_critic
direct	Ativar agente diretamente via CLI	Atlas conduzindo briefing interativo
inline	Executar no contexto atual com MCPs restritos	Helix chamando validate_gate

Helix consulta a matriz antes de executar qualquer step. Isso previne o erro mais comum de delegacao: chamar MCPs nao autorizados inline, ou usar Skill (carrega instrucoes no contexto) em vez de Agent() (lanca subagent com contexto isolado).

# Exemplo de entrada na matriz
task: hawk-blind-critic-validation
execution_context: subagent
authorized_mcps:
  - blind_critic
  - emotional_stress_test
  - black_validation
agent: hawk
template: templates/subagent-prompts/hawk-validation.md

---

Agent Handoff Protocol — Contexto Preservado na Troca de Agentes

Quando voce troca de agente (@dev → @qa, por exemplo), o agente anterior nao some — ele e compactado em um artefato de handoff de ~379 tokens. O novo agente recebe sua persona completa mais o artefato compacto com o que importa do agente anterior.

O que o artefato preserva:

• Story/oferta ativa e fase atual
• Branch git
• Decisoes arquiteturais tomadas
• Arquivos criados ou modificados
• Blockers ativos
• Proxima acao recomendada

O que e descartado:

• Persona completa do agente anterior (~3-5K tokens)
• Lista de comandos e dependencias
• Configuracoes de ferramentas

Resultado: Cada troca custa ~379 tokens em vez de acumular 3-5K. Com 3 trocas de agente, o contexto permanece em ~5K em vez de ~15K.

Handoffs cross-session sao persistidos em disco em .aiox/handoffs/handoff-{from}-to-{to}-{YYYYMMDD}.yaml. Na proxima sessao, o agente receptor le o arquivo automaticamente e retoma de onde parou.

---

Knowledge Base — Helix-Ref, Craft e Critic

O ecossistema carrega conhecimento especializado de tres diretorios:

squads/copy-chief/data/helix-ref/ — Fonte de verdade para validacao. Contem:

• RMBC.md — Framework de validacao estrutural (Relatability, Mechanism, Benefit, Credibility). Define os 15 criterios estruturais e as 3 lentes D/U/P.
• formulas_e_criterios.md — Gates por fase, espelhamento MUP→MUS, criterios de aprovacao.
• puzzle_pieces.md — Componentes do mecanismo unico: Sexy Cause, Villain, Solution.
• DRE.md — Escada de Resposta Emocional e niveis de escalada por nicho.

squads/copy-chief/data/craft/ — Conhecimento de escrita:

• Psicologia de persuasao e gatilhos especificos por nicho
• Padroes de especificidade (numeros nao-redondos, VOC verbatim, nomes proprios)
• Erros comuns e anti-patterns catalogados

squads/copy-chief/data/critic/ — Conhecimento de revisao:

• Anti-patterns por tipo de copy (VSL, LP, criativos, email)
• Exemplos anotados de copy aprovada e reprovada
• Metodologia STAND para avaliacao de hooks

As references em helix-ref/ sao a fonte de verdade para os MCP tools. Se uma reference define um criterio, o tool implementa esse criterio — nunca o contrario.

---

War Room Dashboard — Observabilidade (Nao Controle)

O dashboard em http://localhost:4001 e uma janela de observacao do que esta acontecendo no CLI. Importante: o dashboard NUNCA controla — apenas observa. Isso e o principio CLI First em acao.

Tab	O que mostra
Monitor	Eventos em tempo real via WebSocket: tools chamadas, gates passados, scores de validacao
Kanban	Ofertas organizadas por fase (RESEARCH / BRIEFING / PRODUCTION / DELIVERED)
Insights	Metricas agregadas: scores medios, taxa de aprovacao por fase, tendencias
Context	Health score do contexto, consumo de tokens, status de compactacao SYNAPSE

Stack: Bun + SQLite + WebSocket. O dashboard inicia automaticamente via hook dashboard-autostart.sh quando uma sessao comeca.

bun run ~/.claude/dashboard/server.ts  # Iniciar manualmente se necessario

Voce trabalha no CLI. O dashboard apenas mostra o que esta acontecendo.

---

Constitution Enforcement — Automatico via Hooks e Gates

A Constitution define regras nao-negociaveis. O enforcement e automatico — voce nao precisa lembrar das regras porque o sistema nao deixa viola-las.

65 hooks ativos em tres pontos de interceptacao:

Tipo de Hook	Quando dispara	Exemplos de enforcement
PreToolUse	Antes de qualquer chamada de tool	Bloqueia MCP nao autorizado para o agente; avisa sobre subagent customizado sem MCPs
PostToolUse	Apos cada chamada de tool	Registra tool no helix-state; alimenta self-learning com scores de validacao
UserPromptSubmit	Antes de processar o prompt	Salva estado antes de /clear; injeta contexto de oferta ativa

Gates automaticos: validate_gate verifica pre-condicoes antes de avancar fases. Nao adianta declarar que a pesquisa foi concluida se os MCPs obrigatorios nao foram chamados — o gate verifica o helix-state e bloqueia se as condicoes nao forem satisfeitas.

Constitution Articles enforced automaticamente:

• Artigo I (CLI First): dashboard nunca controla, apenas observa
• Artigo II (Agent Authority): cada agente so acessa MCPs autorizados na matriz
• Artigo IV (No Invention): spec.md deve rastrear todo statement para FR/NFR/CON ou research
• Artigo V (Quality First): gates de qualidade nao podem ser bypassados por restart

VOC — Voice of Customer

Extracao massiva de quotes REAIS de plataformas sociais. Conduzida por Vox (@researcher) usando os MCPs voc_search e semantic_memory_search para extrair e indexar linguagem do avatar, complementados por ferramentas externas para coleta de dados brutos.

Tool Priority (obrigatorio):

1. voc_search MCP (Vox) — busca na base indexada de VOC do ecossistema
2. semantic_memory_search MCP (Vox) — busca semantica cross-ofertas
3. Apify Actor especifico (YouTube, TikTok, Instagram, Reddit, Reclame Aqui) — coleta externa
4. Firecrawl (web scraping) — paginas de reviews, forums, comentarios
5. WebSearch (ULTIMO RESORT)

Viral-First Strategy: Antes de extrair, identificar TOP 10 conteudos mais engajados. Minimos:

• YouTube: 10K+ views OU 500+ comments
• Instagram: 5K+ likes OU 200+ comments
• TikTok: 50K+ views OU 1K+ comments

Minimos por plataforma: 50 quotes, intensidade media >=4/5, username + engagement em cada quote.

Emocoes extraidas (obrigatorio):

Emocao	Minimo Quotes	Sinais na VOC
MEDO	10+	Quotes sobre perda, morte, doenca
VERGONHA	5+	Olhar dos outros, inadequacao
CULPA	5+	Negligencia, falhar com familia
RAIVA	5+	Ser enganado, injustica
FRUSTRACAO	10+	“Ja tentei tudo”, nada funciona

Total minimo: 35 quotes emocionais categorizadas.

Ads Library Spy — Discovery-First

Analise competitiva conduzida por Cipher (@miner) usando os MCPs fb_ad_library para monitorar concorrentes conhecidos e Apify para descoberta em larga escala no nicho.

Metodologia para DESCOBRIR quem esta escalando:

Nivel	Objetivo	Ferramenta
1. Nicho	Descobrir players desconhecidos	Apify (keyword)
2. Sub-nicho	Encontrar especialistas	Apify (keyword)
3. Mecanismo	Validar cross-market	Apify (keyword)
4. Concorrentes	Monitorar conhecidos	fb_ad_library MCP (nome)

Scale Score: (ads_ativos x 2) + (variacoes_copy x 1.5)

• 20+ = Altamente escalado
• 10-19 = Escalando
• 5-9 = Em teste
• <5 = Novo/falhando

TOP 5 Videos (analise obrigatoria): Formato (visual), Angulo (mensagem), Hook 0-3s (transcricao exata), Duracao, Tipo Funil, Padroes Copy.

Deliverables de Research

7 arquivos obrigatorios antes de avancar:

#	Arquivo	Path	Bloqueante
1	VOC Summary	research/voc/summary.md	SIM
2	VOC Trends	research/voc/trends-analysis.md	SIM
3	Competitors Summary	research/competitors/summary.md	SIM
4	Ads Library Spy	research/competitors/processed/ads-library-spy.md	SIM
5	Mechanism Summary	research/mechanism/summary.md	SIM
6	Avatar Summary	research/avatar/summary.md	SIM
7	Synthesis	research/synthesis.md (confidence >= 70%)	SIM

O gate e enforced por Sentinel via MCP validate_gate — o RESEARCH so passa se TODOS os 7 arquivos existem e o synthesis.md atingiu confidence >= 70%.

Biblioteca de Nicho

Cada nicho tem um arquivo consolidado na raiz:

{nicho}/biblioteca_nicho_{nicho}_CONSOLIDADA.md

Conteudo: VOC consolidada cross-ofertas, avatar unificado, linguagem e compliance do nicho, angulos validados. Carregar ANTES de pesquisar.