mega-brain-ai 1.3.0

package/.claude/commands/documentation/create-architecture-documentation.md

@@ -0,0 +1,175 @@
+# Create Architecture Documentation
+
+Generate comprehensive architecture documentation for the Mega Brain project.
+
+## Arguments
+$ARGUMENTS (optional: --c4-model | --full-suite | --mermaid)
+
+## Allowed Tools
+Read, Write, Edit, Bash, Glob, Grep
+
+## What This Command Does
+
+Creates professional architecture documentation including:
+- System Context Diagram
+- Component Diagrams
+- Data Flow Documentation
+- Knowledge Taxonomy
+- Integration Architecture
+
+## Implementation Steps
+
+### Step 1: Discovery
+Scan the project to understand current architecture:
+- Read CLAUDE.md for project overview
+- Scan .claude/ folder for components
+- List KNOWLEDGE/ themes
+- Check scripts/ for utilities
+- Identify integrations (APIs, MCPs)
+
+### Step 2: Generate System Context
+
+Create `docs/architecture/01-system-context.md`:
+
+```markdown
+# Mega Brain - System Context
+
+## Overview
+[High-level description of what the system does]
+
+## External Actors
+- User: Drops content into INBOX
+- YouTube: Source of video transcripts
+- AssemblyAI: Transcription service for local files
+- Claude Code: AI-powered extraction agent
+
+## System Boundaries
+[What's inside vs outside the system]
+
+## Data Flow
+```
+External Content → INBOX → Transcription → Extraction → KNOWLEDGE
+```
+```
+
+### Step 3: Component Architecture
+
+Create `docs/architecture/02-components.md`:
+
+```markdown
+# Components
+
+## .claude/ Components
+| Type | Name | Purpose |
+|------|------|---------|
+| Agent | b2b-sales-expert | B2B sales analysis |
+| Command | /process-video | Video processing |
+| Command | /extract-knowledge | Knowledge extraction |
+| Command | /scan-inbox | INBOX scanning |
+| Skill | video-processing | Transcription |
+| Skill | knowledge-extraction | Classification |
+
+## Scripts
+| Script | Language | Purpose |
+|--------|----------|---------|
+| transcribe.py | Python | AssemblyAI integration |
+| auto_organize_inbox.py | Python | INBOX scanning |
+
+## Knowledge Themes
+[List of 10 theme folders with descriptions]
+```
+
+### Step 4: Data Architecture
+
+Create `docs/architecture/03-data-flow.md`:
+
+```markdown
+# Data Architecture
+
+## Input Formats
+- YouTube URLs
+- Local video files (MP4, MP3, WAV, M4A)
+- Transcription files (TXT)
+- Documents (PDF, DOCX)
+
+## Processing Pipeline
+1. Input Detection (URL vs file path)
+2. Transcription (youtube-api or AssemblyAI)
+3. Theme Classification (keyword matching)
+4. Knowledge Extraction (AI-powered)
+5. File Organization (by theme)
+
+## Output Format
+- Markdown files in KNOWLEDGE/ subfolders
+- Standard structure: Resumo, Visao, Fonte
+```
+
+### Step 5: Integration Architecture
+
+Create `docs/architecture/04-integrations.md`:
+
+```markdown
+# Integrations
+
+## APIs
+| Service | Purpose | Auth |
+|---------|---------|------|
+| YouTube Transcript API | Fetch video transcripts | None |
+| AssemblyAI | Transcribe local files | API Key |
+
+## MCPs (Model Context Protocol)
+| MCP | Purpose |
+|-----|---------|
+| filesystem | Local file access |
+
+## Environment Variables
+| Variable | Purpose |
+|----------|---------|
+| ASSEMBLYAI_API_KEY | AssemblyAI authentication |
+```
+
+### Step 6: Generate Diagrams (if --mermaid or --full-suite)
+
+Create `docs/architecture/diagrams/`:
+
+```mermaid
+graph TD
+    A[User] -->|Drops content| B[inbox]
+    B -->|Video URL| C[YouTube API]
+    B -->|Local file| D[AssemblyAI]
+    C --> E[Transcript]
+    D --> E
+    E -->|/extract-knowledge| F[B2B Sales Agent]
+    F -->|Classify| G[Knowledge Themes]
+    G --> H[01-estrutura-time]
+    G --> I[02-processo-vendas]
+    G --> J[03-contratacao]
+    G --> K[...]
+```
+
+## Output
+
+Creates the following structure:
+```
+docs/
+└── architecture/
+    ├── 01-system-context.md
+    ├── 02-components.md
+    ├── 03-data-flow.md
+    ├── 04-integrations.md
+    └── diagrams/
+        └── system-overview.mmd
+```
+
+## Usage Examples
+
+```
+# Basic documentation
+/documentation/create-architecture-documentation
+
+# With Mermaid diagrams
+/documentation/create-architecture-documentation --mermaid
+
+# Full documentation suite
+/documentation/create-architecture-documentation --full-suite
+```

