@lucapimenta/copy-chief-black 1.0.0

package/templates/ecosystem/squads/copy-chief/data/mecanismo-unico-framework.md

@@ -0,0 +1,212 @@
+---
+phases: [BRIEFING]
+priority: HIGH
+tokens: ~1200
+---
+
+# Mecanismo Unico - Framework Ramalho (v1.0)
+
+> **Principio:** O Mecanismo Unico e onde mora a conversao e escala.
+> **Fonte:** Copy Chief BLACK + Framework Ramalho (Puzzle Pieces)
+> **Criado:** 2026-02-02 (BSSF Score 8.6, GBS 90%)
+
+---
+
+## REGRA CARDINAL
+
+> **NENHUMA oferta avanca para production/ sem Mecanismo Unico VALIDATED.**
+> Hook mecanismo-validation.sh bloqueia automaticamente.
+
+---
+
+## Estrutura do Mecanismo Unico (3 Partes)
+
+### PARTE 1: MUP (Mecanismo Unico do Problema)
+
+| Componente | Descricao | Obrigatorio |
+|------------|-----------|-------------|
+| **Nova Causa** | O que REALMENTE causa o problema (nao o que o mercado fala) | SIM |
+| **Sexy Cause** | NOME intrigante para a nova causa | SIM |
+| **Problema Fundamental** | Como a nova causa se aplica TANGIVELMENTE | SIM |
+| **Causa Raiz** | Historia por tras do problema | NAO |
+
+**Criterios de Validacao:**
+- Diferente do que o mercado ja fala?
+- Tira a culpa do avatar?
+- Explica por que outras solucoes falharam?
+
+**Teste da Sexy Cause:** A pessoa vai querer CONTAR para alguem?
+
+### PARTE 2: MUS (Mecanismo Unico da Solucao)
+
+| Componente | Descricao | Obrigatorio |
+|------------|-----------|-------------|
+| **Nova Oportunidade** | INVERSO da nova causa | SIM |
+| **Ingrediente Hero** | Componente PRINCIPAL que resolve | SIM |
+| **Gimmick Name** | Nome chiclete do INGREDIENTE (nao do sistema!) | SIM |
+| **Origin Story** | Historia de COMO foi descoberto | SIM |
+| **Authority Hook** | Validacao via super estrutura | SIM |
+
+**DISTINCAO CRITICA:**
+- **Gimmick Name** = ligado ao INGREDIENTE (ex: "Pink Salt Trick")
+- **Authority Hook** = ligado a SUPER ESTRUTURA (ex: "Monjaro Natural")
+
+**Teste do Gimmick Name:** Gruda E esta ligado ao ingrediente hero?
+
+### PARTE 3: INDUTOR (Metodo/Produto)
+
+| Componente | Descricao | Obrigatorio |
+|------------|-----------|-------------|
+| **Nome Sistema** | Nome proprietario do metodo | SIM |
+| **Componentes** | Partes do metodo (siglas) | NAO |
+| **Ativacao** | Como o cliente usa | NAO |
+
+---
+
+## Formula do Gancho da Solucao (Ramalho)
+
+```
+"Ja ouviu falar desse [GIMMICK NAME] que [ORIGIN STORY] estao usando
+secretamente para [DESEJO]? Ja estao chamando isso de [AUTHORITY HOOK]."
+```
+
+**Exemplo:**
+> "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."
+
+---
+
+## Arquivo Canonico: mecanismo-unico.yaml
+
+Cada oferta DEVE ter na raiz:
+```
+{oferta}/mecanismo-unico.yaml
+```
+
+**Schema:** `~/.claude/schemas/mecanismo-unico.schema.yaml`
+**Template:** `~/.claude/templates/mecanismo-unico-template.md`
+
+### Estados Validos
+
+| Estado | Significado | Permite Production? |
+|--------|-------------|---------------------|
+| UNDEFINED | Nao iniciado | NAO |
+| DRAFT | Em construcao | NAO |
+| PENDING_VALIDATION | Completo, aguardando MCP | NAO |
+| VALIDATED | Validado via MCP | SIM |
+| APPROVED | Humano aprovou | SIM |
+
+---
+
+## Sequencia de Validacao (Fase 5-6 HELIX)
+
+```
+1. Preencher mecanismo-unico.yaml
+      |
+2. consensus (MCP zen) - TOP 3 candidatos MUP
+      |
+3. blind_critic (MCP copywriting) - MUP Statement (score >= 8)
+      |
+4. Definir MUS baseado no MUP
+      |
+5. blind_critic (MCP copywriting) - MUS Statement (score >= 8)
+      |
+6. emotional_stress_test (MCP copywriting) - MUP+MUS (genericidade >= 8)
+      |
+7. Atualizar state: VALIDATED
+      |
+8. HUMANO aprova -> state: APPROVED
+```
+
+### Criterios RMBC (Media >= 7)
+
+| Criterio | Pergunta | Threshold |
+|----------|----------|-----------|
+| Digerivel | Explicavel em 1-2 frases? | >= 7 |
+| Unico | Gera "nunca ouvi isso antes"? | >= 7 |
+| Provavel | Faz sentido intuitivo? | >= 7 |
+| Conectado | Liga com emocao do avatar? | >= 7 |
+
+---
+
+## Enforcement Automatico
+
+### Hook: mecanismo-validation.sh
+
+- **Evento:** PreToolUse (Write/Edit)
+- **Target:** Arquivos em `*/production/*`
+- **Comportamento:**
+  - Verifica se mecanismo-unico.yaml existe
+  - Verifica se state e VALIDATED ou APPROVED
+  - BLOQUEIA se nao atende criterios
+
+### Script de Validacao
+
+```bash
+# Validar uma oferta
+~/copywriting-ecosystem/scripts/validate-mecanismo.sh path/to/offer
+
+# Validar todas as ofertas
+~/copywriting-ecosystem/scripts/validate-mecanismo.sh --all
+```
+
+**Exit codes:**
+- 0 = VALIDATED ou APPROVED
+- 1 = DRAFT ou UNDEFINED
+- 2 = PENDING_VALIDATION
+- 3 = File not found
+
+---
+
+## Adaptacao por Nicho
+
+### O que e "Ingrediente Hero"?
+
+| Nicho | Ingrediente Hero = | Exemplo |
+|-------|-------------------|---------|
+| Suplemento | Substancia principal | Pink Salt |
+| Educacao/Concursos | Tecnica core | Tecnica Ovelha Negra |
+| Relacionamento | Protocolo principal | Tecnica do Espelho |
+| Riqueza | Estrategia principal | Metodo dos 3 Potes |
+
+### Biblioteca de Sexy Causes
+
+| Nicho | Problema | Sexy Cause |
+|-------|----------|------------|
+| Emagrecimento | Come demais | "Hungry Brain Syndrome" |
+| Concursos | Estuda errado | "Ilusao de Aprendizado" |
+| Concursos | Nao memoriza | "Ponto Cego de Leitura" |
+| ED | Bloqueio | "Sindrome de Dessensibilizacao" |
+
+---
+
+## Ofertas Migradas
+
+| Oferta | State | MUP | MUS |
+|--------|-------|-----|-----|
+| Hacker do Concurso | APPROVED | Ovelha Negra | Tecnica Ovelha Negra |
+| Gabaritando Lei Seca | APPROVED | Buraco da Lei Seca | Metodo Gabaritando |
+| GPT dos Aprovados | APPROVED | Desalinhamento de Contexto | Sistema de 3 Etapas |
+| Gabaritando Portugues | DRAFT | Ponto Cego de Leitura | (pendente) |
+
+---
+
+## Checklist Nova Oferta
+
+- [ ] Criar `mecanismo-unico.yaml` a partir do schema
+- [ ] Preencher MUP (nova causa, sexy cause, problema fundamental)
+- [ ] Validar MUP via consensus + blind_critic (>= 8)
+- [ ] Preencher MUS (ingrediente hero, gimmick name, origin story, authority hook)
+- [ ] Validar MUS via blind_critic (>= 8)
+- [ ] Validar MUP+MUS via emotional_stress_test (>= 8)
+- [ ] Preencher RMBC scores
+- [ ] Atualizar state para VALIDATED
+- [ ] HUMANO aprova -> APPROVED
+- [ ] Rodar `validate-mecanismo.sh` para confirmar
+
+---
+
+*v1.0 - BSSF Score 8.6, GBS 90%*
+*Baseado em Framework Ramalho (Puzzle Pieces)*
+*Criado: 2026-02-02*

