@lucapimenta/copy-chief-black 1.0.0

package/framework/templates/niche-pack/context-template.md

@@ -0,0 +1,120 @@
+---
+template_name: "niche-pack-context"
+template_version: "1.0.0"
+template_type: "niche-pack"
+description: "Template CONTEXT.md para novas ofertas com campos obrigatorios"
+phase: "any"
+output_format: "markdown"
+---
+
+# {{OFFER_NAME_UPPER}} - CONTEXTO CANONICO
+
+> **ATENCAO:** Este arquivo e a FONTE DA VERDADE. Carregar ANTES de qualquer edicao.
+> **Ultima atualizacao:** {{DATE}}
+> **Tipo:** {{OFFER_TYPE}}
+
+---
+
+## PRODUTO
+
+| Campo | Valor |
+|-------|-------|
+| **Nome** | {{OFFER_NAME}} |
+| **Tipo** | {{OFFER_TYPE}} |
+| **Funil** | {{FUNNEL_TYPE}} |
+| **Ticket** | A definir |
+| **Nicho** | {{NICHE_DISPLAY}} |
+| **Sub-nicho** | {{SUBNICHE_DISPLAY}} |
+| **Expert** | A definir |
+| **Diferencial** | A definir na Fase 1 (Research) |
+
+---
+
+## NOMES (Pendente Validacao)
+
+| Elemento | Nome Final |
+|----------|------------|
+| **Sexy Cause (MUP)** | A definir |
+| **Gimmick Name (MUS)** | A definir |
+| **Nome do Produto** | {{OFFER_NAME}} |
+
+---
+
+## MECANISMO
+
+### MUP
+A ser definido apos Research.
+
+### MUS
+A ser definido apos Research.
+
+### Paradigm Shift
+A ser definido apos Research.
+
+---
+
+## ONE BELIEF
+A ser definido apos HELIX Fase 10.
+
+---
+
+## PROMESSA CENTRAL
+A ser definida apos HELIX Fase 10.
+
+---
+
+## AVATAR PRIMARIO
+
+**Perfil:** A ser definido na Fase 1 (Research).
+
+**Emocoes Negativas dominantes:**
+- **Frustracao:** (pendente VOC)
+- **Medo:** (pendente VOC)
+- **Vergonha:** (pendente VOC)
+
+**DRE:** A definir | **Nivel de Consciencia:** A definir
+
+---
+
+## STACK DE VALOR
+
+| # | Componente | Valor Percebido |
+|---|------------|-----------------|
+| CORE | A definir | - |
+| Bonus 1 | A definir | - |
+| Bonus 2 | A definir | - |
+| **TOTAL** | | **-** |
+| **PRECO** | | **A definir** |
+
+Garantia: A definir.
+
+---
+
+## ESTADO ATUAL
+
+| Gate | Status | Data |
+|------|--------|------|
+| Research | NOT_STARTED | - |
+| HELIX 1-10 | NOT_STARTED | - |
+| Mecanismo Unico | UNDEFINED | - |
+| Production | NOT_STARTED | - |
+
+---
+
+## ARQUIVOS-CHAVE (ler nesta ordem)
+
+1. `CONTEXT.md` (este arquivo - START HERE)
+2. `research/synthesis.md` (a criar)
+3. `briefings/phases/` (a criar)
+4. `mecanismo-unico.yaml`
+5. `production/` (a criar)
+
+---
+
+## REFERENCIA
+
+- **Biblioteca do nicho:** `../biblioteca_nicho_{{NICHE}}_CONSOLIDADA.md`
+
+---
+
+*Criado em {{DATE}} via create-niche-pack. Aguardando Fase 1 (Research).*

package/framework/templates/niche-pack/helix-state-template.yaml