package/.claude/commands/dossiers.md

@@ -0,0 +1,180 @@
+---
+description: Mostra status dos dossies de pessoas e temas
+argument-hint: [--persons] [--themes] [--incomplete] [--person "Name"]
+---
+
+# DOSSIERS - Status dos Dossiês
+
+> **Versão:** 1.0.0
+
+---
+
+## SINTAXE
+
+```
+/dossiers [FLAGS]
+```
+
+| Flag | Descrição |
+|------|-----------|
+| (nenhuma) | Lista todos dossiers |
+| `--persons` | Apenas dossiers de pessoas |
+| `--themes` | Apenas dossiers de temas |
+| `--incomplete` | Dossiers criados por atalho (sem rastreabilidade) |
+| `--person "Nome"` | Dossier específico |
+
+---
+
+## EXECUÇÃO
+
+### Step 1: Scan Dossiers
+```
+SCAN /knowledge/dossiers/persons/ for DOSSIER-*.md
+SCAN /knowledge/dossiers/THEMES/ for DOSSIER-*.md
+
+FOR each dossier:
+  READ header for: last_updated, sources, version
+  COUNT sections
+  CHECK for rastreabilidade (chunk_refs present)
+```
+
+### Step 2: Verificar Integridade
+```
+FOR each dossier:
+  VERIFY sources exist in CHUNKS-STATE.json
+  VERIFY insights_included are valid
+  FLAG if missing rastreabilidade
+```
+
+### Step 3: Gerar DOSSIERS STATUS
+```
+═══════════════════════════════════════════════════════════════════════════════
+                              DOSSIERS STATUS
+                         {TIMESTAMP}
+═══════════════════════════════════════════════════════════════════════════════
+
+📁 TOTAIS:
+   Pessoas: {N} dossiers
+   Temas: {N} dossiers
+
+───────────────────────────────────────────────────────────────────────────────
+
+👤 DOSSIERS DE PESSOAS:
+
+   DOSSIER-Cole-Gordon.md
+   ├─ Atualizado: {DATE} │ Versão: v{N}
+   ├─ Fontes: CG001, CG002, CG003, CG004
+   ├─ Chunks: {N} │ Insights: {N}
+   └─ Status: ✅ COMPLETO
+
+   DOSSIER-Jordan-Lee.md
+   ├─ Atualizado: {DATE} │ Versão: v{N}
+   ├─ Fontes: JL001-JL007, CJ001, MT001
+   ├─ Chunks: {N} │ Insights: {N}
+   └─ Status: ✅ COMPLETO
+
+   DOSSIER-Jeremy-Haynes.md
+   ├─ Atualizado: {DATE} │ Versão: v{N}
+   ├─ Fontes: JH001
+   ├─ Chunks: {N} │ Insights: {N}
+   └─ Status: ✅ COMPLETO
+
+───────────────────────────────────────────────────────────────────────────────
+
+📚 DOSSIERS DE TEMAS:
+
+   DOSSIER-Processo-Vendas.md
+   ├─ Atualizado: {DATE}
+   ├─ Pessoas: Cole Gordon, Jordan Lee, Jeremy Haynes
+   └─ Status: ✅ COMPLETO
+
+   DOSSIER-Comissionamento.md
+   ├─ Atualizado: {DATE}
+   ├─ Pessoas: Cole Gordon
+   └─ Status: ✅ COMPLETO
+
+═══════════════════════════════════════════════════════════════════════════════
+```
+
+---
+
+## OUTPUT COM --incomplete
+
+```
+═══════════════════════════════════════════════════════════════════════════════
+                         DOSSIERS INCOMPLETOS
+                         {TIMESTAMP}
+═══════════════════════════════════════════════════════════════════════════════
+
+⚠️ DOSSIERS SEM RASTREABILIDADE COMPLETA:
+
+   DOSSIER-{NAME}.md
+   ├─ Problema: Criado por atalho (sem passar pelo Pipeline Jarvis)
+   ├─ Faltam: chunk_refs, source_ids
+   └─ Sugestão: Reprocessar fonte original
+
+   DOSSIER-{NAME}.md
+   ├─ Problema: insights_included referencia chunks inexistentes
+   ├─ Chunks órfãos: {LIST}
+   └─ Sugestão: Reconstruir via /rebuild-state
+
+═══════════════════════════════════════════════════════════════════════════════
+```
+
+---
+
+## OUTPUT COM --person "Nome"
+
+```
+═══════════════════════════════════════════════════════════════════════════════
+                    DOSSIER: {PESSOA}
+                         {TIMESTAMP}
+═══════════════════════════════════════════════════════════════════════════════
+
+📄 ARQUIVO: /knowledge/dossiers/persons/DOSSIER-{PESSOA}.md
+
+📊 METADADOS:
+   Versão: v{N}
+   Última atualização: {DATE}
+   Fontes: {SOURCE_IDS}
+
+📚 CONTEÚDO:
+   Insights: {N} total ({HIGH} HIGH, {MED} MEDIUM, {LOW} LOW)
+   Frameworks: {N}
+   Tensões: {N}
+   Open Loops: {N}
+
+🔗 RASTREABILIDADE:
+   Chunks referenciados: {N}
+   Todos válidos: ✅
+
+🤖 AGENTES COM ESTE CONHECIMENTO:
+   CLOSER, CRO, SALES-MANAGER
+
+⭐️ AÇÕES
+   Abrir: code "/knowledge/dossiers/persons/DOSSIER-{PESSOA}.md"
+   Reprocessar: /process-jarvis [sources]
+
+═══════════════════════════════════════════════════════════════════════════════
+```
+
+---
+
+## EXEMPLOS
+
+```bash
+# Ver todos dossiers
+/dossiers
+
+# Apenas pessoas
+/dossiers --persons
+
+# Apenas temas
+/dossiers --themes
+
+# Ver dossier específico
+/dossiers --person "Cole Gordon"
+
+# Ver incompletos
+/dossiers --incomplete
+```