package/templates/ecosystem/squads/copy-chief/data/voc-research.md

@@ -0,0 +1,291 @@
+---
+phases: [RESEARCH]
+priority: CRITICAL
+tokens: ~2400
+---
+
+# VOC Research & Enforcement Rules (v7.0)
+
+> Protocolos de pesquisa VOC, Ads Library Spy e enforcement de Research Gate.
+> Consolidado de voc-research.md + research-enforcement.md.
+> **v7.0:** Merged research-enforcement.md (deliverables, validation, anti-patterns)
+
+---
+
+## Erros Documentados
+
+| ERR | Problema | Fix |
+|-----|----------|-----|
+| 001 | Usou MCP para discovery por keyword (MCP busca NOME, nao keyword) → conclusoes falsas | Apify para discovery (Niveis 1-3), MCP so Nivel 4. Checklist Anti-Alucinacao obrigatorio |
+| 002 | 0/8 ferramentas MCP usadas = workflow bypassed | validate_gate obrigatorio antes de avancar fase |
+| 003 | Pesquisa manual em vez de skill | audience-research-agent e UNICO entry point |
+
+---
+
+## Research Gate - Deliverables e Validacao
+
+### REGRA CARDINAL
+
+> **NUNCA** declarar Research "completa" sem:
+> 1. Rodar `validate-gate.py RESEARCH`
+> 2. Ter 4 summaries existindo
+> 3. Ter synthesis.md com confidence >= 70%
+
+### Checklist BLOQUEANTE
+
+| # | Deliverable | 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` | SIM |
+
+### Validacao
+
+`python3 ~/copywriting-ecosystem/scripts/validate-gate.py RESEARCH path/to/offer` (ou `validate-research.sh` para output visual, `--strict` para todos deliverables). SE BLOCKED -> corrigir antes de avancar.
+
+### Anti-Patterns (PROIBIDO)
+
+| Anti-Pattern | Por que e errado | Correto |
+|--------------|------------------|---------|
+| Declarar "Research completa" sem script | Pode estar incompleta | Rodar validate-gate.py |
+| Usar MCP para discovery por keyword | MCP busca por NOME, nao keyword | Usar Apify |
+| Pular template | Output inconsistente | Sempre carregar template |
+| Nao carregar biblioteca de nicho | Falta contexto do nicho | Carregar ANTES de pesquisar |
+| Fazer pesquisa manual sem skill | Workflow bypassed | Usar audience-research-agent |
+
+### Checklist Pre-Avanco (OBRIGATORIO)
+
+Antes de declarar Research completa:
+
+- [ ] `validate-gate.py RESEARCH` retornou PASSED?
+- [ ] 4 summaries existem? (voc, competitors, mechanism, avatar)
+- [ ] synthesis.md existe com confidence >= 70%?
+- [ ] Biblioteca de nicho foi carregada?
+- [ ] Templates foram seguidos?
+- [ ] MCP validate_gate foi chamado?
+
+**SE qualquer checkbox NAO -> Research NAO esta completa.**
+
+---
+
+## Context Management para VOC
+
+> Ref: context-management.md para regras gerais (Regra 60%, Lost in Middle, 3-Tier).
+
+**Posicionamento para VOC:**
+```
+INICIO (zona primacy): Instrucoes core, VOC Protocol
+FIM (zona recency): Quotes atuais, proxima extracao
+MEIO (compressivel): Historico de sessao, metadata
+```
+
+**Limites para arquivos VOC:**
+- `summary.md` <= 500 tokens (zona segura)
+- `processed/*.md` <= 5.000 tokens cada
+- `raw/*.md` NUNCA carregar em contexto (so referencia)
+
+---
+
+## Ads Library Spy Protocol - Discovery-First
+
+### Metodologia Discovery-First
+> Objetivo: DESCOBRIR quem está escalando, não apenas monitorar conhecidos.
+
+---
+
+### 🚨 LIMITAÇÕES CRÍTICAS DAS FERRAMENTAS (v6.4)
+
+> **PROBLEMA DOCUMENTADO:** Confundir "busca por nome de página" com "busca por keyword de anúncio" causa conclusões falsas.
+
+| Ferramenta | O que FAZ | O que NÃO FAZ |
+|------------|-----------|---------------|
+| `get_meta_platform_id` | Busca PÁGINAS pelo NOME | ❌ NÃO busca anúncios por keyword |
+| `get_meta_ads` | Extrai ads de uma página específica | ❌ NÃO busca ads por keyword |
+| Apify Ad Library Scraper | Busca ANÚNCIOS por keyword | ✅ Discovery-First real |
+
+**REGRA:** Para Discovery-First (Níveis 1-3), usar **Apify** com busca por keyword.
+O MCP fb_ad_library serve apenas para Nível 4 (monitorar concorrentes CONHECIDOS).
+
+---
+
+### Contexto de Execucao: Subagent (v7.5)
+
+> Ref: tool-usage-matrix.md § Subagent Tool Access para tabela completa.
+
+**REGRA:** Tasks de extracao VOC DEVEM usar `subagent_type: general-purpose`.
+Custom types NAO herdam MCPs no runtime.
+
+### Checklist Anti-Alucinacao (OBRIGATORIO)
+
+Antes de tirar QUALQUER conclusão sobre "quem está/não está escalando":
+
+- [ ] Usei busca por KEYWORD (Apify) ou busca por NOME (MCP)?
+- [ ] Se usei MCP, reconheço que só encontrei páginas com esse NOME?
+- [ ] Minha conclusão distingue "não tem página com esse nome" de "não está anunciando"?
+- [ ] Verifiquei com Apify se há anunciantes usando essa KEYWORD?
+
+**Se qualquer checkbox estiver desmarcado → NÃO tirar conclusão.**
+
+---
+
+### Apify Discovery Actor
+
+`memo23/facebook-ads-library-scraper-cheerio` — Input: `searchTerms`, `countryCode`, `adType`.
+
+### Scale Score (OBRIGATORIO)
+
+**Formula:** `Scale Score = (ads_ativos x 2) + (variacoes_copy x 1.5)`
+- 20+ = Altamente escalado | 10-19 = Escalando | 5-9 = Em teste | <5 = Novo/falhando
+
+### Hierarquia de Busca (4 Niveis)
+
+| 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) |
+
+**REGRA ABSOLUTA:** Niveis 1-3 = Apify. Nivel 4 = MCP.
+
+### Analise Obrigatoria de Videos (TOP 5)
+
+Para cada criativo escalado registrar: Formato (visual), Angulo (mensagem), Hook 0-3s (transcricao exata), Duracao, Link Funil, Tipo Funil, Padroes Copy.
+
+**FORMATO** = embalagem visual (o que VE). **ANGULO** = abordagem da mensagem (COMO a copy e passada).
+
+### Keywords por Nicho
+
+Keywords específicas por nível estão na biblioteca de cada nicho: `{nicho}/biblioteca_nicho_{nicho}_CONSOLIDADA.md`.
+
+### Output Esperado
+
+`research/competitors/processed/ads-library-spy.md` (template: `~/.claude/templates/ads-library-spy-template.md`).
+Estrutura: Top 10 paginas (Scale Score), TOP 5 videos (formato+angulo+hook+funil), Padroes, Gaps, Recomendacoes.
+
+---
+
+## VOC Quality Protocol
+
+### VOC Squad Architecture (AIOS S6)
+
+> **Recomendado:** Usar VOC Squad (5 analistas paralelos) via audience-research-agent.
+> **Ref:** `~/.claude/rules/voc-squad.md`
+> **Prompts:** `~/.claude/templates/agent-prompts/voc-*.md`
+
+O VOC Squad dispara 5 analistas especializados em paralelo:
+1. **YouTube Analyst** — Comentários, timestamps, hooks
+2. **Instagram Analyst** — Reels, carrosseis, stories
+3. **TikTok Analyst** — Trends, stitches, linguagem Gen-Z
+4. **Reddit Analyst** — Threads, AMAs, linguagem crua
+5. **Amazon Analyst** — Reviews 1-2★ e 5★, Q&A
+
+Consolidação: `~/.claude/templates/voc-squad-consolidation.md`
+
+### Tool Priority (OBRIGATÓRIO)
+Para extração de qualquer plataforma social:
+1. **Apify Actor específico** (5min timeout) → Comentários REAIS
+2. **Playwright direto** (se Apify falha) → Navegação direta
+3. **Firecrawl search** (se Playwright falha) → Extração web
+4. **WebSearch** (ÚLTIMO RESORT) → Apenas se TUDO falha
+
+**NUNCA pular direto para WebSearch sem tentar Apify primeiro.**
+
+### Viral-First Strategy
+Antes de extrair comentários:
+1. Identificar TOP 10 conteúdos mais engajados por plataforma
+2. Validar engajamento mínimo:
+   - YouTube: 10K+ views OU 500+ comments
+   - Instagram: 5K+ likes OU 200+ comments
+   - TikTok: 50K+ views OU 1K+ comments
+3. Extrair APENAS de conteúdo viral
+4. Registrar métricas junto com cada quote
+
+### Outputs Obrigatorios
+
+Cada extracao VOC deve gerar: (1) `*-viral-extraction.md` com quotes + virais, (2) Secao "Analise de Formato", (3) Metricas de engajamento, (4) `trends-analysis.md` cross-platform.
+
+### trends-analysis.md v2.0 (OBRIGATORIO)
+
+3 blocos: (1) FORMATO por plataforma (camera, cenario, edicao, duracao + exemplos), (2) ANGULO por plataforma (hooks, narrativa, tom + exemplos), (3) TENDENCIA DE CONSUMO (trends, padroes culturais, cross-platform, recomendacoes).
+
+**Template:** `~/.claude/templates/trends-analysis-template.md`
+
+### Rejeitar
+- Blog content (não é VOC autêntico)
+- Influencer content (viés de criador)
+- Brand content (marketing, não voz real)
+
+### Mínimos por Plataforma
+- 50 quotes por plataforma social
+- Triangulação obrigatória (quotes em múltiplas fontes = maior peso)
+- Intensidade média ≥4/5
+- Username + engagement em cada quote
+
+---
+
+## 🚨 EMOTION EXTRACTION (Alinhado Fundamentos v5)
+
+> **REGRA:** Toda extração VOC DEVE categorizar emoções por tipo.
+> Sem emoções categorizadas = research incompleta = BLOQUEADO.
+> A DRE (Emoção Dominante Residente) da oferta é identificada AQUI na VOC.
+
+### 5 Emoções Negativas Fundamentais (Fundamentos v5)
+
+| Emoção | Descrição | Aplicação na Copy |
+|--------|-----------|-------------------|
+| **FRUSTRAÇÃO** | Tentou de tudo, nada funciona. Cria desesperança. | Validar frustração ANTES de apresentar solução. "Não funcionou. E a culpa NÃO é sua." |
+| **ANSIEDADE** | Preocupação paralisante com o futuro. Medo de piorar. | Confirmar que a ansiedade é fundamentada — mas oferecer a saída específica. |
+| **TRISTEZA PROFUNDA** | Sensação de derrota após várias tentativas falhas. | A revelação do mecanismo deve trazer ESPERANÇA após a tristeza. Ponto de virada. |
+| **VERGONHA** | Falha pessoal, inadequação perante os outros. | Amplificador poderoso. Vergonha presente + esperança de eliminá-la = urgência máxima. |
+| **MEDO/INSEGURANÇA** | Dúvidas sobre capacidades e como é percebido. | Medo precisa ser ESPECÍFICO, não abstrato. "Medo de engordar" é fraco. "Medo de que sua filha veja você com vergonha no casamento" é visceral. |
+
+### Amplificadores
+
+**VERGONHA** (problema PUBLICO) + **CULPA** (problema PESSOAL) + **ESPERANCA** (solucao URGENTE) = urgencia intensa.
+
+### Identificando a DRE na VOC
+
+A DRE não é sempre medo. Pode ser qualquer emoção dominante. A VOC revela qual:
+
+| Possível DRE | Sinais na VOC | Exemplos de Nicho |
+|--------------|---------------|-------------------|
+| **Medo** | Quotes sobre perda, morte, doença | Saúde, sobrevivência |
+| **Vergonha** | Quotes sobre olhar dos outros, inadequação | Aparência, intimidade, ED |
+| **Desejo** | Quotes sobre inveja, querer o que outros têm | Riqueza, status |
+| **Raiva/Indignação** | Quotes sobre ser enganado, injustiça | Ser enganado, big pharma |
+| **Frustração** | Quotes sobre "já tentei tudo" | Cross-nicho |
+| **Culpa** | Quotes sobre negligência, falhar com família | Relacionamento, saúde familiar |
+
+### Estrutura Obrigatoria em summary.md
+
+Secao "Emocoes Extraidas" com subsecoes por emocao (MEDO 10+, VERGONHA 5+, CULPA 5+, RAIVA 5+, FRUSTRACAO 10+). Cada quote com Intensidade (1-5) e Fonte (plataforma + username).
+
+**Enforcement:** Sem secao "Emocoes Extraidas" ou menos de 35 quotes = Research Gate BLOCKED.
+
+### Escalada Emocional na VOC (substitui Fear Hierarchy)
+
+> Ref: copy-chief.md § Escalada Emocional para definicao canonica dos 5 niveis.
+
+Para cada quote emocional, categorizar nivel de intensidade com exemplos de VOC. Aplica-se a QUALQUER DRE:
+
+| Nível | Tipo | Horizonte | Ex (Medo) | Ex (Vergonha) | Ex (Frustração) |
+|-------|------|-----------|-----------|---------------|-----------------|
+| 1 | Físico Imediato | Horas/dias | "Peso no peito às 3h" | "Roupa não fecha" | "Mais uma dieta falhou" |
+| 2 | Social | Dias/semanas | "Vão notar na reunião" | "Evita fotos em grupo" | "Amigos percebem" |
+| 3 | Consequência | Meses/anos | "Diabético em 5 anos" | "Não sai mais de casa" | "Já perdeu 5 anos" |
+| 4 | Relacional | Permanente | "Parceira vai encontrar outro" | "Filhos terão vergonha" | "Família desistiu" |
+| 5 | Identidade | Existencial | "Morrer sendo lembrado como fracasso" | "Não se reconhece mais" | "Nunca vai conseguir nada" |
+
+**Objetivo:** Identificar quotes de níveis 4 e 5 para copy visceral. Copy que fica nos níveis 1-2 cria desconforto passivo. Níveis 4-5 criam impulso de ação real.
+
+---
+
+*v7.0 - Merged research-enforcement.md (deliverables, validation, anti-patterns)*
+*Ref: tool-usage-matrix.md para ferramentas por fase de Research*
+*ERR-001/002/003 documentados*
+*Atualizado: 2026-02-23*

