mega-brain-ai 1.3.0

package/.claude/skills/dispatching-parallel-agents/SKILL.md

@@ -0,0 +1,193 @@
+---
+name: 07-SKILL-DISPATCHING-PARALLEL-AGENTS
+description: Use quando tiver 2+ tarefas independentes que podem ser processadas em paralelo sem dependências
+---
+
+> **Auto-Trigger:** 2+ arquivos INBOX, múltiplos processamentos, paralelização de tarefas
+> **Keywords:** "paralelo", "agents", "dispatch", "múltiplos", "batch", "concorrente", "INBOX"
+> **Prioridade:** ALTA
+
+---
+
+# Dispatching Parallel Agents - Mega Brain
+
+## Overview
+
+Quando há múltiplos arquivos no INBOX ou tarefas independentes, processá-los sequencialmente desperdiça tempo. Cada processamento é independente e pode acontecer em paralelo.
+
+**Princípio central:** Dispatch de um agente por domínio independente. Deixá-los trabalhar concorrentemente.
+
+## Quando Usar
+
+**Usar quando:**
+- 3+ arquivos no INBOX de fontes diferentes
+- Múltiplas extrações de conhecimento independentes
+- Cada processamento pode ser entendido sem contexto dos outros
+- Sem estado compartilhado entre investigações
+
+**NÃO usar quando:**
+- Arquivos são da mesma fonte (processar juntos para consistência)
+- Precisa entender o estado completo do sistema
+- Agentes interfeririam uns com os outros (editando mesmos arquivos)
+
+```
+┌─────────────────────────────────────────────────────────────────────────┐
+│  DECISÃO: PARALELO OU SEQUENCIAL?                                       │
+├─────────────────────────────────────────────────────────────────────────┤
+│                                                                         │
+│  Múltiplos arquivos? ──NO──→ Processo único                            │
+│        │                                                                │
+│       YES                                                               │
+│        │                                                                │
+│  São independentes? ──NO──→ Processar juntos (mesma fonte/tema)        │
+│        │                                                                │
+│       YES                                                               │
+│        │                                                                │
+│  ┌─────▼─────┐                                                         │
+│  │ PARALLEL  │                                                         │
+│  │ DISPATCH  │                                                         │
+│  └───────────┘                                                         │
+│                                                                         │
+└─────────────────────────────────────────────────────────────────────────┘
+```
+
+## O Padrão
+
+### 1. Identificar Domínios Independentes
+
+Agrupar por o que será processado:
+- Arquivo A: Cole Gordon - Cole Gordon
+- Arquivo B: Alex Hormozi - Alex Hormozi
+
+Cada domínio é independente - processar Cole Gordon não afeta Hormozi.
+
+### 2. Criar Tasks de Agente Focadas
+
+Cada agente recebe:
+- **Escopo específico:** Um arquivo ou fonte
+- **Objetivo claro:** Extrair chunks e insights
+- **Constraints:** Não modificar outros arquivos
+- **Output esperado:** Resumo do que foi extraído
+
+### 3. Dispatch em Paralelo
+
+```
+Task("Processar CG-SM002.txt via Pipeline Jarvis Steps 1-3")
+Task("Processar AH-HR003.txt via Pipeline Jarvis Steps 1-3")
+// Todos rodam concorrentemente
+```
+
+### 4. Revisar e Integrar
+
+Quando agentes retornam:
+- Ler cada resumo
+- Verificar se não há conflitos em canonical/entities
+- Rodar consolidação (Steps 4-6 do Jarvis)
+- Integrar todos os outputs
+
+## Estrutura do Prompt de Agente
+
+```markdown
+Processar arquivo: inbox/COLE GORDON/PODCASTS/CG-SM002.txt
+
+Pipeline Jarvis Steps 1.1 a 2.1:
+1. Chunking semântico → processing/chunks/
+2. Entity Resolution → processing/canonical/
+3. Insight Extraction → processing/insights/
+
+Constraints:
+- NÃO modificar arquivos de outras fontes
+- Seguir protocolos existentes em core/templates/agents/
+- Atualizar INSIGHTS-STATE.json com novos insights
+
+Retornar: Resumo de chunks gerados, entidades encontradas, insights extraídos.
+```
+
+## Erros Comuns
+
+| ❌ Errado | ✅ Correto |
+|-----------|-----------|
+| "Processar todo o INBOX" | "Processar CG-SM002.txt" |
+| Sem contexto do arquivo | Incluir path completo e fonte |
+| Sem constraints | "NÃO modificar outros arquivos" |
+| Output vago | "Retornar resumo de extrações" |
+
+## Exemplo Real - Mega Brain
+
+**Cenário:** 5 arquivos novos no INBOX de 3 fontes diferentes
+
+**Arquivos:**
+- Cole Gordon: CG-SM002.txt, CG-SM003.txt
+- Alex Hormozi: AH-HR002.txt
+
+**Decisão:**
+- CG arquivos → 1 agente (mesma fonte)
+- AH arquivo → 1 agente
+
+**Dispatch:**
+```
+Agent 1 → Processar CG-SM002.txt + CG-SM003.txt
+Agent 2 → Processar AH-HR002.txt
+```
+
+**Resultados:**
+- Agent 1: 45 chunks, 23 insights sobre Sales Management
+- Agent 2: 30 chunks, 18 insights sobre Hiring
+
+**Integração:** Consolidar insights-state.json, rodar Steps 4-6
+
+## Benefícios
+
+1. **Paralelização** - Múltiplos processamentos simultâneos
+2. **Foco** - Cada agente tem escopo narrow
+3. **Independência** - Agentes não interferem
+4. **Velocidade** - 3 problemas resolvidos no tempo de 1
+
+## Verificação
+
+Após agentes retornarem:
+1. **Revisar cada resumo** - Entender o que foi extraído
+2. **Checar conflitos** - Agentes editaram mesmos arquivos?
+3. **Validar integridade** - JSONs de estado estão consistentes?
+4. **Rodar consolidação** - Steps 4-6 do Pipeline Jarvis
+
+---
+
+## INTEGRACAO COM JARVIS_PARALLEL_DISPATCHER.PY
+
+O sistema agora possui um dispatcher automatizado em `scripts/jarvis_parallel_dispatcher.py`.
+
+### Uso Programatico
+
+```python
+import sys
+sys.path.insert(0, "scripts")
+from jarvis_parallel_dispatcher import get_dispatcher, analyze_for_parallelism
+
+# Analisar prompt
+analysis = analyze_for_parallelism("Processar proximos 3 batches")
+# Retorna: {"can_parallelize": True, "reason": "Multiplos batches detectado"}
+
+# Criar tarefas
+dispatcher = get_dispatcher()
+tasks = dispatcher.create_parallel_tasks(prompt, context)
+commands = dispatcher.generate_task_commands(tasks)
+```
+
+### Logs Gerados
+
+| Arquivo | Conteudo |
+|---------|----------|
+| `logs/dispatch.jsonl` | Acoes de dispatch |
+| `system/active_parallel_tasks.json` | Tarefas ativas |
+| `/tmp/claude/.../tasks/*.output` | Output de cada agente |
+
+### Monitoramento
+
+```bash
+# Ver progresso de um agente
+tail -50 /tmp/claude/<project-path>/tasks/[id].output
+
+# Status de todas as tarefas
+python scripts/jarvis_parallel_dispatcher.py
+```

