wizz-method 1.4.0 → 1.5.0

package/src/skills-lib/cerebro/SKILL.md

@@ -23,11 +23,9 @@ Pesquisa:  /prospect
 Sync:      /sync
 ```
 
----
-
 ## REGRA DE OURO — Mínimo de tokens em toda operação
 
-**Nunca leia um arquivo grande inteiro. Sempre grep primeiro, depois Read com offset+limit.**
+**Nunca leia um arquivo grande inteiro. Sempre grep primeiro, depois Read com offset+limit.** Isso vale para TODO comando abaixo, mesmo quando o arquivo de referência específico do comando não repetir a regra.
 
 ```
 # Padrão obrigatório antes de qualquer Read:
@@ -52,8 +50,6 @@ Read offset=(linha-5) limit=15       # → lê só o trecho necessário
 - `CONTEXT.md` — Edit cirúrgico nos campos alterados. Nunca reescrever completo.
 - `_decisions/`, `_learnings/`, `_content/` — Write direto, sem ler arquivo existente.
 
----
-
 ## Vault
 
 Vault padrão conhecido: `~/Documents/projects/Obsidian Vault/`
@@ -68,8 +64,6 @@ Vault padrão conhecido: `~/Documents/projects/Obsidian Vault/`
 grep -m1 "^vault:" "/caminho/CEREBRO.md"
 ```
 
----
-
 ## Estrutura do vault
 
 ```
@@ -77,6 +71,7 @@ grep -m1 "^vault:" "/caminho/CEREBRO.md"
   CEREBRO.md              ← índice central (identidade + projetos ativos — manter < 150 linhas úteis)
   _index/
     sessions.md           ← log histórico de sessões (append-only, nunca lido)
+    cerebro-archive.md    ← excedente do CEREBRO.md movido na compactação do /salvar (grep, nunca Read completo)
   _knowledge/
     about-me.md
     goals.md
@@ -90,278 +85,18 @@ grep -m1 "^vault:" "/caminho/CEREBRO.md"
 
 **Regra de links:** sempre wiki-links `[[arquivo]]` dentro do vault. CONTEXT.md usa Markdown puro.
 
----
-
-## Comandos
-
----
-
-### /salvar
-
-**Objetivo:** fechar sessão, persistir o que aconteceu. Máximo de tokens: ~800 input + edits.
-
-**Passos (executar em ordem, sem desvios):**
-
-**1. Localizar projeto e bloco no CEREBRO.md (1 bash call)**
-```bash
-VAULT=~/Documents/projects/Obsidian\ Vault
-PROJ=construcao   # inferir do diretório atual ou contexto
-grep -n "### \|Última sessão\|Pendente" "$VAULT/CEREBRO.md" | grep -A2 -i "$PROJ"
-wc -l "$VAULT/projetos/$PROJ.md"
-```
-
-**2. Ler apenas o final do arquivo do projeto (1 Read)**
-- `offset = (total_linhas - 80)`, `limit = 80`
-- Isso captura: Hoje atual, Onde parou, O que falta, tabela Sessões
-
-**3. Construir as alterações na memória, depois aplicar (Edits atômicos)**
-
-Em `projetos/[nome].md`, sempre adicionar ACIMA da seção "Onde parou" existente:
-```markdown
-## Hoje ([data] — [sessão])
-- [item 1]
-- [item 2]
-```
-
-Substituir "Onde parou" e "O que falta" com o estado novo.
-
-Adicionar linha na tabela Sessões (append na última linha da tabela).
-
-**4. Atualizar bloco do projeto em CEREBRO.md (1 Edit)**
-- Usar grep do passo 1 para saber as linhas exatas
-- Edit cirúrgico apenas nas linhas "Última sessão" e "Pendente"
-
-**5. Atualizar CONTEXT.md (Edit cirúrgico — só campos alterados)**
-- Nunca reescrever o arquivo inteiro
-- Editar apenas: data no cabeçalho, pendências em "O que falta", commit hash se mudou
-
-**6. Append em `_index/sessions.md` (1 Edit ou Write se não existir)**
-```markdown
-| [data] | [projeto] | [resumo 1 linha] |
-```
-
-**7. Se houve decisão ou aprendizado relevante:** criar arquivo em `_decisions/` ou `_learnings/` (Write direto, sem Read prévio).
-
-**8. Confirmar em 2 linhas** o que foi salvo.
-
----
-
-### /ver
-
-**Objetivo:** mostrar estado atual rápido. Máximo: 1 Read.
-
-**Passos:**
-1. `wc -l "$VAULT/projetos/$PROJ.md"` → total de linhas
-2. Read com `offset=(n-60)`, `limit=60` → pega Onde parou + O que falta + Sessões
-3. Retornar em formato condensado:
-
-```
-## [Projeto] — [data última sessão]
-Stack: [1 linha]
-Onde parou: [bullets]
-O que falta: [checkboxes]
-Última sessão: [1 linha]
-```
-
----
-
-### /dia
+## Comandos (load on demand)
 
