wizz-method 1.16.1 → 1.18.0

package/src/modules/wizz/subagents/wizz-exec-haiku.md

@@ -12,3 +12,15 @@ Regras:
 - Toque apenas os arquivos listados no brief. Nada de melhoria extra fora do escopo.
 - Siga o estilo do código ao redor (nomes, densidade de comentários, idioma).
 - Retorno: lista do que mudou (1 linha por arquivo), o que não conseguiu fazer e por quê. Sem narração, sem introdução.
+
+Disciplina de artefatos forçados (Fable Method — resolve onde prosa de instrução falha em modelo barato):
+
+- INTENT: antes da 1ª edição, escreva 1 linha com o que vai mudar e por quê.
+- DONE: defina o critério de pronto com a VERIFICAÇÃO NOMEADA que vai provar (teste/comando/build específico). Sem verificação nomeada = brief mal definido: pare e pergunte.
+- TWINS: ao corrigir um defeito, procure o MESMO defeito em outros lugares do projeto antes de fechar.
+- PENDING: liste explicitamente o que ficou sem resolver.
+- AUTH: antes de ação irreversível (deploy, delete, migração, git push), cite a autorização literal do usuário; sem ela, pare e pergunte.
+- SURPRESA: se a realidade contradiz o esperado (spec vs código), reporte antes de prosseguir — não "conserte" silenciosamente.
+- Proibição: não enfraqueça nem pule check/teste pra passar.
+- Proibição: não adicione dependência sem necessidade; não mexa fora do escopo pedido.
+- Ao falhar: retry 1x com o mesmo escopo antes de considerar ampliar.

package/src/modules/wizz/subagents/wizz-exec-opus.md

@@ -14,3 +14,15 @@ Regras:
 - Siga o estilo do código ao redor (nomes, densidade de comentários, idioma).
 - Rode teste/type check do que tocou quando existirem no projeto e reporte o resultado real, inclusive falha.
 - Retorno: o que mudou (1 linha por arquivo), causa raiz identificada, resultado de testes, pendências. Sem narração.
+
+Disciplina de artefatos forçados (Fable Method — resolve onde prosa de instrução falha em modelo barato):
+
+- INTENT: antes da 1ª edição, escreva 1 linha com o que vai mudar e por quê.
+- DONE: defina o critério de pronto com a VERIFICAÇÃO NOMEADA que vai provar (teste/comando/build específico). Sem verificação nomeada = brief mal definido: pare e pergunte.
+- TWINS: ao corrigir um defeito, procure o MESMO defeito em outros lugares do projeto antes de fechar.
+- PENDING: liste explicitamente o que ficou sem resolver.
+- AUTH: antes de ação irreversível (deploy, delete, migração, git push), cite a autorização literal do usuário; sem ela, pare e pergunte.
+- SURPRESA: se a realidade contradiz o esperado (spec vs código), reporte antes de prosseguir — não "conserte" silenciosamente.
+- Proibição: não enfraqueça nem pule check/teste pra passar.
+- Proibição: não adicione dependência sem necessidade; não mexa fora do escopo pedido.
+- Ao falhar: retry 1x com o mesmo escopo antes de considerar ampliar.

package/src/modules/wizz/subagents/wizz-exec-review.md

@@ -13,3 +13,14 @@ Regras:
 - Não edite nenhum arquivo. Sua função é avaliar, não implementar.
 - Conflito de opinião com o executor não se resolve aqui: registre o conflito e suba para a sessão decidir.
 - Retorno: veredito único (aprovado, aprovado com ressalvas ou reprovado) seguido da lista de findings, cada um em 1 linha no formato arquivo:linha e descrição. Sem narração.
+
+Disciplina de "judge" (Fable Method):
+
+- RE-RUN: re-execute você mesmo TODA verificação que o executor alegou ter feito (teste, build, comando específico) — não confie no relatório dele.
+- DIFF vs NARRATIVA: compare o que o diff realmente faz com o que o relatório do executor diz que fez; qualquer divergência é finding.
+- Tabela de fraudes a caçar:
+  - teste enfraquecido ou pulado
+  - completion falsa (relatório diz "pronto" sem prova)
+  - scope creep (mexeu além do brief)
+  - dependência adicionada silenciosamente
+  - check/teste comentado ou desabilitado

