mega-brain-ai 1.1.0

package/.claude/skills/02-SKILL-PYTHON-MEGABRAIN/SKILL.md

@@ -0,0 +1,323 @@
+# SKILL-PYTHON-MEGABRAIN
+## Padrões de Código Python do Mega Brain
+
+> **Auto-Trigger:** Criação/edição de arquivos .py no projeto
+> **Keywords:** "script", "python", "código", "função", "automação"
+> **Prioridade:** ALTA
+
+---
+
+## PROPÓSITO
+
+Garantir que todo código Python do Mega Brain siga padrões de:
+- Legibilidade e manutenibilidade
+- Documentação inline
+- Tratamento de erros
+- Integração com o ecossistema
+
+---
+
+## QUANDO USAR
+
+### ✅ USAR quando:
+- Criar novos scripts Python
+- Modificar scripts existentes
+- Criar funções de processamento
+- Desenvolver integrações
+
+### ❌ NÃO USAR quando:
+- Scripts one-off descartáveis
+- Notebooks exploratórios
+- Código de terceiros
+
+---
+
+## REGRAS OBRIGATÓRIAS
+
+### Estrutura de Script
+
+```python
+#!/usr/bin/env python3
+"""
+[NOME DO SCRIPT] - [Descrição em uma linha]
+============================================
+
+[Descrição mais detalhada do que o script faz]
+
+Uso:
+    python script.py [argumentos]
+
+Exemplos:
+    python script.py --input arquivo.txt
+    python script.py --process-all
+
+Dependências:
+    pip install [pacotes necessários]
+
+Variáveis de ambiente:
+    VAR_NAME - Descrição da variável
+"""
+
+import os
+import sys
+import json
+import argparse
+from pathlib import Path
+from typing import Dict, List, Optional
+from datetime import datetime
+
+# =============================================================================
+# CONFIGURAÇÃO
+# =============================================================================
+
+PROJECT_ROOT = Path(__file__).parent.parent
+CONFIG_PATH = PROJECT_ROOT / "system" / "config.json"
+
+# =============================================================================
+# FUNÇÕES AUXILIARES
+# =============================================================================
+
+def funcao_auxiliar():
+    """Descrição da função."""
+    pass
+
+# =============================================================================
+# FUNÇÕES PRINCIPAIS
+# =============================================================================
+
+def funcao_principal():
+    """Descrição da função principal."""
+    pass
+
+# =============================================================================
+# MAIN
+# =============================================================================
+
+def main():
+    """Entry point do script."""
+    parser = argparse.ArgumentParser(description="Descrição")
+    parser.add_argument("--flag", help="Descrição da flag")
+    args = parser.parse_args()
+    
+    # Lógica principal
+    pass
+
+if __name__ == "__main__":
+    main()
+```
+
+### Naming Conventions
+
+| Tipo | Convenção | Exemplo |
+|------|-----------|---------|
+| Arquivos | snake_case | `process_video.py` |
+| Funções | snake_case | `def extract_insights():` |
+| Classes | PascalCase | `class InsightExtractor:` |
+| Constantes | UPPER_SNAKE | `MAX_RETRIES = 3` |
+| Variáveis | snake_case | `chunk_count = 0` |
+
+### Docstrings Obrigatórias
+
+```python
+def process_content(
+    content: str,
+    source_id: str,
+    options: Optional[Dict] = None
+) -> Dict[str, Any]:
+    """
+    Processa conteúdo e extrai insights.
+    
+    Args:
+        content: Texto bruto para processar
+        source_id: ID da fonte (ex: "CG003")
+        options: Configurações opcionais
+            - max_chunks: Máximo de chunks (default: 100)
+            - min_confidence: Confiança mínima (default: 0.7)
+    
+    Returns:
+        Dict contendo:
+            - insights: Lista de insights extraídos
+            - metadata: Informações do processamento
+            - errors: Erros encontrados (se houver)
+    
+    Raises:
+        ValueError: Se content estiver vazio
+        ProcessingError: Se extração falhar
+    
+    Example:
+        >>> result = process_content("texto aqui", "CG003")
+        >>> print(result["insights"])
+    """
+    pass
+```
+
+### Type Hints Obrigatórios
+
+```python
+# ✅ Correto
+def get_insights(source_id: str, limit: int = 10) -> List[Dict[str, Any]]:
+    pass
+
+# ❌ Incorreto
+def get_insights(source_id, limit=10):
+    pass
+```
+
+### Tratamento de Erros
+
+```python
+# Padrão de try/except
+try:
+    result = process_file(path)
+except FileNotFoundError:
+    print(f"❌ Arquivo não encontrado: {path}")
+    return None
+except json.JSONDecodeError as e:
+    print(f"❌ JSON inválido: {e}")
+    return None
+except Exception as e:
+    print(f"❌ Erro inesperado: {e}")
+    raise
+
+# Logging de progresso
+print(f"📥 Processando: {filename}")
+print(f"   ├── Chunks: {chunk_count}")
+print(f"   ├── Insights: {insight_count}")
+print(f"   └── Status: ✅ Concluído")
+```
+
+### Emojis de Status Padronizados
+
+| Emoji | Significado | Uso |
+|-------|-------------|-----|
+| 📥 | Input/Início | Recebendo dados |
+| 🔄 | Processando | Em andamento |
+| ✅ | Sucesso | Concluído com sucesso |
+| ❌ | Erro | Falha |
+| ⚠️ | Aviso | Atenção necessária |
+| 📊 | Métricas | Estatísticas |
+| 💾 | Salvo | Arquivo gravado |
+| 🔍 | Busca | Pesquisando |
+
+### Paths do Projeto
+
+```python
+from pathlib import Path
+
+# Sempre usar Path, nunca strings concatenadas
+PROJECT_ROOT = Path(__file__).parent.parent
+
+# Paths padrão do Mega Brain
+PATHS = {
+    "inbox": PROJECT_ROOT / "inbox",
+    "processing": PROJECT_ROOT / "processing",
+    "knowledge": PROJECT_ROOT / "knowledge",
+    "playbooks": PROJECT_ROOT / "knowledge/playbooks",
+    "system": PROJECT_ROOT / "system",
+    "agents": PROJECT_ROOT / "agents",
+    "logs": PROJECT_ROOT / "logs",
+}
+```
+
+### JSON Handling
+
+```python
+def load_json(path: Path) -> Dict:
+    """Carrega JSON com tratamento de erro."""
+    if not path.exists():
+        return {}
+    
+    with open(path, "r", encoding="utf-8") as f:
+        return json.load(f)
+
+def save_json(data: Dict, path: Path, indent: int = 2) -> None:
+    """Salva JSON com formatação."""
+    path.parent.mkdir(parents=True, exist_ok=True)
+    
+    with open(path, "w", encoding="utf-8") as f:
+        json.dump(data, f, indent=indent, ensure_ascii=False)
+    
+    print(f"💾 Salvo: {path}")
+```
+
+### CLI com Argparse
+
+```python
+def main():
+    parser = argparse.ArgumentParser(
+        description="Descrição do script",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog="""
+Exemplos:
+    python script.py --process arquivo.txt
+    python script.py --all --verbose
+        """
+    )
+    
+    # Argumentos posicionais
+    parser.add_argument("input", nargs="?", help="Arquivo de entrada")
+    
+    # Flags
+    parser.add_argument("--all", "-a", action="store_true", help="Processar todos")
+    parser.add_argument("--verbose", "-v", action="store_true", help="Output detalhado")
+    parser.add_argument("--output", "-o", type=Path, help="Diretório de saída")
+    
+    args = parser.parse_args()
+```
+
+---
+
+## PADRÕES DE OUTPUT
+
+### Relatório de Processamento
+
+```python
+def print_report(stats: Dict) -> None:
+    """Imprime relatório padronizado."""
+    print("\n" + "="*60)
+    print("📊 RELATÓRIO DE PROCESSAMENTO")
+    print("="*60)
+    print(f"""
+┌─────────────────────────────────────────────────────────┐
+│  Arquivos processados: {stats['processed']:>5}                         │
+│  Insights extraídos:   {stats['insights']:>5}                         │
+│  Erros:                {stats['errors']:>5}                         │
+│  Tempo total:          {stats['time']:.2f}s                        │
+└─────────────────────────────────────────────────────────┘
+""")
+```
+
+---
+
+## ANTI-PATTERNS (NUNCA FAZER)
+
+1. ❌ Funções sem docstring
+2. ❌ Código sem type hints
+3. ❌ `except:` genérico sem especificar exceção
+4. ❌ Paths com strings concatenadas (`"dir/" + "file"`)
+5. ❌ Print sem contexto (`print(x)`)
+6. ❌ Variáveis de uma letra (exceto loops)
+7. ❌ Imports dentro de funções (exceto lazy loading)
+8. ❌ Hardcoded paths absolutos
+
+---
+
+## CHECKLIST PRÉ-ENTREGA
+
+- [ ] Docstring no topo do arquivo
+- [ ] Todas funções com docstring
+- [ ] Type hints em todas funções
+- [ ] Tratamento de erros apropriado
+- [ ] Paths usando pathlib.Path
+- [ ] Encoding UTF-8 em file operations
+- [ ] CLI com argparse se aplicável
+- [ ] Emojis de status consistentes
+
+---
+
+## META-INFORMAÇÃO
+
+- **Versão:** 1.0.0
+- **Domínio:** Código
+- **Prioridade:** ALTA
+- **Dependências:** Nenhuma