@@ -0,0 +1,107 @@
+# HELIX State - {{OFFER_NAME}}
+# Schema: ~/.claude/schemas/helix-state.schema.yaml
+# Criado automaticamente via create-niche-pack
+
+offer_path: "{{OFFER_PATH}}"
+created_at: "{{TIMESTAMP}}"
+updated_at: "{{TIMESTAMP}}"
+
+# State Machine
+workflow_phase: "idle"  # idle | research | briefing | production | delivered
+
+# Gates (fonte de verdade para transicoes)
+gates:
+  research:
+    passed: false
+    passed_at: null
+    confidence: null
+  briefing:
+    passed: false
+    passed_at: null
+    phases_completed: 0
+  production:
+    passed: false
+    passed_at: null
+    black_validation_score: null
+
+# HELIX Phases (1-10)
+helix_phases:
+  phase_1:
+    status: "not_started"
+    tools_used: []
+    tools_required: ["get_phase_context"]
+    tools_missing: ["get_phase_context"]
+    file_path: null
+  phase_2:
+    status: "not_started"
+    tools_used: []
+    tools_required: ["get_phase_context"]
+    tools_missing: ["get_phase_context"]
+    file_path: null
+  phase_3:
+    status: "not_started"
+    tools_used: []
+    tools_required: ["get_phase_context", "voc_search"]
+    tools_missing: ["get_phase_context", "voc_search"]
+    file_path: null
+  phase_4:
+    status: "not_started"
+    tools_used: []
+    tools_required: ["get_phase_context", "voc_search"]
+    tools_missing: ["get_phase_context", "voc_search"]
+    file_path: null
+  phase_5:
+    status: "not_started"
+    tools_used: []
+    tools_required: ["get_phase_context", "voc_search", "consensus", "blind_critic"]
+    tools_missing: ["get_phase_context", "voc_search", "consensus", "blind_critic"]
+    file_path: null
+  phase_6:
+    status: "not_started"
+    tools_used: []
+    tools_required: ["get_phase_context", "blind_critic", "emotional_stress_test"]
+    tools_missing: ["get_phase_context", "blind_critic", "emotional_stress_test"]
+    file_path: null
+  phase_7:
+    status: "not_started"
+    tools_used: []
+    tools_required: ["get_phase_context"]
+    tools_missing: ["get_phase_context"]
+    file_path: null
+  phase_8:
+    status: "not_started"
+    tools_used: []
+    tools_required: ["get_phase_context"]
+    tools_missing: ["get_phase_context"]
+    file_path: null
+  phase_9:
+    status: "not_started"
+    tools_used: []
+    tools_required: ["get_phase_context"]
+    tools_missing: ["get_phase_context"]
+    file_path: null
+  phase_10:
+    status: "not_started"
+    tools_used: []
+    tools_required: ["get_phase_context", "validate_gate"]
+    tools_missing: ["get_phase_context", "validate_gate"]
+    file_path: null
+
+# Mecanismo Unico
+mecanismo:
+  state: "UNDEFINED"
+  mup_validated: false
+  mus_validated: false
+  consensus_score: null
+  blind_critic_mup_score: null
+  blind_critic_mus_score: null
+  emotional_stress_test_score: null
+
+# Historico de validacoes
+validation_history: []
+
+# Metadata
+metadata:
+  version: "1.0.0"
+  last_session_id: null
+  total_sessions: 0

package/framework/templates/niche-pack/task-plan-template.md

