mega-brain-ai 1.3.0

package/.claude/skills/skill-writer/troubleshooting.md

@@ -0,0 +1,205 @@
+# Troubleshooting Skills
+
+Common issues and solutions when creating or debugging Skills.
+
+## Skill doesn't activate
+
+**Symptoms**: Claude doesn't use your Skill when you expect it to.
+
+**Solutions**:
+
+1. **Make description more specific**
+   ```yaml
+   # Before (too vague)
+   description: Helps with documents
+
+   # After (specific triggers)
+   description: Extract text from PDF files. Use when working with PDFs or document extraction.
+   ```
+
+2. **Include trigger words users would say**
+   - Add file extensions: `.pdf`, `.xlsx`, `.json`
+   - Add action verbs: "analyze", "extract", "generate", "create"
+   - Add context: "Use when...", "For..."
+
+3. **Check the "Use when" clause**
+   ```yaml
+   description: [What it does]. Use when [specific scenario].
+   ```
+
+## Skill not found
+
+**Symptoms**: Skill doesn't appear in available skills list.
+
+**Check**:
+
+1. **File location**
+   ```bash
+   # Personal skills
+   ls ~/.claude/skills/skill-name/SKILL.md
+
+   # Project skills
+   ls .claude/skills/skill-name/SKILL.md
+   ```
+
+2. **Directory name matches frontmatter**
+   ```
+   Folder: skill-name/
+   Frontmatter: name: skill-name  # Must match exactly
+   ```
+
+3. **SKILL.md filename** (case-sensitive)
+   - Correct: `SKILL.md`
+   - Wrong: `skill.md`, `Skill.md`
+
+## YAML parsing errors
+
+**Symptoms**: Skill fails to load or behaves unexpectedly.
+
+**Check**:
+
+1. **No tabs in YAML** (spaces only)
+   ```yaml
+   # Wrong (tabs)
+   name:	skill-name
+
+   # Correct (spaces)
+   name: skill-name
+   ```
+
+2. **Frontmatter delimiters**
+   ```yaml
+   ---              # Line 1 (no blank lines before)
+   name: skill-name
+   description: ...
+   ---              # Closing delimiter
+
+   # Content starts here
+   ```
+
+3. **Validate YAML**
+   ```bash
+   head -n 10 SKILL.md
+   ```
+
+## Multiple Skills conflict
+
+**Symptoms**: Wrong Skill activates, or Skills interfere.
+
+**Solutions**:
+
+1. **Make descriptions more distinct**
+   ```yaml
+   # Skill A
+   description: Extract text from PDFs...
+
+   # Skill B
+   description: Create PDF reports from data...
+   ```
+
+2. **Use different trigger words**
+
+3. **Narrow scope of each Skill**
+   - One Skill = one capability
+   - Split broad Skills into focused ones
+
+## Skill has runtime errors
+
+**Symptoms**: Skill loads but fails during execution.
+
+**Check**:
+
+1. **Script permissions**
+   ```bash
+   chmod +x scripts/*.py
+   ```
+
+2. **Dependencies installed**
+   ```bash
+   pip install -r requirements.txt
+   ```
+
+3. **File paths use forward slashes**
+   ```yaml
+   # Correct
+   python scripts/helper.py
+
+   # Wrong (Windows backslashes)
+   python scripts\helper.py
+   ```
+
+4. **Relative paths from skill directory**
+   ```yaml
+   # From SKILL.md, reference sibling files
+   See [examples.md](examples.md)
+   Run: python scripts/validate.py
+   ```
+
+## Debug mode
+
+Run Claude Code with debug output:
+
+```bash
+claude --debug
+```
+
+This shows:
+- Which Skills are loaded
+- Why Skills activate or don't
+- Any parsing errors
+
+## Common mistakes
+
+### 1. Name mismatch
+
+```
+Folder: my-skill/
+Frontmatter: name: myskill  # Wrong - doesn't match
+```
+
+### 2. Description too vague
+
+```yaml
+description: Utility for files  # Won't trigger
+```
+
+### 3. Missing "Use when" context
+
+```yaml
+# Missing context
+description: Extracts data from spreadsheets
+
+# Better
+description: Extracts data from spreadsheets. Use when working with Excel or CSV files.
+```
+
+### 4. Nested file references
+
+```markdown
+# Avoid deep nesting
+SKILL.md → advanced.md → details.md → more.md
+
+# Keep it flat
+SKILL.md → reference.md
+SKILL.md → examples.md
+```
+
+### 5. Tabs in YAML
+
+YAML requires spaces. Tabs cause silent failures.
+
+## Validation commands
+
+```bash
+# Check file exists
+ls .claude/skills/skill-name/SKILL.md
+
+# View frontmatter
+head -n 10 .claude/skills/skill-name/SKILL.md
+
+# Check for tabs (should return nothing)
+grep -P '\t' .claude/skills/skill-name/SKILL.md
+
+# Restart Claude to reload skills
+# (Exit and relaunch Claude Code)
+```

