mega-brain-ai 1.3.0

package/docs/conselho.md

@@ -0,0 +1,337 @@
+Senhor, aqui está o ORGANOGRAMA COMPLETO do /council:
+
+
+╔══════════════════════════════════════════════════════════════════════════════════════════════╗
+║                                                                                              ║
+║     ██████╗ ██████╗ ██╗   ██╗███╗   ██╗ ██████╗██╗██╗         ███████╗██╗      ██████╗ ██╗    ██╗  ║
+║    ██╔════╝██╔═══██╗██║   ██║████╗  ██║██╔════╝██║██║         ██╔════╝██║     ██╔═══██╗██║    ██║  ║
+║    ██║     ██║   ██║██║   ██║██╔██╗ ██║██║     ██║██║         █████╗  ██║     ██║   ██║██║ █╗ ██║  ║
+║    ██║     ██║   ██║██║   ██║██║╚██╗██║██║     ██║██║         ██╔══╝  ██║     ██║   ██║██║███╗██║  ║
+║    ╚██████╗╚██████╔╝╚██████╔╝██║ ╚████║╚██████╗██║███████╗    ██║     ███████╗╚██████╔╝╚███╔███╔╝  ║
+║     ╚═════╝ ╚═════╝  ╚═════╝ ╚═╝  ╚═══╝ ╚═════╝╚═╝╚══════╝    ╚═╝     ╚══════╝ ╚═════╝  ╚══╝╚══╝   ║
+║                                                                                              ║
+╚══════════════════════════════════════════════════════════════════════════════════════════════╝
+🏛️ ARQUITETURA EM 3 CAMADAS
+
+┌─────────────────────────────────────────────────────────────────────────────────────────────────┐
+│                                                                                                 │
+│   CAMADA 1: CONSTITUIÇÃO                                                                        │
+│   ═══════════════════════                                                                       │
+│                                                                                                 │
+│   📜 core/templates/CONSTITUICAO-BASE.md                                                  │
+│                                                                                                 │
+│   ┌─────────────────┐  ┌─────────────────┐  ┌─────────────────┐  ┌─────────────────┐           │
+│   │   EMPIRISMO     │  │  PARETO 80/20   │  │    INVERSÃO     │  │ ANTIFRAGILIDADE │           │
+│   │   ─────────     │  │   ──────────    │  │   ──────────    │  │  ──────────────  │           │
+│   │ Decisões por    │  │ 20% de ações    │  │ O que faria     │  │ Preferir opções  │           │
+│   │ DADOS, não      │  │ geram 80%       │  │ FALHAR?         │  │ que se FORTALECEM│           │
+│   │ opiniões        │  │ dos resultados  │  │                 │  │ sob estresse     │           │
+│   └─────────────────┘  └─────────────────┘  └─────────────────┘  └─────────────────┘           │
+│                                                                                                 │
+│   ⚠️ GOVERNA TUDO. Nenhum agente pode contradizer.                                             │
+│                                                                                                 │
+├─────────────────────────────────────────────────────────────────────────────────────────────────┤
+│                                                                                                 │
+│   CAMADA 2: AGENTES DE CARGO (DNA de Domínio)                                                   │
+│   ═══════════════════════════════════════════                                                   │
+│                                                                                                 │
+│   ┌───────────┐  ┌───────────┐  ┌───────────┐  ┌───────────┐  ┌───────────┐                    │
+│   │    CRO    │  │    CFO    │  │    CMO    │  │    COO    │  │    CTO    │                    │
+│   │ (Vendas)  │  │(Finanças) │  │(Marketing)│  │(Operações)│  │  (Tech)   │                    │
+│   └─────┬─────┘  └─────┬─────┘  └─────┬─────┘  └─────┬─────┘  └─────┬─────┘                    │
+│         │              │              │              │              │                           │
+│         └──────────────┴──────────────┴──────────────┴──────────────┘                           │
+│                                        │                                                        │
+│                     ┌──────────────────┴──────────────────┐                                     │
+│                     │          BUSCAM DNA EM:             │                                     │
+│                     └──────────────────┬──────────────────┘                                     │
+│                                        │                                                        │
+│          ┌─────────────────────────────┼─────────────────────────────┐                          │
+│          ▼                             ▼                             ▼                          │
+│   ┌──────────────┐           ┌─────────────────┐           ┌──────────────┐                    │
+│   │ knowledge │           │ knowledge/   │           │ processing│                    │
+│   │   /dossiers  │           │      DNA        │           │   /INSIGHTS  │                    │
+│   │   ──────────  │           │   ─────────     │           │  ───────────  │                    │
+│   │ Cole Gordon  │           │ 5 Camadas:      │           │ Insights     │                    │
+│   │ J. Haynes    │           │ • FILOSOFIAS    │           │ extraídos    │                    │
+│   │ J. Miner     │           │ • MODELOS-MENTAIS│          │ dos batches  │                    │
+│   │ Hormozi      │           │ • HEURÍSTICAS   │           │              │                    │
+│   └──────────────┘           └─────────────────┘           └──────────────┘                    │
+│                                                                                                 │
+├─────────────────────────────────────────────────────────────────────────────────────────────────┤
+│                                                                                                 │
+│   CAMADA 3: CONSELHO (Meta-Avaliação - SEM DNA de Domínio)                                      │
+│   ════════════════════════════════════════════════════════                                      │
+│                                                                                                 │
+│   ┌─────────────────────┐  ┌─────────────────────┐  ┌─────────────────────┐                    │
+│   │      CRÍTICO        │  │  ADVOGADO DO DIABO  │  │    SINTETIZADOR     │                    │
+│   │   METODOLÓGICO      │  │                     │  │                     │                    │
+│   │  ─────────────────  │  │  ─────────────────  │  │  ─────────────────  │                    │
+│   │ Avalia PROCESSO     │  │ ATACA a decisão    │  │ INTEGRA tudo em     │                    │
+│   │ NÃO o mérito        │  │ Busca falhas       │  │ decisão final       │                    │
+│   │                     │  │ que ninguém viu    │  │                     │                    │
+│   │ Score 0-100:        │  │                     │  │ Output:             │                    │
+│   │ • Premissas    /20  │  │ 4 perguntas:       │  │ • Decisão           │                    │
+│   │ • Evidências   /20  │  │ 1. Premissa frágil │  │ • Confiança 0-100%  │                    │
+│   │ • Lógica       /20  │  │ 2. Risco oculto    │  │ • Riscos residuais  │                    │
+│   │ • Cenários     /20  │  │ 3. Arrependimento  │  │ • Próximos passos   │                    │
+│   │ • Conflitos    /20  │  │ 4. Alternativa     │  │ • Critérios reversão│                    │
+│   └─────────────────────┘  └─────────────────────┘  └─────────────────────┘                    │
+│                                                                                                 │
+│   ⚠️ NÃO opinam sobre o tema. Avaliam COMO os cargos raciocinaram.                             │
+│                                                                                                 │
+└─────────────────────────────────────────────────────────────────────────────────────────────────┘
+🔄 FLUXO DE EXECUÇÃO (6 FASES)
+
+┌─────────────────────────────────────────────────────────────────────────────────────────────────┐
+│                                                                                                 │
+│   VOCÊ DIZ: "/council [pergunta complexa]"                                                      │
+│                                                                                                 │
+└──────────────────────────────────────────────────┬──────────────────────────────────────────────┘
+                                                   │
+                                                   ▼
+┌──────────────────────────────────────────────────────────────────────────────────────────────────┐
+│                                                                                                  │
+│  FASE 0: INVOCAR CONSTITUIÇÃO                                                                    │
+│  ════════════════════════════                                                                    │
+│                                                                                                  │
+│  📜 ANTES de qualquer agente falar, exibir os 4 princípios:                                     │
+│                                                                                                  │
+│  ┌────────────────────────────────────────────────────────────────────────────────────────────┐ │
+│  │  ⚖️  EMPIRISMO       → Citar FONTES e NÚMEROS                                              │ │
+│  │  📊 PARETO (80/20)   → Qual ação tem maior alavancagem?                                    │ │
+│  │  🔄 INVERSÃO         → O que faria FALHAR?                                                 │ │
+│  │  💪 ANTIFRAGILIDADE  → Qual opção fica mais forte sob estresse?                            │ │
+│  └────────────────────────────────────────────────────────────────────────────────────────────┘ │
+│                                                                                                  │
+└──────────────────────────────────────────────────┬───────────────────────────────────────────────┘
+                                                   │
+                                                   ▼
+┌──────────────────────────────────────────────────────────────────────────────────────────────────┐
+│                                                                                                  │
+│  FASE 1: DEBATE ENTRE CARGOS                                                                     │
+│  ═══════════════════════════                                                                     │
+│                                                                                                  │
+│                           ┌─────────────────────────────────────┐                                │
+│                           │      RODADA 1: POSIÇÕES INICIAIS    │                                │
+│                           │           (PARALELO)                │                                │
+│                           └─────────────────────────────────────┘                                │
+│                                         │                                                        │
+│         ┌───────────┬───────────────────┼───────────────────┬───────────┐                        │
+│         ▼           ▼                   ▼                   ▼           ▼                        │
+│    ┌─────────┐ ┌─────────┐         ┌─────────┐         ┌─────────┐ ┌─────────┐                  │
+│    │   CRO   │ │   CFO   │         │   CMO   │         │   COO   │ │   CTO   │                  │
+│    └────┬────┘ └────┬────┘         └────┬────┘         └────┬────┘ └────┬────┘                  │
+│         │           │                   │                   │           │                        │
+│         │           │    ┌──────────────┴──────────────┐    │           │                        │
+│         │           │    │    ONDE BUSCAM INFO:        │    │           │                        │
+│         │           │    │                             │    │           │                        │
+│         │           │    │  1. DNA dos especialistas   │    │           │                        │
+│         │           │    │     └── /knowledge/dna/  │    │           │                        │
+│         │           │    │                             │    │           │                        │
+│         │           │    │  2. DOSSIERS                │    │           │                        │
+│         │           │    │     └── /knowledge/      │    │           │                        │
+│         │           │    │         DOSSIERS/           │    │           │                        │
+│         │           │    │                             │    │           │                        │
+│         │           │    │  3. [SUA EMPRESA] Context          │    │           │                        │
+│         │           │    │     └── /[sua-empresa]/         │    │           │                        │
+│         │           │    │         [SUA EMPRESA]-CONTEXT.md   │    │           │                        │
+│         │           │    │                             │    │           │                        │
+│         │           │    │  4. RAG (até 5 consultas)   │    │           │                        │
+│         │           │    │     └── /processing/     │    │           │                        │
+│         │           │    │         insights/           │    │           │                        │
+│         │           │    └─────────────────────────────┘    │           │                        │
+│         │           │                   │                   │           │                        │
+│         └───────────┴───────────────────┼───────────────────┴───────────┘                        │
+│                                         ▼                                                        │
+│                           ┌─────────────────────────────────────┐                                │
+│                           │     CHECKPOINT: CONVERGÊNCIA        │                                │
+│                           │     >= 70%? → Pular para Síntese    │                                │
+│                           │     < 70%?  → Rodada 2              │                                │
+│                           └─────────────────────────────────────┘                                │
+│                                         │                                                        │
+│                               (se < 70%)│                                                        │
+│                                         ▼                                                        │
+│                           ┌─────────────────────────────────────┐                                │
+│                           │      RODADA 2: REBATIDAS            │                                │
+│                           │  (Cada cargo vê posições dos outros)│                                │
+│                           │  Confronto de evidências            │                                │
+│                           └─────────────────────────────────────┘                                │
+│                                         │                                                        │
+│                               (se < 70%)│                                                        │
+│                                         ▼                                                        │
+│                           ┌─────────────────────────────────────┐                                │
+│                           │      RODADA 3: REFINAMENTO          │                                │
+│                           │  (Última tentativa de convergir)    │                                │
+│                           │  Foco apenas nas divergências       │                                │
+│                           └─────────────────────────────────────┘                                │
+│                                         │                                                        │
+│                                         ▼                                                        │
+│                           ┌─────────────────────────────────────┐                                │
+│                           │       CIRCUIT BREAKER               │                                │
+│                           │  > 3 rodadas? → Forçar síntese      │                                │
+│                           │  Loop detectado? → Escalar          │                                │
+│                           │  Timeout 300s? → Abortar            │                                │
+│                           └─────────────────────────────────────┘                                │
+│                                                                                                  │
+└──────────────────────────────────────────────────┬───────────────────────────────────────────────┘
+                                                   │
+                                                   ▼
+┌──────────────────────────────────────────────────────────────────────────────────────────────────┐
+│                                                                                                  │
+│  FASE 2: CRÍTICO AVALIA                                                                          │
+│  ══════════════════════                                                                          │
+│                                                                                                  │
+│  ┌────────────────────────────────────────────────────────────────────────────────────────────┐ │
+│  │                                                                                            │ │
+│  │    CRITÉRIO                               │ PONTOS │ O QUE AVALIA                         │ │
+│  │   ─────────────────────────────────────────┼────────┼────────────────────────────────────  │ │
+│  │    Premissas declaradas explicitamente    │ 0-20   │ Ficou claro o que assumiram?        │ │
+│  │    Evidências com IDs rastreáveis         │ 0-20   │ Citaram fontes [FONTE:ID]?          │ │
+│  │    Lógica consistente (sem contradições)  │ 0-20   │ Argumentos fazem sentido?           │ │
+│  │    Cenários alternativos considerados     │ 0-20   │ Pensaram em outras opções?          │ │
+│  │    Conflitos resolvidos adequadamente     │ 0-20   │ Divergências foram tratadas?        │ │
+│  │   ─────────────────────────────────────────┼────────┼────────────────────────────────────  │ │
+│  │    TOTAL                                  │ 0-100  │                                      │ │
+│  │                                                                                            │ │
+│  │    OUTPUT: APROVAR / REVISAR / REJEITAR                                                   │ │
+│  │                                                                                            │ │
+│  └────────────────────────────────────────────────────────────────────────────────────────────┘ │
+│                                                                                                  │
+└──────────────────────────────────────────────────┬───────────────────────────────────────────────┘
+                                                   │
+                                                   ▼
+┌──────────────────────────────────────────────────────────────────────────────────────────────────┐
+│                                                                                                  │
+│  FASE 3: ADVOGADO DO DIABO                                                                       │
+│  ═════════════════════════                                                                       │
+│                                                                                                  │
+│  ┌────────────────────────────────────────────────────────────────────────────────────────────┐ │
+│  │                                                                                            │ │
+│  │  4 PERGUNTAS OBRIGATÓRIAS:                                                                │ │
+│  │                                                                                            │ │
+│  │  1️⃣ PREMISSA MAIS FRÁGIL                                                                  │ │
+│  │     "Qual afirmação, se estiver ERRADA, derruba toda a recomendação?"                     │ │
+│  │                                                                                            │ │
+│  │  2️⃣ RISCO NÃO DISCUTIDO                                                                   │ │
+│  │     "O que pode dar errado que NINGUÉM mencionou?"                                        │ │
+│  │                                                                                            │ │
+│  │  3️⃣ CENÁRIO DE ARREPENDIMENTO (12 meses)                                                  │ │
+│  │     "Se olharmos para trás arrependidos, o que terá acontecido?"                          │ │
+│  │                                                                                            │ │
+│  │  4️⃣ ALTERNATIVA IGNORADA                                                                  │ │
+│  │     "Que opção ninguém considerou que deveria ser avaliada?"                              │ │
+│  │                                                                                            │ │
+│  │  ⚠️ FUNÇÃO: ATACAR, não confirmar. Se não encontrar falha, procurar mais.                │ │
+│  │                                                                                            │ │
+│  └────────────────────────────────────────────────────────────────────────────────────────────┘ │
+│                                                                                                  │
+└──────────────────────────────────────────────────┬───────────────────────────────────────────────┘
+                                                   │
+                                                   ▼
+┌──────────────────────────────────────────────────────────────────────────────────────────────────┐
+│                                                                                                  │
+│  FASE 4: SINTETIZADOR INTEGRA                                                                    │
+│  ════════════════════════════                                                                    │
+│                                                                                                  │
+│  ┌────────────────────────────────────────────────────────────────────────────────────────────┐ │
+│  │                                                                                            │ │
+│  │  CONSIDERA:                                                                               │ │
+│  │  • Consensos do debate (alta confiança)                                                   │ │
+│  │  • Divergências não resolvidas (requerem escolha)                                         │ │
+│  │  • Gaps do Crítico (precisam ser endereçados)                                             │ │
+│  │  • Vulnerabilidades do Advogado (precisam ser mitigadas)                                  │ │
+│  │                                                                                            │ │
+│  │  GERA:                                                                                    │ │
+│  │  ┌──────────────────────────────────────────────────────────────────────────────────────┐│ │
+│  │  │ • DECISÃO RECOMENDADA (clara, acionável)                                             ││ │
+│  │  │ • MODIFICAÇÕES incorporadas do feedback                                              ││ │
+│  │  │ • CONFIANÇA: 0-100% com justificativa                                                ││ │
+│  │  │ • RISCOS RESIDUAIS + mitigações                                                      ││ │
+│  │  │ • PRÓXIMOS PASSOS (responsável + prazo)                                              ││ │
+│  │  │ • CRITÉRIOS DE REVERSÃO (quando reconsiderar)                                        ││ │
+│  │  └──────────────────────────────────────────────────────────────────────────────────────┘│ │
+│  │                                                                                            │ │
+│  └────────────────────────────────────────────────────────────────────────────────────────────┘ │
+│                                                                                                  │
+└──────────────────────────────────────────────────┬───────────────────────────────────────────────┘
+                                                   │
+                                                   ▼
+┌──────────────────────────────────────────────────────────────────────────────────────────────────┐
+│                                                                                                  │
+│  FASE 5: THRESHOLD DE CONFIANÇA                                                                  │
+│  ══════════════════════════════                                                                  │
+│                                                                                                  │
+│                                 ┌─────────────────┐                                              │
+│                                 │   CONFIANÇA?    │                                              │
+│                                 └────────┬────────┘                                              │
+│                                          │                                                       │
+│              ┌───────────────────────────┼───────────────────────────┐                           │
+│              │                           │                           │                           │
+│              ▼                           ▼                           ▼                           │
+│       ┌────────────┐              ┌────────────┐              ┌────────────┐                     │
+│       │  >= 70%    │              │  50-69%    │              │   < 50%    │                     │
+│       │            │              │            │              │            │                     │
+│       │  EMITIR    │              │  EMITIR    │              │   NÃO      │                     │
+│       │  DECISÃO   │              │  COM       │              │  EMITIR    │                     │
+│       │  FINAL     │              │  RESSALVAS │              │            │                     │
+│       │            │              │            │              │  ESCALAR   │                     │
+│       └────────────┘              │  "MÉDIA"   │              │  HUMANO    │                     │
+│                                   └────────────┘              └────────────┘                     │
+│                                                                                                  │
+└──────────────────────────────────────────────────────────────────────────────────────────────────┘
+📁 ARQUIVOS CARREGADOS AUTOMATICAMENTE
+Ordem	Arquivo	Propósito
+1	core/templates/CONSTITUICAO-BASE.md	4 princípios fundamentais
+2	core/templates/debates/CONCLAVE-PROTOCOL.md	Estrutura das 6 fases
+3	core/templates/debates/DEBATE-PROTOCOL.md	Regras de debate
+4	core/templates/debates/DEBATE-DYNAMICS-PROTOCOL.md	Timeouts, loops, escalação
+5	/[sua-empresa]/[SUA EMPRESA]-CONTEXT.md	Contexto operacional da empresa
+6	/agents/conclave/critico-metodologico/AGENT.md	Agente do Conselho
+7	/agents/conclave/advogado-do-diabo/AGENT.md	Agente do Conselho
+8	/agents/conclave/sintetizador/AGENT.md	Agente do Conselho
+🔍 ONDE BUSCAM INFORMAÇÃO
+
+┌─────────────────────────────────────────────────────────────────────────────────────────────────┐
+│                                                                                                 │
+│   FONTES DE DADOS POR TIPO:                                                                     │
+│                                                                                                 │
+│   ┌───────────────────────────────────────────────────────────────────────────────────────────┐│
+│   │  🧬 DNA DOS ESPECIALISTAS                                                                 ││
+│   │  /knowledge/dna/                                                                       ││
+│   │  ├── COLE-GORDON/          → High-ticket, High-ticket Sales, certificação                       ││
+│   │  ├── JEREMY-HAYNES/        → Paid media, funis, scaling                                  ││
+│   │  ├── JEREMY-MINER/         → NEPQ, perguntas, tonalidade                                 ││
+│   │  ├── ALEX-HORMOZI/         → Equity, scaling, offers framework                               ││
+│   └───────────────────────────────────────────────────────────────────────────────────────────┘│
+│                                                                                                 │
+│   ┌───────────────────────────────────────────────────────────────────────────────────────────┐│
+│   │  📚 DOSSIÊS CONSOLIDADOS                                                                  ││
+│   │  /knowledge/dossiers/                                                                  ││
+│   │  ├── PERSONS/              → Dossiê de cada especialista                                 ││
+│   │  └── THEMES/               → Dossiês temáticos (NEPQ, Call Funnels, etc.)                ││
+│   └───────────────────────────────────────────────────────────────────────────────────────────┘│
+│                                                                                                 │
+│   ┌───────────────────────────────────────────────────────────────────────────────────────────┐│
+│   │  🏢 CONTEXTO [SUA EMPRESA]                                                                       ││
+│   │  /[sua-empresa]/                                                                              ││
+│   │  ├── [SUA EMPRESA]-CONTEXT.md     → Métricas, KPIs, custos fixos, estrutura                     ││
+│   │  ├── HIRING-STRUCTURE.md   → Estrutura de contratação                                    ││
+│   │  └── AGENT-FINANCE.md      → Análise financeira                                          ││
+│   └───────────────────────────────────────────────────────────────────────────────────────────┘│
+│                                                                                                 │
+│   ┌───────────────────────────────────────────────────────────────────────────────────────────┐│
+│   │  💡 INSIGHTS (RAG)                                                                        ││
+│   │  /processing/insights/  → Insights extraídos dos batches                              ││
+│   │  ⚠️ Máximo 5 consultas por sessão                                                        ││
+│   └───────────────────────────────────────────────────────────────────────────────────────────┘│
+│                                                                                                 │
+└─────────────────────────────────────────────────────────────────────────────────────────────────┘
+⏱️ LIMITES E PROTEÇÕES
+Parâmetro	Valor	Ação ao Exceder
+Timeout por agente	30s	Usar resposta parcial
+Timeout por rodada	120s	Encerrar rodada
+Timeout total	300s	Circuit breaker
+Rodadas máximas	3	Forçar síntese
+Consultas RAG	5	Sem mais buscas
+Loop detectado	2x mesma posição	Parar e escalar

package/docs/context7-readme.md

@@ -0,0 +1,28 @@
+O que foi adicionado
+
+- `mcp_servers.json`: arquivo de configuração com a entrada `context7` (placeholder de chave).
+- `setup_context7.ps1`: script PowerShell para definir a variável de ambiente `CONTEXT7_API_KEY` e atualizar `mcp_servers.json` automaticamente.
+
+Como usar
+
+1) No PowerShell (executar na pasta do workspace):
+
+```powershell
+.\setup_context7.ps1 -ApiKey "ctx7sk-SEU_TOKEN_AQUI"
+```
+
+2) Reinicie o VS Code se já estiver aberto.
+
+3) Verifique que a variável está setada:
+
+```powershell
+Get-ChildItem Env:CONTEXT7_API_KEY
+```
+
+4) Se sua ferramenta/projeto lê `mcp_servers.json`, ela automaticamente encontrará a configuração em `mcp_servers.json` no root do workspace.
+
+Segurança
+
+- Não commit seus tokens em repositórios públicos. Use `.gitignore` para excluir `mcp_servers.json` se for o caso.
+
+Precisa que eu adicione `mcp_servers.json` ao `.gitignore` automaticamente?"