package/templates/ecosystem/squads/copy-chief/squad.yaml

@@ -0,0 +1,89 @@
+squad:
+  name: Copy Chief BLACK
+  id: copy-chief
+  version: "1.0.0"
+  description: "Direct Response copy production squad — VSL, Landing Page, Creatives, Emails"
+
+  agents:
+    - id: helix
+      role: orchestrator
+      handle: "@chief"
+      tier: 1
+    - id: vox
+      role: researcher
+      handle: "@researcher"
+      tier: 2
+    - id: cipher
+      role: miner
+      handle: "@miner"
+      tier: 3
+    - id: atlas
+      role: briefer
+      handle: "@briefer"
+      tier: 2
+    - id: echo
+      role: vsl
+      handle: "@vsl"
+      tier: 2
+    - id: forge
+      role: lp
+      handle: "@lp"
+      tier: 3
+    - id: scout
+      role: creative
+      handle: "@creative"
+      tier: 3
+    - id: blade
+      role: producer
+      handle: "@producer"
+      tier: 3
+    - id: hawk
+      role: critic
+      handle: "@critic"
+      tier: 2
+    - id: sentinel
+      role: gatekeeper
+      handle: "@gatekeeper"
+      tier: 2
+    - id: ops
+      role: ops
+      handle: "@ops"
+      tier: 1
+    - id: strategist
+      role: strategy
+      handle: "@strategist"
+      tier: 1
+    - id: reflection
+      role: reflection
+      handle: "@reflect"
+      tier: 2
+
+  data_tiers:
+    tier_1_shared: "squads/copy-chief/data/craft/"
+    tier_2_agent: "squads/copy-chief/data/"
+    tier_3_swipes: "skills/*/references/swipe-files/"
+
+  health_check_modules:
+    - hooks-heartbeat
+    - synapse-performance
+    - data-tier-integrity
+
+  workflows:
+    - research-pipeline
+    - briefing-pipeline
+    - production-pipeline
+    - review-pipeline
+
+  mcp_stack:
+    - name: copywriting
+      tools: [blind_critic, emotional_stress_test, black_validation, layered_review, write_chapter, voc_search, get_phase_context, validate_gate, create_mecanismo, validate_mecanismo]
+    - name: fb_ad_library
+      tools: [get_meta_ads, get_meta_platform_id, analyze_ad_video, analyze_ad_videos_batch]
+    - name: firecrawl
+      tools: [firecrawl_agent, firecrawl_scrape, firecrawl_search, firecrawl_crawl]
+    - name: zen
+      tools: [consensus, thinkdeep, challenge, codereview]
+    - name: apify
+      tools: [call-actor, search-actors, get-actor-output, get-dataset-items]
+    - name: playwright
+      tools: [browser_navigate, browser_snapshot, browser_click, browser_fill_form]

