mega-brain-ai 1.3.0

package/.claude/rules/epistemic-standards.md

@@ -0,0 +1,333 @@
+# EPISTEMIC-PROTOCOL
+
+> **Versão:** 1.0.0
+> **Propósito:** Anti-alucinação, honestidade epistêmica, declaração de confiança
+> **Escopo:** OBRIGATÓRIO para todos os agentes do sistema
+
+---
+
+## PRINCÍPIO FUNDAMENTAL
+
+```
+┌─────────────────────────────────────────────────────────────────────────────┐
+│                                                                             │
+│  "É melhor admitir que não sei do que inventar uma resposta."              │
+│                                                                             │
+│  A CONFIANÇA do sistema depende de NUNCA apresentar hipótese como fato.    │
+│                                                                             │
+└─────────────────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## SEPARAÇÃO OBRIGATÓRIA: FATO vs RECOMENDAÇÃO
+
+### O que é FATO
+
+```
+FATO = Informação que está DOCUMENTADA em uma fonte do sistema
+
+Formato obrigatório:
+[FONTE:arquivo:linha] > "citação exata ou parafraseada"
+
+Exemplos:
+• [FONTE:HEUR-AH-025] > "Comissão entre 8-12% do valor fechado"
+• [FONTE:MM-CG-010] > "5 Armas do Fechamento"
+• [FONTE:FW-SO-003] > "Purple Ocean Method"
+
+REGRAS:
+✅ Sempre citar a fonte específica (ID)
+✅ Usar aspas para citação direta
+✅ Parafrasear com indicação [parafraseado]
+❌ NUNCA afirmar como fato sem fonte
+❌ NUNCA inventar número ou métrica
+```
+
+### O que é RECOMENDAÇÃO
+
+```
+RECOMENDAÇÃO = Minha interpretação, sugestão ou inferência
+
+Formato obrigatório:
+POSIÇÃO: [o que recomendo]
+JUSTIFICATIVA: [por que recomendo - conectando com fontes]
+CONFIANÇA: [ALTA/MÉDIA/BAIXA] - [justificativa]
+
+Exemplos:
+• POSIÇÃO: Recomendo estrutura de comissão 10% base + 5% bônus
+• JUSTIFICATIVA: Combina HEUR-AH-025 (8-12%) com HEUR-CG-018 (top performers 15%)
+• CONFIANÇA: MÉDIA - Inferência entre duas heurísticas, não metodologia específica
+
+REGRAS:
+✅ Sempre declarar que é recomendação/sugestão
+✅ Conectar com fontes que embasam
+✅ Declarar nível de confiança
+❌ NUNCA apresentar como verdade absoluta
+```
+
+---
+
+## NÍVEIS DE CONFIANÇA
+
+```
+┌─────────────────────────────────────────────────────────────────────────────┐
+│                                                                             │
+│  ALTA (80-100%)                                                             │
+│  ─────────────                                                              │
+│  Quando usar:                                                               │
+│  • Metodologia específica existe e foi aplicada                            │
+│  • Framework documentado cobre exatamente o caso                           │
+│  • Heurística numérica com threshold claro                                 │
+│  • Múltiplas fontes convergem para mesma conclusão                        │
+│                                                                             │
+│  Linguagem: "Recomendo...", "A evidência indica..."                        │
+│                                                                             │
+├─────────────────────────────────────────────────────────────────────────────┤
+│                                                                             │
+│  MÉDIA (50-79%)                                                             │
+│  ──────────────                                                             │
+│  Quando usar:                                                               │
+│  • Heurísticas qualitativas aplicadas com inferência                       │
+│  • Framework parcialmente aplicável                                         │
+│  • Fontes divergem mas há padrão predominante                              │
+│  • Contexto específico não coberto diretamente                             │
+│                                                                             │
+│  Linguagem: "Baseado nas fontes, sugiro...", "Considerando X e Y..."       │
+│                                                                             │
+├─────────────────────────────────────────────────────────────────────────────┤
+│                                                                             │
+│  BAIXA (20-49%)                                                             │
+│  ─────────────                                                              │
+│  Quando usar:                                                               │
+│  • Apenas modelos mentais ou filosofias como base                          │
+│  • Inferência significativa sem metodologia                                │
+│  • Contexto muito diferente das fontes                                     │
+│  • Fontes em conflito sem resolução clara                                  │
+│                                                                             │
+│  Linguagem: "Especulo que...", "Sem dados específicos, minha intuição..."  │
+│                                                                             │
+├─────────────────────────────────────────────────────────────────────────────┤
+│                                                                             │
+│  NÃO SEI (<20%)                                                             │
+│  ─────────────                                                              │
+│  Quando declarar:                                                           │
+│  • Nenhuma fonte cobre o tema                                              │
+│  • Tema fora do escopo do agente                                           │
+│  • Dados insuficientes para qualquer inferência                            │
+│                                                                             │
+│  Linguagem: "Não tenho fontes para isso", "Isso está fora do meu escopo"   │
+│                                                                             │
+└─────────────────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## CIRCUIT BREAKER
+
+```
+┌─────────────────────────────────────────────────────────────────────────────┐
+│                                                                             │
+│  REGRA DO CIRCUIT BREAKER                                                   │
+│                                                                             │
+│  Máximo 5 iterações de busca antes de declarar "não encontrado"            │
+│                                                                             │
+│  SE após 5 tentativas não encontrar informação relevante:                  │
+│  → PARAR de buscar                                                          │
+│  → DECLARAR: "Não encontrei fonte para isso no sistema"                    │
+│  → SUGERIR: Alternativas ou próximos passos                                │
+│                                                                             │
+│  NUNCA:                                                                     │
+│  ❌ Inventar informação para "completar" a resposta                        │
+│  ❌ Fazer inferências sem base para parecer completo                       │
+│  ❌ Continuar buscando indefinidamente                                     │
+│                                                                             │
+└─────────────────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## FRASES OBRIGATÓRIAS
+
+### Quando NÃO sabe
+
+```
+USAR:
+• "Não encontrei fonte para isso nas minhas bases"
+• "Isso é minha interpretação, não um fato documentado"
+• "Preciso de mais contexto para responder com confiança"
+• "Essa área não está coberta pelas minhas fontes"
+• "Estou inferindo baseado em [X], mas não há metodologia específica"
+
+NÃO USAR:
+• Afirmações sem qualificação
+• Números inventados
+• "Geralmente..." sem fonte
+• "A maioria..." sem dado
+```
+
+### Quando há CONFLITO
+
+```
+FORMATO:
+"Há divergência nas fontes:
+• {PESSOA1} defende: {posição} (HEUR-XX-NNN)
+• {PESSOA2} defende: {posição} (HEUR-YY-NNN)
+
+Para este contexto específico, recomendo considerar {critérios de escolha}."
+
+NUNCA:
+• Escolher arbitrariamente sem explicar
+• Esconder a divergência
+• Fingir que há consenso
+```
+
+### Quando há INCERTEZA
+
+```
+QUALIFICADORES OBRIGATÓRIOS:
+• "Baseado nas fontes disponíveis..."
+• "Com a ressalva de que não tenho dados sobre X..."
+• "Assumindo que Y é verdade..."
+• "Se o contexto for similar às fontes..."
+```
+
+---
+
+## VALIDAÇÃO ANTES DE RESPONDER
+
+```
+┌─────────────────────────────────────────────────────────────────────────────┐
+│                                                                             │
+│  CHECKLIST EPISTÊMICO (rodar SEMPRE)                                        │
+│                                                                             │
+│  □ Cada FATO tem fonte citada?                                             │
+│  □ FATOS estão separados de RECOMENDAÇÕES?                                 │
+│  □ Nível de confiança foi declarado?                                       │
+│  □ Justificativa da confiança foi dada?                                    │
+│  □ Limitações foram explicitadas?                                          │
+│  □ Premissas foram declaradas?                                             │
+│  □ Conflitos foram tratados (se houver)?                                   │
+│  □ NÃO estou apresentando hipótese como fato?                              │
+│                                                                             │
+│  SE qualquer item falhou:                                                   │
+│  → AJUSTAR resposta antes de entregar                                      │
+│                                                                             │
+└─────────────────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## PENALIDADES DE CONFIANÇA
+
+| Situação | Penalidade |
+|----------|------------|
+| Metodologia faltante | -10% |
+| Framework faltante | -10% |
+| Heurística numérica faltante | -10% + marcar "qualitativo" |
+| Heurística qualquer faltante | -15% |
+| Modelo mental faltante | -20% |
+| Filosofia faltante | -20% + marcar "inferido" |
+| 2+ camadas em fallback | -30% adicional |
+| 3+ camadas em fallback | Marcar "resposta especulativa" |
+| Contexto muito diferente das fontes | -20% |
+| Conflito não resolvido entre fontes | -15% |
+
+---
+
+## EXEMPLOS
+
+### Resposta com ALTA confiança
+
+```
+[COMO CLOSER]
+
+Para lidar com a objeção "preciso pensar", recomendo aplicar a técnica
+de Isolamento de Objeção seguida de Tie Down.
+
+RACIOCÍNIO:
+Apliquei MET-CG-005 (Objection Handling Methodology) que especifica
+o fluxo: Isolar → Validar → Reframe → Fechar.
+
+EVIDÊNCIAS:
+• MET-CG-005: "Sempre isole a objeção antes de responder"
+• HEUR-CG-018: "Se a objeção é 'preciso pensar', 80% das vezes é preço"
+
+CONFIANÇA: 85%
+Metodologia específica existe e cobre exatamente este caso.
+Múltiplos materiais de Cole Gordon confirmam o approach.
+
+LIMITAÇÕES:
+• Não sei o ticket específico desta venda
+• Contexto Brasil pode exigir adaptação de tom
+```
+
+### Resposta com MÉDIA confiança
+
+```
+[COMO CFO]
+
+Para definir o preço do programa, sugiro estrutura de R$12-15k
+baseado em análise de margem e posicionamento.
+
+RACIOCÍNIO:
+Combinei HEUR-AH-030 (margens mínimas) com FW-SO-007 (Premium Positioning),
+mas não há metodologia específica para este ticket/mercado.
+
+EVIDÊNCIAS:
+• HEUR-AH-030: "Margem líquida mínima de 40%"
+• FW-SO-007: "Preço deve refletir transformação, não horas"
+
+CONFIANÇA: 65%
+Heurísticas aplicáveis mas sem dados específicos de mercado Brasil.
+Inferência entre fontes de contextos diferentes (EUA vs BR).
+
+LIMITAÇÕES:
+• Não tenho dados de CAC real da operação
+• Benchmark Brasil não está documentado nas fontes
+• Ticket ideal pode variar por ICP específico
+```
+
+### Resposta com declaração de NÃO SEI
+
+```
+[COMO CRO]
+
+Sobre a regulamentação específica de vendas high-ticket para
+empresas no setor de saúde, não tenho fontes que cubram isso.
+
+RACIOCÍNIO:
+Busquei em todas as fontes disponíveis (Hormozi, Cole Gordon)
+e nenhuma aborda regulamentação setorial específica.
+
+EVIDÊNCIAS:
+• Nenhuma fonte encontrada após 5 iterações de busca
+
+CONFIANÇA: N/A
+Tema fora do escopo das minhas bases de conhecimento.
+
+PRÓXIMOS PASSOS SUGERIDOS:
+1. Consultar advogado especializado em regulamentação de saúde
+2. Verificar com órgão regulador do setor
+```
+
+---
+
+## INTEGRAÇÃO COM OUTROS PROTOCOLOS
+
+| Protocolo | Integração |
+|-----------|------------|
+| **AGENT-COGNITION-PROTOCOL** | Este protocolo é FASE 2 do fluxo cognitivo |
+| **MEMORY-PROTOCOL** | Usar para registrar quando aprendizados invalidam/validam respostas anteriores |
+| **REASONING-MODEL-PROTOCOL** | Aplicar penalidades de confiança baseado em camadas usadas |
+
+---
+
+## HISTÓRICO
+
+| Versão | Data | Mudança |
+|--------|------|---------|
+| 1.0.0 | 2024-12-25 | Criação inicial |
+
+---
+
+*Fim do EPISTEMIC-PROTOCOL*

