mega-brain-ai 1.3.0

package/.claude/skills/resume/SKILL.md

@@ -0,0 +1,61 @@
+# RESUME SESSION - Recuperação de Contexto
+
+## Trigger
+`/resume` ou ao iniciar nova conversa
+
+## Objetivo
+Recuperar o contexto COMPLETO da última sessão para continuar de onde parou.
+
+## Execução
+
+### 1. Localizar Última Sessão
+Ler `.claude/sessions/LATEST-SESSION.md` para encontrar a sessão mais recente.
+
+### 2. Carregar Contexto
+Ler o arquivo de sessão completo e extrair:
+- Estado da missão
+- Fase atual
+- Pendências
+- Próximos passos
+- Decisões tomadas
+- Notas importantes
+
+### 3. Apresentar Resumo de Retomada
+
+```
+┌──────────────────────────────────────────────────────────────────────────────┐
+│  🔄 RETOMANDO SESSÃO                                                         │
+│                                                                              │
+│  Última atividade: [DATA/HORA]                                              │
+│  Duração desde última sessão: [X horas/dias]                                │
+│                                                                              │
+│  📍 ONDE PARAMOS:                                                            │
+│  Missão: [NOME]                                                              │
+│  Fase: [N] de 5 - [NOME_FASE]                                               │
+│  Progresso: [X]%                                                             │
+│                                                                              │
+│  📋 PENDÊNCIAS HERDADAS:                                                     │
+│  - [Pendência 1]                                                             │
+│  - [Pendência 2]                                                             │
+│                                                                              │
+│  ➡️ PRÓXIMO PASSO PLANEJADO:                                                 │
+│  [Descrição do próximo passo]                                                │
+│                                                                              │
+│  💡 DECISÕES ANTERIORES:                                                     │
+│  - [Decisão relevante]                                                       │
+│                                                                              │
+└──────────────────────────────────────────────────────────────────────────────┘
+```
+
+### 4. Perguntar Confirmação
+"Quer continuar de onde paramos ou precisa de algo diferente?"
+
+### 5. Listar Sessões Antigas (Opcional)
+Se usuário pedir, listar todas as sessões disponíveis:
+```
+/resume list - mostra todas as sessões salvas
+/resume [SESSION-ID] - carrega sessão específica
+```
+
+## Output
+Contexto recuperado + resumo visual + confirmação do usuário

package/.claude/skills/save/SKILL.md

@@ -0,0 +1,87 @@
+# SAVE SESSION - Persistência de Contexto
+
+## Trigger
+`/save` ou automaticamente ao final de cada tarefa significativa
+
+## Objetivo
+Salvar o estado COMPLETO da sessão atual para recuperação posterior.
+
+## Execução
+
+Quando acionado:
+
+### 1. Coletar Estado Atual
+```
+- Timestamp da sessão
+- Missão ativa (se houver)
+- Fase atual
+- Últimas ações executadas
+- Arquivos modificados
+- Pendências identificadas
+- Contexto de conversa (resumo estruturado)
+```
+
+### 2. Gerar SESSION-LOG
+Criar arquivo em `.claude/sessions/` com formato:
+```
+SESSION-YYYY-MM-DD-HHmm.md
+```
+
+### 3. Template Obrigatório
+
+```markdown
+# SESSION LOG - [TIMESTAMP]
+
+## ESTADO DA MISSÃO
+- **Missão**: [NOME]
+- **Fase**: [N] de 5
+- **Progresso**: [X]%
+
+## CONTEXTO DA CONVERSA
+[Resumo detalhado do que foi discutido/decidido]
+
+## AÇÕES EXECUTADAS
+1. [Ação 1 com detalhes]
+2. [Ação 2 com detalhes]
+...
+
+## ARQUIVOS MODIFICADOS
+- [arquivo1.ext] - [o que mudou]
+- [arquivo2.ext] - [o que mudou]
+
+## PENDÊNCIAS
+- [ ] [Pendência 1]
+- [ ] [Pendência 2]
+
+## DECISÕES TOMADAS
+- [Decisão 1]: [Razão]
+- [Decisão 2]: [Razão]
+
+## PRÓXIMOS PASSOS PLANEJADOS
+1. [Próximo passo 1]
+2. [Próximo passo 2]
+
+## NOTAS IMPORTANTES
+[Qualquer coisa crítica para não esquecer]
+
+---
+Session ID: [UUID]
+Saved at: [ISO timestamp]
+```
+
+### 4. Atualizar LATEST-SESSION.md
+Sempre manter um link para a última sessão em:
+`.claude/sessions/LATEST-SESSION.md`
+
+### 5. Confirmar
+Responder: "Sessão salva: SESSION-YYYY-MM-DD-HHmm.md"
+
+## Auto-Save Triggers
+- Após completar qualquer batch
+- Antes de qualquer operação destrutiva
+- A cada 30 minutos de atividade
+- Quando detectar pausa prolongada
+- Quando usuário expressar que vai sair
+
+## Output
+Arquivo de sessão + confirmação visual