@@ -0,0 +1,89 @@
+---
+template_name: "niche-pack-task-plan"
+template_version: "1.0.0"
+template_type: "niche-pack"
+description: "Template de task plan para novas ofertas criadas via niche pack"
+phase: "any"
+output_format: "markdown"
+---
+
+# Task Plan: {{OFFER_NAME}}
+
+**Versao:** v1.0
+**Data:** {{DATE}}
+**Status:** IDLE - Aguardando Research
+
+---
+
+## Objetivo
+
+Desenvolver copy completa para {{OFFER_NAME}} no nicho {{NICHE_DISPLAY}}.
+
+---
+
+## Entregaveis
+
+| # | Fase | Entregavel | Status |
+|---|------|------------|--------|
+| 1 | Research | VOC Summary | NOT_STARTED |
+| 2 | Research | VOC Trends | NOT_STARTED |
+| 3 | Research | Competitors Summary | NOT_STARTED |
+| 4 | Research | Ads Library Spy | NOT_STARTED |
+| 5 | Research | Mechanism Summary | NOT_STARTED |
+| 6 | Research | Avatar Summary | NOT_STARTED |
+| 7 | Research | Synthesis | NOT_STARTED |
+| 8 | Briefing | HELIX Fases 1-10 | NOT_STARTED |
+| 9 | Briefing | Mecanismo Unico | NOT_STARTED |
+| 10 | Production | VSL/TSL | NOT_STARTED |
+| 11 | Production | Landing Page | NOT_STARTED |
+| 12 | Production | Criativos | NOT_STARTED |
+| 13 | Production | Emails | NOT_STARTED |
+
+---
+
+## Fases de Execucao
+
+### FASE 1: Research
+- [ ] Carregar biblioteca do nicho
+- [ ] Invocar audience-research-agent
+- [ ] VOC extraction (min 50 quotes/plataforma)
+- [ ] Ads Library Spy (4 niveis)
+- [ ] Mechanism research
+- [ ] Avatar consolidation
+- [ ] Synthesis (confidence >= 70%)
+- [ ] validate_gate RESEARCH
+
+### FASE 2: Briefing (HELIX)
+- [ ] Fases 1-4 (Fundacao)
+- [ ] Fases 5-6 (MUP/MUS)
+- [ ] Fases 7-10 (Execucao)
+- [ ] validate_gate BRIEFING
+- [ ] Mecanismo Unico VALIDATED
+
+### FASE 3: Production
+- [ ] Produzir deliverables
+- [ ] blind_critic por peca
+- [ ] emotional_stress_test por peca
+- [ ] layered_review
+- [ ] black_validation (>= 8/10)
+
+### FASE 4: Review
+- [ ] copy-critic (STAND)
+- [ ] black_validation final
+- [ ] HUMANO aprova
+
+---
+
+## 5-Question Reboot
+
+| Question | Answer |
+|----------|--------|
+| Where am I? | IDLE - Setup completo |
+| Where am I going? | Research Phase |
+| What's the goal? | Copy completa para {{OFFER_NAME}} |
+| What have I learned? | Nada ainda - oferta nova |
+| What have I done? | Setup de estrutura via create-niche-pack |
+
+---
+
+*Criado em {{DATE}} via create-niche-pack*

package/framework/templates/partials/attribution-header.md

@@ -0,0 +1,30 @@
+---
+template_name: attribution-header
+template_version: "1.0.0"
+template_type: production
+description: "YAML frontmatter partial for copy attribution metadata in production deliverables"
+phase: production
+---
+
+---
+attribution:
+  produced_by: "{PERSONA_HANDLE}"
+  expert_archetype: "{EXPERT_NAME}"
+  validated_by: "{VALIDATOR_HANDLE}"
+  offer: "{OFFER_NAME}"
+  created_at: "{DATE}"
+  updated_at: "{DATE}"
+  context_tokens: {TOKENS}
+  confidence: {CONFIDENCE}
+  voc_sources:
+    - "{VOC_SOURCE_1}"
+  briefing_phases:
+    - "{PHASE_1}"
+  scores:
+    blind_critic: {BC_SCORE}
+    emotional_stress_test: {EST_SCORE}
+    black_validation: {BV_SCORE}
+    layered_review: "{LR_STATUS}"
+  iteration: {ITERATION}
+  status: "{STATUS}"
+---

package/framework/templates/partials/epistemic-header.md

@@ -0,0 +1,18 @@
+---
+template_name: epistemic-header
+template_version: "1.0.0"
+template_type: production
+description: "Epistemic confidence declaration partial for briefings and production deliverables"
+phase: production
+---
+
+---
+epistemic:
+  confidence_level: "{ALTA|MÉDIA|BAIXA|NÃO SEI}"
+  sources:
+    - file: "{path/to/source.md}"
+      line: {N}
+      quote: "{exact text from source}"
+  methodology: "{framework reference — ex: HELIX Fase 5, VOC Quality Protocol, RMBC-II}"
+  unverified_claims: []
+---

