mega-brain-ai 1.3.0

package/.claude/skills/github-workflow/SKILL.md

@@ -0,0 +1,190 @@
+> **Auto-Trigger:** Quando usuário menciona GitHub, issues, PRs, branches, ou workflow de código
+> **Keywords:** "github", "issue", "pull request", "pr", "branch", "merge", "commit", "workflow"
+> **Prioridade:** ALTA
+> **Tools:** Bash, Read, Write
+
+---
+
+# /github-workflow - Guia do Fluxo GitHub
+
+## Propósito
+
+Este skill guia o usuário através do fluxo GitHub obrigatório definido na **REGRA #30**.
+Todo código modificado DEVE seguir este workflow: **Issue → Branch → PR → Merge**.
+
+---
+
+## Workflow Completo
+
+```
+┌─────────────────────────────────────────────────────────────────────────────┐
+│                    GITHUB WORKFLOW OBRIGATÓRIO                              │
+├─────────────────────────────────────────────────────────────────────────────┤
+│                                                                             │
+│  1. CRIAR ISSUE                                                             │
+│     ├── Prefixo correto: [FEAT], [FIX], [REFACTOR], [DOCS]                 │
+│     ├── Título descritivo                                                   │
+│     └── Critérios de aceite claros                                         │
+│                                                                             │
+│  2. CRIAR BRANCH                                                            │
+│     ├── Formato: tipo/issue-XX-descricao                                   │
+│     ├── Exemplos:                                                          │
+│     │   feat/issue-42-add-auth                                             │
+│     │   fix/issue-15-memory-leak                                           │
+│     │   refactor/issue-8-cleanup-hooks                                     │
+│     └── git checkout -b tipo/issue-XX-desc                                 │
+│                                                                             │
+│  3. FAZER COMMITS                                                           │
+│     ├── Mensagens descritivas                                              │
+│     ├── Referência à issue: refs #XX                                       │
+│     └── Exemplo: "Add auth module refs #42"                                │
+│                                                                             │
+│  4. ABRIR PULL REQUEST                                                      │
+│     ├── Título claro                                                       │
+│     ├── "Fixes #XX" no body (auto-fecha issue)                             │
+│     ├── Checklist de 6 níveis de verificação                               │
+│     └── Usar template: .github/PULL_REQUEST_TEMPLATE.md                    │
+│                                                                             │
+│  5. VERIFICAR (6 Níveis)                                                    │
+│     ├── 1. Lint/Hooks                                                      │
+│     ├── 2. Tests                                                           │
+│     ├── 3. Build/Integrity                                                 │
+│     ├── 4. Visual                                                          │
+│     ├── 5. Staging                                                         │
+│     └── 6. Security                                                        │
+│                                                                             │
+│  6. MERGE                                                                   │
+│     └── Apenas após todos os níveis passarem                               │
+│                                                                             │
+└─────────────────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## Templates de Issue
+
+### [FEAT] - Nova Funcionalidade
+```bash
+gh issue create --title "[FEAT] Descrição curta" --body "## Descrição
+[Detalhe da feature]
+
+## Critérios de Aceite
+- [ ] Critério 1
+- [ ] Critério 2
+
+## Contexto JARVIS
+- Fase: [X]
+- Regras afetadas: [lista]"
+```
+
+### [FIX] - Correção de Bug
+```bash
+gh issue create --title "[FIX] Descrição do bug" --body "## Bug
+[Descrição do problema]
+
+## Reprodução
+1. Passo 1
+2. Passo 2
+
+## Comportamento Esperado
+[O que deveria acontecer]
+
+## Logs/Screenshots
+[Se aplicável]"
+```
+
+### [REFACTOR] - Refatoração
+```bash
+gh issue create --title "[REFACTOR] Área de refatoração" --body "## Objetivo
+[Por que refatorar]
+
+## Escopo
+- Arquivos afetados: [lista]
+- Impacto: [baixo/médio/alto]
+
+## Abordagem
+[Como será feito]"
+```
+
+---
+
+## Comandos Úteis
+
+### Criar Issue
+```bash
+gh issue create --title "[TIPO] Título" --label "tipo"
+```
+
+### Criar Branch
+```bash
+git checkout -b feat/issue-XX-descricao
+```
+
+### Abrir PR
+```bash
+gh pr create --title "Título do PR" --body "Fixes #XX
+
+## Summary
+- Change 1
+- Change 2
+
+## Verification Checklist
+- [ ] 1. Hooks/Lint passed
+- [ ] 2. Tests passed
+- [ ] 3. Build successful
+- [ ] 4. Visual verification
+- [ ] 5. Staging tested
+- [ ] 6. Security audit"
+```
+
+### Verificar Status
+```bash
+gh pr status
+gh pr checks
+```
+
+---
+
+## 6 Níveis de Verificação
+
+| Nível | Nome | Comando | O que Verifica |
+|-------|------|---------|----------------|
+| 1 | Lint/Hooks | `pre-commit run --all` | Formatação, style |
+| 2 | Tests | `pytest` / `npm test` | Testes automatizados |
+| 3 | Build | `python -m py_compile **/*.py` | Integridade do código |
+| 4 | Visual | Manual | Revisão visual do output |
+| 5 | Staging | Deploy staging | Funciona em ambiente real |
+| 6 | Security | `bandit` / manual | Vulnerabilidades |
+
+---
+
+## Quando NÃO Ativar
+
+- Perguntas gerais sobre git (não sobre o workflow específico)
+- Quando usuário já está no meio de um workflow e sabe o que fazer
+- Consultas sobre histórico de commits sem intenção de modificar
+
+---
+
+## Regras Relacionadas
+
+- **REGRA #30**: GitHub Workflow Obrigatório
+- **REGRA #13**: Plan Mode para modificações
+- **REGRA #8**: Logging obrigatório
+
+---
+
+## Exemplos de Uso
+
+**Usuário:** "Como faço para criar uma issue de feature?"
+**JARVIS:** [Ativa este skill, mostra template de issue FEAT]
+
+**Usuário:** "Preciso fazer um PR para a issue #42"
+**JARVIS:** [Ativa este skill, guia através do processo de PR]
+
+**Usuário:** "Qual o workflow do GitHub?"
+**JARVIS:** [Ativa este skill, mostra diagrama completo]
+
+---
+
+*Para verificação completa de 6 níveis, use `/verify-6-levels`*

package/.claude/skills/hookify/SKILL.md

@@ -0,0 +1,134 @@
+# Hookify Skill
+
+> **Auto-Trigger:** Quando usuário quiser criar hook, regra de segurança, validação customizada, lifecycle hook
+> **Keywords:** "hook", "criar hook", "lifecycle", "safety rule", "validação", "regra de segurança", "pre-tool", "post-tool"
+> **Prioridade:** ALTA
+> **Namespace:** [OFFICIAL]
+> **Tools:** Read, Write, Edit, Glob, Grep
+
+## Quando NÃO Ativar
+
+- Discussões sobre hooks existentes sem intenção de criar novos
+- Debugging de hooks já implementados
+- Perguntas gerais sobre o sistema de hooks
+- Quando usuário explicitamente pedir skill diferente
+
+---
+
+## Core Purpose
+
+Creating custom safety rules and hooks for Claude Code via markdown files with YAML frontmatter.
+Enables pattern detection, regex matching, and warn/block modes for tool usage control.
+
+---
+
+## Hook Structure
+
+### File Format
+
+```markdown
+---
+name: hook-name
+description: What this hook does
+trigger: PreToolUse | PostToolUse | UserPromptSubmit | SessionStart | Stop
+tools: ["Bash", "Write", "Edit"]  # Optional: specific tools to match
+pattern: "regex pattern"  # Optional: content pattern matching
+mode: warn | block  # Default: warn
+---
+
+# Instructions for what to do when triggered
+
+Your custom logic here...
+```
+
+### Trigger Types
+
+| Trigger | When It Fires |
+|---------|---------------|
+| `PreToolUse` | Before any tool execution |
+| `PostToolUse` | After tool execution |
+| `UserPromptSubmit` | When user sends a message |
+| `SessionStart` | At session initialization |
+| `Stop` | At session end |
+
+### Mode Options
+
+| Mode | Behavior |
+|------|----------|
+| `warn` | Alerts but continues execution |
+| `block` | Prevents the action entirely |
+
+---
+
+## Implementation Guidelines
+
+### 1. Identify the Need
+
+- What action should be controlled?
+- When should the hook trigger?
+- Should it warn or block?
+
+### 2. Define Patterns
+
+- Use regex for content matching
+- Specify tools if action-specific
+- Consider edge cases
+
+### 3. Write Instructions
+
+- Clear, concise logic
+- Explain the "why" for debugging
+- Include examples if complex
+
+---
+
+## Example Hooks
+
+### Prevent Dangerous Commands
+
+```markdown
+---
+name: prevent-rm-rf
+description: Blocks recursive force delete commands
+trigger: PreToolUse
+tools: ["Bash"]
+pattern: "rm\\s+-rf"
+mode: block
+---
+
+This command is blocked for safety. Use explicit file deletion instead.
+```
+
+### Warn on Sensitive Files
+
+```markdown
+---
+name: warn-env-access
+description: Warns when accessing environment files
+trigger: PreToolUse
+tools: ["Read", "Edit"]
+pattern: "\\.env"
+mode: warn
+---
+
+You're accessing an environment file. Ensure no secrets are exposed.
+```
+
+---
+
+## Example Prompts This Skill Handles
+
+- "Crie um hook para bloquear comandos perigosos"
+- "Create a safety rule for database operations"
+- "Preciso de uma validação antes de editar arquivos .env"
+- "Make a pre-tool hook that warns about large file writes"
+- "Quero criar regras de segurança customizadas"
+
+---
+
+## 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/hybrid-source-reading/SKILL.md

@@ -0,0 +1,265 @@
+# SKILL: Leitura de Fontes Híbridas
+
+## Descrição
+Skill para leitura inteligente de conteúdo proveniente de múltiplas fontes de dados (Google Sheets, Google Docs, arquivos locais).
+
+---
+
+## FONTES DA MISSÃO ATUAL
+
+### 1. Planilha Google Sheets (Conteúdo Principal)
+```
+ID: [YOUR_SHEET_ID_HERE]
+URL: https://docs.google.com/spreadsheets/d/[YOUR_SHEET_ID_HERE]
+```
+
+**19 Abas Disponíveis:**
+| Aba | Prefixo | Descrição |
+|-----|---------|-----------|
+| Jeremy Miner | JM | Jeremy Miner Sales |
+| Jeremy Haynes Sales Training | JH-ST | Cursos JH |
+| Jeremy Haynes Inner Circle | JH-IC | Masterminds JH |
+| Inner Circle Weekly Group Call Recordings | JH-WK | Calls Semanais JH |
+| Agency Blueprint | AOBA | Cursos Agência |
+| Cold Video Pitch | PCVP | Cold Pitch |
+| Land Your First Agency Client | LYFC | Primeiro Cliente |
+| Marketer Mindset Masterclass | MMM | Mindset |
+| 30 Days Challenge | 30DC | Desafio 30 dias |
+| Scale The Agency | STA | Escala |
+| Ultra High Ticket Closer | UHTC | High Ticket |
+| The Scalable Company | TSC | Ryan Deiss |
+| Sales Training BR | EDC | Closer BR |
+| Alex Hormozi | AH | Hormozi |
+| Jeremy Haynes Program | CA | Sam Ovens |
+
+### 2. Documento Google Docs (SOPs)
+```
+ID: [YOUR_DOC_ID_HERE]
+URL: https://docs.google.com/document/d/[YOUR_DOC_ID_HERE]
+Nome: [2.0 OWNER] Master SOP Index
+```
+
+**32 SOPs do Jeremy Haynes:**
+| SOP # | Nome | TAG Sugerida |
+|-------|------|--------------|
+| 1 | THE HYDRA Ad Strategy | JH-SOP-0001 |
+| 2 | Hammer Them Ad Strategy | JH-SOP-0002 |
+| 3 | Mastering VSLs | JH-SOP-0003 |
+| 4 | Mastering Webinars | JH-SOP-0004 |
+| 5 | Client Reporting | JH-SOP-0005 |
+| 6 | If This, Then That Rules for Advertising | JH-SOP-0006 |
+| 7 | Client Onboarding | JH-SOP-0007 |
+| 8 | Hiring & Team Onboarding | JH-SOP-0008 |
+| 9 | A2P 10DLC Compliance | JH-SOP-0009 |
+| 10 | 5-Point Client Retention Star | JH-SOP-0010 |
+| 11 | The Tornado Ad Strategy | JH-SOP-0011 |
+| 12 | Venus Fly Trap 2.0 Ad Strategy | JH-SOP-0012 |
+| 13 | The Email Matrix | JH-SOP-0013 |
+| 14 | Venus Fly Trap Ad Strategy | JH-SOP-0014 |
+| 15 | The Forester Ad Strategy | JH-SOP-0015 |
+| 16 | DSL Deck Sales Letter Funnel Strategy | JH-SOP-0016 |
+| 17 | The Harvester Ad Strategy | JH-SOP-0017 |
+| 18 | Ultimate Sales Guide | JH-SOP-0018 |
+| 19 | What I Wish I Knew | JH-SOP-0019 |
+| 20 | Top Hooks & Headlines for Copywriting | JH-SOP-0020 |
+| 21 | Cold Video Pitch | JH-SOP-0021 |
+| 22 | Friends and Family Insurance Policy | JH-SOP-0022 |
+| 23 | The Perfect Client Traits | JH-SOP-0023 |
+| 24 | Thinking Time | JH-SOP-0024 |
+| 25 | What is Ad Fatigue? | JH-SOP-0025 |
+| 26 | Direct Response Ad Creation Framework (Expanded) | JH-SOP-0026 |
+| 27 | Direct Response Ad Creation Framework (TLDR) | JH-SOP-0027 |
+| 28 | Confirmation Page Best Practices | JH-SOP-0028 |
+| 29 | Advanced Book Funnel Creative | JH-SOP-0029 |
+| 30 | Challenge Funnel Mastery | JH-SOP-0030 |
+| 31 | Ad Diversification Mastery | JH-SOP-0031 |
+| 32 | Setter Pre Call Best Practices | JH-SOP-0032 |
+
+---
+
+## ESTRUTURA DAS TRANSCRIÇÕES NA PLANILHA
+
+**AS TRANSCRIÇÕES ESTÃO NA PLANILHA, NÃO EM ARQUIVOS EXTERNOS.**
+
+### Colunas Típicas (variam por aba):
+```
+┌────────────────────────────────────────────────────────────────────────────┐
+│  COLUNA  │  CONTEÚDO                                                       │
+├────────────────────────────────────────────────────────────────────────────┤
+│  A       │  MÓDULO (número ou categoria)                                   │
+│  B       │  AULA (número + título)                                         │
+│  C       │  ASSUNTO/TEMA (descrição/resumo)                                │
+│  D       │  DURAÇÃO (mm:ss)                                                │
+│  E       │  LINK - DRIVE (nome do arquivo de vídeo .mp4)                   │
+│  F       │  LINK - YOUTUBE (título ou URL)                                 │
+│  G       │  TRANSCRIÇÃO VISUAL + VERBAL ← PREFERENCIAL (nome .docx)       │
+│  H       │  TRANSCRIÇÃO ← FALLBACK (nome .docx)                           │
+│  I       │  TAG (JM-0001, JH-ST-0015, etc.)                               │
+└────────────────────────────────────────────────────────────────────────────┘
+```
+
+### Hierarquia de Extração:
+```
+1. TRANSCRIÇÃO VISUAL + VERBAL (coluna G) → Melhor qualidade, usa primeiro
+2. TRANSCRIÇÃO (coluna H) → Fallback se G não disponível
+```
+
+### Como Extrair Transcrições:
+```
+1. Ler planilha → identificar linhas faltantes no INBOX
+2. Para cada linha faltante:
+   a. Pegar valor da coluna G (nome do arquivo .docx)
+   b. Se G vazio → usar coluna H
+   c. Buscar arquivo .docx no Google Drive por nome
+   d. Ler conteúdo do .docx
+   e. Salvar como [TAG] Nome.txt no INBOX
+```
+
+### Detecção Inteligente de Padrão por Aba:
+```python
+def detect_columns(sheet_data):
+    """
+    Analisa primeira linha para detectar estrutura da aba.
+    Retorna mapeamento de colunas.
+    """
+    headers = sheet_data['columnHeaders']
+    mapping = {}
+
+    for i, header in enumerate(headers):
+        value = header.get('value', '').upper()
+        col_letter = chr(65 + i)  # A, B, C...
+
+        if 'TRANSCRIÇÃO VISUAL' in value or 'VISUAL + VERBAL' in value:
+            mapping['transcription_primary'] = col_letter
+        elif 'TRANSCRIÇÃO' in value:
+            mapping['transcription_fallback'] = col_letter
+        elif 'TAG' in value:
+            mapping['tag'] = col_letter
+        elif 'AULA' in value or 'NOME' in value:
+            mapping['name'] = col_letter
+
+    return mapping
+```
+
+---
+
+## COMO LER CADA FONTE
+
+### Google Sheets
+```
+1. Usar mcp__gdrive__gsheets_read com spreadsheetId
+2. Especificar ranges por aba: ["NomeAba!A:Z"]
+3. Analisar headers para detectar estrutura
+4. Coluna de TRANSCRIÇÃO: G ou H (verificar header)
+5. Coluna de TAG: geralmente I ou J
+6. Se resultado muito grande, será salvo em tool-results/
+```
+
+### Google Docs
+```
+1. Usar mcp__gdrive__gdrive_read_file com fileId
+2. Se muito grande, será salvo em tool-results/
+3. Usar grep para buscar padrões específicos
+4. Formato markdown com headers e links
+```
+
+### Arquivos Locais
+```
+1. Usar Read tool para arquivos .txt
+2. Usar Glob para encontrar padrões
+3. Usar Grep para buscar conteúdo
+```
+
+---
+
+## MATCHING DE ARQUIVOS
+
+### Formato de TAG no Nome do Arquivo
+```
+[PREFIX-XXXX] Nome Original.txt
+
+Exemplos:
+[JM-0114] 112 - How To Sell A Pen.txt
+[JH-SOP-0001] SOP 01. THE HYDRA AD STRATEGY.txt
+```
+
+### Algoritmo de Matching
+```python
+from difflib import SequenceMatcher
+
+def match_file_to_entry(filename, entries, threshold=0.7):
+    """
+    Compara nome do arquivo com entradas da planilha
+    Retorna melhor match se score >= threshold
+    """
+    normalized = normalize_name(filename)
+    best_match = None
+    best_score = 0
+
+    for entry_name, tag in entries.items():
+        score = SequenceMatcher(None, normalized, normalize_name(entry_name)).ratio()
+        if score > best_score:
+            best_score = score
+            best_match = (entry_name, tag)
+
+    return best_match if best_score >= threshold else None
+```
+
+---
+
+## HIERARQUIA DE DECISÃO
+
+```
+1. Arquivo já tem TAG [PREFIX-XXXX]?
+   → SIM: Verificar se corresponde à planilha
+   → NÃO: Buscar match na planilha
+
+2. Match encontrado com score >= 0.7?
+   → SIM: Renomear com TAG
+   → NÃO: Marcar como órfão
+
+3. Órfão identificado?
+   → Verificar se existe em outra fonte (Docs, etc)
+   → Se não existe, é conteúdo não catalogado
+```
+
+---
+
+## FERRAMENTAS MCP DISPONÍVEIS
+
+| Ferramenta | Uso |
+|------------|-----|
+| `mcp__gdrive__gsheets_read` | Ler planilhas Google Sheets |
+| `mcp__gdrive__gdrive_read_file` | Ler documentos Google Docs |
+| `mcp__gdrive__gdrive_search` | Buscar arquivos no Drive |
+| `mcp__gdrive__gsheets_update_cell` | Atualizar célula na planilha |
+
+---
+
+## CACHE DE RESULTADOS
+
+Resultados grandes são salvos automaticamente em:
+```
+~/.claude/projects/<project-path>/[SESSION-ID]/tool-results/
+```
+
+Formato dos arquivos:
+```json
+[{"type": "text", "text": "...conteúdo JSON..."}]
+```
+
+**Para ler:** Fazer double-parse do JSON (outer array → inner text)
+
+---
+
+## REGRAS IMPORTANTES
+
+1. **SEMPRE verificar ambas as fontes** (Sheets + Docs) antes de declarar órfão
+2. **NUNCA assumir** que arquivo não existe sem verificar
+3. **GRAVAR** mapeamento DE-PARA após cada operação
+4. **LOGAR** todas as ações em CURRENT-SESSION.md
+
+---
+
+**Skill criada em:** 2026-01-07
+**Autor:** JARVIS