mega-brain-ai 1.3.0

package/.claude/commands/benchmark.md

@@ -0,0 +1,224 @@
+# /benchmark - Comparação com Melhores Práticas
+
+---
+name: benchmark
+description: Compara o Mega Brain com as melhores práticas da indústria
+version: 1.0.0
+author: JARVIS
+triggers:
+  - /benchmark
+  - compare com melhores práticas
+  - benchmark do sistema
+---
+
+## PROPÓSITO
+
+Executar análise comparativa do Mega Brain contra as melhores práticas de:
+- Arquitetura de conhecimento (Notion, Obsidian, PARA, Zettelkasten)
+- Automação e IA (Claude Code workflows, Langchain, CrewAI)
+- Gestão de vendas (Hormozi, Cole Gordon, Miner, Sandler)
+- Gestão de projetos (Shape Up, OKRs, EOS, GTD)
+
+---
+
+## COMANDOS
+
+### Benchmark Completo
+
+```
+/benchmark                        → Executa benchmark completo (todas as dimensões)
+```
+
+### Modos Específicos
+
+```
+/benchmark --dimension knowledge   → Apenas arquitetura de conhecimento
+/benchmark --dimension automation  → Apenas automação e IA
+/benchmark --dimension sales       → Apenas vendas
+/benchmark --dimension projects    → Apenas gestão de projetos
+```
+
+### Opções
+
+```
+/benchmark --quick                 → Versão rápida (scores apenas)
+/benchmark --compare [source]      → Compara com fonte específica
+/benchmark --history               → Mostra evolução dos scores
+/benchmark --gaps                  → Lista apenas gaps identificados
+```
+
+---
+
+## WORKFLOW DE EXECUÇÃO
+
+```
+/benchmark
+│
+├── 1. COLETA
+│   ├── Snapshot do estado atual
+│   ├── Buscar referências (context7, web)
+│   ├── Coletar métricas atuais
+│   └── Identificar mudanças desde último benchmark
+│
+├── 2. ANÁLISE
+│   ├── Comparar com cada área de benchmark
+│   ├── Calcular scores por dimensão (0-100)
+│   ├── Identificar gaps críticos
+│   └── Priorizar por impacto
+│
+├── 3. SCORING
+│   │
+│   │  DIMENSÕES (25% cada):
+│   │  ├── Knowledge Architecture
+│   │  │   ├── structure_clarity
+│   │  │   ├── navigation_ease
+│   │  │   ├── linking_quality
+│   │  │   ├── update_freshness
+│   │  │   └── discovery_support
+│   │  │
+│   │  ├── Automation Maturity
+│   │  │   ├── task_automation_rate
+│   │  │   ├── error_handling
+│   │  │   ├── self_healing
+│   │  │   ├── async_capability
+│   │  │   └── integration_breadth
+│   │  │
+│   │  ├── Sales Excellence
+│   │  │   ├── playbook_coverage
+│   │  │   ├── script_quality
+│   │  │   ├── objection_handling
+│   │  │   ├── metrics_tracking
+│   │  │   └── team_structure
+│   │  │
+│   │  └── Project Management
+│   │      ├── goal_clarity
+│   │      ├── progress_tracking
+│   │      ├── prioritization
+│   │      ├── execution_rate
+│   │      └── review_cadence
+│   │
+│   └── Overall Score = weighted_avg(all_dimensions)
+│
+├── 4. RECOMENDAÇÕES
+│   ├── Gerar lista de melhorias ordenada
+│   ├── Estimar esforço vs impacto
+│   ├── Criar action items específicos
+│   └── Propor próximos passos
+│
+└── 5. REPORT
+    ├── Gerar BENCHMARK-REPORT-YYYY-WW.md
+    ├── Atualizar BENCHMARK-SCORES.json
+    └── Criar propostas em /evolve queue
+```
+
+---
+
+## OUTPUT ESPERADO
+
+```
+╔══════════════════════════════════════════════════════════════════════════════╗
+║                         BENCHMARK REPORT                                     ║
+║                    Mega Brain vs Melhores Práticas                           ║
+╠══════════════════════════════════════════════════════════════════════════════╣
+║  Data: YYYY-MM-DD                                                            ║
+║  Overall Score: XX/100                                                       ║
+║  Trend: ↑/↓/→ vs last week                                                   ║
+╚══════════════════════════════════════════════════════════════════════════════╝
+
+┌──────────────────────────────────────────────────────────────────────────────┐
+│                           SCORES POR DIMENSÃO                                │
+├──────────────────────────────────────────────────────────────────────────────┤
+│  Knowledge Architecture  │ ████████████████████░░░░ │ 80/100 │ ↑ +5         │
+│  Automation Maturity     │ ██████████████████░░░░░░ │ 72/100 │ ↑ +3         │
+│  Sales Excellence        │ ██████████████████████░░ │ 88/100 │ → 0          │
+│  Project Management      │ ██████████████░░░░░░░░░░ │ 56/100 │ ↓ -2         │
+└──────────────────────────────────────────────────────────────────────────────┘
+
+┌──────────────────────────────────────────────────────────────────────────────┐
+│                            TOP 5 GAPS                                        │
+├──────────────────────────────────────────────────────────────────────────────┤
+│  1. [CRITICAL] ClickUp integration missing                                   │
+│     Reference: Process Auditor AIOS                                            │
+│     Impact: HIGH | Effort: MEDIUM                                            │
+│                                                                              │
+│  2. [HIGH] No automated KPI tracking                                         │
+│     Reference: OKR methodology                                               │
+│     Impact: HIGH | Effort: HIGH                                              │
+│                                                                              │
+│  3. [MEDIUM] Web agents not configured                                       │
+│     Reference: Boris Churney workflow                                        │
+│     Impact: MEDIUM | Effort: LOW                                             │
+└──────────────────────────────────────────────────────────────────────────────┘
+
+┌──────────────────────────────────────────────────────────────────────────────┐
+│                       PRÁTICAS DESCOBERTAS                                   │
+├──────────────────────────────────────────────────────────────────────────────┤
+│  ✨ [context7] New documentation pattern for skills                          │
+│  ✨ [web] ClickUp + n8n integration best practices                           │
+│  ✨ [internal] Council debate improving decision quality                     │
+└──────────────────────────────────────────────────────────────────────────────┘
+
+➡️  RECOMENDAÇÕES:
+   1. Instalar ClickUp MCP e configurar integração
+   2. Configurar web agents no claude.ai
+   3. Criar dashboard de KPIs automatizado
+```
+
+---
+
+## INTERPRETAÇÃO DE SCORES
+
+```yaml
+score_interpretation:
+  90-100: "World class - referência para outros"
+  80-89:  "Excellent - poucos gaps"
+  70-79:  "Good - algumas melhorias necessárias"
+  60-69:  "Needs improvement - gaps significativos"
+  below_60: "Critical - ação urgente necessária"
+```
+
+---
+
+## INTEGRAÇÃO
+
+### Com AGENT-BENCHMARK
+
+O comando `/benchmark` ativa o AGENT-BENCHMARK que:
+1. Executa a coleta e análise
+2. Consulta fontes externas (context7, web)
+3. Gera relatório estruturado
+4. Cria propostas para `/evolve`
+
+### Com /evolve
+
+Gaps identificados são automaticamente:
+1. Categorizados por risco (AUTO/REVIEW/MAJOR)
+2. Adicionados à queue do EVOLVER
+3. Priorizados por impacto/esforço
+
+---
+
+## AGENDAMENTO
+
+```
+Manual:     /benchmark (on-demand)
+Automático: Domingo 06:00 UTC (via GitHub Actions - futuro)
+Trigger:    Quando health score < 70
+```
+
+---
+
+## LOGS
+
+```
+Location: /logs/BENCHMARK/
+├── BENCHMARK-YYYY-WW.md          → Relatório semanal
+├── BENCHMARK-SCORES.json         → Histórico de scores
+├── BENCHMARK-GAPS.jsonl          → Gaps identificados
+└── BENCHMARK-PRACTICES.jsonl     → Práticas descobertas
+```
+
+---
+
+**JARVIS COMMAND v1.0.0**
+*Nunca pare de comparar com os melhores*