-**Objetivo:** briefing de início do dia. Ler apenas o essencial de cada projeto ativo.
-
-**Passos:**
-1. `grep -A4 "### " "$VAULT/CEREBRO.md"` → lista todos os blocos de projeto (nome + última sessão + pendente)
-2. Para cada projeto com status ativo (🟢🟡): tail-read de 30 linhas (`offset=n-30`)
-3. Montar briefing consolidado
-4. Não ler `_knowledge/goals.md` a menos que o usuário peça explicitamente
-
-**Formato de saída:**
-```
-## Briefing — [data]
-
-**[Projeto]** — [emoji status]
-↳ Última sessão: [data] — [resumo]
-↳ Pendente: [items]
-
-**Foco sugerido:** [1-2 linhas]
-```
-
----
-
-### /dump
-
-**Objetivo:** captura rápida. Zero reads.
-
-**Passos:**
-1. Receber o conteúdo (do argumento ou perguntar em 1 mensagem)
-2. Classificar: ideia / aprendizado / decisão / referência / conteúdo
-3. Write direto no arquivo certo — sem ler nada antes
-4. `grep -n "## Conteúdo em aberto\|## Aprendizados" "$VAULT/CEREBRO.md"` → achar linha para Edit de 1 linha
-5. Confirmar em 1 linha
-
----
+Cada comando tem seu procedimento passo-a-passo completo em um arquivo de referência. Carregue só o arquivo do grupo do comando que o usuário disparou:
 
