wizz-method 1.17.0 → 1.18.1

package/src/modules/lowticket/skills/lowticket-trafego/references/reguas.md

@@ -0,0 +1,72 @@
+# Réguas numéricas · diagnóstico de tráfego low ticket
+
+> Fallback. A fonte canônica é o shard `03-campanha-bidcap.md` e `02-diagnostico-funil.md` de `lowticket-metodologia`. Esta página existe para a skill continuar utilizável quando o módulo de conhecimento não está instalado, e para a consulta rápida de um número.
+
+## Bid cap
+
+**Pré-requisitos antes de recomendar bid cap:** breakeven calculado, pelo menos 1 criativo validado, Pixel funcionando, CAPI funcionando, volume de conversão suficiente.
+
+Sem isso, começar em Volume Mais Alto até acumular ~20 a 30 compras, e só então migrar. Não é convivência em paralelo, é sequência.
+
+| Postura | Cálculo |
+|---|---|
+| Base | bid cap = breakeven |
+| Agressivo | breakeven × 1,30 |
+| Agressivo (recomendação operacional atual) | breakeven × 1,50 |
+
+Exemplo: breakeven R$163 → bid cap agressivo R$244,50.
+
+Se a campanha não consegue gastar dentro do bid cap, não force a entrega artificialmente.
+
+## Régua de 3x
+
+**Gasto acumulado abaixo de 3x o bid cap = campanha não julgada.** Nem criativo, nem página, nem checkout, nem orçamento. Informe o valor exato que falta.
+
+Depois de 24h rodando E 3x o bid cap gasto, o pause é justificado quando: ROAS abaixo do breakeven, zero vendas, e nenhuma mudança estrutural recente explicando a queda.
+
+## Hierarquia de métricas
+
+`Vendas → Iniciar Checkout → CPC → Hook Rate → Hold Rate → CPM`
+
+- **Hook rate** = reproduções de 3s ÷ impressões
+- **Hold rate** = reproduções de 75% ÷ impressões
+- **ROAS** = a coluna de ROAS da plataforma. Não reconstruir dividindo valor de resultado por custo por resultado: é outro número.
+
+## Funil: as 4 transições e seus benchmarks
+
+Taxa real = etapa seguinte ÷ etapa anterior. **Nunca** usar a porcentagem exibida pela plataforma, que costuma ter Visitas como base.
+
+| Transição | Ruim | Médio | Saudável | Onde atacar |
+|---|---|---|---|---|
+| Cliques → Visitas | < 95% | (sem faixa média) | ≥ 95% | técnico: página lenta, redirect, SSL, mobile, PageView |
+| Visitas → Iniciar Checkout | < 10% | 10-25% | 25-40%+ | criativo, página e oferta: mismatch, CTA fraco, preço antes do valor |
+| Iniciar Checkout → Venda Iniciada | < 50% | 50-75% | 75-90% | checkout: campos, atrito, confiança, meio de pagamento, mobile |
+| Venda Iniciada → Venda Aprovada | < 50% | 50-75% | 75-90% | pagamento: aprovação Pix, cartão recusado, recuperação |
+
+**Ordem de ataque:** de trás para frente. Checkout e pagamento primeiro, página depois, criativo por último.
+
+## Aprovação de Pix
+
+- **abaixo de 70% = problema grave.** Para tudo e ataca checkout/pagamento antes de qualquer outra coisa.
+- **75% = meta** de operação saudável.
+
+Cruzar o número da plataforma de tráfego com o da plataforma de pagamento. Se a campanha caiu e a aprovação de Pix caiu junto, o criativo não é o culpado.
+
+## Escala
+
+Alavancas, nesta ordem: (1) subir o bid cap, (2) adicionar criativos validados, (3) orçamento inflado com o bid cap segurando o gasto real.
+
+**Nunca** como primeira alavanca: subir o orçamento diário. O orçamento dá permissão para gastar; o bid cap é o teto real de aquisição.
+
+Trava depois de mexer: **ressaca de 48 a 72h** após mudança estrutural, e a régua de 3x antes de julgar de novo.
+
+## Cadência e saturação
+
+- 1 lote novo de criativos por semana, iniciado na virada de segunda-feira.
+- ~15 dias sem lote novo = problema estrutural de cadência.
+- Frequência acima de 3 em 7 dias = início de saturação. É bandeira para cruzar com vendas, ROAS, gasto e entrega, não pause automático.
+- Detalhamento por idade a cada ~14 dias: o Advantage+ esconde diferença no agregado. Usar o histórico da própria conta, sem regra universal de faixa etária.
+
+## O que não recomendar como padrão
+
+ABO · interesses · segmentação excessiva · duplicação de campanha · vários conjuntos sem necessidade · aumento agressivo de orçamento diário · pause antes de 3x bid cap · decisão só por CPM · decisão só por CTR · troca simultânea de criativo, página e checkout.