package/.claude/commands/chat.md

@@ -0,0 +1,343 @@
+# MEGA BRAIN - LOG DE ABERTURA COMPLETO
+## Sistema de Inteligencia Operacional
+
+---
+
+## INSTRUÇÃO CRÍTICA: SEMPRE MOSTRAR LOG DE MODIFICAÇÕES
+
+> **REGRA INVIOLÁVEL:** Ao iniciar QUALQUER sessão, ANTES do dashboard padrão, mostrar:
+> 1. **LOG DE MODIFICAÇÕES DA ÚLTIMA SESSÃO** (formato tabela)
+> 2. **GRANDIOSO RESUMO** de onde paramos
+> 3. **PRÓXIMAS ETAPAS** sugeridas
+>
+> Ler `/system/SESSION-STATE.md` seção "ÚLTIMA SESSÃO" para obter esses dados.
+
+---
+
+## GATILHOS DE ATIVACAO
+
+Este log aparece quando:
+1. Usuario digita "Mega Brain" ou "abra o Mega Brain"
+2. Primeira mensagem apos reabrir o projeto
+3. Comando explicito `/status` ou `/welcome`
+4. Apos periodo de inatividade (>1h desde ultima mensagem)
+
+---
+
+## ACAO OBRIGATORIA
+
+Leia os seguintes arquivos em paralelo:
+
+```
+/system/SESSION-STATE.md           → Estado atual, ultima sessao
+/system/OPEN-LOOPS.json            → Loops pendentes
+/system/SESSION-HISTORY.json       → Historico de sessoes
+/system/EVOLUTION-LOG.md           → Changelog (primeiras 100 linhas)
+/processing/chunks/CHUNKS-STATE.json      → Total de chunks
+/processing/insights/INSIGHTS-STATE.json  → Total de insights
+/processing/narratives/NARRATIVES-STATE.json → Pessoas e temas
+```
+
+Liste tambem:
+- `ls /agents/SALES/` e `/agents/C-LEVEL/` → Contar agentes IA
+- `ls /agents/sua-empresa/roles/` → Contar ROLEs (cargos humanos)
+- `ls /agents/sua-empresa/jds/` → Contar Job Descriptions
+- `ls /agents/sua-empresa/memory/` → Contar MEMORYs de cargos
+- `ls /knowledge/dossiers/persons/` → Contar dossies pessoas
+- `ls /knowledge/dossiers/THEMES/` → Contar dossies temas
+- `ls /inbox/` (recursivo) → Materiais pendentes
+
+Ler arquivo de mapeamento:
+- `/agents/sua-empresa/AGENT-ROLE-MAPPING.md` → Paridade Agent IA ↔ Role Humano
+
+---
+
+## TEMPLATE COMPLETO
+
+```
+╔══════════════════════════════════════════════════════════════════════════════════════════════════╗
+║                                                                                                  ║
+║  🧠 M E G A   B R A I N                                                                          ║
+║  Sistema de Inteligencia Operacional                                                             ║
+║                                                                                                  ║
+║  📅 {DATA_ATUAL} {HORA}                                                                          ║
+║  👤 [OWNER]                                                                                 ║
+║                                                                                                  ║
+╠══════════════════════════════════════════════════════════════════════════════════════════════════╣
+║                                                                                                  ║
+║  🫀 SAUDE DO SISTEMA                                                                             ║
+║  ════════════════════════════════════════════════════════════════════════════════════════════════║
+║                                                                                                  ║
+║  {BARRA_PROGRESSO_HEALTH} {SCORE}/100                                                            ║
+║                                                                                                  ║
+║  📦 State Files:    {BARRA}  {%}  {STATUS}                                                       ║
+║  📁 Dossiers:       {BARRA}  {%}  {STATUS}                                                       ║
+║  🤖 Agent MEMORYs:  {BARRA}  {%}  {STATUS}                                                       ║
+║  🔍 RAG Index:      {BARRA}  {%}  {STATUS}                                                       ║
+║  📥 Inbox:          {BARRA}  {%}  {STATUS}                                                       ║
+║                                                                                                  ║
+╠══════════════════════════════════════════════════════════════════════════════════════════════════╣
+║                                                                                                  ║
+║  📊 ESTATISTICAS DO CONHECIMENTO                                                                 ║
+║  ════════════════════════════════════════════════════════════════════════════════════════════════║
+║                                                                                                  ║
+║  ┌────────────────┬────────────────┬────────────────┬────────────────┬────────────────┐          ║
+║  │ 📦 CHUNKS      │ 💡 INSIGHTS    │ 📝 NARRATIVAS  │ 📁 DOSSIERS    │ 🤖 AGENTS      │          ║
+║  ├────────────────┼────────────────┼────────────────┼────────────────┼────────────────┤          ║
+║  │     {N}        │      {N}       │   {N}P + {N}T  │   {N}P + {N}T  │      {N}       │          ║
+║  │   ({DELTA})    │   ({DELTA})    │  ({DELTA})     │  ({DELTA})     │   ({DELTA})    │          ║
+║  └────────────────┴────────────────┴────────────────┴────────────────┴────────────────┘          ║
+║                                                                                                  ║
+╠══════════════════════════════════════════════════════════════════════════════════════════════════╣
+║                                                                                                  ║
+║  👥 PESSOAS NO SISTEMA                                                                           ║
+║  ════════════════════════════════════════════════════════════════════════════════════════════════║
+║                                                                                                  ║
+║  ┌─────────────────────────┬──────────┬──────────┬──────────────────────────────────────────┐    ║
+║  │ Pessoa                  │ Insights │ Chunks   │ Expertise Principal                      │    ║
+║  ├─────────────────────────┼──────────┼──────────┼──────────────────────────────────────────┤    ║
+║  │ {STATUS} {NOME}         │    {N}   │    {N}   │ {EXPERTISE}                              │    ║
+║  └─────────────────────────┴──────────┴──────────┴──────────────────────────────────────────┘    ║
+║                                                                                                  ║
+║  Status: 🟢 Completo | 🟡 Parcial | 🔴 Pendente                                                  ║
+║                                                                                                  ║
+╠══════════════════════════════════════════════════════════════════════════════════════════════════╣
+║                                                                                                  ║
+║  🏷️ TEMAS MAPEADOS                                                                               ║
+║  ════════════════════════════════════════════════════════════════════════════════════════════════║
+║                                                                                                  ║
+║  ┌─────────────────────────────┬───────────┬───────────────────┬─────────────────────────────┐   ║
+║  │ Tema                        │ Insights  │ Contributors      │ Status Dossier              │   ║
+║  ├─────────────────────────────┼───────────┼───────────────────┼─────────────────────────────┤   ║
+║  │ {TEMA}                      │    {N}    │ {PESSOAS}         │ {STATUS}                    │   ║
+║  └─────────────────────────────┴───────────┴───────────────────┴─────────────────────────────┘   ║
+║                                                                                                  ║
+╠══════════════════════════════════════════════════════════════════════════════════════════════════╣
+║                                                                                                  ║
+║  🤖 STATUS DOS AGENTES                                                                           ║
+║  ════════════════════════════════════════════════════════════════════════════════════════════════║
+║                                                                                                  ║
+║  ┌────────────────────────┬──────────────┬──────────────┬───────────────────────────────────┐    ║
+║  │ Agente                 │ MEMORY       │ Ultima Att.  │ Conhece                           │    ║
+║  ├────────────────────────┼──────────────┼──────────────┼───────────────────────────────────┤    ║
+║  │ {EMOJI} {AGENTE}       │ {N} insights │ {TEMPO}      │ {PESSOAS}                         │    ║
+║  └────────────────────────┴──────────────┴──────────────┴───────────────────────────────────┘    ║
+║                                                                                                  ║
+║  ⚠️ Agentes >3 dias sem update podem estar desatualizados                                       ║
+║                                                                                                  ║
+╠══════════════════════════════════════════════════════════════════════════════════════════════════╣
+║                                                                                                  ║
+║  🏢 SUA-EMPRESA STATUS (Cargos Humanos)                                                             ║
+║  ════════════════════════════════════════════════════════════════════════════════════════════════║
+║                                                                                                  ║
+║  📋 ROLES: {N} definidos | 📄 JDs: {N} prontos | 🧠 MEMORYs: {N}                                 ║
+║                                                                                                  ║
+║  ┌────────────────────────┬──────────┬──────────┬─────────────────────────────────────────────┐  ║
+║  │ Role                   │ JD       │ MEMORY   │ Status                                      │  ║
+║  ├────────────────────────┼──────────┼──────────┼─────────────────────────────────────────────┤  ║
+║  │ CLOSER-CHEFE           │ ✅       │ ✅       │ 🟢 Ativo (hibrido)                          │  ║
+║  │ SALES-MANAGER          │ ✅       │ ✅       │ 🟡 Planejado                                │  ║
+║  │ CLOSER                 │ ✅       │ ✅       │ 🟡 Planejado                                │  ║
+║  │ SDR                    │ ✅       │ ✅       │ 🟡 Planejado                                │  ║
+║  │ {mais roles...}        │          │          │                                             │  ║
+║  └────────────────────────┴──────────┴──────────┴─────────────────────────────────────────────┘  ║
+║                                                                                                  ║
+║  📊 PARIDADE Agent IA ↔ Role: Ver /agents/sua-empresa/AGENT-ROLE-MAPPING.md                      ║
+║                                                                                                  ║
+╠══════════════════════════════════════════════════════════════════════════════════════════════════╣
+║                                                                                                  ║
+║  📥 INBOX - MATERIAIS PENDENTES                                                                  ║
+║  ════════════════════════════════════════════════════════════════════════════════════════════════║
+║                                                                                                  ║
+║  🔴 ALTA PRIORIDADE (transcricoes prontas):                                                      ║
+║  {LISTA_MATERIAIS_ALTA}                                                                          ║
+║                                                                                                  ║
+║  🟡 MEDIA PRIORIDADE (transcricao necessaria):                                                   ║
+║  {LISTA_MATERIAIS_MEDIA}                                                                         ║
+║                                                                                                  ║
+║  🔴 BLOQUEADOS (arquivo vazio):                                                                  ║
+║  {LISTA_BLOQUEADOS}                                                                              ║
+║                                                                                                  ║
+║  📊 Total: {N} pendentes | Estimativa: ~{N}h para processar tudo                                 ║
+║                                                                                                  ║
+╠══════════════════════════════════════════════════════════════════════════════════════════════════╣
+║                                                                                                  ║
+║  📈 ROLE-TRACKING - NOVOS AGENTES POTENCIAIS                                                     ║
+║  ════════════════════════════════════════════════════════════════════════════════════════════════║
+║                                                                                                  ║
+║  ┌────────────────────────┬───────────┬────────────┬─────────────────────────────────────────┐   ║
+║  │ Role                   │ Mencoes   │ Threshold  │ Status                                  │   ║
+║  ├────────────────────────┼───────────┼────────────┼─────────────────────────────────────────┤   ║
+║  │ {STATUS} {ROLE}        │    {N}    │    10      │ {BARRA} {%} {ACAO}                      │   ║
+║  └────────────────────────┴───────────┴────────────┴─────────────────────────────────────────┘   ║
+║                                                                                                  ║
+║  Status: 🔴 >100% CRIAR! | 🟡 80-99% | ⚪ <80%                                                   ║
+║                                                                                                  ║
+╠══════════════════════════════════════════════════════════════════════════════════════════════════╣
+║                                                                                                  ║
+║  📝 ULTIMA SESSAO                                                                                ║
+║  ════════════════════════════════════════════════════════════════════════════════════════════════║
+║                                                                                                  ║
+║  📅 {DATA_SESSAO} | Duracao: {DURACAO}                                                           ║
+║                                                                                                  ║
+║  O QUE FOI FEITO:                                                                                ║
+║  {LISTA_HIGHLIGHTS}                                                                              ║
+║                                                                                                  ║
+║  ONDE PARAMOS:                                                                                   ║
+║  └─ {CONTEXTO_FINAL}                                                                             ║
+║                                                                                                  ║
+╠══════════════════════════════════════════════════════════════════════════════════════════════════╣
+║                                                                                                  ║
+║  🔓 OPEN LOOPS PENDENTES ({N})                                                                   ║
+║  ════════════════════════════════════════════════════════════════════════════════════════════════║
+║                                                                                                  ║
+║  {LISTA_LOOPS_COM_PRIORIDADE_E_CONTEXTO}                                                         ║
+║                                                                                                  ║
+╠══════════════════════════════════════════════════════════════════════════════════════════════════╣
+║                                                                                                  ║
+║  ⚠️ ALERTAS E INCONSISTENCIAS                                                                    ║
+║  ════════════════════════════════════════════════════════════════════════════════════════════════║
+║                                                                                                  ║
+║  🔴 CRITICO:                                                                                     ║
+║  {LISTA_CRITICOS}                                                                                ║
+║                                                                                                  ║
+║  🟡 ATENCAO:                                                                                     ║
+║  {LISTA_ATENCAO}                                                                                 ║
+║                                                                                                  ║
+║  🟢 INFO:                                                                                        ║
+║  {LISTA_INFO}                                                                                    ║
+║                                                                                                  ║
+╠══════════════════════════════════════════════════════════════════════════════════════════════════╣
+║                                                                                                  ║
+║  💡 SUGESTOES PROATIVAS                                                                          ║
+║  ════════════════════════════════════════════════════════════════════════════════════════════════║
+║                                                                                                  ║
+║  Baseado no estado atual, recomendo:                                                             ║
+║                                                                                                  ║
+║  {LISTA_SUGESTOES_PRIORIZADAS}                                                                   ║
+║                                                                                                  ║
+╠══════════════════════════════════════════════════════════════════════════════════════════════════╣
+║                                                                                                  ║
+║  ❓ O QUE DESEJA FAZER?                                                                          ║
+║  ════════════════════════════════════════════════════════════════════════════════════════════════║
+║                                                                                                  ║
+║  [1] Resolver open loops pendentes                                                               ║
+║  [2] Processar materiais do inbox                                                                ║
+║  [3] Ver diagnostico completo (/system-digest)                                                   ║
+║  [4] Consultar agente especifico                                                                 ║
+║  [5] Criar novo agente                                                                           ║
+║  [6] Adicionar novo material (/ingest)                                                           ║
+║  [7] Outro - me diga o que precisa                                                               ║
+║                                                                                                  ║
+╚══════════════════════════════════════════════════════════════════════════════════════════════════╝
+```
+
+---
+
+## VERSAO COMPACTA
+
+Se usuario pedir versao resumida ou usar `/status --compact`:
+
+```
+╔══════════════════════════════════════════════════════════════════════════════╗
+║  🧠 MEGA BRAIN | 📅 {DATA} {HORA} | 🫀 {SCORE}/100                            ║
+╠══════════════════════════════════════════════════════════════════════════════╣
+║  📊 {N} chunks | {N} insights | {N} dossiers | {N} agents                    ║
+║  📥 {N} pendentes inbox | 🔓 {N} open loops | 🚨 {N} alertas                 ║
+╠══════════════════════════════════════════════════════════════════════════════╣
+║  📝 Ultima: {RESUMO_1_LINHA}                                                 ║
+║  ⚠️ Pendente: {TOP_PENDENCIAS}                                               ║
+╠══════════════════════════════════════════════════════════════════════════════╣
+║  ❓ [1] Loops [2] Inbox [3] Digest [4] Agente [5] Outro                      ║
+╚══════════════════════════════════════════════════════════════════════════════╝
+```
+
+---
+
+## FONTES DE DADOS
+
+| Secao | Fonte |
+|-------|-------|
+| Saude do Sistema | Inferido de todas as fontes |
+| Estatisticas | CHUNKS-STATE, INSIGHTS-STATE, NARRATIVES-STATE |
+| Pessoas | NARRATIVES-STATE.persons + DOSSIERS/persons/ |
+| Temas | NARRATIVES-STATE.themes + DOSSIERS/THEMES/ |
+| Agentes IA | ls agents/SALES/ + agents/C-LEVEL/ |
+| ORG-LIVE (Cargos) | ls agents/ORG-LIVE/ROLES/, JDS/, MEMORY/ |
+| Paridade Agent↔Role | agents/ORG-LIVE/AGENT-ROLE-MAPPING.md |
+| Inbox | ls inbox/ + comparar com file-registry |
+| Role-Tracking | SESSION-STATE.md secao de funcoes |
+| Ultima Sessao | SESSION-STATE.md + SESSION-HISTORY.json |
+| Open Loops | OPEN-LOOPS.json |
+| Alertas | Inferido de todas as fontes |
+| Sugestoes | Logica baseada em alertas + estado |
+
+---
+
+## CALCULO DE SAUDE
+
+```
+Health Score = Media ponderada:
+  - State Files (20%): Arquivos JSON existem e sao validos
+  - Dossiers (20%): Ratio dossiers/pessoas conhecidas
+  - Agent MEMORYs (20%): Agentes atualizados nos ultimos 3 dias
+  - RAG Index (20%): Index atualizado vs knowledge files
+  - Inbox (20%): Ratio processados/pendentes
+
+Status:
+  >=90% → ✅
+  70-89% → 🟡
+  <70% → ⚠️
+```
+
+---
+
+## COMPORTAMENTO DURANTE SESSAO
+
+### Mudanca de Assunto com Loops Abertos
+
+```
+┌─────────────────────────────────────────────────────────────────────────────┐
+│ 📌 LOOPS ABERTOS: {N}                                                       │
+│ ─────────────────────────────────────────────────────────────────────────── │
+│ • [{ID}] {DESCRIPTION}                                                      │
+│                                                                             │
+│ 💡 Prossigo com sua nova solicitacao. Loops ficam abertos ate voce pedir.   │
+└─────────────────────────────────────────────────────────────────────────────┘
+```
+
+### Criacao Automatica de Loops
+
+Criar loop quando:
+- Sugestao de acao nao executada
+- Patch criado mas nao aplicado
+- Material identificado para processar
+- Bug encontrado mas nao corrigido
+
+NAO criar quando:
+- Informacoes consultivas
+- Perguntas retoricas
+- Usuario diz "deixa pra depois"
+
+---
+
+## COMANDOS RELACIONADOS
+
+| Comando | Acao |
+|---------|------|
+| `/loops` | Lista todos os loops |
+| `/loop exec [ID]` | Executa comando do loop |
+| `/loop close [ID]` | Fecha loop |
+| `/loop close-all` | Fecha todos |
+| `/loop dismiss [ID]` | Dispensa loop |
+| `/status --compact` | Versao resumida |
+| `/status --full` | Versao completa (padrao) |
+
+---
+
+## ATUALIZACAO DE ARQUIVOS
+
+Ao final de cada sessao significativa:
+1. `OPEN-LOOPS.json` - Novos loops ou fechamentos
+2. `SESSION-HISTORY.json` - Adicionar entrada
+3. `SESSION-STATE.md` - Atualizar "Ultima sessao"