-### /decisao
-
-**Objetivo:** registrar decisão. Zero reads de arquivos existentes.
-
-**Passos:**
-1. Receber descrição + alternativas + projeto (perguntar tudo de uma vez se não passado)
-2. Write direto em `_decisions/YYYY-MM-DD-[slug].md` (template abaixo)
-3. `grep -n "## Decisões recentes" "$VAULT/CEREBRO.md"` → linha
-4. Edit para inserir referência wiki-link logo abaixo dessa linha
-5. Se há projeto: `grep -n "## Decisões" "$VAULT/projetos/$PROJ.md"` → Edit 1 linha
-
-**Template `_decisions/YYYY-MM-DD-[slug].md`:**
-```markdown
-# [Título]
-> Data: [data] | Projeto: [[projetos/nome]] | Status: ativa
-
-## Decisão
-[1-2 linhas]
-
-## Contexto
-[por que foi necessária]
-
-## Alternativas
-- [A] — descartada: [motivo]
-- [B] — descartada: [motivo]
-
-## Raciocínio
-[por que esta]
-
-## Consequências
-[o que muda]
-```
-
----
-
-### /conteudo
-
-**Objetivo:** capturar ideia de conteúdo. Zero reads.
-
-**Passos:**
-1. Receber ideia + plataforma + formato + gancho + CTA (perguntar tudo de uma vez)
-2. Write direto em `_content/YYYY-MM-DD-[slug].md`
-3. `grep -n "## Conteúdo em aberto" "$VAULT/CEREBRO.md"` → Edit 1 linha abaixo
-
-**Template `_content/YYYY-MM-DD-[slug].md`:**
-```markdown
-# [Título]
-> Data: [data] | Plataforma: [plataforma] | Status: ideia
-
-## Ideia
-[1-3 linhas]
-
-## Formato / Gancho / CTA
-- Formato: [tipo]
-- Gancho: [o que torna diferente]
-- CTA: [ação / objetivo]
-
-## Rascunho
-[espaço livre]
-```
-
----
-
-### /prospect
-
-**Objetivo:** pesquisar e registrar prospect.
-
-**Passos:**
-1. Receber nome/empresa + objetivo (tudo de uma vez)
-2. Pesquisar via web search (setor, presença digital, dores, oportunidades)
-3. Write direto em `_prospects/YYYY-MM-DD-[slug].md`
-4. Resumo executivo para o usuário (não precisa estar no arquivo)
-
-**Template `_prospects/YYYY-MM-DD-[slug].md`:**
-```markdown
-# [Nome / Empresa]
-> Data: [data] | Objetivo: [tipo] | Status: pesquisado
-
-## Perfil
-- Setor / Tamanho / Produto / Público-alvo
-
-## Presença digital
-- Site / Redes / Ads ativos
-
-## Oportunidade e ângulo de abordagem
-[o que oferecer e como entrar]
-
-## Próximo passo
-- [ ] [ação]
-```
-
----
-
-### /sync
-
-**Objetivo:** espelhar CONTEXT.md → vault após sessão no Codex.
-
-**Passos:**
-1. Read `CONTEXT.md` no diretório atual (arquivo pequeno — OK ler completo)
-2. `wc -l "$VAULT/projetos/$PROJ.md"` → tail Read das últimas 60 linhas
-3. Identificar diferenças em: estado atual, pendências, decisões
-4. Edit cirúrgico em `projetos/[nome].md` (só seções alteradas)
-5. `grep -n "Última sessão\|Pendente" "$VAULT/CEREBRO.md" | grep -i "$PROJ"` → Edit linha
-6. Append linha em `_index/sessions.md`
-7. Confirmar em 2 linhas
-
----
-
-### /iniciar
-
-**Objetivo:** configurar projeto novo. Só cria arquivos — não lê nada além do CEREBRO.md mínimo.
-
-**Passos:**
-1. Descobrir vault (ver seção Vault)
-2. `grep -c "$PROJ" "$VAULT/CEREBRO.md"` → verificar se projeto já existe (0 = novo)
-3. Se novo: entrevistar em 1 mensagem (organização, info essencial, estilo, modo)
-4. Write `projetos/[nome].md` com template
-5. `grep -n "## Projetos" "$VAULT/CEREBRO.md"` → Edit para inserir entrada
-6. Confirmar
-
-**Template `projetos/[nome].md`:**
-```markdown
-# [Nome] — Estado Atual
-> Atualizado: [data]
-
-## Preferências
-- Organização: [resposta]
-- Info essencial: [resposta]
-- Estilo: [resposta]
-- Modo: [registro / sugestivo]
-
-## Stack
-[breve descrição]
-
-## Onde parou
--
-
-## O que falta
-- [ ]
-
-## Sessões
-| Data | Resumo |
-|------|--------|
-|      |        |
-```
-
-**Template bloco em CEREBRO.md:**
-```markdown
-### [Nome] [emoji]
-- **Stack:** [stack]
-- **Última sessão:** [data] — [resumo]
-- **Pendente:** [pendências]
-- **Estado atual:** [[projetos/nome]]
-```
-
----
+- `references/comandos-sessao.md` — `/iniciar` (configurar projeto novo), `/ver` (estado atual rápido), `/salvar` (fechar sessão) com passos, orçamento de tokens e templates completos.
+- `references/comandos-rotina-e-captura.md` — `/dia` (briefing do dia), `/dump` (captura rápida), `/decisao` (registrar decisão), `/conteudo` (ideia de conteúdo) com passos e templates completos.
+- `references/comandos-pesquisa-e-sync.md` — `/prospect` (pesquisar prospect) e `/sync` (espelhar CONTEXT.md → vault) com passos e templates completos.
 
 ## Regras gerais
 
 - Wiki-links `[[arquivo]]` dentro do vault. Markdown puro no CONTEXT.md.