package/src/modules/wizz/subagents/wizz-exec-sonnet.md

@@ -13,3 +13,15 @@ Regras:
 - Siga o estilo do código ao redor (nomes, densidade de comentários, idioma).
 - Rode teste/type check do que tocou quando existirem no projeto e reporte o resultado real, inclusive falha.
 - Retorno: o que mudou (1 linha por arquivo), resultado de testes, pendências. Sem narração.
+
+Disciplina de artefatos forçados (Fable Method — resolve onde prosa de instrução falha em modelo barato):
+
+- INTENT: antes da 1ª edição, escreva 1 linha com o que vai mudar e por quê.
+- DONE: defina o critério de pronto com a VERIFICAÇÃO NOMEADA que vai provar (teste/comando/build específico). Sem verificação nomeada = brief mal definido: pare e pergunte.
+- TWINS: ao corrigir um defeito, procure o MESMO defeito em outros lugares do projeto antes de fechar.
+- PENDING: liste explicitamente o que ficou sem resolver.
+- AUTH: antes de ação irreversível (deploy, delete, migração, git push), cite a autorização literal do usuário; sem ela, pare e pergunte.
+- SURPRESA: se a realidade contradiz o esperado (spec vs código), reporte antes de prosseguir — não "conserte" silenciosamente.
+- Proibição: não enfraqueça nem pule check/teste pra passar.
+- Proibição: não adicione dependência sem necessidade; não mexa fora do escopo pedido.
+- Ao falhar: retry 1x com o mesmo escopo antes de considerar ampliar.

package/src/skills-lib/analytics-tracking/SKILL.md