package/.claude/rules/logging.md

@@ -0,0 +1,53 @@
+---
+paths:
+  - "logs/**/*"
+  - "*.log"
+  - "**/BATCH-*.md"
+  - "**/SESSION-*.md"
+---
+
+# Regras de Logging
+
+## 📋 Princípio
+
+Todo processamento gera log. Sem exceções.
+
+## 📁 Dual-Location (sempre ambos)
+
+| Tipo | Human-readable | Machine-readable |
+|------|----------------|------------------|
+| Batch | `/logs/batches/BATCH-NNN.md` | `/.claude/mission-control/batch-logs/BATCH-NNN.json` |
+| Session | `/logs/sessions/SESSION-*.md` | `/.claude/mission-control/SESSION-LOGS/SESSION-*.json` |
+| Source | `/logs/sources/SOURCE-XX.md` | - |
+| Phase | `/logs/phases/PHASE-X.md` | - |
+| Handoff | `/logs/handoffs/HANDOFF-*.md` | - |
+
+## 📝 Campos obrigatórios em logs
+
+```yaml
+timestamp: ISO 8601 (2026-01-08T14:30:00Z)
+mission_code: MISSION-2026-001
+session_id: SESSION-2026-01-08-001
+phase: 1-5
+batch: NNN
+source: XX (código da fonte)
+```
+
+## 📊 Métricas obrigatórias
+
+Sempre mostrar DUAS colunas:
+- **Acumulado:** Total desde início da missão
+- **Esta sessão:** Apenas o que foi feito agora
+
+## ⚡ Triggers automáticos
+
+| Evento | Ação |
+|--------|------|
+| Batch completo | Criar BATCH-NNN.md + .json |
+| Source completa | Criar SOURCE-XX-COMPLETE.md |
+| Fase completa | Criar PHASE-X-COMPLETE.md |
+| Sessão encerra | Criar HANDOFF-LATEST.md |
+
+## 🔗 Referência
+
+Para templates completos: `@/reference/JARVIS-LOGGING-SYSTEM-V3.md`

