mega-brain-ai 1.3.0

package/.claude/skills/pr-review-toolkit/SKILL.md

@@ -0,0 +1,178 @@
+# PR Review Toolkit Skill
+
+> **Auto-Trigger:** Quando usuário pedir análise de PR, revisão de pull request, análise de comentários, hunting de falhas
+> **Keywords:** "PR", "pull request", "revisar PR", "análise de PR", "PR review", "comment analyzer", "silent failure"
+> **Prioridade:** ALTA
+> **Namespace:** [OFFICIAL]
+> **Tools:** Read, Glob, Grep, Bash, Task
+
+## Quando NÃO Ativar
+
+- Code review geral sem contexto de PR
+- Criação de PRs (usar git workflow)
+- Perguntas sobre PRs sem análise
+- Quando usuário explicitamente pedir skill diferente
+
+---
+
+## Core Purpose
+
+Bundle of 6 specialized agents for comprehensive PR analysis. Provides deep inspection
+of comments, tests, silent failures, type design, code quality, and simplification opportunities.
+
+---
+
+## The 6 Specialized Agents
+
+### 1. Comment Analyzer
+
+**Focus:** PR comment triage
+
+- Categorizes comments by severity
+- Identifies blocking vs non-blocking
+- Summarizes discussion threads
+- Highlights unresolved items
+- Tracks comment resolution status
+
+### 2. PR Test Analyzer
+
+**Focus:** Test coverage validation
+
+- Identifies untested code paths
+- Suggests missing test cases
+- Validates test quality
+- Checks edge case coverage
+- Reviews test naming/structure
+
+### 3. Silent Failure Hunter
+
+**Focus:** Hidden bug detection
+
+- Finds swallowed exceptions
+- Identifies missing error handling
+- Detects async/await issues
+- Spots race conditions
+- Finds resource leaks
+
+### 4. Type Design Analyzer
+
+**Focus:** Type system quality
+
+- Reviews type definitions
+- Identifies type safety issues
+- Suggests better type patterns
+- Checks generic usage
+- Validates interface design
+
+### 5. Code Reviewer
+
+**Focus:** General code quality
+
+- Style consistency
+- Best practices adherence
+- Pattern compliance
+- Documentation quality
+- Naming conventions
+
+### 6. Code Simplifier
+
+**Focus:** Complexity reduction
+
+- Identifies over-engineering
+- Suggests simplifications
+- Removes dead code
+- Consolidates duplicates
+- Improves readability
+
+---
+
+## Agent Activation
+
+Each agent can be invoked individually or as a full suite:
+
+| Command | Agents Activated |
+|---------|------------------|
+| `/pr-review:full` | All 6 agents |
+| `/pr-review:comments` | Comment Analyzer |
+| `/pr-review:tests` | PR Test Analyzer |
+| `/pr-review:failures` | Silent Failure Hunter |
+| `/pr-review:types` | Type Design Analyzer |
+| `/pr-review:quality` | Code Reviewer |
+| `/pr-review:simplify` | Code Simplifier |
+
+---
+
+## Output Format
+
+```
+╔══════════════════════════════════════════════════════════════════════════════╗
+║                         PR REVIEW TOOLKIT REPORT                             ║
+╠══════════════════════════════════════════════════════════════════════════════╣
+║  PR: #[number] - [title]                                                     ║
+║  Agents Run: [list]                                                          ║
+║  Files Analyzed: [N]                                                         ║
+╚══════════════════════════════════════════════════════════════════════════════╝
+
+┌─ COMMENT ANALYZER ──────────────────────────────────────────────────────────┐
+│  Blocking: [N]  |  Suggestions: [N]  |  Resolved: [N]                       │
+│                                                                             │
+│  BLOCKING ITEMS:                                                            │
+│  - [item description] @ file:line                                           │
+└─────────────────────────────────────────────────────────────────────────────┘
+
+┌─ SILENT FAILURE HUNTER ─────────────────────────────────────────────────────┐
+│  Potential Issues Found: [N]                                                │
+│                                                                             │
+│  ⚠️  [issue description]                                                    │
+│      Location: file:line                                                    │
+│      Risk: [HIGH | MEDIUM | LOW]                                            │
+└─────────────────────────────────────────────────────────────────────────────┘
+
+┌─ TEST ANALYZER ─────────────────────────────────────────────────────────────┐
+│  Coverage Delta: [+/-X%]                                                    │
+│  Missing Tests: [N]                                                         │
+│                                                                             │
+│  SUGGESTED TESTS:                                                           │
+│  - [test case description]                                                  │
+└─────────────────────────────────────────────────────────────────────────────┘
+
+┌─ TYPE DESIGN ANALYZER ──────────────────────────────────────────────────────┐
+│  Type Issues: [N]                                                           │
+│                                                                             │
+│  RECOMMENDATIONS:                                                           │
+│  - [recommendation]                                                         │
+└─────────────────────────────────────────────────────────────────────────────┘
+
+┌─ CODE SIMPLIFIER ───────────────────────────────────────────────────────────┐
+│  Simplification Opportunities: [N]                                          │
+│                                                                             │
+│  SUGGESTIONS:                                                               │
+│  - [simplification suggestion]                                              │
+└─────────────────────────────────────────────────────────────────────────────┘
+
+┌─ SUMMARY ───────────────────────────────────────────────────────────────────┐
+│  ✅ Ready to merge: [YES | NO | NEEDS WORK]                                 │
+│  📋 Action items: [N]                                                       │
+│  ⏱️  Estimated fix time: [estimate]                                         │
+└─────────────────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## Example Prompts This Skill Handles
+
+- "Analise o PR #123 completamente"
+- "Review the pull request for silent failures"
+- "Verifique os comentários não resolvidos no PR"
+- "Hunt for async issues in this PR"
+- "Simplifique o código deste pull request"
+- "Check test coverage for PR changes"
+
+---
+
+## Integration Notes
+
+This skill is part of the **Claude Code Official Skills** collection.
+Namespace: `[OFFICIAL]` - Distinguishes from Mega Brain custom skills.
+
+For custom Mega Brain skills, see: `/.claude/skills/`

package/.claude/skills/process-company-inbox/SKILL.md

@@ -0,0 +1,183 @@
+---
+name: process-[sua-empresa]-inbox
+description: "Processa arquivos no INBOX [SUA EMPRESA], classifica, extrai insights, e move para pasta destino. Use quando: novos arquivos em inbox, processar conteúdo [SUA EMPRESA], atualizar contexto da empresa."
+---
+
+# Process [SUA EMPRESA] Inbox
+
+Pipeline de processamento de conteúdo interno da [SUA EMPRESA].
+
+---
+
+## Quando Usar
+
+- Novos arquivos adicionados em `/[sua-empresa]/inbox/`
+- Atualização de contexto da empresa necessária
+- Processamento de calls, planilhas, documentos internos
+
+---
+
+## O Que Faz
+
+1. **Escaneia** `/[sua-empresa]/inbox/` por arquivos não processados
+2. **Classifica** cada arquivo por tipo e categoria
+3. **Extrai** CHUNKS e INSIGHTS relevantes
+4. **Move** para pasta destino apropriada
+5. **Indexa** em `_INDEX.md` e `[SUA EMPRESA]-STATE.json`
+
+---
+
+## Fluxo de Processamento
+
+```
+┌────────────────────────────────────────────────────────────────────────────┐
+│  PASSO 1: SCAN                                                              │
+├────────────────────────────────────────────────────────────────────────────┤
+│  1. Listar arquivos em /[sua-empresa]/inbox/                                │
+│  2. Ignorar README.md                                                       │
+│  3. Para cada arquivo:                                                      │
+│     - Detectar extensão                                                     │
+│     - Ler conteúdo                                                          │
+│     - Classificar tipo                                                      │
+└────────────────────────────────────────────────────────────────────────────┘
+                                    │
+                                    ▼
+┌────────────────────────────────────────────────────────────────────────────┐
+│  PASSO 2: CLASSIFICAÇÃO                                                     │
+├────────────────────────────────────────────────────────────────────────────┤
+│  Detectar tipo baseado em:                                                  │
+│  - Nome do arquivo (call-, planilha-, contrato-)                           │
+│  - Extensão (.txt, .csv, .pdf, .md)                                        │
+│  - Conteúdo (keywords: "transcrição", "reunião", "KPI", etc.)              │
+│                                                                             │
+│  TIPOS:                                                                     │
+│  - CALL_MENTOR: Calls com mentores externos                                │
+│  - CALL_TEAM: Reuniões internas                                            │
+│  - CALL_CLIENT: Calls com clientes                                         │
+│  - FINANCE: Planilhas financeiras                                          │
+│  - CONTRACT: Contratos                                                      │
+│  - TEAM: Documentos de time                                                │
+│  - STRATEGY: Documentos estratégicos                                       │
+│  - PRODUCT: Documentação de produto                                        │
+│  - MARKETING: Material de marketing                                         │
+└────────────────────────────────────────────────────────────────────────────┘
+                                    │
+                                    ▼
+┌────────────────────────────────────────────────────────────────────────────┐
+│  PASSO 3: EXTRAÇÃO (por tipo)                                               │
+├────────────────────────────────────────────────────────────────────────────┤
+│                                                                             │
+│  CALL_MENTOR:                                                               │
+│  - Extrair DNA 5 camadas ([FILOSOFIA], [MODELO-MENTAL], [HEURISTICA],      │
+│    [FRAMEWORK], [METODOLOGIA])                                              │
+│  - Gerar INSIGHTS-[NOME-MENTOR].md em /07-STRATEGY/                        │
+│  - Criar CHUNKS indexados                                                   │
+│                                                                             │
+│  CALL_TEAM:                                                                 │
+│  - Extrair DECISÕES tomadas                                                │
+│  - Extrair ACTION ITEMS com responsáveis                                   │
+│  - Gerar resumo executivo                                                  │
+│                                                                             │
+│  FINANCE:                                                                   │
+│  - Extrair métricas-chave (MRR, CAC, LTV, etc.)                           │
+│  - Atualizar DAILY-SNAPSHOT.yaml                                           │
+│  - Detectar thresholds críticos                                            │
+│                                                                             │
+│  STRATEGY:                                                                  │
+│  - Indexar decisões                                                         │
+│  - Vincular com contexto existente                                         │
+│                                                                             │
+└────────────────────────────────────────────────────────────────────────────┘
+                                    │
+                                    ▼
+┌────────────────────────────────────────────────────────────────────────────┐
+│  PASSO 4: MOVIMENTAÇÃO                                                      │
+├────────────────────────────────────────────────────────────────────────────┤
+│                                                                             │
+│  DESTINOS:                                                                  │
+│  - CALL_MENTOR → /[sua-empresa]/calls/MENTORS/                             │
+│  - CALL_TEAM → /[sua-empresa]/calls/TEAM/                                  │
+│  - CALL_CLIENT → /[sua-empresa]/calls/CLIENTS/                             │
+│  - FINANCE → /[sua-empresa]/02-FINANCE/                                       │
+│  - CONTRACT → /[sua-empresa]/03-CONTRACTS/                                    │
+│  - TEAM → /[sua-empresa]/team/                                             │
+│  - MARKETING → /[sua-empresa]/05-MARKETING/                                   │
+│  - PRODUCT → /[sua-empresa]/06-PRODUCTS/                                      │
+│  - STRATEGY → /[sua-empresa]/07-STRATEGY/                                     │
+│                                                                             │
+│  AÇÕES:                                                                     │
+│  - Renomear com prefixo [[SUA EMPRESA]]                                           │
+│  - Mover para pasta destino                                                 │
+│  - Criar backup em inbox/PROCESSED/ se necessário                       │
+│                                                                             │
+└────────────────────────────────────────────────────────────────────────────┘
+                                    │
+                                    ▼
+┌────────────────────────────────────────────────────────────────────────────┐
+│  PASSO 5: INDEXAÇÃO                                                         │
+├────────────────────────────────────────────────────────────────────────────┤
+│                                                                             │
+│  1. Atualizar /[sua-empresa]/_INDEX.md:                                        │
+│     - Adicionar entrada com link                                            │
+│     - Atualizar contadores                                                  │
+│     - Registrar data de processamento                                       │
+│                                                                             │
+│  2. Atualizar /[sua-empresa]/[SUA EMPRESA]-STATE.json:                               │
+│     - Incrementar contadores por categoria                                  │
+│     - Atualizar last_processed_at                                          │
+│     - Registrar arquivo processado                                          │
+│                                                                             │
+│  3. Gerar LOG em /logs/[SUA EMPRESA]-PIPELINE/:                               │
+│     - PROCESS-YYYY-MM-DD-HHmm.md                                           │
+│     - Detalhes de cada arquivo processado                                   │
+│                                                                             │
+└────────────────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## Output
+
+Após processamento, entregar relatório:
+
+```
+╔══════════════════════════════════════════════════════════════════════════════╗
+║                    [SUA EMPRESA] INBOX PROCESSING - COMPLETE                        ║
+╠══════════════════════════════════════════════════════════════════════════════╣
+║  Data: YYYY-MM-DD HH:MM                                                      ║
+║  Arquivos processados: N                                                     ║
+╚══════════════════════════════════════════════════════════════════════════════╝
+
+┌─────────────────────────────────────────────────────────────────────────────┐
+│  ARQUIVOS PROCESSADOS                                                       │
+├────────────────────────────────────┬────────────┬───────────────────────────┤
+│  ARQUIVO                           │ TIPO       │ DESTINO                   │
+├────────────────────────────────────┼────────────┼───────────────────────────┤
+│  [arquivo1.txt]                    │ CALL_MENTOR│ /calls/MENTORS/        │
+│  [arquivo2.csv]                    │ FINANCE    │ /02-FINANCE/              │
+└────────────────────────────────────┴────────────┴───────────────────────────┘
+
+┌─────────────────────────────────────────────────────────────────────────────┐
+│  INSIGHTS EXTRAÍDOS                                                         │
+├─────────────────────────────────────────────────────────────────────────────┤
+│  [Lista de insights principais]                                             │
+└─────────────────────────────────────────────────────────────────────────────┘
+
+✅ _INDEX.md atualizado
+✅ [SUA EMPRESA]-STATE.json atualizado
+✅ Log salvo em /logs/[SUA EMPRESA]-PIPELINE/
+```
+
+---
+
+## Regras
+
+- **NUNCA** deletar arquivos originais sem backup
+- **SEMPRE** atualizar _INDEX.md após processamento
+- **SEMPRE** gerar log de processamento
+- **SEMPRE** aplicar marcação [[SUA EMPRESA]] nos arquivos movidos
+
+---
+
+**Versão:** 1.0.0
+**Última atualização:** 2026-01-11

package/.claude/skills/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