package/.claude/skills/03-SKILL-AGENT-CREATION/SKILL.md

@@ -0,0 +1,374 @@
+# SKILL-AGENT-CREATION
+## Padrões para Criação de Agentes no Mega Brain
+
+> **Auto-Trigger:** Criação de agentes, comando /create-agent
+> **Keywords:** "criar agente", "novo agente", "agent", "SOUL", "ROLE"
+> **Prioridade:** ALTA
+
+---
+
+## PROPÓSITO
+
+Garantir que todos os agentes do Mega Brain sigam:
+- Estrutura padronizada de arquivos
+- Separação clara DNA vs MEMORY
+- Integração com o sistema de conhecimento
+- Rastreabilidade de fontes
+
+---
+
+## QUANDO USAR
+
+### ✅ USAR quando:
+- Criar novo Agent of Person
+- Criar novo Agent of Position
+- Atualizar estrutura de agente existente
+- Expandir capacidades de agente
+
+### ❌ NÃO USAR quando:
+- Apenas consultando agente
+- Fazendo queries no RAG
+- Processando conteúdo (usar SKILL-PIPELINE)
+
+---
+
+## TIPOS DE AGENTES
+
+### 1. Agents of Person (Digital Twins)
+```
+/agents/persons/
+├── DNA-[PESSOA].md        # Essência imutável
+└── AGENT-PERSON-[PESSOA].md  # Comportamento ativo
+```
+
+### 2. Agents of Position (Cargos)
+```
+/agents/[CATEGORIA]/
+├── ROLE-[CARGO].md        # Definição do papel
+├── MEMORY-[CARGO].md      # Experiências acumuladas
+└── PLAYBOOK-[CARGO].md    # Guia operacional
+```
+
+### 3. Council (Meta-Avaliadores)
+```
+/agents/council/
+├── METHODOLOGICAL-CRITIC.md
+├── DEVILS-ADVOCATE.md
+└── SYNTHESIZER.md
+```
+
+---
+
+## ESTRUTURA: AGENT OF PERSON
+
+### DNA-[PESSOA].md
+```markdown
+# DNA: [NOME COMPLETO]
+
+> **Tipo:** Agent of Person
+> **Versão:** X.X.X
+> **Fontes:** [IDs]
+> **Última atualização:** [Data]
+
+---
+
+## IDENTIDADE
+
+**Nome:** [Nome completo]
+**Empresa:** [Empresa principal]
+**Especialidade:** [Área de expertise]
+**Background:** [Contexto relevante]
+
+---
+
+## FILOSOFIA CORE
+
+### Crenças Fundamentais
+1. [Crença 1 - com citação fonte]
+2. [Crença 2 - com citação fonte]
+
+### Valores Inegociáveis
+- [Valor 1]
+- [Valor 2]
+
+---
+
+## MODELOS MENTAIS
+
+### [Nome do Modelo 1]
+**Conceito:** [Explicação]
+**Aplicação:** [Como usa]
+**Fonte:** [ID]
+
+### [Nome do Modelo 2]
+...
+
+---
+
+## HEURÍSTICAS
+
+| Situação | Resposta Padrão | Fonte |
+|----------|-----------------|-------|
+| [Contexto] | [Ação típica] | [ID] |
+
+---
+
+## FRAMEWORKS PROPRIETÁRIOS
+
+### [Nome do Framework]
+**Estrutura:**
+1. [Passo 1]
+2. [Passo 2]
+
+**Quando usar:** [Contexto]
+**Fonte:** [ID]
+
+---
+
+## PADRÕES DE LINGUAGEM
+
+### Frases Características
+- "[Frase típica 1]"
+- "[Frase típica 2]"
+
+### Gírias/Expressões
+- [Expressão 1] - [Significado]
+- [Expressão 2] - [Significado]
+
+### Tom de Voz
+[Descrição do tom: direto, provocador, analítico, etc.]
+
+---
+
+## ANTI-PATTERNS (O que esta pessoa NÃO faria)
+
+1. ❌ [Comportamento incompatível]
+2. ❌ [Comportamento incompatível]
+
+---
+
+## FONTES PROCESSADAS
+
+| ID | Tipo | Título | Data |
+|----|------|--------|------|
+| [ID] | [Video/PDF/etc] | [Título] | [Data] |
+```
+
+### AGENT-PERSON-[PESSOA].md
+```markdown
+# AGENT: [NOME]
+
+> **Tipo:** Agent of Person
+> **DNA:** DNA-[PESSOA].md
+> **Status:** Ativo
+> **Threshold de ativação:** [Quando invocar]
+
+---
+
+## COMO INVOCAR
+
+### Triggers Automáticos
+- Menção do nome: "[Nome]"
+- Keywords: [lista de palavras]
+- Temas: [lista de temas]
+
+### Invocação Explícita
+```
+"Como [Nome] responderia a isso?"
+"Consulte [Nome] sobre [tema]"
+/consult [nome] "[pergunta]"
+```
+
+---
+
+## COMPORTAMENTO
+
+### Ao Responder
+1. Falar em PRIMEIRA PESSOA
+2. Usar linguagem característica
+3. Citar frameworks quando aplicável
+4. Referenciar experiências das fontes
+
+### Formato de Resposta
+```
+[Opinião direta em 1-2 frases]
+
+[Explicação com framework/modelo]
+
+[Citação ou referência a fonte]
+
+"[Frase característica]"
+```
+
+---
+
+## INTEGRAÇÃO COM SISTEMA
+
+### Consulta ao DNA
+Antes de responder, consultar:
+- DNA-[PESSOA].md para filosofia
+- Fontes no RAG para evidências
+
+### Citação Obrigatória
+Toda afirmação factual DEVE incluir:
+- ID da fonte
+- Contexto de onde veio
+
+---
+
+## LIMITAÇÕES
+
+### Este agente NÃO pode:
+- Inventar informações não presentes nas fontes
+- Contradizer o DNA estabelecido
+- Responder sobre temas sem fontes processadas
+
+### Quando não souber:
+"Não tenho informação processada sobre isso.
+Minhas fontes cobrem: [lista de temas]"
+```
+
+---
+
+## ESTRUTURA: AGENT OF POSITION
+
+### ROLE-[CARGO].md
+```markdown
+# ROLE: [CARGO]
+
+> **Categoria:** [C-LEVEL/SALES/OPERATIONS]
+> **Versão:** X.X.X
+
+---
+
+## DEFINIÇÃO
+
+**Título:** [Nome completo do cargo]
+**Reporta a:** [Superior]
+**Gerencia:** [Subordinados]
+
+---
+
+## RESPONSABILIDADES
+
+### Primárias
+1. [Responsabilidade core]
+2. [Responsabilidade core]
+
+### Secundárias
+- [Responsabilidade adicional]
+
+---
+
+## MÉTRICAS
+
+| KPI | Target | Frequência |
+|-----|--------|------------|
+| [Métrica] | [Valor] | [Diário/Semanal] |
+
+---
+
+## DECISÕES QUE TOMA
+
+### Autonomamente
+- [Tipo de decisão]
+
+### Com Aprovação
+- [Tipo de decisão] → [Quem aprova]
+
+---
+
+## INTERAÇÕES
+
+### Colabora com
+| Cargo | Tipo de Interação |
+|-------|-------------------|
+| [Cargo] | [Natureza] |
+
+### Conflitos Naturais
+- [Cargo X] - [Motivo do conflito natural]
+```
+
+### MEMORY-[CARGO].md
+```markdown
+# MEMORY: [CARGO]
+
+> **Última atualização:** [Data]
+> **Entradas:** [N]
+
+---
+
+## DECISÕES REGISTRADAS
+
+### [Data] - [Título da Decisão]
+**Contexto:** [Situação]
+**Decisão:** [O que foi decidido]
+**Resultado:** [Outcome]
+**Aprendizado:** [Lição]
+**Fonte:** [Se veio de material processado]
+
+---
+
+## PADRÕES IDENTIFICADOS
+
+### [Padrão 1]
+**Frequência:** [Quantas vezes apareceu]
+**Contexto comum:** [Quando acontece]
+**Resposta típica:** [Como lidar]
+
+---
+
+## ERROS A EVITAR
+
+| Erro | Por que evitar | Fonte |
+|------|----------------|-------|
+| [Erro] | [Consequência] | [ID] |
+```
+
+---
+
+## CHECKLIST PRÉ-CRIAÇÃO
+
+### Para Agent of Person
+- [ ] Mínimo 2 fontes processadas da pessoa
+- [ ] DNA extraído com citações
+- [ ] Padrões de linguagem identificados
+- [ ] Frameworks mapeados
+- [ ] Verificado no glossário (não duplicar)
+
+### Para Agent of Position
+- [ ] Função definida no glossário
+- [ ] ROLE documentado
+- [ ] MEMORY inicializado
+- [ ] Conflitos naturais identificados
+- [ ] Métricas definidas
+
+---
+
+## ANTI-PATTERNS (NUNCA FAZER)
+
+1. ❌ Criar agente sem fontes suficientes
+2. ❌ Duplicar função existente com outro nome
+3. ❌ Misturar DNA (imutável) com MEMORY (mutável)
+4. ❌ Agente sem triggers definidos
+5. ❌ Responder como agente sem consultar DNA
+6. ❌ Inventar informações não presentes nas fontes
+
+---
+
+## REGISTRO
+
+Ao criar agente, atualizar:
+- [ ] `/system/ROLE-TRACKING.md`
+- [ ] `/agents/AGENT-REGISTRY.md`
+- [ ] `README.md` se for agente novo
+- [ ] `SESSION-STATE.md`
+
+---
+
+## META-INFORMAÇÃO
+
+- **Versão:** 1.0.0
+- **Domínio:** Agentes
+- **Prioridade:** ALTA
+- **Dependências:** SKILL-DOCS-MEGABRAIN