-- Datas absolutas (ex: "Apr 23 2026") — nunca relativas.
+- Datas absolutas no formato `YYYY-MM-DD`, nunca relativas ("ontem", "semana passada"). Fatos voláteis (versão publicada, estado de release, etc.) levam prefixo `em YYYY-MM-DD:` no texto; na releitura, o agente trata como snapshot daquele momento, não como fato atual.
 - Nunca apagar histórico — só acrescentar.
 - Log histórico de sessões vai em `_index/sessions.md`, não no CEREBRO.md — mantém o CEREBRO.md curto.
 - Resumos: 1 linha por item.

package/src/skills-lib/cerebro/references/comandos-pesquisa-e-sync.md

@@ -0,0 +1,44 @@
+# Comandos de Pesquisa e Sync: /prospect, /sync
+
+Carregue este arquivo ao executar `/prospect` ou `/sync`. Antes de tudo, releia a REGRA DE OURO e a seção Vault no SKILL.md principal — esses comandos dependem delas.
+
+## /prospect
+
+**Objetivo:** pesquisar e registrar prospect.
+
+**Passos:**
+1. Receber nome/empresa + objetivo (tudo de uma vez)
+2. Pesquisar via web search (setor, presença digital, dores, oportunidades)
+3. Write direto em `_prospects/YYYY-MM-DD-[slug].md`
+4. Resumo executivo para o usuário (não precisa estar no arquivo)
+
+**Template `_prospects/YYYY-MM-DD-[slug].md`:**
+```markdown
+# [Nome / Empresa]
+> Data: [data] | Objetivo: [tipo] | Status: pesquisado
+
+## Perfil
+- Setor / Tamanho / Produto / Público-alvo
+
+## Presença digital
+- Site / Redes / Ads ativos
+
+## Oportunidade e ângulo de abordagem
+[o que oferecer e como entrar]
+
+## Próximo passo
+- [ ] [ação]
+```
+
+## /sync
+
+**Objetivo:** espelhar CONTEXT.md → vault após sessão no Codex.
+
+**Passos:**
+1. Read `CONTEXT.md` no diretório atual (arquivo pequeno — OK ler completo)
+2. `wc -l "$VAULT/projetos/$PROJ.md"` → tail Read das últimas 60 linhas
+3. Identificar diferenças em: estado atual, pendências, decisões
+4. Edit cirúrgico em `projetos/[nome].md` (só seções alteradas)
+5. `grep -n "Última sessão\|Pendente" "$VAULT/CEREBRO.md" | grep -i "$PROJ"` → Edit linha
+6. Append linha em `_index/sessions.md`
+7. Confirmar em 2 linhas

package/src/skills-lib/cerebro/references/comandos-rotina-e-captura.md