package/.claude/skills/smart-download-tagger/SKILL.md

@@ -0,0 +1,148 @@
+# SKILL: Smart Download & Tagger
+
+## Descrição
+Sistema inteligente de download, tagueamento e organização de materiais do Mega Brain.
+Lê a planilha de controle, identifica materiais pendentes, baixa do Drive, gera TAGs e atualiza a planilha.
+
+---
+
+## ESTRUTURA DA PLANILHA (PADRÃO ATUAL)
+
+```
+┌──────────────────────────────────────────────────────────────────────────────┐
+│  COLUNA  │  CONTEÚDO                                                         │
+├──────────────────────────────────────────────────────────────────────────────┤
+│  A       │  Módulo (número ou categoria)                                     │
+│  B       │  Número da Aula                                                   │
+│  C       │  Aula/Assunto/Tema (título descritivo)                           │
+│  D       │  Duração (mm:ss)                                                  │
+│  E       │  Link - Drive (URL ou nome do arquivo no Drive)                  │
+│  F       │  Link - YouTube (URL do vídeo no YouTube)                        │
+│  G       │  Transcrição (nome do arquivo .docx no Drive)                    │
+│  H       │  TAG (gerada por JARVIS - VAZIA = pendente)                      │
+└──────────────────────────────────────────────────────────────────────────────┘
+```
+
+### Regras da Planilha:
+1. **Cada linha = um conteúdo** (vídeo OU material complementar)
+2. **Materiais complementares** (PDFs, etc.) têm sua própria linha dedicada
+3. **Coluna H vazia** = material novo, não processado, precisa de download/TAG
+4. **Coluna H preenchida** = já processado e tagueado
+
+---
+
+## PREFIXOS DE TAG POR ABA
+
+| Aba | Prefixo TAG | 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 |
+
+---
+
+## ALGORITMO DE PROCESSAMENTO
+
+```python
+def process_pending_materials():
+    """
+    1. Para cada aba da planilha:
+       a. Ler todas as linhas
+       b. Identificar linhas onde coluna H está VAZIA
+       c. Para cada linha pendente:
+          - Extrair nome do arquivo da coluna G (ou E para materiais)
+          - Buscar arquivo no Google Drive por nome
+          - Baixar conteúdo do arquivo
+          - Gerar TAG no formato: PREFIXO-XXXX
+          - Atualizar coluna H na planilha com a TAG
+          - Salvar arquivo no INBOX como: [TAG] nome_original.ext
+    """
+```
+
+---
+
+## FORMATO DE SAÍDA
+
+### Arquivo no INBOX
+```
+[TAG] Nome Original do Arquivo.ext
+
+Exemplos:
+[JM-0152] How to Handle Objections.txt
+[UHTC-0012] Module_5.m4a
+[CA-0032] 9 Figure Ad Scripts.pdf
+```
+
+### Atualização na Planilha
+- Coluna H recebe a TAG gerada
+- Formato: `PREFIXO-XXXX` (4 dígitos com zero à esquerda)
+
+---
+
+## TIPOS DE ARQUIVO SUPORTADOS
+
+| Tipo | Extensão | Ação |
+|------|----------|------|
+| Transcrição | .docx | Extrair texto, salvar como .txt |
+| PDF | .pdf | Baixar binário, manter formato |
+| Áudio | .mp3, .m4a | Baixar binário, manter formato |
+| Planilha | .xlsx | Baixar binário, manter formato |
+| Apresentação | .pptx | Baixar binário, manter formato |
+| Imagem | .jpeg, .jpg, .png | Baixar binário, manter formato |
+
+---
+
+## FERRAMENTAS MCP UTILIZADAS
+
+| Ferramenta | Uso |
+|------------|-----|
+| `mcp__gdrive__gsheets_read` | Ler planilha para identificar pendentes |
+| `mcp__gdrive__gdrive_search` | Buscar arquivos no Drive por nome |
+| `mcp__gdrive__gdrive_read_file` | Baixar conteúdo do arquivo |
+| `mcp__gdrive__gsheets_update_cell` | Atualizar TAG na coluna H |
+
+---
+
+## MAPEAMENTO DE DESTINO NO INBOX
+
+| Prefixo | Pasta Destino |
+|---------|---------------|
+| JM | JEREMY MINER/COURSES |
+| JH-ST, JH-IC, JH-WK, AOBA, PCVP, LYFC, MMM, 30DC, STA, UHTC | JEREMY HAYNES/COURSES |
+| TSC | THE SCALABLE COMPANY/COURSES |
+| EDC | COLE GORDON/COURSES |
+| AH | ALEX HORMOZI/COURSES |
+| CA | JEREMY HAYNES PROGRAM/COURSES |
+
+---
+
+## SCRIPT PRINCIPAL
+
+Localização: `scripts/smart-download-tagger.py`
+
+---
+
+## REGRAS IMPORTANTES
+
+1. **NUNCA duplicar** - verificar se arquivo já existe no INBOX antes de baixar
+2. **SEMPRE atualizar planilha** - TAG na coluna H após download bem-sucedido
+3. **MANTER consistência** - mesmo formato de TAG em todo o sistema
+4. **LOGS detalhados** - registrar cada ação para auditoria
+
+---
+
+**Skill criada em:** 2026-01-08
+**Autor:** JARVIS
+**Versão:** 1.0