package/framework/templates/phase-review-checklist.md

@@ -0,0 +1,51 @@
+---
+template_name: "phase-review-checklist"
+template_version: "1.0.0"
+template_type: "checklist"
+description: "Checklist generico de review por fase do pipeline HELIX"
+phase: "any"
+output_format: "markdown"
+---
+
+# Phase Review Checklist — {phase} → {next_phase}
+
+> **Template:** phase-review-checklist.md
+> **Version:** v1.0 (2026-02-24)
+> **Offer:** {offer}
+> **Generated:** {timestamp}
+
+---
+
+## Layer 1: Pre-Advance (Automated)
+
+> Auto-generated checks based on current phase. These are verified programmatically.
+
+{layer1_checks}
+
+## Layer 2: Deliverable Review (Semi-Automated)
+
+> Phase-specific deliverable checks. Some can be verified by file existence,
+> others require content review.
+
+{layer2_checks}
+
+## Layer 3: Human Review
+
+> Items requiring human judgment and explicit approval before advancing.
+
+{layer3_checks}
+
+---
+
+## Gate Decision
+
+| Item | Value |
+|------|-------|
+| **Phase** | {phase} |
+| **Target** | {next_phase} |
+| **Layer 1** | {layer1_status} |
+| **Layer 2** | {layer2_status} |
+| **Layer 3** | {layer3_status} |
+| **Decision** | {decision} |
+| **Reviewed by** | {reviewer} |
+| **Date** | {review_date} |

package/framework/templates/processing-registry-template.yaml

@@ -0,0 +1,24 @@
+---
+template_name: processing-registry
+template_version: "1.0.0"
+template_type: research
+description: "Per-offer registry tracking processed materials to prevent redundant extraction"
+phase: research
+schema: "~/.claude/schemas/processing-registry.schema.yaml"
+---
+
+# Processing Registry — {OFFER_NAME}
+# Auto-populated by: ~/copywriting-ecosystem/scripts/processing-registry.ts
+# Schema: ~/.claude/schemas/processing-registry.schema.yaml
+# Sprint: S44 — Incremental Processing Registry
+#
+# DO NOT edit manually — use the CLI script:
+#   bun run scripts/processing-registry.ts add <path> --source <type> --offer <name> --type <type>
+#   bun run scripts/processing-registry.ts list --offer <name>
+#   bun run scripts/processing-registry.ts check <hash_or_path>
+
+offer: "{OFFER_NAME}"
+created_at: "{TIMESTAMP}"
+updated_at: "{TIMESTAMP}"
+
+entries: []

package/framework/templates/research-deliverables-checklist.md

