mega-brain-ai 1.3.0

package/.claude/skills/DETECTION-PROTOCOL.md

@@ -0,0 +1,217 @@
+# 🔍 PROTOCOLO DE DETECÇÃO DE SKILLS
+
+> Este arquivo define as regras internas para o sistema de auto-detecção.
+> **Versão:** 1.0.0
+> **Tipo:** Protocolo interno
+
+---
+
+## CHECKLIST DE OBSERVAÇÃO
+
+Durante cada tarefa, verificar mentalmente:
+
+### Padrões de Estrutura
+- [ ] Estou usando um formato específico?
+- [ ] Este formato foi usado antes?
+- [ ] O formato tem regras implícitas?
+
+### Padrões de Processo
+- [ ] Estou seguindo passos específicos?
+- [ ] Estes passos se repetem em outras tarefas?
+- [ ] Os passos poderiam ser documentados?
+
+### Padrões de Decisão
+- [ ] Tomei decisões de formatação?
+- [ ] Estas decisões são consistentes?
+- [ ] Outro agente tomaria as mesmas decisões?
+
+### Padrões de Output
+- [ ] O output segue estrutura específica?
+- [ ] A estrutura é replicável?
+- [ ] Há elementos obrigatórios implícitos?
+
+---
+
+## THRESHOLD DE SUGESTÃO
+
+| Evidência | Pontos | Descrição |
+|-----------|--------|-----------|
+| Estrutura repetida | +2 | Mesma estrutura usada 2+ vezes |
+| Regras implícitas | +2 | Regras aplicadas sem documentação |
+| Formato específico | +1 | Formato não-padrão consistente |
+| Processo multi-step | +1 | Sequência de passos definida |
+| Domínio sem skill | +1 | Área não coberta por skill existente |
+
+### Ações por Pontuação
+
+| Pontuação | Ação |
+|-----------|------|
+| **Total ≥ 3** | **SUGERIR** skill ao usuário |
+| **Total ≥ 5** | **SUGERIR COM PRIORIDADE ALTA** |
+| **Total < 3** | Apenas observar, não sugerir |
+
+---
+
+## ANTI-PATTERNS DE DETECÇÃO
+
+Evitar falsos positivos:
+
+| Situação | Por que NÃO sugerir |
+|----------|---------------------|
+| Código boilerplate genérico | Já coberto por skill de linguagem |
+| Formatação markdown básica | Já coberto por skill de docs |
+| Estrutura JSON padrão | Muito genérico |
+| Resposta conversacional | Não é padronizável |
+| Tarefa one-off única | Não há repetição |
+| Padrão já documentado | Skill ou protocolo existe |
+
+---
+
+## EXEMPLOS DE DETECÇÃO CORRETA
+
+### Exemplo 1: Relatório de Métricas
+```
+Tarefa: "Formata relatório de métricas de vendas"
+
+Observado:
+- Estrutura: Header → Métricas → Análise → Ações
+- Formato: Tabela de KPIs, bullets de insights
+- Repetição: 2ª vez fazendo similar
+
+Pontuação:
+- Estrutura repetida: +2
+- Formato específico: +1
+- Processo multi-step: +1
+- Domínio sem skill: +1
+
+TOTAL: 5 → SUGERIR PRIORIDADE ALTA
+
+Sugestão: skill-relatorio-metricas
+```
+
+### Exemplo 2: Script de Automação
+```
+Tarefa: "Cria script para processar CSVs"
+
+Observado:
+- Estrutura: Imports → Config → Funcs → Main
+- Já existe: skill-python-megabrain
+
+Pontuação:
+- Estrutura coberta por skill: 0
+- Formato coberto: 0
+
+TOTAL: 0 → NÃO SUGERIR (coberto)
+```
+
+### Exemplo 3: Documentação de API
+```
+Tarefa: "Documenta endpoints da API"
+
+Observado:
+- Formato: Endpoint → Método → Params → Response → Errors
+- Primeira vez fazendo
+- Domínio específico (APIs)
+
+Pontuação:
+- Formato específico: +1
+- Processo multi-step: +1
+- Domínio sem skill: +1
+
+TOTAL: 3 → SUGERIR (threshold mínimo)
+
+Sugestão: skill-api-docs
+```
+
+---
+
+## FLUXO COMPLETO DE DETECÇÃO
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│  DURANTE A EXECUÇÃO                                             │
+│                                                                 │
+│  1. Observar padrões (checklist mental)                         │
+│  2. Calcular pontuação de evidência                             │
+│  3. Verificar anti-patterns                                     │
+│  4. Verificar se skill similar existe                           │
+│                                                                 │
+├─────────────────────────────────────────────────────────────────┤
+│  APÓS ENTREGAR TAREFA (se pontuação ≥ 3)                        │
+│                                                                 │
+│  1. Formatar sugestão visual                                    │
+│  2. Mostrar ao usuário                                          │
+│  3. Registrar em SKILL-SUGGESTIONS.md                           │
+│  4. Aguardar decisão                                            │
+│                                                                 │
+├─────────────────────────────────────────────────────────────────┤
+│  SE USUÁRIO APROVAR                                             │
+│                                                                 │
+│  1. Ler 00-SKILL-CREATOR/SKILL.md                               │
+│  2. Usar padrões detectados como base                           │
+│  3. Criar nova skill na pasta /.claude/skills/                  │
+│  4. Atualizar SKILL-SUGGESTIONS.md (status: 🟢 Criada)          │
+│  5. Confirmar ao usuário                                        │
+│                                                                 │
+├─────────────────────────────────────────────────────────────────┤
+│  SE USUÁRIO REJEITAR                                            │
+│                                                                 │
+│  1. Atualizar SKILL-SUGGESTIONS.md (status: 🔴 Rejeitada)       │
+│  2. Continuar normalmente                                       │
+│  3. Não sugerir similar por 5 interações                        │
+│                                                                 │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## CONTEXTOS ESPECIAIS
+
+### Urgência Detectada
+
+Se input contiver: "rápido", "urgente", "agora", "preciso já"
+→ **NÃO SUGERIR** (prioridade do usuário)
+
+### Conversa Curta
+
+Se menos de 3 interações na sessão
+→ **NÃO SUGERIR** (contexto insuficiente)
+
+### Sugestão Recente Rejeitada
+
+Se usuário rejeitou sugestão similar nas últimas 5 interações
+→ **NÃO SUGERIR** (respeitar decisão)
+
+---
+
+## INTEGRAÇÃO COM SKILL-CREATOR
+
+Ao criar skill aprovada:
+
+1. **Ler template** de `00-SKILL-CREATOR/SKILL.md`
+2. **Usar nome sugerido** da detecção
+3. **Preencher keywords** identificadas
+4. **Definir prioridade** baseada em frequência
+5. **Documentar regras** dos padrões observados
+
+### Estrutura da Nova Skill
+
+```
+/.claude/skills/[nome-skill]/
+└── SKILL.md
+    ├── Header padrão (nome, trigger, keywords, prioridade)
+    ├── Propósito
+    ├── Quando usar
+    ├── Regras (baseadas nos padrões detectados)
+    ├── Anti-patterns
+    └── Checklist
+```
+
+---
+
+## META-INFORMAÇÃO
+
+- **Versão:** 1.0.0
+- **Criado:** Janeiro 2025
+- **Tipo:** Protocolo interno
+- **Atualização:** Manual quando necessário