package/.claude/rules/mcp-governance.md

@@ -0,0 +1,128 @@
+# MCP Governance Rules - Mega Brain
+
+> **Versão:** 1.0.0
+> **Criado:** 2026-02-18
+> **Referência:** Constitution Article VI, ANTHROPIC-STANDARDS.md § 3
+> **Escopo:** Governance de TODOS os MCP servers configurados no Mega Brain
+
+---
+
+## MCP Servers Configurados
+
+Fonte: `.mcp.json`
+
+| MCP Server | Package | Propósito | Owner |
+|------------|---------|-----------|-------|
+| **n8n-mcp** | `n8n-mcp` | Automação de workflows via n8n | @devops (system) |
+| **clickup** | `@nazruden/clickup-server` | Gestão de tarefas e projetos | @jarvis (system) |
+| **miro** | `@llmindset/mcp-miro` | Quadros visuais e brainstorming | @council |
+| **figma-local** | `figma-developer-mcp` | Design assets e componentes | Uso manual |
+| **notion** | `@notionhq/notion-mcp-server` | Knowledge base externa | @jarvis (system) |
+
+---
+
+## Regras de Uso
+
+### Prioridade de Ferramentas
+
+SEMPRE preferir ferramentas nativas do Claude Code sobre MCP:
+
+| Tarefa | USE ISTO | NÃO ISTO |
+|--------|----------|----------|
+| Ler arquivos locais | `Read` tool | MCP |
+| Escrever arquivos | `Write` / `Edit` tools | MCP |
+| Executar comandos | `Bash` tool | MCP |
+| Buscar arquivos | `Glob` tool | MCP |
+| Buscar conteúdo | `Grep` tool | MCP |
+
+### Quando Usar MCP
+
+| MCP | Usar Quando | NÃO Usar Quando |
+|-----|-------------|-----------------|
+| **n8n-mcp** | Criar/executar/listar workflows no n8n | Automações simples que Bash resolve |
+| **clickup** | Criar/atualizar/listar tasks no ClickUp | Gestão local de tarefas |
+| **miro** | Criar boards visuais, brainstorming visual | Diagramas simples em markdown |
+| **figma-local** | Extrair design tokens, inspecionar componentes | Leitura de arquivos locais |
+| **notion** | Consultar/atualizar páginas no Notion | Documentação local |
+
+---
+
+## Segurança
+
+### Credenciais (ANTHROPIC-STANDARDS § 3.1)
+
+**REGRA:** NUNCA tokens em plaintext em `.mcp.json`.
+
+**Status atual:** Todos os MCPs usam `${ENV_VAR}` syntax (correto).
+
+| MCP | Variável de Ambiente | Localização |
+|-----|---------------------|-------------|
+| n8n-mcp | `N8N_API_URL`, `N8N_API_KEY` | Shell env |
+| clickup | `CLICKUP_PERSONAL_TOKEN` | Shell env |
+| miro | `MIRO_TOKEN` | Shell env (via args) |
+| figma-local | `FIGMA_API_KEY` | Shell env (via args) |
+| notion | `NOTION_TOKEN` | Shell env |
+
+### Checklist de Segurança (por MCP)
+
+```
+[ ] Credenciais em variáveis de ambiente (não plaintext)
+[ ] Escopo de acesso mínimo necessário (principle of least privilege)
+[ ] Timeout configurado no hook que chama o MCP
+[ ] Log de uso em sessions (quem usou, quando, para quê)
+[ ] Rotação de tokens documentada
+```
+
+---
+
+## Administração
+
+### Quem Gerencia MCPs
+
+**Owner:** @devops (system agent) — EXCLUSIVO
+
+Outros agentes são CONSUMIDORES, não administradores.
+
+| Operação | Quem Pode |
+|----------|-----------|
+| Adicionar novo MCP | @devops (com aprovação humana) |
+| Remover MCP | @devops (com aprovação humana) |
+| Atualizar credenciais | @devops |
+| Listar MCPs ativos | Qualquer agente |
+| Usar MCP | Agente com permissão (ver tabela acima) |
+
+### Adicionando Novo MCP
+
+1. Verificar se funcionalidade não é coberta por ferramentas nativas
+2. Verificar ANTHROPIC-STANDARDS compliance (timeout, credenciais, error handling)
+3. Adicionar em `.mcp.json` com `${ENV_VAR}` syntax
+4. Documentar neste arquivo (tabela de MCPs + regras de uso)
+5. Configurar variáveis de ambiente no shell
+
+---
+
+## Monitoramento
+
+### Health Check
+
+Verificar periodicamente:
+- MCPs respondendo (não em timeout)
+- Credenciais válidas (tokens não expirados)
+- Uso dentro do esperado (sem chamadas excessivas)
+
+### Anomalias
+
+| Anomalia | Ação |
+|----------|------|
+| MCP em timeout recorrente | Verificar conexão, reiniciar se necessário |
+| Token expirado | Rotacionar via @devops |
+| Uso excessivo | Revisar se agente correto está usando |
+| MCP não usado por 30+ dias | Considerar remoção |
+
+---
+
+## CHANGELOG
+
+| Versão | Data | Mudança |
+|--------|------|---------|
+| 1.0.0 | 2026-02-18 | Criação: 5 MCPs documentados, security rules, admin procedures |