package/.claude/skills/skill-creator-internal/SKILL.md

@@ -0,0 +1,186 @@
+# SKILL-CREATOR
+## Meta-Skill: Guia Automático para Criação de Skills
+
+> **Auto-Trigger:** Ativado quando detectar intenção de criar nova skill
+> **Keywords:** "criar skill", "nova skill", "skill para", "automatizar"
+> **Prioridade:** ALTA
+
+---
+
+## PROPÓSITO
+
+Esta skill guia a criação de novas skills no sistema Mega Brain, garantindo:
+- Estrutura padronizada
+- Triggers bem definidos
+- Integração automática
+- Documentação completa
+
+---
+
+## ESTRUTURA OBRIGATÓRIA DE UMA SKILL
+
+```
+/SKILLS/
+└── [NOME-DA-SKILL]/
+    ├── SKILL.md           # Arquivo principal (OBRIGATÓRIO)
+    ├── EXAMPLES/          # Exemplos de uso (opcional)
+    │   ├── good.md        # Exemplos corretos
+    │   └── bad.md         # Anti-patterns
+    └── TEMPLATES/         # Templates reutilizáveis (opcional)
+```
+
+---
+
+## TEMPLATE DE SKILL.md
+
+```markdown
+# [NOME DA SKILL]
+## [Descrição em uma linha]
+
+> **Auto-Trigger:** [Quando esta skill é ativada automaticamente]
+> **Keywords:** [palavras-chave que ativam, separadas por vírgula]
+> **Prioridade:** [ALTA | MÉDIA | BAIXA]
+
+---
+
+## PROPÓSITO
+
+[Explique O QUE esta skill faz e POR QUE existe]
+
+---
+
+## QUANDO USAR
+
+### ✅ USAR quando:
+- [Situação 1]
+- [Situação 2]
+- [Situação 3]
+
+### ❌ NÃO USAR quando:
+- [Situação 1]
+- [Situação 2]
+
+---
+
+## REGRAS OBRIGATÓRIAS
+
+### [Categoria 1]
+| Regra | Valor/Padrão |
+|-------|--------------|
+| [Item] | [Especificação] |
+
+### [Categoria 2]
+- [Regra 1]
+- [Regra 2]
+
+---
+
+## ANTI-PATTERNS (NUNCA FAZER)
+
+1. ❌ [O que não fazer]
+2. ❌ [O que não fazer]
+
+---
+
+## CHECKLIST PRÉ-ENTREGA
+
+- [ ] [Verificação 1]
+- [ ] [Verificação 2]
+- [ ] [Verificação 3]
+
+---
+
+## EXEMPLOS
+
+### ✅ Correto
+\`\`\`
+[Exemplo de uso correto]
+\`\`\`
+
+### ❌ Incorreto
+\`\`\`
+[Exemplo de uso incorreto]
+\`\`\`
+```
+
+---
+
+## REGRAS PARA CRIAR SKILLS
+
+### 1. Naming Convention
+```
+SKILL-[DOMÍNIO]-[FUNÇÃO].md
+
+Exemplos:
+- SKILL-PYTHON-PROCESSING.md
+- SKILL-DOCS-PLAYBOOK.md
+- SKILL-AGENT-CREATION.md
+```
+
+### 2. Auto-Triggers Obrigatórios
+
+Toda skill DEVE ter triggers claros:
+
+| Tipo de Trigger | Exemplo |
+|-----------------|---------|
+| **Keyword** | "criar playbook", "processar vídeo" |
+| **Contexto** | Quando arquivo .py é criado |
+| **Extensão** | Quando output é .md, .json, .py |
+| **Comando** | /process, /create-agent |
+
+### 3. Prioridade de Skills
+
+Quando múltiplas skills aplicam:
+
+```
+ALTA    → Sempre aplicar primeiro
+MÉDIA   → Aplicar se não conflitar
+BAIXA   → Aplicar apenas se explicitamente relevante
+```
+
+### 4. Composição de Skills
+
+Skills podem chamar outras:
+
+```markdown
+## DEPENDÊNCIAS
+- Requer: SKILL-DOCS-FORMATTING
+- Complementa: SKILL-PYTHON-STANDARDS
+```
+
+---
+
+## CHECKLIST PARA NOVA SKILL
+
+Antes de finalizar uma skill, verificar:
+
+- [ ] Nome segue convenção SKILL-[DOMÍNIO]-[FUNÇÃO]
+- [ ] Auto-Trigger definido claramente
+- [ ] Keywords listadas (mínimo 3)
+- [ ] Prioridade definida
+- [ ] Seção "QUANDO USAR" completa
+- [ ] Seção "ANTI-PATTERNS" presente
+- [ ] Checklist pré-entrega incluído
+- [ ] Pelo menos 1 exemplo correto e 1 incorreto
+- [ ] Integração com outras skills documentada
+
+---
+
+## REGISTRO DE SKILLS
+
+Ao criar nova skill, registrar em `/SKILLS/SKILL-REGISTRY.md`:
+
+```markdown
+| Skill | Domínio | Triggers | Prioridade | Status |
+|-------|---------|----------|------------|--------|
+| SKILL-X | Python | .py, código | ALTA | Ativo |
+```
+
+---
+
+## META-INFORMAÇÃO
+
+- **Versão:** 1.0.0
+- **Criado:** Janeiro 2025
+- **Domínio:** Sistema
+- **Dependências:** Nenhuma (skill raiz)

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