@@ -0,0 +1,127 @@
+---
+template_name: "research-deliverables-checklist"
+template_version: "1.0.0"
+template_type: "checklist"
+description: "Checklist de deliverables obrigatorios para Research Gate (7 itens bloqueantes)"
+phase: "research"
+output_format: "markdown"
+---
+
+# Research Deliverables Checklist v2.0
+
+> **OBRIGATÓRIO:** Usar este checklist antes de declarar Research Gate PASSED.
+> **Validação:** `python scripts/validate-gate.py RESEARCH /path/to/offer`
+
+---
+
+## Deliverables Obrigatórios
+
+### CORE (Bloqueante)
+| Status | Arquivo | Descrição | Critério |
+|--------|---------|-----------|----------|
+| ⬜ | `research/synthesis.md` | Synthesis consolidada | Existe + Confidence >= 70% |
+
+### VOC (Bloqueante)
+| Status | Arquivo | Descrição | Critério |
+|--------|---------|-----------|----------|
+| ⬜ | `research/voc/summary.md` | Summary executivo | Existe + <= 500 tokens |
+| ⬜ | `research/voc/trends-analysis.md` | FORMATO + ÂNGULO | Existe (OBRIGATÓRIO v4.9.6) |
+| ⬜ | `research/voc/raw/*.md` | Extrações brutas | >= 3 plataformas |
+
+### VOC Processado (Recomendado)
+| Status | Arquivo | Descrição | Critério |
+|--------|---------|-----------|----------|
+| ⬜ | `research/voc/processed/pain-points.md` | Dores classificadas | Por intensidade |
+| ⬜ | `research/voc/processed/desires.md` | Desejos organizados | Declarado/Implícito/Secreto |
+| ⬜ | `research/voc/processed/objections.md` | Objeções mapeadas | Com counters |
+| ⬜ | `research/voc/processed/language-patterns.md` | Linguagem VOC | Expressões verbatim |
+
+### COMPETITORS (Bloqueante)
+| Status | Arquivo | Descrição | Critério |
+|--------|---------|-----------|----------|
+| ⬜ | `research/competitors/summary.md` | Summary executivo | Existe |
+| ⬜ | `research/competitors/processed/ads-library-spy.md` | Análise de ads | Scale Scores calculados |
+
+### MECHANISM (Bloqueante summary)
+| Status | Arquivo | Descrição | Critério |
+|--------|---------|-----------|----------|
+| ⬜ | `research/mechanism/summary.md` | Summary executivo | Existe |
+| ⬜ | `research/mechanism/processed/mechanism-research.md` | MUP/MUS Research | Recomendado |
+
+### AVATAR (Bloqueante summary)
+| Status | Arquivo | Descrição | Critério |
+|--------|---------|-----------|----------|
+| ⬜ | `research/avatar/summary.md` | Summary executivo | Existe |
+| ⬜ | `research/avatar/processed/avatar-profile.md` | Perfil + DRE | Recomendado |
+
+---
+
+## Métricas Mínimas
+
+| Métrica | Mínimo | Recomendado | Strict |
+|---------|--------|-------------|--------|
+| VOC Quotes | 50 | 200 | 300+ |
+| Confidence | 70% | 80% | 90%+ |
+| Plataformas | 3 | 4 | 5+ |
+| Triangulação | 2x | 3x | 4x+ |
+
+---
+
+## Validação Automática
+
+```bash
+# Modo normal (recomendado para começar)
+python scripts/validate-gate.py RESEARCH /path/to/offer
+
+# Modo strict (todos deliverables)
+python scripts/validate-gate.py RESEARCH /path/to/offer --strict
+
+# Output JSON (para scripts)
+python scripts/validate-gate.py RESEARCH /path/to/offer --json
+```
+
+---
+
+## Fluxo Correto
+
+```
+1. Invocar audience-research-agent
+   ↓
+2. Skill executa workflow de 4 fases
+   ↓
+3. Deliverables gerados automaticamente
+   ↓
+4. validate-gate.py RESEARCH (verificação)
+   ↓
+5. Gate PASSED (ou corrigir issues)
+```
+
+---
+
+## Erros Comuns
+
+| Erro | Causa | Correção |
+|------|-------|----------|
+| "trends-analysis.md não existe" | Skill não invocada | Executar audience-research-agent |
+| "synthesis.md não encontrado" | Pesquisa incompleta | Completar Fase 3 do workflow |
+| "Confidence < 70%" | Pouca evidência | Expandir pesquisa VOC |
+| "summary.md não existe" | Módulo pulado | Gerar summary para cada tipo |
+
+---
+
+## NUNCA Fazer
+
+- ❌ Declarar "Research Gate PASSED" manualmente sem validação
+- ❌ Pular trends-analysis.md (obrigatório v4.9.6)
+- ❌ Fazer pesquisa "manual" sem invocar skill
+- ❌ Criar synthesis.md sem gerar summaries individuais
+- ❌ Usar task_plan.md ad-hoc sem seguir template
+
+---
+
+---
+
+*Last updated: 2026-01-26*
+*Template version: v2.0*
+*Ecosystem: v4.9.6*
+*Compatível com validate-gate.py v2.0*