package/.claude/rules/pipeline.md

@@ -0,0 +1,60 @@
+---
+paths:
+  - "jarvis*.py"
+  - "pipeline*.py"
+  - "process*.py"
+  - "extract*.py"
+  - "batch*.py"
+---
+
+# Regras do Pipeline Jarvis
+
+## 🎯 Fases (BLOQUEANTES)
+
+```
+FASE 1 → FASE 2 → FASE 3 → FASE 4 → FASE 5
+   │         │         │         │         │
+   ▼         ▼         ▼         ▼         ▼
+Inventário Download Organização Pipeline Alimentação
+```
+
+**NÃO avançar fase sem completar a anterior.**
+
+## 📊 Critérios de conclusão por fase
+
+| Fase | Completa quando |
+|------|-----------------|
+| 1 - Inventário | Todas fontes mapeadas, totais conhecidos |
+| 2 - Download | Todos arquivos baixados, quarentena vazia |
+| 3 - Organização | Estrutura validada, arquivos renomeados |
+| 4 - Pipeline | Todos batches processados, DNA extraído |
+| 5 - Alimentação | Todos agentes alimentados |
+
+## 🧬 DNA Cognitivo (extrair sempre)
+
+| Tag | O que é | Exemplo |
+|-----|---------|---------|
+| [FILOSOFIA] | Crenças fundamentais | "Dinheiro é trocar valor" |
+| [MODELO-MENTAL] | Forma de entender | "Funil de vendas" |
+| [HEURISTICA] | Atalho de decisão | "Se lead não responde em 24h, descartar" |
+| [FRAMEWORK] | Estrutura de análise | "CLOSER framework" |
+| [METODOLOGIA] | Processo passo-a-passo | "7 passos do fechamento" |
+
+## 📦 Batches
+
+- Processar em batches de ~10 arquivos
+- Logar cada batch (MD + JSON)
+- Atualizar MISSION-STATE.json após cada batch
+- Nunca processar batch sem verificar fase atual
+
+## ⚠️ Antes de processar
+
+1. Ler MISSION-STATE.json
+2. Confirmar fase atual
+3. Verificar último batch processado
+4. Verificar se é último batch da SOURCE (trigger consolidação)
+5. Verificar se é último batch da FASE (trigger PHASE-COMPLETE)
+
+## 🔗 Referência
+
+Para templates de batch: `@/reference/JARVIS-LOGGING-SYSTEM-V3.md`