package/templates/ecosystem/squads/copy-chief/tasks/competitor-analysis.md

@@ -0,0 +1,24 @@
+---
+task:
+  id: competitor-analysis
+  title: "Competitor Analysis & Ads Library Spy"
+  agent: cipher
+  input:
+    - type: file
+      path: "{offer}/CONTEXT.md"
+  output:
+    - type: file
+      path: "{offer}/research/competitors/processed/ads-library-spy.md"
+    - type: file
+      path: "{offer}/research/competitors/summary.md"
+  checklist:
+    - item: "4-level search completed (niche, sub-niche, mechanism, known)"
+    - item: "Scale Score calculated for TOP 10 pages"
+    - item: "TOP 5 videos analyzed"
+    - item: "Winning patterns extracted"
+    - item: "Market gaps identified"
+---
+
+## Instructions
+
+Run Ads Library Spy at 4 levels using Apify for keyword discovery (levels 1-3) and fb_ad_library MCP for known pages (level 4). Calculate Scale Score for each competitor. Analyze TOP 5 competitor videos. Extract winning formats, angles, and patterns. Identify market gaps and opportunities.

package/templates/ecosystem/squads/copy-chief/tasks/helix-briefing.md

@@ -0,0 +1,29 @@
+---
+task:
+  id: helix-briefing
+  title: "HELIX 10-Phase Strategic Briefing"
+  agent: atlas
+  input:
+    - type: file
+      path: "{offer}/research/synthesis.md"
+    - type: file
+      path: "{offer}/CONTEXT.md"
+  output:
+    - type: directory
+      path: "{offer}/briefings/phases/"
+    - type: file
+      path: "{offer}/briefings/helix-complete.md"
+  checklist:
+    - item: "get_phase_context at start of each phase"
+    - item: "10 phases completed sequentially"
+    - item: "consensus validates TOP 3 MUP candidates"
+    - item: "blind_critic >= 8 for MUP statement"
+    - item: "blind_critic >= 8 for MUS statement"
+    - item: "emotional_stress_test >= 8 for MUP+MUS"
+    - item: "voc_search confirms language alignment"
+    - item: "Human approval at phases 5-6"
+---
+
+## Instructions
+
+Execute the 10-phase HELIX briefing system. Each phase builds on the previous. Phases 5-6 (MUP/MUS) require consensus validation and human approval before advancing. All claims must trace to VOC or research data. Create helix-complete.md as the master briefing document.