@@ -197,6 +197,8 @@ dataLayer.push({
 - Be specific but concise: `blog_footer_cta`, not `cta1`
 - Document all UTMs in a spreadsheet
 
+**For closed value lists, the naming standard, BR/PT checkout specifics and governance**: See [references/utm-taxonomy.md](references/utm-taxonomy.md)
+
 ---
 
 ## Debugging and Validation

package/src/skills-lib/analytics-tracking/references/utm-taxonomy.md

@@ -0,0 +1,92 @@
+# UTM Taxonomy and Governance
+
+A UTM scheme is only worth what its weakest tag is worth. One free-text `utm_source` per person and the channel report is fiction within a month. This reference is the governance layer: the allowed values, the naming standard, and who owns it.
+
+For auditing a direct-response funnel (pixel, CAPI, checkout passthrough, test purchase per route), use the `tracking-audit` skill instead. This file defines the taxonomy; that skill proves it is installed correctly.
+
+## The one rule
+
+**Every value comes from a closed list.** If a value is not on the list, it does not go in the URL: it goes to whoever owns the taxonomy, gets added to the list, and only then gets used. Free text in `utm_source` is the single most common cause of a useless channel report.
+
+## Canonical values
+
+### utm_source — where the click came from
+
+Use the platform, never the campaign or the person.
+
+| Value | Use for |
+|---|---|
+| `google`, `bing` | search and display networks |
+| `facebook`, `instagram` | Meta placements (keep them separate: the reports differ) |
+| `tiktok`, `kwai`, `pinterest`, `linkedin`, `x` | the named platform |
+| `youtube` | YouTube, whether organic or paid |
+| `whatsapp`, `telegram` | messaging apps |
+| `newsletter`, `email` | owned lists (pick one and keep it) |
+| `partner-<slug>` | affiliates and partners, one slug per partner |
+
+### utm_medium — the kind of traffic
+
+This is the field that feeds channel grouping. Keep it tiny.
+
+| Value | Use for |
+|---|---|
+| `cpc` | paid click auctions |
+| `paid-social` | paid social placements |
+| `organic-social` | unpaid posts, stories, bio links |
+| `email` | any email send |
+| `affiliate` | affiliate and partner traffic |
+| `referral` | links from other sites you do not control |
+| `qr` | printed or physical placements |
+
+Do not invent `facebook-ads` as a medium. Platform belongs in `utm_source`; `utm_medium` answers "what kind of traffic is this".
+
+### utm_campaign, utm_content, utm_term
+
+- `utm_campaign`: the offer or initiative, not the month. `black-friday-2026`, not `campanha-nova`.
+- `utm_content`: what distinguishes two versions of the same placement. Creative, headline variant, or button.
+- `utm_term`: keyword for search, placement for social.
+
+## Naming standard
+
+- lowercase, no accents, no spaces
+- hyphen between words, underscore never mixed in halfway
+- fixed field order, decided once and written down
+- never `|`, `#`, `&` or `?`: they are delimiters inside the tag string and they break attribution silently
+
+Renaming later does not fix a bad name. Ad platforms keep serving the old name from cache for impressions already delivered, so the historical report stays split.
+
+## Brazil and Portugal specifics
+
+Direct-response operations in BR and PT usually route through a checkout platform that owns the final domain. Two consequences:
+
+1. **The checkout may not forward `utm_*`.** Several platforms (Hotmart, Kiwify, Eduzz, Monetizze, Braip and similar) carry a native parameter of their own. Pack the same identifiers into that native parameter as well, so the sale webhook still knows the origin. The exact parameter name is platform-specific: confirm it in the platform docs before writing the template.
+2. **Payment method changes the funnel shape.** PIX and card approve at different rates and on different clocks. Split "sale started to approved" by payment method or the number means nothing.
+
+Owned routes that people forget to tag, and that inflate the organic bucket:
+
+| Route | Suggested tag |
+|---|---|
+| Instagram bio link | `utm_source=instagram&utm_medium=organic-social&utm_campaign=bio` |
+| Instagram highlight | `utm_source=instagram&utm_medium=organic-social&utm_campaign=destaque-<name>` |
+| Story swipe up | `utm_source=instagram&utm_medium=organic-social&utm_campaign=story-<date>` |
+| WhatsApp broadcast | `utm_source=whatsapp&utm_medium=referral&utm_campaign=<list>` |
+| Link in a printed piece | `utm_source=<place>&utm_medium=qr&utm_campaign=<piece>` |
+
+"Organic" is not a channel. It is the bucket of everything that arrived untagged. Tag every owned route and watch it shrink: the size of the drop is how much the bucket was lying.
+
+## Attribution by ID
+
+Whenever the ad platform exposes an object ID, carry both name and ID:
+
+```
+utm_campaign=<campaign-name>|<campaign-id>
+```
+
+Names get renamed; IDs do not. Attribution keyed on the name breaks the first time someone tidies up the ad account.
+
+## Governance
+
+- One owner for the taxonomy. Not a team, a person.
+- One document with the closed lists, linked from wherever campaigns are built.
+- A monthly check for values outside the lists. Anything outside is either an addition to the list or a fix at the source.
+- A link builder (spreadsheet or small form) beats hand-typed URLs. Hand-typed URLs are where the typos come from.

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

@@ -2,15 +2,15 @@
 name: cerebro
 description: >
   Sistema de memória persistente entre sessões de AI. Use esta skill sempre que o usuário digitar
-  /iniciar, /salvar, /ver, /dia, /dump, /decisao, /conteudo, /prospect ou /sync. Também ative quando o
+  /iniciar, /salvar, /ver, /dia, /dump, /decisao, /conteudo, /prospect ou /memoria. Também ative quando o
   usuário mencionar "cerebro", "atualizar o cerebro", "salvar sessão", "resumo do projeto",
-  "estado atual", "registrar decisão", "ideia de conteúdo", "pesquisar prospect" ou "sincronizar vault".
+  "estado atual", "registrar decisão", "ideia de conteúdo", "pesquisar prospect" ou "ler a auto-memória".
   Esta skill mantém CEREBRO.md como índice central e arquivos por projeto — é a memória do
   usuário entre Claude Code, Codex e qualquer outro agente.
-  CONTEXT.md no repo é o espelho do vault para agentes cloud (Codex). Fluxo: Codex atualiza
-  CONTEXT.md → usuário roda /sync no Claude Code → vault atualizado.
+  A auto-memória do agente é a outra camada, e `/memoria` é a ponte de leitura dela para
+  qualquer plataforma (Codex, OpenCode, Gemini) rodando na mesma máquina.
   Use quando o usuário digitar um desses comandos de barra ou mencionar memória, sessão,
-  decisão, ideia de conteúdo, prospect ou sincronização do cérebro.
+  decisão, ideia de conteúdo, prospect ou auto-memória.
 ---
 
 # Cérebro — Sistema de Memória Persistente
@@ -22,7 +22,7 @@ Sessão:    /iniciar  /salvar  /ver
 Rotina:    /dia
 Captura:   /dump  /decisao  /conteudo
 Pesquisa:  /prospect
-Sync:      /sync
+Memória:   /memoria
 ```
 
 ## REGRA DE OURO — Mínimo de tokens em toda operação
@@ -44,13 +44,12 @@ Read offset=(linha-5) limit=15       # → lê só o trecho necessário
 | /dia     | 1 por projeto ativo | 0    |
 | /dump    | 0            | 1             |
 | /decisao | 0            | 2             |
-| /sync    | 2            | 3             |
+| /memoria | 1            | 0             |
 
 **Regras de leitura por arquivo:**
 - `CEREBRO.md` — **nunca Read completo**. Grep para achar o bloco do projeto (5–8 linhas), Edit direto.
 - `projetos/[nome].md` — Read das **últimas 80 linhas** (tail). Sessões e estado atual ficam no final.
-- `CONTEXT.md` — Edit cirúrgico nos campos alterados. Nunca reescrever completo.
-- `_decisions/`, `_learnings/`, `_content/` — Write direto, sem ler arquivo existente.
+- `_decisions/`, `_content/` — Write direto, sem ler arquivo existente.
 
 ## Vault
 
@@ -72,20 +71,23 @@ grep -m1 "^vault:" "/caminho/CEREBRO.md"
 [Vault]/
   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
-  _decisions/             ← YYYY-MM-DD-[slug].md
-  _learnings/             ← YYYY-MM-DD-[slug].md
+  _decisions/             ← YYYY-MM-DD-[slug].md, com frontmatter (data, projeto, tema,
+                            status, supersede). O campo `tema` é o que o grep acha.
+                            (não existe mais `_learnings/`: era escrito e nunca
+                             lido por nenhum comando, e foi removido em 2026-08-28.
+                             Armadilha de stack e bug não óbvio vão para a
+                             auto-memória do agente, que carrega sozinha.)
   _content/               ← YYYY-MM-DD-[slug].md
   _prospects/             ← YYYY-MM-DD-[slug].md
   projetos/
-    [nome].md             ← estado atual do projeto (estrutura: cabeçalho + stack + Hoje + Onde parou + O que falta + Sessões)
+    [nome].md             ← estado atual do projeto (estrutura: cabeçalho + bloco `Estado` de 12 linhas no topo + Preferências + Contexto + O que falta + Sessões)
 ```
 
-**Regra de links:** sempre wiki-links `[[arquivo]]` dentro do vault. CONTEXT.md usa Markdown puro.
+**Regra de links:** sempre wiki-links `[[arquivo]]` dentro do vault.
 
 ## Comandos (load on demand)
 
@@ -93,13 +95,14 @@ Cada comando tem seu procedimento passo-a-passo completo em um arquivo de refer
 
 - `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.
+- `references/comandos-pesquisa-e-memoria.md` — `/prospect` (pesquisar prospect) e `/memoria` (ler e alimentar a auto-memória do projeto de qualquer plataforma) com passos e templates completos.
 
 ## Regras gerais
 
-- Wiki-links `[[arquivo]]` dentro do vault. Markdown puro no CONTEXT.md.
+- Wiki-links `[[arquivo]]` dentro do vault.
 - 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.
+- **Grep antes de gravar.** Antes de criar decisão, ideia ou registro novo, busque o tema na pasta de destino. Se o fato já existe, atualize o registro que existe; decisão que substitui outra marca a antiga como `superseded` em vez de conviver com ela.
+- Narrativa de sessão mora no arquivo do projeto: bloco `Estado` no topo (12 linhas, sobrescrito a cada `/salvar`) + 1 linha na tabela `Sessões`. Não existe mais `_index/sessions.md`: era escrito e nunca lido por nenhum comando, e saiu em 2026-08-28.
 - Resumos: 1 linha por item.
 - CEREBRO.md deve ficar sempre < 150 linhas úteis — mover tabelas longas para `_index/`.

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

@@ -0,0 +1,96 @@
+# Comandos de Pesquisa e Memoria: /prospect, /memoria
+
+Carregue este arquivo ao executar `/prospect` ou `/memoria`. 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]
+```
+
+## /memoria
+
+**Objetivo:** ler (e alimentar) a auto-memória do projeto a partir de **qualquer**
+plataforma, não só do Claude Code.
+
+A auto-memória guarda as duas linhas que não moram no vault: **armadilha de stack /
+bug não-óbvio** e **preferência de trabalho / correção do usuário**. No Claude Code ela
+carrega sozinha no início da sessão. Em Codex, OpenCode e Gemini não carrega nada, mas
+o dado está lá: é um diretório comum de arquivos `.md` no disco local. Este comando é a
+ponte de leitura. Não existe segunda cópia dos fatos — a fonte continua sendo uma só.
+
+### Passo 1 — resolver o diretório de memória
+
+```bash
+PROJ_DIR="$(pwd)"
+SLUG="$(printf '%s' "$PROJ_DIR" | sed 's/[/.]/-/g')"
+MEM="$HOME/.claude/projects/$SLUG/memory"
+# fallback: o slug histórico nem sempre normaliza espaço e ponto do mesmo jeito
+[ -d "$MEM" ] || MEM="$(ls -d "$HOME"/.claude/projects/*"$(basename "$PROJ_DIR")"/memory 2>/dev/null | head -1)"
+echo "$MEM"
+```
+
+Diretório inexistente = projeto sem auto-memória. Siga sem travar; não é problema a corrigir.
+
+### Passo 2 — carregar só o índice
+
+```bash
+cat "$MEM/MEMORY.md"
+```
+
+O índice tem teto de 8 KB e é 1 linha por memória. **Nunca leia os arquivos individuais
+em bloco.** Abra um arquivo só quando a linha do índice for relevante ao pedido da vez:
+
+```bash
+grep -rln "termo" "$MEM" --include="*.md" | head -5   # depois Read só o que casar
+```
+
+`_archive/` fica fora do índice de propósito. Só entre nele quando o índice não tiver a resposta.
+
+### Passo 3 — gravar (mesma pasta, mesmo formato)
+
+Vale o Dever de Memória e o teto: **40 memórias e 8 KB de índice por projeto**. Antes de
+criar, `grep` no destino; se o fato já existe, atualize o arquivo que existe.
+
+```markdown
+---
+name: <slug-em-kebab-case>
+description: <resumo de uma linha, é o que decide a relevância na recuperação>
+metadata:
+  type: user | feedback | project | reference
+---
+
+<o fato. Para feedback/project, siga com as linhas **Why:** e **How to apply:**.
+Ligue memórias relacionadas com [[nome-da-outra]].>
+```
+
+Depois de escrever o arquivo, acrescente 1 linha ao `MEMORY.md`:
+`- [Título](arquivo.md) — gancho`
+
+### Limites honestos
+
+- É **pull, não push**: fora do Claude Code nada carrega sozinho, o agente precisa rodar o comando.
+- Vale só para agente rodando na **mesma máquina**. Agente remoto não enxerga este disco.
+- O teto e a poda continuam valendo igual, venha a escrita de qual plataforma vier.

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

@@ -36,19 +36,38 @@ Carregue este arquivo ao executar `/dia`, `/dump`, `/decisao` ou `/conteudo`. An
 
 ## /decisao
 
-**Objetivo:** registrar decisão. Zero reads de arquivos existentes.
+**Objetivo:** registrar decisão. 1 grep antes, nenhum Read.
 
 **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
+2. **Grep antes de gravar** (obrigatório, 1 bash call):
+
+```bash
+grep -ril "<2 ou 3 palavras do tema>" "$VAULT/_decisions/" | head -5
+```
+
+- Achou decisão sobre o mesmo tema: **não crie arquivo novo**. Abra o que existe e decida entre dois caminhos:
+  - a decisão nova **substitui** a antiga → marque a antiga com `status: superseded` e `supersedida_por: <slug novo>`, e crie a nova com `supersede: <slug antigo>`
+  - a decisão nova **detalha** a antiga → edite a antiga, não crie a segunda
+- Não achou nada: siga para o passo 3.
+
+3. Write direto em `_decisions/YYYY-MM-DD-[slug].md` (template abaixo)
+4. `grep -n "## Decisões recentes" "$VAULT/CEREBRO.md"` → linha
+5. Edit para inserir referência wiki-link logo abaixo dessa linha
+6. Se há projeto: `grep -n "## Decisões" "$VAULT/projetos/$PROJ.md"` → Edit 1 linha
 
 **Template `_decisions/YYYY-MM-DD-[slug].md`:**
 ```markdown
+---
+data: YYYY-MM-DD
+projeto: [nome]
+tema: [2 a 4 palavras-chave separadas por vírgula, é por elas que o grep acha]
+status: ativa
+supersede: [slug da decisão que esta substitui, ou omitir]
+supersedida_por: [preenchido depois, quando outra decisão substituir esta]
+---
+
 # [Título]
-> Data: [data] | Projeto: [[projetos/nome]] | Status: ativa
 
 ## Decisão
 [1-2 linhas]

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

@@ -2,11 +2,30 @@
 
 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.
 
+## O bloco Estado
+
+Todo arquivo em `projetos/` começa com um bloco `## Estado` de no **máximo 12 linhas**, logo abaixo do título. Ele é sobrescrito a cada `/salvar` e é a única coisa que o `/ver` precisa ler.
+
+```markdown
+## Estado
+- **Fase:** [em que ponto o projeto está, 1 linha]
+- **Stack:** [1 linha]
+- **Onde parou:** [1 linha]
+- **Próximo passo:** [1 linha, a primeira coisa a fazer ao voltar]
+- **Bloqueio:** [1 linha, ou "nenhum"]
+- **Última sessão:** [YYYY-MM-DD] — [1 linha]
+```
+
+Por que 12 linhas: o `/ver` vira 1 Read de 14 linhas em vez de um tail de 60. E o bloco fica no topo, onde qualquer humano abrindo a nota também lê primeiro.
+
+O que **não** entra no bloco: histórico, decisão, aprendizado, lista longa de pendências. Histórico é a tabela `Sessões`; decisão é `_decisions/`; aprendizado é a auto-memória do agente; a lista completa de pendências é a seção `O que falta`.
+
 ## /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)
@@ -15,21 +34,27 @@ Carregue este arquivo ao executar `/iniciar`, `/ver` ou `/salvar`. Antes de tudo
 6. Confirmar
 
 **Template `projetos/[nome].md`:**
+
 ```markdown
 # [Nome] — Estado Atual
 > Atualizado: [data]
 
+## Estado
+- **Fase:** [fase]
+- **Stack:** [stack]
+- **Onde parou:** [1 linha]
+- **Próximo passo:** [1 linha]
+- **Bloqueio:** nenhum
+- **Última sessão:** [data] — [1 linha]
+
 ## Preferências
 - Organização: [resposta]
 - Info essencial: [resposta]
 - Estilo: [resposta]
 - Modo: [registro / sugestivo]
 
-## Stack
-[breve descrição]
-
-## Onde parou
--
+## Contexto
+[o que o bloco Estado não cabe: stack detalhada, restrições, links]
 
 ## O que falta
 - [ ]
@@ -41,6 +66,7 @@ Carregue este arquivo ao executar `/iniciar`, `/ver` ou `/salvar`. Antes de tudo
 ```
 
 **Template bloco em CEREBRO.md:**
+
 ```markdown
 ### [Nome] [emoji]
 - **Stack:** [stack]
@@ -51,20 +77,14 @@ Carregue este arquivo ao executar `/iniciar`, `/ver` ou `/salvar`. Antes de tudo
 
 ## /ver
 
-**Objetivo:** mostrar estado atual rápido. Máximo: 1 Read.
+**Objetivo:** mostrar estado atual rápido. Máximo: 1 Read de 14 linhas.
 
 **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]
-```
+1. Read `projetos/[nome].md` com `limit=14` (o bloco Estado está no topo)
+2. Devolver o bloco quase como está, sem reescrever
+
+**Arquivo antigo, sem bloco Estado no topo:** cai no caminho lento uma única vez — `wc -l` e Read das últimas 60 linhas — e ao devolver, ofereça criar o bloco. Aceito, o próximo `/ver` volta a custar 1 Read curto.
 
 ## /salvar
 
@@ -73,6 +93,7 @@ O que falta: [checkboxes]
 **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
@@ -80,43 +101,46 @@ grep -n "### \|Última sessão\|Pendente" "$VAULT/CEREBRO.md" | grep -A2 -i "$PR
 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
+**2. Ler o topo e o fim do arquivo do projeto (2 Reads curtos)**
+
+- topo: `limit=14` → bloco Estado
+- fim: `offset = (total_linhas - 40)`, `limit = 40` → O que falta e 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:
+Em `projetos/[nome].md`:
+
+- **Sobrescrever o bloco `## Estado`** inteiro, mantendo os mesmos 6 campos e o teto de 12 linhas. Não empilhar bloco novo: o histórico é a tabela.
+- Atualizar a seção `O que falta` (marcar o que saiu, acrescentar o que entrou).
+- Acrescentar 1 linha ao fim da tabela `Sessões`:
+
 ```markdown
-## Hoje ([data] — [sessão])
-- [item 1]
-- [item 2]
+| [data] | [resumo 1 linha] |
 ```
 
-Substituir "Onde parou" e "O que falta" com o estado novo.
-
-Adicionar linha na tabela Sessões (append na última linha da tabela).
+Arquivo sem bloco `## Estado`: criar agora, logo abaixo do título, com o que a sessão apurou.
 
 **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
+**5. Se houve decisão relevante:** criar arquivo em `_decisions/` (ver `comandos-rotina-e-captura.md` para o frontmatter e a regra de grep-antes-de-gravar).
+Aprendizado técnico (armadilha de stack, bug não óbvio, pegadinha de ambiente) **não vai para o vault**: vai para a auto-memória do agente. No vault ninguém lia. No Claude Code ela carrega sozinha no início da sessão; em Codex, OpenCode e Gemini o caminho de leitura é o `/memoria` (ver `comandos-pesquisa-e-memoria.md`).
 
-**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).
+**6. Higiene do índice (compactação)**
 
-**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.
+```bash
+grep -c "^| " "$VAULT/projetos/$PROJ.md"
+```
+
+- Tabela Sessões com mais de 15 linhas: mover as mais antigas para `_index/cerebro-archive.md`, sob `## Sessões antigas — [projeto]`, deixando as 15 mais novas no arquivo do projeto. Nunca apagar, só mover.
+
+**7. Confirmar em 2 linhas** o que foi salvo.