@@ -0,0 +1,94 @@
+# Comandos de Rotina e Captura: /dia, /dump, /decisao, /conteudo
+
+Carregue este arquivo ao executar `/dia`, `/dump`, `/decisao` ou `/conteudo`. Antes de tudo, releia a REGRA DE OURO e a seção Vault no SKILL.md principal — esses comandos dependem delas.
+
+## /dia
+
+**Objetivo:** briefing de início do dia. Ler apenas o essencial de cada projeto ativo.
+
+**Passos:**
+1. `grep -A4 "### " "$VAULT/CEREBRO.md"` → lista todos os blocos de projeto (nome + última sessão + pendente)
+2. Para cada projeto com status ativo (🟢🟡): tail-read de 30 linhas (`offset=n-30`)
+3. Montar briefing consolidado
+4. Não ler `_knowledge/goals.md` a menos que o usuário peça explicitamente
+
+**Formato de saída:**
+```
+## Briefing — [data]
+
+**[Projeto]** — [emoji status]
+↳ Última sessão: [data] — [resumo]
+↳ Pendente: [items]
+
+**Foco sugerido:** [1-2 linhas]
+```
+
+## /dump
+
+**Objetivo:** captura rápida. Zero reads.
+
+**Passos:**
+1. Receber o conteúdo (do argumento ou perguntar em 1 mensagem)
+2. Classificar: ideia / aprendizado / decisão / referência / conteúdo
+3. Write direto no arquivo certo — sem ler nada antes
+4. `grep -n "## Conteúdo em aberto\|## Aprendizados" "$VAULT/CEREBRO.md"` → achar linha para Edit de 1 linha
+5. Confirmar em 1 linha
+
+## /decisao
+
+**Objetivo:** registrar decisão. Zero reads de arquivos existentes.
+
+**Passos:**
+1. Receber descrição + alternativas + projeto (perguntar tudo de uma vez se não passado)
+2. Write direto em `_decisions/YYYY-MM-DD-[slug].md` (template abaixo)
+3. `grep -n "## Decisões recentes" "$VAULT/CEREBRO.md"` → linha
+4. Edit para inserir referência wiki-link logo abaixo dessa linha
+5. Se há projeto: `grep -n "## Decisões" "$VAULT/projetos/$PROJ.md"` → Edit 1 linha
+
+**Template `_decisions/YYYY-MM-DD-[slug].md`:**
+```markdown
+# [Título]
+> Data: [data] | Projeto: [[projetos/nome]] | Status: ativa
+
+## Decisão
+[1-2 linhas]
+
+## Contexto
+[por que foi necessária]
+
+## Alternativas
+- [A] — descartada: [motivo]
+- [B] — descartada: [motivo]
+
+## Raciocínio
+[por que esta]
+
+## Consequências
+[o que muda]
+```
+
+## /conteudo
+
+**Objetivo:** capturar ideia de conteúdo. Zero reads.
+
+**Passos:**
+1. Receber ideia + plataforma + formato + gancho + CTA (perguntar tudo de uma vez)
+2. Write direto em `_content/YYYY-MM-DD-[slug].md`
+3. `grep -n "## Conteúdo em aberto" "$VAULT/CEREBRO.md"` → Edit 1 linha abaixo
+
+**Template `_content/YYYY-MM-DD-[slug].md`:**
+```markdown
+# [Título]
+> Data: [data] | Plataforma: [plataforma] | Status: ideia
+
+## Ideia
+[1-3 linhas]
+
+## Formato / Gancho / CTA
+- Formato: [tipo]
+- Gancho: [o que torna diferente]
+- CTA: [ação / objetivo]
+
+## Rascunho
+[espaço livre]
+```

package/src/skills-lib/cerebro/references/comandos-sessao.md