package/.claude/skills/README.md

@@ -0,0 +1,240 @@
+# 🎯 SKILLS MEGA BRAIN
+## Sistema de Skills Auto-Invocáveis
+
+> **Versão:** 1.0.0
+> **Skills Ativas:** 6
+> **Modo:** Auto-Invocação por Contexto
+
+---
+
+## O QUE SÃO SKILLS?
+
+Skills são **instruções padronizadas** que o sistema invoca automaticamente baseado em:
+- **Extensão de arquivo** (.md, .py, .json)
+- **Comandos** (/process, /create-agent)
+- **Keywords** detectadas na conversa
+- **Contexto** da operação
+
+### Benefícios
+✅ Consistência em todos os outputs
+✅ Padrões aplicados automaticamente
+✅ Sem necessidade de comandos manuais
+✅ Conhecimento institucional preservado
+
+---
+
+## COMO FUNCIONA
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│                    SISTEMA DE SKILLS                             │
+├─────────────────────────────────────────────────────────────────┤
+│                                                                  │
+│   USUÁRIO                                                        │
+│      │                                                           │
+│      ▼                                                           │
+│   ┌─────────────────┐                                           │
+│   │  INPUT/COMANDO  │                                           │
+│   └────────┬────────┘                                           │
+│            │                                                     │
+│            ▼                                                     │
+│   ┌─────────────────┐                                           │
+│   │    DETECTOR     │ ◄── Analisa: extensão, keywords, contexto │
+│   └────────┬────────┘                                           │
+│            │                                                     │
+│            ▼                                                     │
+│   ┌─────────────────┐                                           │
+│   │ SKILL-REGISTRY  │ ◄── Mapeia para skill(s) apropriada(s)   │
+│   └────────┬────────┘                                           │
+│            │                                                     │
+│            ▼                                                     │
+│   ┌─────────────────┐                                           │
+│   │  SKILL(S).md    │ ◄── Carrega regras e padrões             │
+│   └────────┬────────┘                                           │
+│            │                                                     │
+│            ▼                                                     │
+│   ┌─────────────────┐                                           │
+│   │    EXECUÇÃO     │ ◄── Aplica padrões automaticamente        │
+│   └────────┬────────┘                                           │
+│            │                                                     │
+│            ▼                                                     │
+│   ┌─────────────────┐                                           │
+│   │     OUTPUT      │ ◄── Resultado padronizado                 │
+│   └─────────────────┘                                           │
+│                                                                  │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## SKILLS DISPONÍVEIS
+
+| # | Skill | Quando é Invocada |
+|---|-------|-------------------|
+| 00 | **SKILL-CREATOR** | Ao criar novas skills |
+| 01 | **SKILL-DOCS-MEGABRAIN** | Ao criar/editar arquivos .md |
+| 02 | **SKILL-PYTHON-MEGABRAIN** | Ao criar/editar arquivos .py |
+| 03 | **SKILL-AGENT-CREATION** | Ao criar agentes |
+| 04 | **SKILL-KNOWLEDGE-EXTRACTION** | Ao extrair insights |
+| 05 | **SKILL-PIPELINE-JARVIS** | Ao processar material novo |
+
+---
+
+## TRIGGERS AUTOMÁTICOS
+
+### Por Extensão
+```
+.md  → SKILL-DOCS-MEGABRAIN
+.py  → SKILL-PYTHON-MEGABRAIN
+```
+
+### Por Comando
+```
+/process      → SKILL-PIPELINE-JARVIS
+/create-agent → SKILL-AGENT-CREATION
+/scan-inbox   → SKILL-PIPELINE-JARVIS
+```
+
+### Por Keywords
+```
+"criar playbook"  → SKILL-DOCS-MEGABRAIN
+"script python"   → SKILL-PYTHON-MEGABRAIN
+"novo agente"     → SKILL-AGENT-CREATION
+"extrair insight" → SKILL-KNOWLEDGE-EXTRACTION
+"processar video" → SKILL-PIPELINE-JARVIS
+```
+
+---
+
+## ESTRUTURA DE PASTAS
+
+```
+/SKILLS/
+├── README.md                          # Este arquivo
+├── SKILL-REGISTRY.md                  # Índice de todas as skills
+│
+├── 00-SKILL-CREATOR/
+│   └── SKILL.md                       # Meta-skill para criar skills
+│
+├── 01-SKILL-DOCS-MEGABRAIN/
+│   └── SKILL.md                       # Padrões de documentação
+│
+├── 02-SKILL-PYTHON-MEGABRAIN/
+│   └── SKILL.md                       # Padrões de código Python
+│
+├── 03-SKILL-AGENT-CREATION/
+│   └── SKILL.md                       # Criação de agentes
+│
+├── 04-SKILL-KNOWLEDGE-EXTRACTION/
+│   └── SKILL.md                       # Extração de conhecimento
+│
+└── 05-SKILL-PIPELINE-JARVIS/
+    └── SKILL.md                       # Pipeline de processamento
+```
+
+---
+
+## COMO USAR
+
+### Uso Automático (Padrão)
+Simplesmente trabalhe normalmente. O sistema detecta o contexto e aplica as skills apropriadas.
+
+```
+Você: "Cria um playbook para o Closer"
+Sistema: [Detecta "playbook" → Invoca SKILL-DOCS-MEGABRAIN]
+         [Aplica padrões de documentação automaticamente]
+```
+
+### Verificar Skill Ativa
+```
+"Qual skill está sendo usada?"
+"Mostre os padrões aplicados"
+```
+
+### Ignorar Skill (Raro)
+```
+"Ignore as skills neste caso"
+"Não aplique formatação padrão"
+```
+
+---
+
+## CRIAR NOVA SKILL
+
+1. **Consulte SKILL-CREATOR**
+   ```
+   "Quero criar uma skill para [X]"
+   ```
+
+2. **Siga o template** em `00-SKILL-CREATOR/SKILL.md`
+
+3. **Registre** em `SKILL-REGISTRY.md`
+
+4. **Teste** os triggers automáticos
+
+---
+
+## MANUTENÇÃO
+
+### Ao Modificar Skill
+- [ ] Atualizar versão na skill
+- [ ] Verificar SKILL-REGISTRY
+- [ ] Testar triggers
+
+### Ao Criar Nova Skill
+- [ ] Seguir template do SKILL-CREATOR
+- [ ] Registrar no SKILL-REGISTRY
+- [ ] Definir todos os triggers
+- [ ] Documentar dependências
+
+---
+
+## FILOSOFIA
+
+> **"Padrões são libertadores, não restritivos."**
+
+As skills existem para:
+1. **Liberar carga cognitiva** - não precisa lembrar padrões
+2. **Garantir consistência** - outputs sempre profissionais
+3. **Acelerar execução** - sem discussão sobre formato
+4. **Preservar conhecimento** - boas práticas institucionalizadas
+
+---
+
+## INTEGRAÇÃO COM CLAUDE CODE
+
+Para implementar no Claude Code, adicione ao CLAUDE.md:
+
+```markdown
+## 🎯 SISTEMA DE SKILLS
+
+> **Localização:** `/SKILLS/`
+> **Registry:** `/SKILLS/SKILL-REGISTRY.md`
+
+### Auto-Invocação
+
+Antes de executar qualquer tarefa, verificar:
+1. Extensão do arquivo sendo criado/editado
+2. Comando sendo executado
+3. Keywords na solicitação
+4. Contexto da operação
+
+Consultar SKILL-REGISTRY para identificar skill(s) aplicável(is).
+
+### Aplicação
+
+Ao identificar skill relevante:
+1. Carregar SKILL.md correspondente
+2. Aplicar regras automaticamente
+3. Não perguntar ao usuário (é automático)
+4. Seguir checklist da skill antes de entregar
+```
+
+---
+
+## META-INFORMAÇÃO
+
+- **Versão:** 1.0.0
+- **Criado:** Janeiro 2025
+- **Mantido por:** Sistema Mega Brain
+- **Última atualização:** [Auto-atualizado]