mega-brain-ai 1.3.0

package/core/templates/phases/narrative-metabolism.md

@@ -0,0 +1,292 @@
+# NARRATIVE METABOLISM PROTOCOL v1.0
+
+> **Propósito:** Transformar insights fragmentados em narrativas vivas e evolutivas
+> **Aplicação:** SOURCES/, DOSSIERS/persons/, DOSSIERS/THEMES/
+> **Criado:** 2025-12-20
+
+---
+
+## Conceito Central
+
+O documento tem **metabolismo** — ele **digere** novos insights e **consolida** quando fica denso demais. Não é um resumo estático, é um organismo vivo de conhecimento.
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│                    NARRATIVE METABOLISM                         │
+├─────────────────────────────────────────────────────────────────┤
+│                                                                 │
+│   NOVO INSIGHT                                                  │
+│        │                                                        │
+│        ▼                                                        │
+│   ┌────────────────────────────────────┐                       │
+│   │  1. CLASSIFICAÇÃO SEMÂNTICA        │                       │
+│   │     Qual seção? Qual conceito?     │                       │
+│   │     Reforça ou expande existente?  │                       │
+│   └────────────────────────────────────┘                       │
+│        │                                                        │
+│        ▼                                                        │
+│   ┌────────────────────────────────────┐                       │
+│   │  2. INJEÇÃO CONTEXTUAL             │                       │
+│   │     Inserir no ponto certo         │                       │
+│   │     Conectar com texto existente   │                       │
+│   │     Preservar fluxo narrativo      │                       │
+│   └────────────────────────────────────┘                       │
+│        │                                                        │
+│        ▼                                                        │
+│   ┌────────────────────────────────────┐                       │
+│   │  3. CHECK DE CONSOLIDAÇÃO          │                       │
+│   │     Densidade > threshold?         │                       │
+│   │     Se sim → reescrever seção      │                       │
+│   └────────────────────────────────────┘                       │
+│                                                                 │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## Configuração Padrão
+
+| Parâmetro | Valor | Justificativa |
+|-----------|-------|---------------|
+| **Tom** | Voz da Fonte | Autenticidade, conexão, terminologia preservada |
+| **Idioma** | Português BR + termos técnicos em inglês | Fluidez natural |
+| **Granularidade** | 800-1500 palavras | Acionável + consultável + escalável |
+| **Consolidação** | Automática + Safeguards | Fluidez sem perder controle |
+| **Diagramas** | Apenas para exemplificar | Não decorativo |
+
+---
+
+## Estrutura do Documento Narrativo
+
+```markdown
+# [FONTE] — [TEMA]
+
+> **Em resumo:** [Síntese executiva — máximo 3 linhas]
+> **Versão:** X.Y | **Atualizado:** YYYY-MM-DD
+> **Densidade:** ◯◯◯◯◯ (1-5) — trigger consolidação em 4+
+
+---
+
+## Filosofia Central
+[O "porquê" — princípios fundamentais, crenças, mentalidade]
+
+## Modus Operandi
+[O "como" — processos, frameworks, sequência de ações]
+
+## Arsenal Técnico
+[O "o quê" — táticas concretas, scripts, números específicos]
+
+## Armadilhas
+[O que NÃO fazer — erros comuns, anti-patterns]
+
+## Evolução
+[Mudanças de pensamento ao longo do tempo — se aplicável]
+
+---
+
+## Citações Originais
+> "Citação exata preservada" — [Fonte:chunk_id]
+
+## Metadados
+- **Chunks:** [IDs]
+- **Insights:** [IDs]
+- **Última consolidação:** [data]
+```
+
+---
+
+## Regras de Voz
+
+### Princípio: A Fonte Fala
+
+O texto deve soar como se a pessoa estivesse explicando diretamente para você. Não é uma análise sobre a pessoa — é a pessoa compartilhando conhecimento.
+
+### Exemplos
+
+**❌ ERRADO (voz de analista):**
+```
+Jordan Lee utiliza uma estrutura hierárquica com team leads
+que recebem overrides. A metodologia dele prioriza sistemas
+sobre dependência de indivíduos.
+```
+
+**✅ CORRETO (voz da fonte):**
+```
+Minha operação tem 240 pessoas, mas sabe quantas são realmente
+insubstituíveis? Três. Só três além do Jacob. Isso não acontece
+por acaso — construí sistemas, não feudos. Quando um closer sai,
+o sistema continua rodando.
+```
+
+### Marcadores de Voz
+
+| Elemento | Como Aplicar |
+|----------|--------------|
+| **Primeira pessoa** | "Eu faço...", "Minha abordagem...", "Aprendi que..." |
+| **Tom conversacional** | Como se estivesse num podcast explicando |
+| **Termos próprios** | Preservar jargão do expert (Farm System, 7 Beliefs, etc.) |
+| **Números específicos** | Nunca arredondar — "4.3 calls/dia", não "cerca de 4" |
+| **Convicção** | Experts têm opiniões fortes — preservar assertividade |
+
+---
+
+## Regras de Injeção
+
+Quando novo insight chega, classificar e injetar:
+
+| Tipo de Insight | Seção Destino | Método de Integração |
+|-----------------|---------------|----------------------|
+| Princípio/Crença | Filosofia Central | Expandir ou contrastar com existente |
+| Processo/Sequência | Modus Operandi | Detalhar passos, adicionar nuances |
+| Tática/Número | Arsenal Técnico | Novo item ou enriquecer existente |
+| Erro/Lição | Armadilhas | Adicionar caso ou reforçar padrão |
+| Contradição/Mudança | Evolução | Documentar tensão temporal |
+| Citação marcante | Citações Originais | Sempre preservar na íntegra |
+
+### Exemplo de Injeção
+
+**Texto existente:**
+```
+Meu time de vendas roda com 70 closers fazendo 300 calls por dia.
+```
+
+**Novo insight:** "Team leads recebem override de 3% sobre vendas do time"
+
+**Após injeção:**
+```
+Meu time de vendas roda com 70 closers fazendo 300 calls por dia.
+Os team leads não são só gerentes — eles têm skin in the game com
+override de 3% sobre as vendas do time inteiro. Isso muda tudo:
+eles querem que os closers vendam, não que falhem.
+```
+
+---
+
+## Regras de Consolidação
+
+### Trigger Automático
+
+```
+SE seção.palavras > 600
+   OU seção.insights > 5
+   OU densidade >= 4:
+
+   → EXECUTAR consolidação
+```
+
+### Processo de Consolidação
+
+1. **Snapshot** — Salvar versão anterior em `_ARCHIVE/`
+2. **Identificar núcleo** — O que é essencial vs. repetitivo
+3. **Reescrever** — Manter essência + integrar detalhes
+4. **Preservar** — Números, citações, termos técnicos
+5. **Logar** — Registrar consolidação em metadados
+
+### Exemplo de Consolidação
+
+**ANTES (fragmentado, densidade 5):**
+```
+- "Contrato por competência, não experiência"
+- "Experiência pode ser ensinada, competência é inata"
+- "Prefiro alguém que aprende rápido do que alguém que já sabe"
+- "Gente experiente traz vícios, gente competente traz potencial"
+- "Competência > Experiência, sempre"
+```
+
+**DEPOIS (consolidado, densidade 2):**
+```
+Minha filosofia de contratação é simples: competência bate experiência,
+sempre. Experiência você ensina — em 3 meses a pessoa está calibrada.
+Mas competência? Ou a pessoa tem, ou não tem. Prefiro alguém que
+aprende rápido e chega zerado do que um "veterano" cheio de vícios
+que vai levar 6 meses pra desaprender.
+```
+
+---
+
+## Safeguards Obrigatórios
+
+| Regra | Implementação |
+|-------|---------------|
+| **Nunca deletar** | Consolidar = reescrever, texto antigo vai pro archive |
+| **Preservar números** | Métricas específicas são intocáveis |
+| **Manter citações** | Quotes originais sempre preservadas na seção dedicada |
+| **Versionar** | Incrementar versão a cada mudança significativa |
+| **Logar** | Registrar data e motivo de cada consolidação |
+
+---
+
+## Aplicação por Camada
+
+### SOURCES/{pessoa}/{tema}
+
+| Aspecto | Configuração |
+|---------|--------------|
+| **Foco** | Profundidade máxima naquele tema específico |
+| **Voz** | 100% voz da fonte |
+| **Detalhe** | Scripts, números, passo-a-passo |
+| **Extensão** | 800-1500 palavras |
+
+### DOSSIERS/persons/{pessoa}
+
+| Aspecto | Configuração |
+|---------|--------------|
+| **Foco** | Perfil completo — padrões decisórios |
+| **Voz** | 80% voz da fonte, 20% contextualização |
+| **Detalhe** | Filosofias, frameworks, jornada |
+| **Extensão** | 1500-3000 palavras |
+
+### DOSSIERS/THEMES/{tema}
+
+| Aspecto | Configuração |
+|---------|--------------|
+| **Foco** | Comparativo entre múltiplas fontes |
+| **Voz** | Narrador que apresenta cada perspectiva |
+| **Detalhe** | Consensos, tensões, síntese |
+| **Extensão** | 1500-2500 palavras |
+
+---
+
+## Indicador de Densidade
+
+Visual para sinalizar necessidade de consolidação:
+
+```
+◯◯◯◯◯ (1) — Documento novo, espaço para crescer
+◐◯◯◯◯ (2) — Conteúdo básico estabelecido
+◐◐◯◯◯ (3) — Bem desenvolvido
+◐◐◐◯◯ (4) — Denso, monitorar (trigger warning)
+◐◐◐◐◯ (5) — CONSOLIDAR AGORA
+```
+
+---
+
+## Checklist de Qualidade
+
+Antes de finalizar qualquer documento narrativo:
+
+- [ ] Tom soa como a fonte falando?
+- [ ] Números específicos preservados?
+- [ ] Termos técnicos em inglês mantidos?
+- [ ] Português BR fluido e natural?
+- [ ] Diagramas apenas onde necessário?
+- [ ] Citações originais na seção dedicada?
+- [ ] Metadados atualizados?
+- [ ] Densidade calculada corretamente?
+
+---
+
+## Integração com Pipeline Jarvis
+
+Este protocolo é executado nas fases:
+
+| Fase | Aplicação |
+|------|-----------|
+| **4.0 Dossier Compilation** | Criar/atualizar DOSSIERS/ com voz narrativa |
+| **4.1 Sources Compilation** | Criar/atualizar SOURCES/ com voz da fonte |
+| **Incremental Updates** | Injetar novos insights seguindo regras |
+
+---
+
+*Protocol Version 1.0 — Narrative Metabolism*
+*Mega Brain System v3.21.0*