@@ -0,0 +1,122 @@
+# Comandos de Sessão: /iniciar, /ver, /salvar
+
+Carregue este arquivo ao executar `/iniciar`, `/ver` ou `/salvar`. Antes de tudo, releia a REGRA DE OURO e a seção Vault no SKILL.md principal — esses comandos dependem delas.
+
+## /iniciar
+
+**Objetivo:** configurar projeto novo. Só cria arquivos — não lê nada além do CEREBRO.md mínimo.
+
+**Passos:**
+1. Descobrir vault (ver seção Vault)
+2. `grep -c "$PROJ" "$VAULT/CEREBRO.md"` → verificar se projeto já existe (0 = novo)
+3. Se novo: entrevistar em 1 mensagem (organização, info essencial, estilo, modo)
+4. Write `projetos/[nome].md` com template
+5. `grep -n "## Projetos" "$VAULT/CEREBRO.md"` → Edit para inserir entrada
+6. Confirmar
+
+**Template `projetos/[nome].md`:**
+```markdown
+# [Nome] — Estado Atual
+> Atualizado: [data]
+
+## Preferências
+- Organização: [resposta]
+- Info essencial: [resposta]
+- Estilo: [resposta]
+- Modo: [registro / sugestivo]
+
+## Stack
+[breve descrição]
+
+## Onde parou
+-
+
+## O que falta
+- [ ]
+
+## Sessões
+| Data | Resumo |
+|------|--------|
+|      |        |
+```
+
+**Template bloco em CEREBRO.md:**
+```markdown
+### [Nome] [emoji]
+- **Stack:** [stack]
+- **Última sessão:** [data] — [resumo]
+- **Pendente:** [pendências]
+- **Estado atual:** [[projetos/nome]]
+```
+
+## /ver
+
+**Objetivo:** mostrar estado atual rápido. Máximo: 1 Read.
+
+**Passos:**
+1. `wc -l "$VAULT/projetos/$PROJ.md"` → total de linhas
+2. Read com `offset=(n-60)`, `limit=60` → pega Onde parou + O que falta + Sessões
+3. Retornar em formato condensado:
+
+```
+## [Projeto] — [data última sessão]
+Stack: [1 linha]
+Onde parou: [bullets]
+O que falta: [checkboxes]
+Última sessão: [1 linha]
+```
+
+## /salvar
+
+**Objetivo:** fechar sessão, persistir o que aconteceu. Máximo de tokens: ~800 input + edits.
+
+**Passos (executar em ordem, sem desvios):**
+
+**1. Localizar projeto e bloco no CEREBRO.md (1 bash call)**
+```bash
+VAULT=~/Documents/projects/Obsidian\ Vault
+PROJ=construcao   # inferir do diretório atual ou contexto
+grep -n "### \|Última sessão\|Pendente" "$VAULT/CEREBRO.md" | grep -A2 -i "$PROJ"
+wc -l "$VAULT/projetos/$PROJ.md"
+```
+
+**2. Ler apenas o final do arquivo do projeto (1 Read)**
+- `offset = (total_linhas - 80)`, `limit = 80`
+- Isso captura: Hoje atual, Onde parou, O que falta, tabela Sessões
+
+**3. Construir as alterações na memória, depois aplicar (Edits atômicos)**
+
+Em `projetos/[nome].md`, sempre adicionar ACIMA da seção "Onde parou" existente:
+```markdown
+## Hoje ([data] — [sessão])
+- [item 1]
+- [item 2]
+```
+
+Substituir "Onde parou" e "O que falta" com o estado novo.
+
+Adicionar linha na tabela Sessões (append na última linha da tabela).
+
+**4. Atualizar bloco do projeto em CEREBRO.md (1 Edit)**
+- Usar grep do passo 1 para saber as linhas exatas
+- Edit cirúrgico apenas nas linhas "Última sessão" e "Pendente"
+
+**5. Atualizar CONTEXT.md (Edit cirúrgico — só campos alterados)**
+- Nunca reescrever o arquivo inteiro
+- Editar apenas: data no cabeçalho, pendências em "O que falta", commit hash se mudou
+
+**6. Append em `_index/sessions.md` (1 Edit ou Write se não existir)**
+```markdown
+| [data] | [projeto] | [resumo 1 linha] |
+```
+
+**7. Se houve decisão ou aprendizado relevante:** criar arquivo em `_decisions/` ou `_learnings/` (Write direto, sem Read prévio).
+
+**8. Higiene do índice (compactação)**
+```bash
+wc -l "$VAULT/CEREBRO.md"
+```
+- Se > 150 linhas: mover o conteúdo mais antigo/menos essencial (projeto ✅ concluído ou ❌ descontinuado com histórico longo, ou entradas de "Decisões recentes" além das ~15 mais novas) para `_index/cerebro-archive.md`, deixando no lugar só 1 linha de referência `[[_index/cerebro-archive]]`. Nunca apagar, só mover.
+- Se ≤ 150 linhas: pular este passo.
+
+**9. Confirmar em 2 linhas** o que foi salvo.