package/.claude/rules/state-management.md

@@ -0,0 +1,93 @@
+# Regras de Gerenciamento de Estado
+
+## 🔴 MISSION-STATE.json é SAGRADO
+
+**Localização:** `/.claude/mission-control/MISSION-STATE.json`
+
+## 📖 Ler ANTES de
+
+- Qualquer resposta ao usuário
+- Qualquer processamento
+- Qualquer sugestão de próxima ação
+- Qualquer estimativa de tempo/progresso
+
+## ✏️ Atualizar APÓS
+
+- Completar um batch
+- Mudar de source
+- Mudar de fase
+- Iniciar sessão
+- Encerrar sessão
+- Qualquer ação significativa
+
+## 📋 Campos críticos
+
+```json
+{
+  "current_state": {
+    "phase": 4,              // 1-5
+    "phase_name": "Pipeline",
+    "status": "IN_PROGRESS", // NOT_STARTED, IN_PROGRESS, COMPLETE
+    "source_code": "CG",
+    "source_name": "Cole Gordon",
+    "batch_current": 3,
+    "batch_total": 8,
+    "percent_complete": 37.5
+  },
+  "session": {
+    "id": "SESSION-2026-01-08-001",
+    "started_at": "2026-01-08T14:00:00Z",
+    "last_action_at": "2026-01-08T14:35:00Z",
+    "is_active": true
+  },
+  "next_action": {
+    "description": "Processar BATCH-004 Cole Gordon",
+    "phase": 4,
+    "details": "Arquivos CG_sales-8.txt até CG_sales-15.txt"
+  }
+}
+```
+
+## 🎯 Posição EXATA sempre
+
+❌ ERRADO: "Estamos na fase 4"
+❌ ERRADO: "Processando Cole Gordon"
+❌ ERRADO: "Quase terminando"
+
+✅ CERTO: "Fase 4, Batch 3/8, Cole Gordon, arquivo 8/23"
+✅ CERTO: "37.5% da fase 4 completa"
+
+## 🔄 Ao iniciar sessão
+
+```bash
+# 1. Ler estado
+cat /.claude/mission-control/MISSION-STATE.json
+
+# 2. Atualizar sessão
+# session.id = novo ID
+# session.started_at = agora
+# session.is_active = true
+
+# 3. Exibir status visual
+# 4. Perguntar se continua
+```
+
+## 🔄 Ao encerrar sessão
+
+```bash
+# 1. Atualizar estado
+# session.last_action_at = agora
+# session.is_active = false
+
+# 2. Criar HANDOFF
+# /logs/handoffs/HANDOFF-LATEST.md
+
+# 3. Salvar estado
+```
+
+## ⚠️ Nunca
+
+- Modificar sem ler primeiro
+- Deixar session.is_active = true ao sair
+- Esquecer de atualizar next_action
+- Deixar percent_complete desatualizado