package/.claude/skills/docs-megabrain/SKILL.md

@@ -0,0 +1,251 @@
+# SKILL-DOCS-MEGABRAIN
+## Padrões de Documentação do Mega Brain
+
+> **Auto-Trigger:** Criação de qualquer arquivo .md no projeto
+> **Keywords:** "documento", "documentar", "criar md", "playbook", "README"
+> **Prioridade:** ALTA
+
+---
+
+## PROPÓSITO
+
+Garantir que toda documentação do Mega Brain siga padrões consistentes de:
+- Estrutura hierárquica
+- Formatação visual
+- Linguagem acessível
+- Rastreabilidade
+
+---
+
+## QUANDO USAR
+
+### ✅ USAR quando:
+- Criar qualquer arquivo .md
+- Documentar processos, playbooks, guias
+- Atualizar README, CLAUDE.md, SESSION-STATE
+- Criar documentação de agentes
+
+### ❌ NÃO USAR quando:
+- Arquivos de configuração (.json, .yaml)
+- Código fonte (.py, .sh)
+- Logs temporários
+
+---
+
+## REGRAS OBRIGATÓRIAS
+
+### Estrutura de Documento
+
+```markdown
+# TÍTULO PRINCIPAL
+## Subtítulo descritivo
+
+> **Metadata em blockquote**
+> **Versão:** X.X.X
+> **Atualizado:** Data
+
+---
+
+## SEÇÃO 1
+
+### Subseção 1.1
+
+Conteúdo...
+
+---
+
+## SEÇÃO 2
+
+...
+```
+
+### Hierarquia de Títulos
+
+| Nível | Uso | Exemplo |
+|-------|-----|---------|
+| `#` | Título do documento (1 por arquivo) | `# PLAYBOOK CLOSER` |
+| `##` | Seções principais | `## MÉTRICAS` |
+| `###` | Subseções | `### Taxa de Conversão` |
+| `####` | Detalhes (evitar) | Usar apenas se necessário |
+
+### Regra de Não Abreviar
+
+| ❌ Proibido | ✅ Usar |
+|-------------|---------|
+| SM | Sales Manager (Gerente de Vendas) |
+| BDR | Prospector (Business Development Representative) |
+| MRR | Receita Recorrente Mensal |
+| LTV | Valor do Tempo de Vida do Cliente |
+| CAC | Custo de Aquisição de Cliente |
+
+**Exceção:** Após primeira menção completa, pode usar sigla.
+
+### Formatação de Métricas
+
+```markdown
+## Métricas de Sucesso
+
+| Métrica | Target | Crítico |
+|---------|--------|---------|
+| Taxa de comparecimento | ≥80% | <70% |
+| Taxa de fechamento | 25-35% | <20% |
+
+**Na prática:** Se agenda 10 reuniões, 8 devem comparecer.
+Dessas 8, fechar 2-3 vendas.
+```
+
+### Formatação de Processos
+
+```markdown
+## Processo de [Nome]
+
+### Passo 1: [Ação]
+**O que:** Descrição clara
+**Por que:** Justificativa
+**Como:** Instruções específicas
+
+### Passo 2: [Ação]
+...
+```
+
+### Separadores
+
+- Usar `---` entre seções principais
+- Nunca usar `***` ou `___`
+- Linha em branco antes e depois do separador
+
+### Blockquotes
+
+```markdown
+> ⚠️ **ATENÇÃO:** Para avisos importantes
+> 💡 **DICA:** Para sugestões úteis
+> 📌 **NOTA:** Para informações adicionais
+```
+
+### Tabelas
+
+- Sempre com header
+- Alinhamento consistente
+- Mínimo 2 colunas
+
+```markdown
+| Coluna A | Coluna B | Coluna C |
+|----------|----------|----------|
+| Valor 1  | Valor 2  | Valor 3  |
+```
+
+### Listas
+
+**Bullets para itens sem ordem:**
+```markdown
+- Item A
+- Item B
+- Item C
+```
+
+**Números para sequências:**
+```markdown
+1. Primeiro passo
+2. Segundo passo
+3. Terceiro passo
+```
+
+### Links Internos
+
+```markdown
+Ver também: [Nome do Documento](/caminho/DOCUMENTO.md)
+Fonte: [ID-FONTE](/knowledge/dossiers/...)
+```
+
+---
+
+## TEMPLATES POR TIPO
+
+### Playbook
+```markdown
+# PLAYBOOK [FUNÇÃO]
+
+> **Função:** [Nome completo]
+> **Versão:** X.X.X
+> **Fontes:** [IDs das fontes]
+
+---
+
+## VISÃO GERAL
+[Resumo executivo]
+
+## RESPONSABILIDADES
+[Lista de responsabilidades]
+
+## MÉTRICAS
+[Tabela de métricas]
+
+## PROCESSO DIÁRIO
+[Passo a passo]
+
+## scripts/FRAMEWORKS
+[Ferramentas práticas]
+
+## ERROS COMUNS
+[O que evitar]
+```
+
+### Dossier de Pessoa
+```markdown
+# DOSSIER: [NOME]
+
+> **Empresa:** [Nome]
+> **Especialidade:** [Área]
+> **Fontes processadas:** [N]
+
+---
+
+## BIOGRAFIA
+[Contexto da pessoa]
+
+## FILOSOFIA CORE
+[Crenças fundamentais]
+
+## FRAMEWORKS PRINCIPAIS
+[Metodologias da pessoa]
+
+## CITAÇÕES MARCANTES
+[Quotes importantes]
+
+## FONTES
+[Lista de materiais processados]
+```
+
+---
+
+## ANTI-PATTERNS (NUNCA FAZER)
+
+1. ❌ Títulos sem hierarquia clara
+2. ❌ Parágrafos gigantes sem quebra
+3. ❌ Siglas sem explicação na primeira menção
+4. ❌ Listas mistas (bullets + números juntos)
+5. ❌ Formatação inconsistente entre documentos
+6. ❌ Links quebrados ou relativos incorretos
+7. ❌ Documentos sem metadata (versão, data)
+
+---
+
+## CHECKLIST PRÉ-ENTREGA
+
+- [ ] Título principal único (#)
+- [ ] Metadata em blockquote no topo
+- [ ] Separadores entre seções principais
+- [ ] Siglas explicadas na primeira menção
+- [ ] Tabelas com header
+- [ ] Links internos funcionais
+- [ ] Sem parágrafos > 5 linhas
+- [ ] Versão e data atualizados
+
+---
+
+## META-INFORMAÇÃO
+
+- **Versão:** 1.0.0
+- **Domínio:** Documentação
+- **Prioridade:** ALTA
+- **Dependências:** Nenhuma

package/.claude/skills/executing-plans/SKILL.md

@@ -0,0 +1,114 @@
+---
+name: 08-SKILL-EXECUTING-PLANS
+description: Use quando tiver um plano de processamento para executar com checkpoints de revisão
+---
+
+> **Auto-Trigger:** Executar plano de processamento, implementar pipeline com checkpoints
+> **Keywords:** "executar", "plano", "execução", "pipeline", "checkpoint", "batch", "jarvis"
+> **Prioridade:** ALTA
+
+---
+
+# Executing Plans - Mega Brain
+
+## Overview
+
+Carrega plano, revisa criticamente, executa tarefas em batches, reporta para revisão entre batches.
+
+**Princípio central:** Execução em batch com checkpoints para revisão do usuário.
+
+**Anunciar no início:** "Estou usando a skill executing-plans para implementar este plano."
+
+## O Processo
+
+### Step 1: Carregar e Revisar Plano
+1. Ler arquivo do plano (geralmente em `knowledge/playbooks/drafts/`)
+2. Revisar criticamente - identificar questões ou preocupações
+3. Se houver preocupações: Levantar antes de começar
+4. Se ok: Criar TodoWrite e prosseguir
+
+### Step 2: Executar Batch
+**Default: Primeiras 3 tarefas**
+
+Para cada tarefa:
+1. Marcar como in_progress
+2. Seguir cada passo exatamente
+3. Executar verificações conforme especificado
+4. Marcar como completed
+
+### Step 3: Reportar
+Quando batch completo:
+```
+┌─ BATCH N COMPLETO ─────────────────────────────────────────────────────┐
+│                                                                         │
+│  ✅ TAREFAS CONCLUÍDAS:                                                │
+│  ├─ [Tarefa 1]: [resultado]                                            │
+│  ├─ [Tarefa 2]: [resultado]                                            │
+│  └─ [Tarefa 3]: [resultado]                                            │
+│                                                                         │
+│  📊 VERIFICAÇÕES:                                                       │
+│  ├─ [verificação 1]: ✅                                                 │
+│  └─ [verificação 2]: ✅                                                 │
+│                                                                         │
+│  Pronto para feedback.                                                 │
+│                                                                         │
+└─────────────────────────────────────────────────────────────────────────┘
+```
+
+### Step 4: Continuar
+Baseado no feedback:
+- Aplicar mudanças se necessário
+- Executar próximo batch
+- Repetir até completar
+
+### Step 5: Completar Processamento
+
+Após todas tarefas completas e verificadas:
+- Atualizar SESSION-STATE.md
+- Atualizar EVOLUTION-LOG.md se houve mudança estrutural
+- Seguir regras de fim de sessão do CLAUDE.md
+
+## Quando Parar e Pedir Ajuda
+
+**PARAR execução imediatamente quando:**
+- Encontrar blocker mid-batch (dependência faltando, verificação falha)
+- Plano tem gaps críticos que impedem começar
+- Não entender uma instrução
+- Verificação falha repetidamente
+
+**Pedir clarificação ao invés de adivinhar.**
+
+## Contexto Mega Brain
+
+### Tipos de Planos
+
+| Tipo de Plano | Exemplo |
+|---------------|---------|
+| Processamento INBOX | "Processar 5 arquivos novos via Jarvis" |
+| Criação de Agente | "Criar agente SALES-COORDINATOR" |
+| Reestruturação | "Migrar THEMES para SOURCES" |
+| Batch Council | "Deliberar 3 decisões estratégicas" |
+
+### Integrações com Pipeline Jarvis
+
+Ao executar planos de processamento:
+- Steps 1.1-2.1: Podem rodar em paralelo (usar dispatching-parallel-agents)
+- Steps 3.1-4.0: Consolidação (rodar sequencialmente)
+- Steps 8.7-8.10: Finalização e logs inteligentes
+
+### Checkpoints Obrigatórios
+
+| Após Step | Checkpoint |
+|-----------|------------|
+| 2.1 (Insights) | Revisar insights extraídos |
+| 4.0 (Dossiers) | Revisar dossiês gerados |
+| 8.8 (Briefing) | Apresentar briefing executivo |
+
+## Lembrar
+
+- Revisar plano criticamente primeiro
+- Seguir passos do plano exatamente
+- Não pular verificações
+- Entre batches: reportar e aguardar
+- Parar quando bloqueado, não adivinhar
+- Atualizar SESSION-STATE após completar

package/.claude/skills/executor/SKILL.md

@@ -0,0 +1,161 @@
+---
+name: executor
+version: 1.0.0
+description: Orquestrador de operacoes autonomas. Executa acoes no ClickUp, N8N e Google Drive baseado em decisoes dos agentes.
+triggers:
+  - executar
+  - criar task
+  - notificar
+  - agendar
+  - processar
+user_invocable: false
+auto_trigger: true
+---
+
+# SKILL: Executor - Operacoes Autonomas
+
+## Proposito
+
+Orquestrar e executar acoes autonomas baseadas em decisoes dos agentes TALENT, FINANCE e COUNCIL. Este skill e ativado AUTOMATICAMENTE quando outros agentes produzem outputs acionaveis.
+
+## Quando Ativar Automaticamente
+
+```yaml
+triggers:
+  - AGENT-TALENT emite HELL YES
+  - AGENT-FINANCE emite alerta
+  - COUNCIL emite decisao com confianca >= 70%
+  - Usuario solicita execucao explicita
+```
+
+## Contexto Obrigatorio
+
+```
+OBRIGATORIO:
+1. /[sua-empresa]/agents/AGENT-EXECUTOR.md (persona e capacidades)
+2. /[sua-empresa]/[SUA EMPRESA]-CONTEXT.md (contexto operacional)
+
+INTEGRACAO:
+- ClickUp MCP (criar/atualizar tasks)
+- N8N Webhooks (notificacoes, workflows)
+- Google Drive MCP (arquivos, planilhas)
+```
+
+## Classificacao de Risco
+
+Antes de executar, classificar:
+
+```
+LOW RISK (Executar automaticamente):
+- Criar task no ClickUp
+- Atualizar status
+- Enviar notificacao
+- Gerar relatorio
+
+MEDIUM RISK (Confirmar com usuario):
+- Criar campanha
+- Aprovar gasto operacional
+- Modificar processo
+
+HIGH RISK (Escalar para COUNCIL):
+- Contratacao/demissao
+- Investimento > R$ 100K
+- Mudanca estrategica
+```
+
+## Acoes Disponiveis
+
+### 1. Task Management (ClickUp)
+
+```bash
+# Criar task
+mcp__clickup__clickup_create_task(
+  list_id: "${CLICKUP_LIST_ID}",
+  name: "Nome da task",
+  description: "Descricao",
+  status: "backlog"
+)
+
+# Atualizar status
+mcp__clickup__clickup_update_task(
+  task_id: "id",
+  status: "em progresso"
+)
+```
+
+### 2. Notificacoes (N8N)
+
+```bash
+# Enviar para NotificationHub
+curl -X POST ${N8N_API_URL}/webhook/notification-hub \
+  -d '{
+    "event_type": "alert",
+    "source": "AGENT-FINANCE",
+    "data": {...}
+  }'
+```
+
+### 3. Google Drive
+
+```bash
+# Ler planilha
+mcp__gdrive__gsheets_read(spreadsheetId: "id")
+
+# Atualizar celula
+mcp__gdrive__gsheets_update_cell(fileId: "id", range: "A1", value: "valor")
+```
+
+## Fluxo de Execucao
+
+```
+1. RECEBER trigger de outro agente
+2. CLASSIFICAR nivel de risco
+3. SE LOW → EXECUTAR automaticamente
+   SE MEDIUM → CONFIRMAR com usuario
+   SE HIGH → ESCALAR para COUNCIL
+4. LOGAR acao em /logs/EXECUTOR/
+5. RETORNAR confirmacao
+```
+
+## Logging Obrigatorio
+
+Toda acao deve ser logada:
+
+```json
+{
+  "timestamp": "ISO8601",
+  "action": "nome_acao",
+  "trigger": "agente:evento",
+  "risk_level": "LOW|MEDIUM|HIGH",
+  "status": "SUCCESS|FAILED|PENDING"
+}
+```
+
+## Exemplo de Uso Automatico
+
+**AGENT-TALENT emite HELL YES para candidato:**
+
+```
+EXECUTOR detecta trigger: AGENT-TALENT:HELL_YES
+EXECUTOR classifica: LOW RISK (criar task)
+EXECUTOR executa:
+  → mcp__clickup__clickup_create_task(
+      list_id: "${CLICKUP_LIST_ID}",
+      name: "Onboarding: Maria Silva - SDR",
+      description: "Candidata aprovada via AGENT-TALENT\nScore: 8.5/10"
+    )
+EXECUTOR loga: /logs/EXECUTOR/2026-01-11.jsonl
+EXECUTOR notifica: Usuario informado via chat
+```
+
+## Principios Inviolaveis
+
+1. **Sempre logar** - Nenhuma acao sem registro
+2. **Classificar risco** - Nunca executar HIGH sem aprovacao
+3. **Transparencia** - Usuario sempre sabe o que foi feito
+4. **Rastreabilidade** - Toda acao tem origem identificada
+
+---
+
+**Ultima Atualizacao:** 2026-01-11
+**User Story:** US-026