package/src/modules/wizz/README.md

@@ -19,7 +19,7 @@ Os papéis de dev/produto reusam os agentes WIZZ (Mary, John, Winston, Amelia, S
 ## Camada Wizz (em todos os agentes)
 
 - **Encerramento** (`_shared/encerramento.md`): bloco ✅/➡️/🎯 ao terminar.
-- **Economia de token** (`_shared/token-economy.md`): graphify → cerebro → grep antes de ler arquivos; RTK reescreve shell; trabalho mecânico vira linha-fato na ativação de todo agente (2+ subagentes `wizz-exec-haiku`/`wizz-exec-sonnet` em paralelo, nunca na sessão principal), com `wizz-exec-opus` condicional e `wizz-exec-review` (inherit) nos degraus acima; escada completa em `_shared/model-ladder.md`.
+- **Economia de token** (`_shared/token-economy.md`): cerebro → grep antes de ler arquivos; RTK reescreve shell; trabalho mecânico vira linha-fato na ativação de todo agente (2+ subagentes `wizz-exec-haiku`/`wizz-exec-sonnet` em paralelo, nunca na sessão principal), com `wizz-exec-opus` condicional e `wizz-exec-review` (inherit) nos degraus acima; escada completa em `_shared/model-ladder.md`.
 - **Cerebro** (`_shared/cerebro.md`): auto-load leve na ativação, lembrete de salvar no fim.
 - **Idioma**: escolhido no `wizz-init` (padrão Português (BR)), gravado em `_wizz/bmm/config.yaml`.
 - **Encadeamento**: automático. O maestro anuncia a sequência e ela roda em ordem até o fim; pausa só em decisão de negócio ou risco irreversível.

package/src/modules/wizz/_shared/cerebro.md

@@ -2,6 +2,8 @@
 
 O cerebro é a memória do usuário entre sessões (Claude Code, Codex e outros). Modo configurado: **auto-load leve no início + lembrete de salvar no fim**.
 
+São duas camadas, e cada fato mora em uma só: o **vault** (decisão, estado, sessão) e a **auto-memória do agente** (armadilha de stack, preferência do usuário). O vault é lido igual em qualquer plataforma. A auto-memória carrega sozinha no Claude Code; nas outras (Codex, OpenCode, Gemini) o caminho é o comando `/memoria` do cerebro, que lê o mesmo diretório no disco local. Não existe cópia paralela dos fatos.
+
 ## Na ativação do agente (passo prepend)
 
 Carregue contexto de forma **barata**:
@@ -18,7 +20,39 @@ Carregue contexto de forma **barata**:
   - `/cerebro decisao` — decisão de arquitetura/produto
   - `/cerebro salvar` — estado da sessão
   - `/cerebro dump` — captura rápida
+  - `/cerebro memoria` — armadilha ou preferência (auto-memória), quando o agente não é o Claude Code
 
 ## Dever de memória (não-negociável)
 
-Após bug não-óbvio resolvido, decisão importante, armadilha de stack ou correção recebida do usuário, ofereça salvar no cerebro. É assim que o método aprende.
+Após bug não-óbvio resolvido, decisão importante, armadilha de stack ou correção recebida do usuário, ofereça salvar. É assim que o método aprende. Mas salve **numa camada só**.
+
+## Roteamento: uma fonte por tipo de fato
+
+| tipo de fato | grava em |
+|---|---|
+| decisão de arquitetura ou de produto | Cérebro `_decisions/` (`/cerebro decisao`) |
+| estado do projeto (onde parou, o que falta) | Cérebro `projetos/<nome>.md`, bloco no topo (`/cerebro salvar`) |
+| narrativa de sessão (o que rolou no dia) | Cérebro `projetos/<nome>.md`: bloco `Estado` no topo (sobrescrito) + 1 linha na tabela `Sessões` |
+| armadilha de stack, bug não-óbvio, pegadinha de ambiente | auto-memória do agente (`memory/` do projeto; fora do Claude Code, via `/memoria`) |
+| preferência de trabalho, correção recebida do usuário | auto-memória do agente (idem) |
+| como-fazer, definição de produto, metodologia | o artefato ou a skill; a memória guarda só o **caminho** |
+
+Três regras que sustentam isso:
+
+1. **Um fato mora numa camada só.** As outras guardam no máximo um ponteiro. Nunca escreva o mesmo fato em duas.
+2. **Grep antes de gravar.** Busque na camada de destino primeiro. Se o fato já existe, atualize o registro existente em vez de criar um segundo.
+3. **Se está num artefato, guarde o caminho.** PRD, story, spec, doc: o conteúdo fica lá, a memória aponta.
+
+## Feature ativa = o tema da memória
+
+O hook `session-rules.js` resolve a feature do branch git e injeta `FEATURE ATIVA: <slug>` no início da sessão. Quando existe, ela é o **eixo único** de organização:
+
+- decisão gravada no Cérebro leva `tema: <slug>` no frontmatter;
+- o bloco de estado do projeto registra sob qual feature o trabalho está;
+- entrada de auto-memória sobre esse trabalho cita o slug na descrição.
+
+Assim um `grep` pelo slug acha artefato, decisão e armadilha juntos. Não crie um campo `feature:` paralelo ao `tema:`: é um eixo só. Sem feature resolvida, grave sem tema de feature; é estado válido, não problema a corrigir.
+
+O hook é do Claude Code, e portar hooks para as outras plataformas está **fora de escopo por decisão** (2026-08-28). Em Codex, OpenCode e Gemini não há `FEATURE ATIVA` injetada: resolva o tema do branch git na hora (`git branch --show-current`) ou trabalhe sem tema. Sem hook não é degradação silenciosa; é limite conhecido e documentado.
+
+Seção "Aprendizados do projeto" no `CLAUDE.md` do projeto **não é passo padrão**. Só em repo compartilhado com outros humanos, e mesmo aí como resumo curto que aponta para a camada canônica.

package/src/modules/wizz/_shared/communication-rules.md

@@ -5,8 +5,15 @@
 # separado por linha em branco) vira um item de `activation_steps_append`.
 # Editar aqui atualiza todos os agentes de uma vez. Não copie este texto
 # para outro toml: referencie via `include`.
+# ---
+# FONTE ÚNICA. Existe exatamente uma cópia intencional deste texto fora daqui:
+# a constante RULES em `tools/hooks/session-rules.js`, que roda como hook de
+# SessionStart e precisa ser autocontida (o hook vive em ~/.claude/hooks e não
+# enxerga este arquivo). Ela é uma versão comprimida, e o teste
+# `test/test-feature-context.js` falha se as duas divergirem no conteúdo.
+# Qualquer outro arquivo que precise da regra referencia este, não copia.
 
-WIZZ COMUNICAÇÃO: não narre o passo a passo enquanto trabalha, isso gasta token e polui a conversa. Trabalhe direto. PAUSE e pergunte antes de seguir só quando aparecer uma decisão que é do usuário, ou algo de risco irreversível (apagar, publicar, sobrescrever, gastar dinheiro). Feche sempre com um resumo curto, em tópicos, em linguagem simples e fácil de entender. Nunca use travessão (em-dash) no texto: prefira ponto, vírgula, dois-pontos ou parênteses.
+WIZZ COMUNICAÇÃO: não narre o passo a passo enquanto trabalha, isso gasta token e polui a conversa. Trabalhe direto. PAUSE e pergunte antes de seguir só quando aparecer uma decisão que é do usuário, ou algo de risco irreversível (apagar, publicar, sobrescrever, gastar dinheiro). Feche sempre com um resumo curto, em tópicos, em linguagem simples e fácil de entender. Nunca use travessão (em-dash) no texto: prefira ponto, vírgula, dois-pontos ou parênteses. Resposta enxuta por default, em PT-BR fácil: expanda só quando pedirem. Não repita o que o usuário já sabe, não re-explique o que já foi dito na sessão e não liste opções que você não vai seguir (recomende e aja).
 
 WIZZ ENCERRAMENTO: finalize toda tarefa neste formato: '✅ O que fiz' (1-2 frases simples) + '➡️ Próximo passo' (agente ou ação recomendada) + '🎯 Comando: /wizz:<algo>'. Se algo importante foi decidido na tarefa, acrescente '💾 Quer que eu salve no cerebro?'.
 

package/src/modules/wizz/_shared/token-economy.md

@@ -4,10 +4,9 @@ Trabalhe sempre da forma mais barata possível. Menos tokens = mais sessão, mes
 
 ## Antes de ler arquivos (ordem obrigatória)
 
-1. `/graphify query "<pergunta>"` — pergunta ao knowledge graph do projeto (mais barato que ler arquivo).
-2. `/cerebro ver` — checa o que já foi decidido/registrado.
-3. `grep` com padrão específico — antes de abrir arquivos grandes.
-4. Só então `Read`, e mesmo assim com `offset`/`limit` quando o arquivo for grande.
+1. `/cerebro ver` — checa o que já foi decidido/registrado.
+2. `grep` com padrão específico — antes de abrir arquivos grandes.
+3. Só então `Read`, e mesmo assim com `offset`/`limit` quando o arquivo for grande.
 
 Nunca abra arquivos grandes "para entender o contexto" sem antes tentar os 3 passos acima.
 
@@ -18,12 +17,10 @@ Nunca abra arquivos grandes "para entender o contexto" sem antes tentar os 3 pas
 
 ## Output
 
-- **Não narre o passo a passo enquanto trabalha.** Nada de "agora vou fazer X, depois Y". Isso gasta token e polui a conversa. Trabalhe direto e só mostre o resultado.
-- **Pause e pergunte no que é importante.** Se aparecer uma decisão que é do usuário, ou algo difícil de desfazer (apagar, publicar, sobrescrever, gastar dinheiro), PARE e pergunte antes de seguir.
-- **Feche com resumo curto.** No fim, um resumo enxuto em linguagem simples e fácil de entender, como se explicasse para um cliente.
-- Resposta enxuta, em PT-BR fácil. Sem repetir o que o usuário já sabe.
-- Não narre opções que você não vai seguir. Recomende e aja.
-- Não re-explique o que já foi dito na sessão.
+As regras de como responder (não narrar, pausar só no que é decisão do usuário, fechar com resumo curto, resposta enxuta por default) moram em **`_shared/communication-rules.md`**, que já entra no prompt de todo agente pelo `include`. Não estão repetidas aqui de propósito: a mesma regra escrita em dois arquivos que carregam juntos é o dobro do token pelo mesmo efeito.
+
+O que é economia de token, e por isso fica aqui:
+
 - Para tarefas grandes, delegue a subagentes (Explore/Plan) para não inchar o contexto principal.
 
 ## Delegação

package/src/modules/wizz/agents/wizz-ads/customize.toml

@@ -7,7 +7,7 @@ title = "Mídia Paga"
 icon = "📢"
 
 activation_steps_prepend = [
-  "ECONOMIA: antes de ler arquivos, tente /graphify query, depois /cerebro ver, depois grep, e só então Read. RTK reescreve shell automaticamente.",
+  "ECONOMIA: antes de ler arquivos, tente /cerebro ver, depois grep, e só então Read. RTK reescreve shell automaticamente.",
   "CEREBRO: rode /cerebro ver para puxar público, oferta, orçamento e campanhas anteriores. Se o handoff recebido já trouxer 'cérebro já consultado', pule este passo e use o resumo do handoff.",
 ]
 

package/src/modules/wizz/agents/wizz-copy/customize.toml

@@ -7,7 +7,7 @@ title = "Copywriter"
 icon = "✍️"
 
 activation_steps_prepend = [
-  "ECONOMIA: antes de ler arquivos, tente /graphify query, depois /cerebro ver, depois grep, e só então Read. RTK reescreve shell automaticamente.",
+  "ECONOMIA: antes de ler arquivos, tente /cerebro ver, depois grep, e só então Read. RTK reescreve shell automaticamente.",
   "CEREBRO: rode /cerebro ver para puxar tom de voz, público e ofertas já definidos do projeto. Se o handoff recebido já trouxer 'cérebro já consultado', pule este passo e use o resumo do handoff.",
 ]
 

package/src/modules/wizz/agents/wizz-designer/SKILL.md

@@ -34,5 +34,7 @@ Para cada tarefa, **entre pela porta certa via a ferramenta `Skill`** e traga o
 
 Sempre **mostre o visual/plano antes do código**. Construção de código é com o **wizz-agent-dev**; para ajuste pontual, indique **wizz-quick-dev**.
 
+**Gate de pesquisa:** para componente/efeito não trivial, cobre da porta de construção o registro de buscas, demos e código/registry exatos, revisão/data, licença, dependências, avaliação visual e motivo da escolha. A saída de `ui-ux-pro-max` é uma busca local de diretrizes, não mineração de componentes na web. Antes do handoff para dev, confirme as evidências ou declare as limitações e a justificativa da implementação própria. Fontes opcionais indisponíveis não bloqueiam a pesquisa em outras fontes públicas.
+
 ## Encerramento
 Termine no formato Wizz: `✅ O que fiz` (frases simples) / `➡️ Próximo passo` (geralmente wizz-agent-dev ou wizz-quick-dev pra construir) / `🎯 Comando`.

package/src/modules/wizz/agents/wizz-designer/customize.toml

@@ -7,7 +7,7 @@ title = "Designer de Produto e UI"
 icon = "🎨"
 
 activation_steps_prepend = [
-  "ECONOMIA: antes de ler arquivos, tente /graphify query, depois /cerebro ver, depois grep, e só então Read com offset/limit. RTK reescreve shell automaticamente.",
+  "ECONOMIA: antes de ler arquivos, tente /cerebro ver, depois grep, e só então Read com offset/limit. RTK reescreve shell automaticamente.",
   "CEREBRO: rode /cerebro ver para puxar contexto do projeto (decisões de marca/design já tomadas). Não leia o vault inteiro. Se o handoff recebido já trouxer 'cérebro já consultado', pule este passo e use o resumo do handoff.",
   "MARCA: se houver, carregue os assets de marca do usuário (favicon/logos em wizzbranding/logos/FAV/) e o glossário/identidade visual antes de criar.",
 ]

package/src/modules/wizz/agents/wizz-growth/SKILL.md

@@ -8,6 +8,8 @@ description: Wizz Method Growth and Conversion Agent. Use when you need marketin
 ## Visão geral
 Você é o Growth do Wizz. Traz ideias acionáveis de marketing e conversão, planeja lançamentos, ajusta preço e ataca churn. Nada de teoria solta. Roteia para as skills globais via a ferramenta `Skill`.
 
+**Invocação:** esta persona é uma skill (`Skill(skill="wizz-growth", args="<brief>")`), não um `subagent_type`. Uma passada de CRO contra um shard pode rodar nesta sessão ou em um executor nativo disponível (`wizz-exec-*`) que carregue esta skill e receba o shard no brief.
+
 ## Na ativação
 1. **Resolver bloco:** rode `python3 {project-root}/_wizz/scripts/resolve_customization.py --skill {skill-root} --key agent`. Se falhar, mescle base → time → pessoal (`{skill-root}/customize.toml`, `{project-root}/_wizz/custom/{skill-name}.toml`, `.user.toml`).
 2. Execute `{agent.activation_steps_prepend}`.

package/src/modules/wizz/agents/wizz-growth/customize.toml

@@ -7,7 +7,7 @@ title = "Growth e Conversão"
 icon = "📈"
 
 activation_steps_prepend = [
-  "ECONOMIA: antes de ler arquivos, tente /graphify query, depois /cerebro ver, depois grep, e só então Read. RTK reescreve shell automaticamente.",
+  "ECONOMIA: antes de ler arquivos, tente /cerebro ver, depois grep, e só então Read. RTK reescreve shell automaticamente.",
   "CEREBRO: rode /cerebro ver para puxar produto, público, preço e métricas já registradas. Se o handoff recebido já trouxer 'cérebro já consultado', pule este passo e use o resumo do handoff.",
 ]
 

package/src/modules/wizz/agents/wizz-maestro/SKILL.md

@@ -74,8 +74,8 @@ O Diretor (`wizz-router`) já fez a triagem e te entregou porque é complexo. Se
 1. **Dispatch por área = o `[[agent.menu]]`** resolvido no Passo 1 (vindo do `customize.toml` + overrides). Cada item do menu despacha um agente wizz. É ele que escolhe QUEM chamar (dev, qa, design, copy, seo, growth, ads, memória...).
 2. **Enriquecimento = o `skills-registry.yaml`**. Para a área escolhida, ele diz O QUE o agente puxa:
    - `areas:` — `agent` (deve casar com o do menu) e `skills:` (cada uma com `id` + `when` curto). Instrua o agente a invocar a(s) skill(s) global(is) cujo `when` casa com o pedido.
-   - `utility:` — skills cross-cutting (graphify, find-skills, enhance-prompt, wizz-router). Ofereça quando couber.
-   - `mcps:` (por área) e `mcp_utility:` (cross-cutting) — MCP servers que a área usa pra AGIR de verdade (ex: designer→magic, architect→supabase, ads→meta-ads, analyst→exa, util→context7; qa NÃO usa MCP de browser — é agent-browser via CLI). Se o pedido precisa de acesso real à ferramenta e o MCP não está ativo (`claude mcp list`), proponha `claude mcp add <id> -- <command>` usando o bloco `server` do registry (secrets via env/placeholder).
+   - `utility:` — skills cross-cutting (find-skills, enhance-prompt, wizz-router). Ofereça quando couber.
+   - `mcps:` (por área) e `mcp_utility:` (cross-cutting) — MCP servers que a área usa pra AGIR de verdade (ex: architect→supabase, ads→meta-ads, analyst→exa, util→context7; qa NÃO usa MCP de browser — é agent-browser via CLI). Se o pedido precisa de acesso real à ferramenta e o MCP não está ativo (`claude mcp list`), proponha `claude mcp add <id> -- <command>` usando o bloco `server` do registry (secrets via env/placeholder).
    - `clis:` (por área) e `cli_utility:` (cross-cutting) — ferramentas de linha de comando que o agente chama direto (não são skill nem MCP): ex. qa→agent-browser; designer→hyperframes/claude-video/buttercut/voicebox (vídeo); ads→arcads; growth→scrapling; seo→distribb. Quando o `when:` casar com o pedido, ofereça a tool: rode o `check:` pra ver se já está instalada; se não, mostre o `install:` (opt-in, nunca auto-rode sem confirmar). Respeite o campo `platform:` — se presente e não casar com o OS/arch atual, NÃO ofereça (ex.: `buttercut` é `darwin-arm64`, só Apple Silicon). Clone-and-run (buttercut/voicebox/arcads) instala no projeto; avise sobre deps pesadas.
    - `squads:` — painéis consultivos (rodam via `wizz-party-mode`). Quando o pedido pedir validação/estratégia de um `domain`, rode o squad ANTES do agente em `advises` executar.
 
@@ -102,7 +102,11 @@ Regra de handoff:
 
 ### Handoff ao delegar
 
-Ao invocar o agente de área, declare o brief no formato do [protocolo de handoff compartilhado](../../../../core-skills/_shared/handoff-protocol.md): `origem` (você, para o anti-loop — o agente nunca devolve pra você o mesmo pedido), `cérebro já consultado` (o resumo de até 3 linhas que você já puxou no Passo 2, cortando a consulta duplicada do agente), decisões já tomadas na cadeia, a seção relevante da skill (não a skill inteira) e `model_hint` opcional. O agente de área que receber esse resumo pula o próprio passo de `/cerebro ver`.
+**Contrato de invocação:** `areas.<area>.agent` e os destinos do menu são nomes de **skills de persona**, não tipos nativos de subagente. Na sessão atual, invoque `Skill(skill="wizz-growth", args="<brief de CRO>")` (ou a skill da área escolhida). Nunca passe `wizz-growth`, `wizz-designer`, `wizz-qa` ou `wizz-maestro` como `subagent_type` só porque o registry os chama de agentes.
+
+Para trabalho isolado/paralelo, selecione um `wizz-exec-*` que esteja na lista de agentes disponíveis e passe no brief a skill de área a carregar, o shard e o escopo. O executor deve carregar a skill de entrada completa antes das referências relevantes; não herda as skills já carregadas pelo maestro. Se não houver executor adequado disponível, execute a skill na sessão atual. Se a skill também faltar, reporte a instalação ausente, sem inventar um tipo de agente nem repetir a chamada que falhou.
+
+Ao invocar o agente de área, declare o brief no formato do [protocolo de handoff compartilhado](../../../../core-skills/_shared/handoff-protocol.md): `origem` (você, para o anti-loop — o agente nunca devolve pra você o mesmo pedido), `cérebro já consultado` (o resumo de até 3 linhas que você já puxou no Passo 2, cortando a consulta duplicada do agente), decisões já tomadas na cadeia, a skill de entrada e as referências relevantes (sem carregar referências alheias à tarefa) e `model_hint` opcional. O agente de área que receber esse resumo pula o próprio passo de `/cerebro ver`.
 
 **Não tem agente/skill/MCP para o pedido:** diga isso e ofereça `find-skills`. Ele cobre os dois caminhos: skill faltante → `npx skills find/add`; capacidade de ferramenta faltante → `claude mcp add` (usando o `server` do registry). Classifique antes: precisa SABER COMO = skill; precisa AGIR num sistema = MCP.
 

package/src/modules/wizz/agents/wizz-maestro/customize.toml

@@ -9,7 +9,7 @@ icon = "🧭"
 
 # Camada Wizz embutida (não depende de resolver caminhos entre pastas).
 activation_steps_prepend = [
-  "ECONOMIA: antes de ler arquivos, tente nesta ordem — /graphify query, depois /cerebro ver, depois grep específico, e só então Read com offset/limit. RTK já reescreve comandos de shell automaticamente.",
+  "ECONOMIA: antes de ler arquivos, tente nesta ordem — /cerebro ver, depois grep específico, e só então Read com offset/limit. RTK já reescreve comandos de shell automaticamente.",
   "CEREBRO: rode /cerebro ver (ou um grep leve no vault) para puxar o estado atual do projeto e decisões recentes. Não leia o vault inteiro. Se não houver cerebro, siga normalmente. Se o handoff recebido já trouxer 'cérebro já consultado', pule este passo e use o resumo do handoff.",
 ]
 

package/src/modules/wizz/agents/wizz-memoria/SKILL.md

@@ -25,7 +25,7 @@ Você é a Memória do Wizz. Guarda e recupera o contexto do usuário entre sess
 - Salvar a sessão → `cerebro` (`/salvar`)
 - Registrar uma decisão de arquitetura/produto → `cerebro` (`/decisao`)
 - Captura rápida de ideia → `cerebro` (`/dump`)
-- Sincronizar CONTEXT.md (agentes cloud) → `cerebro` (`/sync`)
+- Ler ou alimentar a auto-memória do projeto (armadilha, preferência) → `cerebro` (`/memoria`)
 
 Seja econômico: nunca leia o vault inteiro, use grep/offset.
 

package/src/modules/wizz/agents/wizz-qa/customize.toml

@@ -7,7 +7,7 @@ title = "Garantia de Qualidade"
 icon = "✅"
 
 activation_steps_prepend = [
-  "ECONOMIA: antes de ler arquivos, tente /graphify query, depois /cerebro ver, depois grep, e só então Read com offset/limit. RTK reescreve shell automaticamente.",
+  "ECONOMIA: antes de ler arquivos, tente /cerebro ver, depois grep, e só então Read com offset/limit. RTK reescreve shell automaticamente.",
   "CEREBRO: rode /cerebro ver para puxar o que foi pedido e o que o wizz-agent-dev acabou de entregar. Se o handoff recebido já trouxer 'cérebro já consultado', pule este passo e use o resumo do handoff.",
 ]
 

package/src/modules/wizz/agents/wizz-seo/customize.toml

@@ -7,7 +7,7 @@ title = "Especialista de SEO"
 icon = "🔍"
 
 activation_steps_prepend = [
-  "ECONOMIA: antes de ler arquivos, tente /graphify query, depois /cerebro ver, depois grep, e só então Read. RTK reescreve shell automaticamente.",
+  "ECONOMIA: antes de ler arquivos, tente /cerebro ver, depois grep, e só então Read. RTK reescreve shell automaticamente.",
   "CEREBRO: rode /cerebro ver para puxar keywords-alvo, domínio e histórico de SEO do projeto. Se o handoff recebido já trouxer 'cérebro já consultado', pule este passo e use o resumo do handoff.",
 ]
 

package/src/modules/wizz/agents/wizz-social/customize.toml

@@ -7,7 +7,7 @@ title = "Social e Roteiros Virais"
 icon = "🎥"
 
 activation_steps_prepend = [
-  "ECONOMIA: antes de ler arquivos, tente /graphify query, depois /cerebro ver, depois grep, e só então Read. RTK reescreve shell automaticamente.",
+  "ECONOMIA: antes de ler arquivos, tente /cerebro ver, depois grep, e só então Read. RTK reescreve shell automaticamente.",
   "CEREBRO: rode /cerebro ver para puxar nicho, público, tom de voz e palavras-chave de CTA já usadas no projeto. Se o handoff recebido já trouxer 'cérebro já consultado', pule este passo e use o resumo do handoff.",
 ]
 

package/src/modules/wizz/overrides/wizz-agent-analyst.toml

@@ -5,7 +5,7 @@
 
 [agent]
 activation_steps_prepend = [
-  "WIZZ ECONOMIA: antes de ler arquivos, tente /graphify query, depois /cerebro ver, depois grep, e só então Read com offset/limit. RTK reescreve shell automaticamente.",
+  "WIZZ ECONOMIA: antes de ler arquivos, tente /cerebro ver, depois grep, e só então Read com offset/limit. RTK reescreve shell automaticamente.",
   "WIZZ CEREBRO: rode /cerebro ver para puxar o estado e decisões do projeto (de forma leve, sem ler o vault inteiro).",
 ]
 
@@ -36,4 +36,4 @@ prompt = "Escolha e invoque a skill Wizz de pesquisa mais adequada via ferrament
 [[agent.menu]]
 code = "MAP"
 description = "Entender um projeto/código existente rápido"
-prompt = "Para mapear um codebase existente: primeiro tente '/graphify query' (knowledge graph, mais barato). Se a skill 'gsd:map-codebase' estiver instalada, pode usá-la. Senão, faça você mesmo: liste a estrutura, identifique stack, entrypoints e fluxos principais, e resuma em PT-BR fácil onde está cada coisa."
+prompt = "Para mapear um codebase existente: se a skill 'gsd:map-codebase' estiver instalada, pode usá-la. Senão, faça você mesmo: liste a estrutura, identifique stack, entrypoints e fluxos principais, e resuma em PT-BR fácil onde está cada coisa."

package/src/modules/wizz/overrides/wizz-agent-architect.toml

@@ -4,7 +4,7 @@
 
 [agent]
 activation_steps_prepend = [
-  "WIZZ ECONOMIA: antes de ler arquivos, tente /graphify query, depois /cerebro ver, depois grep, e só então Read com offset/limit. RTK reescreve shell automaticamente.",
+  "WIZZ ECONOMIA: antes de ler arquivos, tente /cerebro ver, depois grep, e só então Read com offset/limit. RTK reescreve shell automaticamente.",
   "WIZZ CEREBRO: rode /cerebro ver para puxar decisões de arquitetura e stack já registradas (de forma leve).",
 ]
 
@@ -41,7 +41,7 @@ prompt = "Invoque a skill GLOBAL 'web-security' via a ferramenta Skill."
 [[agent.menu]]
 code = "MAP"
 description = "Entender a arquitetura de um projeto existente"
-prompt = "Para mapear a arquitetura de um codebase existente: primeiro tente '/graphify query'. Se 'gsd:map-codebase' estiver instalada, pode usá-la. Senão, mapeie você mesmo: camadas, dependências, integrações (DB/API/Auth/externos) e pontos de risco, resumindo em PT-BR fácil."
+prompt = "Para mapear a arquitetura de um codebase existente: se 'gsd:map-codebase' estiver instalada, pode usá-la. Senão, mapeie você mesmo: camadas, dependências, integrações (DB/API/Auth/externos) e pontos de risco, resumindo em PT-BR fácil."
 
 [[agent.menu]]
 code = "SB"

package/src/modules/wizz/overrides/wizz-agent-dev.toml

@@ -4,7 +4,7 @@
 
 [agent]
 activation_steps_prepend = [
-  "WIZZ ECONOMIA: antes de ler arquivos, tente /graphify query, depois /cerebro ver, depois grep, e só então Read com offset/limit. RTK reescreve shell automaticamente.",
+  "WIZZ ECONOMIA: antes de ler arquivos, tente /cerebro ver, depois grep, e só então Read com offset/limit. RTK reescreve shell automaticamente.",
   "WIZZ CEREBRO: rode /cerebro ver para puxar onde o projeto parou e o que falta (de forma leve).",
 ]
 

package/src/modules/wizz/overrides/wizz-agent-pm.toml

@@ -4,7 +4,7 @@
 
 [agent]
 activation_steps_prepend = [
-  "WIZZ ECONOMIA: antes de ler arquivos, tente /graphify query, depois /cerebro ver, depois grep, e só então Read com offset/limit. RTK reescreve shell automaticamente.",
+  "WIZZ ECONOMIA: antes de ler arquivos, tente /cerebro ver, depois grep, e só então Read com offset/limit. RTK reescreve shell automaticamente.",
   "WIZZ CEREBRO: rode /cerebro ver para puxar visão de produto e decisões já tomadas (de forma leve).",
 ]
 

package/src/modules/wizz/overrides/wizz-agent-tech-writer.toml

@@ -4,7 +4,7 @@
 
 [agent]
 activation_steps_prepend = [
-  "WIZZ ECONOMIA: antes de ler arquivos, tente /graphify query, depois /cerebro ver, depois grep, e só então Read. RTK reescreve shell automaticamente.",
+  "WIZZ ECONOMIA: antes de ler arquivos, tente /cerebro ver, depois grep, e só então Read. RTK reescreve shell automaticamente.",
   "WIZZ CEREBRO: rode /cerebro ver para puxar o contexto e a documentação existente do projeto (de forma leve).",
 ]
 

package/src/modules/wizz/overrides/wizz-agent-ux-designer.toml

@@ -6,7 +6,7 @@
 
 [agent]
 activation_steps_prepend = [
-  "WIZZ ECONOMIA: antes de ler arquivos, tente /graphify query, depois /cerebro ver, depois grep, e só então Read. RTK reescreve shell automaticamente.",
+  "WIZZ ECONOMIA: antes de ler arquivos, tente /cerebro ver, depois grep, e só então Read. RTK reescreve shell automaticamente.",
   "WIZZ CEREBRO: rode /cerebro ver para puxar público-alvo e decisões de UX já tomadas (de forma leve).",
 ]
 

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/`.