@@ -0,0 +1,153 @@
+---
+name: skill-writer
+description: Guide users through creating Agent Skills for Claude Code. Use when the user wants to create, write, author, or design a new Skill, or needs help with SKILL.md files, frontmatter, or skill structure.
+allowed-tools: Read, Grep, Glob, Write, Edit, Bash(mkdir:*), Bash(ls:*)
+---
+
+# Skill Writer
+
+Create well-structured Agent Skills for Claude Code following best practices.
+
+## Quick start
+
+```yaml
+---
+name: my-skill-name
+description: What this does. Use when user mentions X, Y, or Z.
+---
+
+# My Skill Name
+
+Instructions for Claude here...
+```
+
+## When to use this Skill
+
+- Creating a new Agent Skill
+- Writing or updating SKILL.md files
+- Designing skill structure and frontmatter
+- Converting existing prompts into Skills
+
+## Instructions
+
+### Step 1: Determine scope
+
+Ask clarifying questions:
+- What specific capability should this Skill provide?
+- When should Claude use this Skill?
+- What tools or resources does it need?
+
+**Rule**: One Skill = one capability
+
+### Step 2: Choose location
+
+| Location | Use Case |
+|----------|----------|
+| `~/.claude/skills/` | Personal, experimental |
+| `.claude/skills/` | Team/project, git-tracked |
+
+### Step 3: Create structure
+
+```bash
+mkdir -p .claude/skills/skill-name
+```
+
+Multi-file structure:
+```
+skill-name/
+├── SKILL.md (required)
+├── reference.md (optional)
+├── examples.md (optional)
+└── scripts/ (optional)
+```
+
+### Step 4: Write frontmatter
+
+```yaml
+---
+name: skill-name
+description: Brief description of what this does and when to use it
+---
+```
+
+| Field | Rules |
+|-------|-------|
+| `name` | Lowercase, hyphens, max 64 chars, **must match folder name** |
+| `description` | Max 1024 chars, include WHAT + WHEN to use |
+| `allowed-tools` | (Optional) Restrict tool access |
+
+### Step 5: Write effective descriptions
+
+**Formula**: `[What it does] + [When to use it] + [Key triggers]`
+
+```yaml
+# Good
+description: Extract text from PDFs, fill forms. Use when working with PDF files or document extraction.
+
+# Bad
+description: Helps with documents
+```
+
+Tips:
+- Include file extensions (.pdf, .xlsx)
+- Use trigger words ("analyze", "extract", "generate")
+- Add "Use when..." clause
+
+### Step 6: Structure content
+
+```markdown
+# Skill Name
+
+Brief overview.
+
+## Quick start
+
+Simple example.
+
+## Instructions
+
+Step-by-step guidance.
+
+## Requirements
+
+Dependencies if any.
+```
+
+### Step 7: Validate
+
+- [ ] SKILL.md exists in correct location
+- [ ] Directory name matches frontmatter `name`
+- [ ] YAML valid (no tabs, spaces only)
+- [ ] Description < 1024 chars, includes what + when
+- [ ] Instructions are actionable
+
+### Step 8: Test
+
+1. Restart Claude Code to load Skill
+2. Ask questions matching the description
+3. Verify activation and behavior
+
+## Additional resources
+
+- **Patterns and examples**: See [examples.md](examples.md)
+- **Debugging issues**: See [troubleshooting.md](troubleshooting.md)
+
+## Output format
+
+When creating a Skill, I will:
+
+1. Ask clarifying questions about scope
+2. Suggest name and location
+3. Create SKILL.md with proper frontmatter
+4. Include instructions and examples
+5. Add supporting files if needed
+6. Validate against requirements
+
+## Best practices summary
+
+1. **One Skill, one purpose**
+2. **Specific descriptions** with trigger words
+3. **Clear instructions** written for Claude
+4. **Concrete examples** with real code
+5. **Progressive disclosure** for complex Skills
+6. **Under 500 lines** in SKILL.md

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