package/.claude/skills/source-sync/SKILL.md

@@ -0,0 +1,240 @@
+# SKILL: Source Sync - Sincronização com Planilha
+
+> **Versão:** 1.0.0
+> **Criado:** 2026-01-13
+> **Propósito:** Detectar NOVOS arquivos na planilha, taguear na fonte, baixar organizados.
+
+---
+
+## Comando
+
+```
+/source-sync [opções]
+```
+
+## Opções
+
+| Opção | Descrição |
+|-------|-----------|
+| `--check` | Apenas verificar delta (não baixar) |
+| `--force` | Forçar re-sincronização completa |
+| `--source=XX` | Filtrar por fonte específica (JM, JH, CG, etc.) |
+| `--execute` | Executar download após verificação |
+
+---
+
+## CONCEITO FUNDAMENTAL
+
+```
+┌─────────────────────────────────────────────────────────────────────────────┐
+│  PLANILHA (Google Sheets)                                                   │
+│       │                                                                     │
+│       ▼                                                                     │
+│  COMPARAR com SNAPSHOT LOCAL (PLANILHA-INDEX.json)                          │
+│       │                                                                     │
+│       ├── NOVOS? → Gerar TAG na planilha → Baixar com [TAG]                │
+│       │                                                                     │
+│       └── IGUAIS? → Nada a fazer                                           │
+└─────────────────────────────────────────────────────────────────────────────┘
+```
+
+**Diferença crítica vs Fase 2.5:**
+- Fase 2.5: Tagueia LOCALMENTE (arquivo já baixado)
+- Source Sync: Tagueia NA FONTE (planilha) ANTES de baixar
+
+---
+
+## MAPEAMENTO ABA → PREFIXO
+
+```python
+SHEET_TO_PREFIX = {
+    "Jeremy Miner": "JM",
+    "Jeremy Haynes Sales Training": "JH-ST",
+    "Jeremy Haynes Inner Circle": "JH-IC",
+    "Inner Circle Weekly Group Call Recordings": "JH-WK",
+    "Agency Blueprint": "AOBA",
+    "Cold Video Pitch": "PCVP",
+    "Land Your First Agency Client": "LYFC",
+    "Marketer Mindset Masterclass": "MMM",
+    "30 Days Challenge": "30DC",
+    "Scale The Agency": "STA",
+    "Ultra High Ticket Closer": "UHTC",
+    "The Scalable Company": "TSC",
+    "Cole Gordon": "CG",
+    "Sales Training BR": "EDC",
+    "Alex Hormozi": "AH",
+    "Jeremy Haynes Program": "CA",
+}
+```
+
+---
+
+## FLUXO DE TRABALHO
+
+### PASSO 1: CARREGAR SNAPSHOT
+```python
+# Ler PLANILHA-INDEX.json (último estado conhecido)
+snapshot = load_json("/.claude/mission-control/PLANILHA-INDEX.json")
+# Contém: {entries: [{tag, name, sheet, row, link_drive}], timestamp}
+```
+
+### PASSO 2: LER PLANILHA ATUAL (MCP)
+```python
+# Via MCP gdrive
+planilha_atual = mcp__gdrive__gsheets_read(spreadsheetId=PLANILHA_ID)
+# Para cada aba, extrair: nome_video, TAG existente, link_drive
+```
+
+### PASSO 3: DETECTAR DELTA
+```python
+# Comparar snapshot vs atual
+novos = [entry for entry in atual if entry['tag'] not in snapshot_tags]
+# Separar: com_tag (já tagueados) vs sem_tag (precisam TAG)
+```
+
+### PASSO 4: EXIBIR RELATÓRIO
+```
+╔══════════════════════════════════════════════════════════════════════════════╗
+║         SOURCE SYNC - RELATÓRIO DE DELTA                                     ║
+╠══════════════════════════════════════════════════════════════════════════════╣
+║  NOVOS ARQUIVOS DETECTADOS: 47                                               ║
+║                                                                              ║
+║  POR FONTE:                                                                  ║
+║  ├── Jeremy Miner:       12 novos                                            ║
+║  ├── Jeremy Haynes:      23 novos                                            ║
+║  └── Cole Gordon:         8 novos                                            ║
+║                                                                              ║
+║  AÇÕES NECESSÁRIAS:                                                          ║
+║  ├── TAGs a gerar:       15 (arquivos sem TAG)                               ║
+║  ├── Downloads:          47 arquivos                                         ║
+║  └── Destino: inbox/[FONTE]/[TIPO]/                                       ║
+╚══════════════════════════════════════════════════════════════════════════════╝
+```
+
+### PASSO 5: TAGUEAMENTO NA FONTE (com --execute)
+```python
+# Para cada arquivo SEM TAG na planilha:
+for entry in novos_sem_tag:
+    prefix = SHEET_TO_PREFIX[entry['sheet']]
+    next_tag = generate_next_tag(prefix, existing_tags)
+    # Escrever na planilha
+    mcp__gdrive__gsheets_update_cell(
+        fileId=PLANILHA_ID,
+        range=f"{entry['sheet']}!I{entry['row']}",
+        value=next_tag
+    )
+```
+
+### PASSO 6: DOWNLOAD ORGANIZADO
+```python
+# Baixar com nome já tagueado:
+for entry in novos:
+    content = mcp__gdrive__gdrive_read_file(fileId=entry['file_id'])
+    filename = f"[{entry['tag']}] {entry['original_name']}.txt"
+    save_to_inbox(content, filename, source_folder=entry['source'])
+```
+
+### PASSO 7: ATUALIZAR SNAPSHOT
+```python
+# Adicionar novos ao índice
+snapshot['entries'].extend(novos)
+snapshot['timestamp'] = datetime.now().isoformat()
+save_json(snapshot, "/.claude/mission-control/PLANILHA-INDEX.json")
+```
+
+---
+
+## ARQUIVOS DO SISTEMA
+
+| Arquivo | Propósito |
+|---------|-----------|
+| `.claude/mission-control/PLANILHA-INDEX.json` | Snapshot da planilha (915+ entries) |
+| `.claude/mission-control/SOURCE-SYNC-STATE.json` | Estado da última sincronização |
+| `.claude/mission-control/DELTA-PENDING.json` | Arquivos novos pendentes |
+| `.claude/scripts/source-sync.py` | Script de detecção de delta |
+| `.claude/hooks/session-source-sync.py` | Hook de início de sessão |
+
+---
+
+## INTEGRAÇÃO COM FASES
+
+```
+┌─────────────────────────────────────────────────────────────────────────────┐
+│  ANTES (Manual):                                                            │
+│                                                                             │
+│  Fase 1 (Download) → Fase 2 (Organização) → Fase 2.5 (Tags) → Fase 3       │
+│       ↑                    ↑                      ↑                         │
+│     Manual              Manual                 Scripts                      │
+│                                                                             │
+├─────────────────────────────────────────────────────────────────────────────┤
+│  DEPOIS (Source Sync):                                                      │
+│                                                                             │
+│  /source-sync ─────────────────────────────────────────────→ Fase 4        │
+│       │                                                                     │
+│       └── Detecta + Tagueia na fonte + Baixa organizado                    │
+│                                                                             │
+│  Fases 1, 2, 2.5, 3 SUBSTITUÍDAS por um único comando                      │
+└─────────────────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## REGRA #25 - SOURCE SYNC OBRIGATÓRIO
+
+**ANTES DE PROCESSAR NOVOS CONTEÚDOS, EXECUTAR /source-sync.**
+
+### Regras Absolutas:
+
+- **NÃO PODE** baixar arquivos manualmente sem usar /source-sync
+- **NÃO PODE** ignorar alerta de delta pendente
+- **NÃO PODE** processar no Pipeline sem sincronização
+- **DEVE** sempre verificar snapshot antes de baixar
+- **DEVE** atualizar snapshot após cada sincronização
+
+```
+⚠️ SYNC ANTES DE DOWNLOAD
+⚠️ TAG NA FONTE, NÃO NO LOCAL
+⚠️ SNAPSHOT É A VERDADE
+```
+
+---
+
+## ALERTAS DE SESSÃO
+
+O hook verifica no início de cada sessão:
+
+```
+┌──────────────────────────────────────────────────────────────────────────────┐
+│  SOURCE SYNC - ALERTAS DE SESSÃO                                             │
+├──────────────────────────────────────────────────────────────────────────────┤
+│  [PENDING_DELTA]                                                             │
+│    ⚠️ 47 arquivos NOVOS detectados aguardando download                       │
+│    → Execute /source-sync para processar                                     │
+│                                                                              │
+│  [STALE_SYNC]                                                                │
+│    ⚠️ Última sincronização há 8 dias                                         │
+│    → Considere executar /source-sync --check                                 │
+└──────────────────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## COMANDOS RÁPIDOS
+
+```bash
+# Verificar delta (sem baixar)
+/source-sync --check
+
+# Executar sincronização completa
+/source-sync --execute
+
+# Filtrar por fonte específica
+/source-sync --source=JM --execute
+
+# Forçar re-sincronização
+/source-sync --force --execute
+```
+
+---
+
+*Skill criada para MISSION-2026-001 | JARVIS v3.33.0*