package/templates/ecosystem/squads/copy-chief/tasks/produce-creatives.md

@@ -0,0 +1,27 @@
+---
+task:
+  id: produce-creatives
+  title: "Creative Production"
+  agent: scout
+  input:
+    - type: file
+      path: "{offer}/briefings/helix-complete.md"
+    - type: directory
+      path: "{offer}/swipes/criativos/"
+  output:
+    - type: directory
+      path: "{offer}/production/creatives/"
+  checklist:
+    - item: "3+ swipe files read before production"
+    - item: "3Ms defined (Mystery, Mechanism, Market)"
+    - item: "10+ hooks generated in divergent phase"
+    - item: "NUUPPECC >= 4/8 per selected hook"
+    - item: "5+ creatives per platform"
+    - item: "blind_critic >= 8 per creative"
+    - item: "emotional_stress_test >= 8 per batch"
+    - item: "black_validation >= 8"
+---
+
+## Instructions
+
+Create scroll-stopping creatives through divergent hook exploration. Read 3+ swipe files first. Generate 10+ hooks, evaluate on NUUPPECC, select top 5. Each creative = Hook (0-3s) + Body (3-30s) + CTA. Document FORMAT and ANGLE separately. Validate with blind_critic per creative, emotional_stress_test per batch.

package/templates/ecosystem/squads/copy-chief/tasks/produce-emails.md

@@ -0,0 +1,23 @@
+---
+task:
+  id: produce-emails
+  title: "Email Sequence Production"
+  agent: blade
+  input:
+    - type: file
+      path: "{offer}/briefings/helix-complete.md"
+    - type: directory
+      path: "{offer}/production/vsl/"
+  output:
+    - type: directory
+      path: "{offer}/production/emails/"
+  checklist:
+    - item: "blind_critic >= 8 per email"
+    - item: "DRE in subject line"
+    - item: "emotional_stress_test >= 8 on sequence"
+    - item: "black_validation >= 8"
+---
+
+## Instructions
+
+Produce email sequence that references VSL narrative and LP structure. Each email activates DRE in subject line. Subject lines are DRE-loaded, not clever. Body escalates emotion and drives to action. Validate each email with blind_critic.