package/core/templates/phases/narrative-synthesis.md

@@ -0,0 +1,278 @@
+# NARRATIVE-SYNTHESIS-PROTOCOL.md
+
+> **Phase:** 3.1 (após Insight Extraction, antes de DNA Extraction)
+> **Input:** INSIGHTS-STATE.json (insights categorizados por fonte)
+> **Output:** `/processing/narratives/NARRATIVES-STATE.json`
+> **Versão:** 1.0.0
+> **Criado:** 2026-01-04
+
+---
+
+## PROPÓSITO
+
+Consolidar insights isolados em **narrativas coerentes** por tema. Não é mais "o que a pessoa disse", mas "como a pessoa PENSA sobre X" - uma visão consolidada que captura a filosofia e a lógica por trás das táticas.
+
+```
+┌─────────────────────────────────────────────────────────────────────────────────────┐
+│                                                                                     │
+│  INSIGHT EXTRACTION (Phase 2.1)          NARRATIVE SYNTHESIS (Phase 3.1)           │
+│  ───────────────────────────────────────────────────────────────────────────────   │
+│                                                                                     │
+│  ✅ Extrai PONTOS DISCRETOS               ✅ Consolida em NARRATIVAS TEMÁTICAS     │
+│  ✅ "Jeremy diz X sobre ads"              ✅ "A filosofia de Jeremy sobre ads é..." │
+│  ✅ Categoriza por tipo                   ✅ Identifica PADRÕES entre categorias   │
+│  ✅ 50 insights separados                 ✅ 5-10 narrativas consolidadas          │
+│                                                                                     │
+└─────────────────────────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## CONCEITOS-CHAVE
+
+### Narrativa vs Insight
+
+| Insight | Narrativa |
+|---------|-----------|
+| Ponto discreto | História consolidada |
+| "Hammer Them: 15-20 peças em 72h" | "A filosofia central de JH é pré-vender antes da call..." |
+| Pode ser aplicado isoladamente | Requer compreensão do sistema todo |
+| Cita número específico | Explica o PORQUÊ do número |
+
+### Tipos de Síntese
+
+1. **INTRA-CATEGORIA**: Insights da mesma categoria → 1 narrativa
+   - Ex: 10 insights de `ad_strategies_jh` → "Filosofia de Ads de JH"
+
+2. **INTER-CATEGORIA**: Padrões entre categorias
+   - Ex: `ad_strategies` + `sales_psychology` → "Sistema de Pré-Venda de JH"
+
+3. **TENSÕES**: Aparentes contradições que revelam nuance
+   - Ex: "Alta frequência" vs "Qualidade de conteúdo" → Tensão explicada
+
+---
+
+## INPUT
+
+### Fontes Primárias
+
+1. **INSIGHTS-STATE.json** - Insights categorizados
+2. **Filtro por fonte** - Ex: todas categorias com sufixo `_jh`
+
+### Formato de Entrada
+
+```json
+{
+  "ad_strategies_jh": {
+    "count": 10,
+    "insights": [
+      { "id": "ASJH001", "insight": "...", "chunks": [...], "heuristic": true },
+      ...
+    ]
+  }
+}
+```
+
+---
+
+## OUTPUT
+
+### NARRATIVES-STATE.json (Schema)
+
+```json
+{
+  "version": "1.0.0",
+  "created": "2026-01-04T16:00:00Z",
+  "last_updated": "2026-01-04T16:00:00Z",
+  "total_narratives": 8,
+  "pessoa": "jeremy-haynes",
+  "fonte_ids": ["JH-SOP001", "JH-SOP002", "..."],
+
+  "narratives": [
+    {
+      "id": "NAR-JH-001",
+      "titulo": "O Sistema Hammer Them: Pré-Venda como Filosofia Central",
+      "tema_principal": "AD_STRATEGY",
+      "temas_relacionados": ["SALES_PSYCHOLOGY", "SHOW_RATE"],
+      "insights_consolidados": ["ASJH001", "ASJH002", "SPJH001", "SPJH002"],
+      "chunks_raiz": ["JH-SOP002_001", "JH-SOP002_002", "..."],
+
+      "narrativa": "Jeremy Haynes construiu sua abordagem de marketing em torno de uma ideia central: a venda começa ANTES da call. O sistema 'Hammer Them' não é apenas uma tática - é uma filosofia. A premissa é que em mercados sofisticados (Stage 3-4), o prospect precisa de 15-20+ pontos de contato em uma janela de 72 horas antes da call para converter. Isso se baseia em princípios psicológicos como Familiarity Bias e Mere-Exposure Effect...",
+
+      "filosofia_central": "A confused mind says no. Elimine confusão com saturação estratégica.",
+
+      "heuristicas": [
+        {"regra": "15-20+ peças em 72h", "fonte": "ASJH001"},
+        {"regra": "CPE $0.01-0.02 vs CPC $0.50-2.00", "fonte": "ASJH005"}
+      ],
+
+      "frameworks": [
+        {"nome": "4 Pillars of Pre-Call Content", "fonte": "ASJH002"},
+        {"nome": "3 Critical Nurture Lines", "fonte": "ASJH003"}
+      ],
+
+      "tensoes": [
+        {
+          "aparente": "Alta frequência vs Qualidade de conteúdo",
+          "resolucao": "JH resolve com biblioteca pré-construída: 30-50 short + 15-30 long antes de lançar campanhas"
+        }
+      ],
+
+      "confidence": "HIGH",
+      "completude": "ALTA"
+    }
+  ],
+
+  "meta_patterns": [
+    {
+      "pattern": "Pre-sell before sell",
+      "narratives": ["NAR-JH-001", "NAR-JH-003"],
+      "insight": "JH inverte o funil tradicional: gasta mais em awareness que em direct response"
+    }
+  ],
+
+  "gaps_identificados": [
+    "Sem insights sobre pricing específico de JH",
+    "Pouco sobre estrutura de time interno"
+  ]
+}
+```
+
+---
+
+## PROCESSO DE SÍNTESE
+
+### Passo 1: Agrupar por Tema
+
+```
+PARA cada categoria com sufixo da fonte (ex: "_jh"):
+  AGRUPAR insights por tema principal
+  IDENTIFICAR temas relacionados
+```
+
+### Passo 2: Identificar Núcleo Narrativo
+
+```
+PARA cada grupo temático:
+  IDENTIFICAR insight mais fundamental (geralmente uma filosofia)
+  CONSTRUIR narrativa ao redor deste núcleo
+  CONECTAR insights relacionados como "evidências"
+```
+
+### Passo 3: Extrair Padrões Meta
+
+```
+ANALISAR narrativas como conjunto:
+  DETECTAR padrões recorrentes entre narrativas
+  IDENTIFICAR tensões aparentes
+  DOCUMENTAR resolução de tensões (se existir)
+```
+
+### Passo 4: Documentar Gaps
+
+```
+COMPARAR insights disponíveis vs temas esperados:
+  LISTAR temas sem cobertura
+  PRIORIZAR gaps por relevância
+```
+
+---
+
+## TEMPLATES DE NARRATIVA
+
+### Template: Narrativa de Sistema
+
+```markdown
+## [TÍTULO DO SISTEMA]
+
+### Filosofia Central
+> "[Citação ou princípio fundamental]"
+
+### O Que É
+[Descrição em 2-3 parágrafos do sistema]
+
+### Componentes
+1. **[Componente 1]** - [descrição]
+2. **[Componente 2]** - [descrição]
+
+### Números-Chave (Heurísticas)
+- [Heurística 1] ^[chunk_id]
+- [Heurística 2] ^[chunk_id]
+
+### Quando Usar
+- [Contexto 1]
+- [Contexto 2]
+
+### Tensões Conhecidas
+- **[Tensão]**: [Como JH resolve]
+
+### Insights Fonte
+[Lista de IDs dos insights consolidados]
+```
+
+---
+
+## REGRAS DE SÍNTESE
+
+### Princípios
+
+1. **FIDELIDADE**: Narrativa deve ser derivável dos insights fonte
+2. **RASTREABILIDADE**: Todo claim liga a chunk_id
+3. **COMPLETUDE**: Não omitir insights que contradizem
+4. **CLAREZA**: Explicar o "porquê", não apenas o "o quê"
+
+### O Que NUNCA Fazer
+
+```
+❌ NUNCA inventar conexões não evidenciadas
+❌ NUNCA omitir tensões/contradições
+❌ NUNCA generalizar sem sufixo de confidence
+❌ NUNCA perder rastreabilidade a chunks
+```
+
+### O Que SEMPRE Fazer
+
+```
+✅ SEMPRE citar insight_ids consolidados
+✅ SEMPRE manter chunks_raiz para navegação
+✅ SEMPRE declarar confidence level
+✅ SEMPRE documentar gaps
+```
+
+---
+
+## VALIDAÇÃO
+
+Antes de considerar Phase 3.1 completa:
+
+```
+□ NARRATIVES-STATE.json existe e é JSON válido?
+□ Todos os insights da fonte foram considerados?
+□ Toda narrativa tem insights_consolidados?
+□ Toda narrativa tem chunks_raiz?
+□ Tensões foram documentadas?
+□ Gaps foram identificados?
+□ Meta-patterns foram extraídos?
+```
+
+---
+
+## INTEGRAÇÃO COM PIPELINE
+
+### Antes (Phase 2.1)
+- INSIGHTS-STATE.json deve estar atualizado
+- Categorias com sufixo da fonte (ex: `_jh`) identificadas
+
+### Depois (Phase 3.2)
+- DNA Extraction usa narrativas como contexto adicional
+- SOUL.md pode citar narrativas diretamente
+
+### Dossier Compilation (Phase 4.0)
+- Dossiês REFERENCIAM narrativas
+- Estrutura de DOSSIER segue temas das narrativas
+
+---
+
+**Versão:** 1.0.0
+**Autor:** JARVIS + [OWNER]
+**Última atualização:** 2026-01-04