package/.claude/commands/evolve.md

@@ -0,0 +1,223 @@
+# /evolve - Evolução Autônoma do Sistema
+
+---
+name: evolve
+description: Ativa agentes de evolução para melhorar o Mega Brain
+version: 1.0.0
+author: JARVIS
+triggers:
+  - /evolve
+  - evolua o sistema
+  - melhore o projeto
+---
+
+## PROPÓSITO
+
+Ativar o ciclo de evolução autônoma do Mega Brain, coordenando os agentes:
+- **EVOLVER** - Identifica gaps e implementa melhorias
+- **CRITIC** - Questiona e valida mudanças
+- **BENCHMARK** - Compara com melhores práticas
+
+---
+
+## COMANDOS
+
+### Evolução Completa
+
+```
+/evolve                    → Ciclo completo (scan + analyze + propose + execute)
+```
+
+### Modos Específicos
+
+```
+/evolve --scan             → Apenas escaneia o sistema (read-only)
+/evolve --analyze          → Scan + análise de gaps
+/evolve --propose          → Scan + análise + propostas (sem execução)
+/evolve --execute [id]     → Executa melhoria específica aprovada
+/evolve --report           → Gera relatório de evolução
+```
+
+### Opções
+
+```
+/evolve --quick            → Versão rápida (apenas métricas)
+/evolve --deep             → Análise profunda (todas as dimensões)
+/evolve --auto             → Executa melhorias automáticas (low-risk)
+/evolve --dry-run          → Simula sem fazer mudanças
+```
+
+---
+
+## WORKFLOW DE EXECUÇÃO
+
+```
+/evolve (ciclo completo)
+│
+├── 1. SCAN
+│   ├── Ler MISSION-STATE.json
+│   ├── Verificar integridade de arquivos
+│   ├── Catalogar estado atual
+│   └── Gerar SCAN-SNAPSHOT.json
+│
+├── 2. ANALYZE
+│   ├── Comparar com estado ideal
+│   ├── Identificar gaps por categoria:
+│   │   ├── KNOWLEDGE (fontes, dossiers, DNAs)
+│   │   ├── AUTOMATION (scripts, workflows)
+│   │   ├── AGENTS (MEMORYs, definições)
+│   │   └── SYSTEM (logs, configs, docs)
+│   └── Calcular health score
+│
+├── 3. PROPOSE
+│   ├── Gerar lista de melhorias
+│   ├── Priorizar por impacto/esforço
+│   ├── Classificar por risco:
+│   │   ├── AUTO (executar automaticamente)
+│   │   ├── REVIEW (requer aprovação)
+│   │   └── MAJOR (requer planejamento)
+│   └── Consultar AGENT-CRITIC
+│
+├── 4. EXECUTE (melhorias AUTO apenas)
+│   ├── Executar melhorias low-risk
+│   ├── Logar todas as ações
+│   └── Atualizar estados
+│
+└── 5. REPORT
+    ├── Gerar EVOLUTION-REPORT.md
+    ├── Listar melhorias REVIEW pendentes
+    └── Sugerir próximos passos
+```
+
+---
+
+## CATEGORIAS DE MELHORIA
+
+### AUTO (Execução Automática)
+
+```
+Melhorias que podem ser executadas sem aprovação:
+├── Limpeza de arquivos temporários
+├── Regeneração de índices
+├── Atualização de timestamps
+├── Correção de typos em docs
+├── Normalização de formatação
+└── Atualização de métricas
+```
+
+### REVIEW (Requer Aprovação)
+
+```
+Melhorias que requerem validação:
+├── Novos comandos
+├── Novos agentes
+├── Mudanças em templates
+├── Refatoração de scripts
+└── Atualizações de regras
+```
+
+### MAJOR (Requer Planejamento)
+
+```
+Mudanças estruturais:
+├── Mudanças em CLAUDE.md
+├── Nova arquitetura
+├── Novas integrações (MCPs)
+├── Refatoração grande
+└── Mudanças em pipeline
+```
+
+---
+
+## OUTPUT ESPERADO
+
+### Após /evolve
+
+```
+╔══════════════════════════════════════════════════════════════════════════════╗
+║                         EVOLUTION CYCLE COMPLETE                             ║
+╠══════════════════════════════════════════════════════════════════════════════╣
+║  Timestamp: YYYY-MM-DD HH:MM                                                ║
+║  Duration: X minutes                                                        ║
+║  Health Score: XX/100 (↑/↓ vs last)                                         ║
+╚══════════════════════════════════════════════════════════════════════════════╝
+
+┌──────────────────────────────────────────────────────────────────────────────┐
+│                              SCAN RESULTS                                    │
+├──────────────────────────────────────────────────────────────────────────────┤
+│  Files scanned:        XXXX                                                 │
+│  Agents verified:      XX                                                   │
+│  Commands checked:     XX                                                   │
+│  Scripts analyzed:     XX                                                   │
+└──────────────────────────────────────────────────────────────────────────────┘
+
+┌──────────────────────────────────────────────────────────────────────────────┐
+│                              GAPS IDENTIFIED                                 │
+├──────────────────────────────────────────────────────────────────────────────┤
+│  [CRITICAL] X gaps                                                          │
+│  [HIGH]     X gaps                                                          │
+│  [MEDIUM]   X gaps                                                          │
+│  [LOW]      X gaps                                                          │
+└──────────────────────────────────────────────────────────────────────────────┘
+
+┌──────────────────────────────────────────────────────────────────────────────┐
+│                           ACTIONS TAKEN (AUTO)                               │
+├──────────────────────────────────────────────────────────────────────────────┤
+│  ✅ [action 1]                                                              │
+│  ✅ [action 2]                                                              │
+│  ✅ [action 3]                                                              │
+└──────────────────────────────────────────────────────────────────────────────┘
+
+┌──────────────────────────────────────────────────────────────────────────────┐
+│                         PENDING REVIEW (X items)                             │
+├──────────────────────────────────────────────────────────────────────────────┤
+│  1. [REVIEW] [description] - /evolve --execute 001                          │
+│  2. [REVIEW] [description] - /evolve --execute 002                          │
+│  3. [MAJOR]  [description] - Requires planning                              │
+└──────────────────────────────────────────────────────────────────────────────┘
+
+➡️  Top 3 recommendations:
+   1. [recommendation]
+   2. [recommendation]
+   3. [recommendation]
+```
+
+---
+
+## INTEGRAÇÃO COM AGENTES
+
+```
+/evolve invoca:
+├── AGENT-EVOLVER → Executa o ciclo de evolução
+├── AGENT-CRITIC → Valida propostas antes de executar
+├── AGENT-BENCHMARK → Fornece referências de melhores práticas
+└── JARVIS → Coordena e reporta
+```
+
+---
+
+## SCHEDULING (Futuro)
+
+```
+Quando integrado com GitHub Actions:
+├── Diário (06:00 UTC): /evolve --quick
+├── Semanal (Sunday): /evolve --deep + /benchmark
+└── On-demand: Via comando ou trigger
+```
+
+---
+
+## LOGS
+
+```
+Location: /logs/EVOLUTION/
+├── EVOLUTION-YYYY-MM-DD.md       → Relatório diário
+├── EVOLUTION-ACTIONS.jsonl        → Ações executadas
+├── EVOLUTION-PROPOSALS.jsonl      → Propostas pendentes
+└── EVOLUTION-METRICS.json         → Histórico de health scores
+```
+
+---
+
+**JARVIS COMMAND v1.0.0**
+*Evolução contínua do Mega Brain*