@@ -0,0 +1,191 @@
+# Skill Examples
+
+Common patterns and templates for creating Skills.
+
+## Read-only Skill
+
+For Skills that only analyze without modifying:
+
+```yaml
+---
+name: code-reader
+description: Read and analyze code without making changes. Use for code review, understanding codebases, or documentation.
+allowed-tools: Read, Grep, Glob
+---
+
+# Code Reader
+
+Analyze code structure and patterns without making modifications.
+
+## Instructions
+
+1. Use Glob to find relevant files
+2. Use Read to examine content
+3. Use Grep to search patterns
+4. Report findings without editing
+```
+
+## Script-based Skill
+
+For Skills that use helper scripts:
+
+```yaml
+---
+name: data-processor
+description: Process CSV and JSON data files with Python scripts. Use when analyzing data files or transforming datasets.
+---
+
+# Data Processor
+
+## Instructions
+
+1. Use the processing script:
+```bash
+python scripts/process.py input.csv --output results.json
+```
+
+2. Validate output:
+```bash
+python scripts/validate.py results.json
+```
+
+## Requirements
+
+```bash
+pip install pandas
+```
+```
+
+## Multi-file Skill (Progressive Disclosure)
+
+For complex Skills with extensive documentation:
+
+```yaml
+---
+name: api-designer
+description: Design REST APIs following best practices. Use when creating API endpoints, designing routes, or planning API architecture.
+---
+
+# API Designer
+
+Quick start: See [examples.md](examples.md)
+
+Detailed reference: See [reference.md](reference.md)
+
+## Instructions
+
+1. Gather requirements
+2. Design endpoints (see examples.md)
+3. Document with OpenAPI spec
+4. Review against best practices (see reference.md)
+```
+
+## Description Examples
+
+### Good Descriptions
+
+```yaml
+# Specific actions + file types + trigger words
+description: Extract text and tables from PDF files, fill forms, merge documents. Use when working with PDF files or when the user mentions PDFs, forms, or document extraction.
+
+# Clear scope + when to use
+description: Analyze Excel spreadsheets, create pivot tables, and generate charts. Use when working with Excel files, spreadsheets, or analyzing tabular data in .xlsx format.
+
+# Action-oriented + context
+description: Generate git commit messages following conventional commits format. Use when the user wants to commit changes or needs help writing commit messages.
+```
+
+### Bad Descriptions
+
+```yaml
+# Too vague
+description: Helps with documents
+
+# No trigger context
+description: For data analysis
+
+# Too broad
+description: General purpose tool for files
+```
+
+## Validation Checklist Template
+
+Include this in your Skill for self-validation:
+
+```markdown
+## Validation checklist
+
+Before finalizing, verify:
+
+- [ ] Name is lowercase, hyphens only, max 64 chars
+- [ ] Name matches directory name exactly
+- [ ] Description < 1024 chars
+- [ ] Description includes "what" and "when"
+- [ ] YAML frontmatter has no tabs
+- [ ] Instructions are step-by-step
+- [ ] Examples use real code
+- [ ] Dependencies documented
+- [ ] File paths use forward slashes
+```
+
+## File Structure Examples
+
+### Minimal Skill (single file)
+
+```
+commit-helper/
+└── SKILL.md
+```
+
+### Standard Skill (with examples)
+
+```
+pdf-processor/
+├── SKILL.md
+└── examples.md
+```
+
+### Complex Skill (full structure)
+
+```
+api-designer/
+├── SKILL.md
+├── reference.md
+├── examples.md
+├── templates/
+│   └── openapi.yaml
+└── scripts/
+    └── validate.py
+```
+
+## Frontmatter Options
+
+### Basic (required fields only)
+
+```yaml
+---
+name: my-skill
+description: What it does. Use when X happens.
+---
+```
+
+### With tool restrictions
+
+```yaml
+---
+name: my-skill
+description: What it does. Use when X happens.
+allowed-tools: Read, Grep, Glob, Write, Edit
+---
+```
+
+### Full options
+
+```yaml
+---
+name: my-skill
+description: What it does. Use when X happens.
+allowed-tools: Read, Grep, Glob
+model: claude-sonnet-4-20250514
+---
+```