wizz-method 1.17.0 → 1.18.0

package/src/skills-lib/wizz-offer-forge/SKILL.md

@@ -16,6 +16,7 @@ Um artefato mestre `OFFER-SPEC.md` contendo:
 4. **Ancoragem de Preço, Modelagem de Planos & Order Bumps / Upsells**.
 5. **Garantia Reversa / Inversão de Risco** (Risco Zero ou Ganho Duplo).
 6. **Ponte de Tráfego: Matriz de Hooks e Ângulos de Criativos**.
+7. **Plano de Medição** (eventos mínimos, padrão de UTM, metas por transição, hipótese e número que reprova).
 
 ## Princípios de Forja de Oferta
 
@@ -28,11 +29,21 @@ Um artefato mestre `OFFER-SPEC.md` contendo:
 
 ### Passo 0 — Coleta de Insumos & Ambição
 
-Consulte o contexto existente ou pergunte ao usuário:
+**Antes de perguntar qualquer coisa, leia o que já existe.** Oferta boa nasce do resultado da anterior, não de página em branco.
+
+Se a skill `cerebro` estiver instalada, rode `/cerebro ver` do projeto e faça um grep por tema em `_decisions/`. Procure especificamente: oferta anterior do mesmo público, preço que já foi testado, garantia que já foi usada, e decisão registrada que proíba algum caminho. Traga o que achou como insumo e diga na resposta de onde veio. Sem a skill instalada, pule este bloco e siga com as perguntas abaixo.
+
+Depois, consulte o contexto existente ou pergunte ao usuário:
 1. **Pesquisa de Público Prévia:** Existe um relatório da skill `pesquisa-de-publico-do-piva` ou notas de VoC? Se sim, importe como insumo primário. Se não, defina Avatar, Dor Latente e Nível de Consciência inicial.
 2. **Modelo de Negócio:** Low-ticket (R$ 10 a R$ 97), Front-end médio (R$ 197 a R$ 497) ou High-ticket / Mentoria (R$ 1.000 a R$ 10.000+)?
 3. **Veículo de Entrega:** Curso gravado, comunidade, templates/ferramentas, mentoria ao vivo, SaaS ou híbrido?
 
+### Passo 0.5 — Régua local tem precedência
+
+Se a skill `lowticket-metodologia` estiver instalada neste projeto, leia as entradas de **oferta, preço e garantia** do INDEX dela e use esses valores como régua acima dos padrões desta skill (faixas de preço, múltiplo de upsell, prazo de garantia). Declare na resposta qual régua está valendo. Onde a régua local contradisser esta skill, **a régua local vence**.
+
+Sem essa skill instalada, siga com os padrões desta skill. Nada muda.
+
 ### Passo 1 — Destilação do Mecanismo Único
 
 Consulte `references/mecanismo-unico.md`:
@@ -70,6 +81,20 @@ Consulte `references/ponte-trafego.md`:
   3. *Gancho da Demonstração do Mecanismo*
   4. *Gancho da História de Transformação / Case*
 
-### Passo 6 — Compilação e Entrega
+### Passo 6 — Plano de Medição
+
+Consulte `references/plano-de-medicao.md`.
+
+Uma oferta sem definição de sucesso não pode ser diagnosticada depois: quando ela não converte, ninguém sabe se o furo foi criativo, página, checkout ou a oferta em si. Este passo fecha esse buraco enquanto a promessa ainda está fresca.
+
+Derive da própria oferta, sem inventar número:
+- **Eventos mínimos** que precisam existir para medir esta promessa.
+- **Padrão de UTM** por canal de entrada.
+- **Metas por transição do funil**, calibradas para este ticket, com a fonte da régua declarada.
+- **A hipótese principal** em uma frase, e o **número que reprova a oferta**.
+
+Se a skill `tracking-audit` estiver instalada, delegue a implantação e a conferência para ela: aqui se declara o que precisa ser verdade, lá se prova que é.
+
+### Passo 7 — Compilação e Entrega
 
 Grave o artefato final em `{output_folder}/offers/OFFER-[NOME_SLUG].md` e apresente um resumo executivo com os 4 pontos de decisão para validação imediata do usuário.

package/src/skills-lib/wizz-offer-forge/references/plano-de-medicao.md

@@ -0,0 +1,74 @@
+# Plano de Medição da Oferta
+
+O sétimo bloco do `OFFER-SPEC.md`. Não é arquivo separado, é uma seção do artefato.
+
+Serve para uma coisa só: quando a oferta não converter, saber **onde** ela não converteu. Sem isso o diagnóstico vira arqueologia.
+
+Regra que atravessa tudo: **nada de número inventado**. Toda meta tem fonte declarada (régua da metodologia local, histórico do próprio projeto, ou combinado com o usuário). O que não tiver fonte fica escrito como pendência.
+
+## 1. Eventos mínimos
+
+Derive da promessa, não de uma lista pronta. A pergunta é: qual é o instante em que esta oferta foi aceita?
+
+Base para quase toda oferta de resposta direta:
+
+| Evento | Marca | Obrigatório |
+|---|---|---|
+| `PageView` | chegou à página | sim |
+| `ViewContent` | chegou ao bloco da oferta | sim |
+| `InitiateCheckout` | clicou para comprar | sim |
+| `Purchase` (com valor e moeda) | venda aprovada | sim |
+| `AddPaymentInfo` | preencheu pagamento | quando o checkout tiver a etapa |
+| evento do order bump | aceitou o bump | quando houver bump |
+| evento do upsell | aceitou o upsell | quando houver upsell |
+
+`Purchase` sem valor monetário inutiliza qualquer cálculo de retorno. Evento duplicado inutiliza todos.
+
+## 2. Padrão de UTM por canal
+
+Uma linha por rota de entrada que esta oferta vai usar. Toda rota, inclusive as próprias:
+
+```
+anúncio    utm_source=<plataforma>&utm_campaign=<nome>|<id>&utm_medium=<conjunto>|<id>&utm_content=<anúncio>|<id>
+bio        utm_source=instagram&utm_medium=bio&utm_campaign=<oferta>
+destaque   utm_source=instagram&utm_medium=destaque&utm_campaign=<nome-do-destaque>
+story      utm_source=instagram&utm_medium=story&utm_campaign=<oferta>
+e-mail     utm_source=email&utm_medium=<sequência>&utm_campaign=<oferta>
+```
+
+Rota sem UTM cai no balde do orgânico e some da análise. Se a skill `tracking-audit` estiver instalada, ela é a dona da implantação e da conferência disso.
+
+## 3. Metas por transição
+
+As cinco transições do funil, com a meta calibrada para **este** ticket e a fonte ao lado:
+
+| Transição | Meta | Fonte da meta |
+|---|---|---|
+| Cliques → visitas | | |
+| Visitas → checkout iniciado | | |
+| Checkout iniciado → venda iniciada | | |
+| Venda iniciada → aprovada (PIX) | | |
+| Venda iniciada → aprovada (cartão) | | |
+
+Preencher com régua declarada. Célula sem fonte fica vazia e vira pendência, nunca chute.
+
+## 4. Hipótese e número que reprova
+
+Duas frases, e elas são o coração do bloco:
+
+```
+Hipótese: <público> compra <promessa> a <preço> porque <mecanismo>,
+          e isso aparece como <métrica> acima de <número>.
+
+Reprova:  se depois de <volume mínimo de dados> a <métrica> ficar abaixo de <número>,
+          a oferta está errada e o próximo passo é <mudar promessa | mudar preço | mudar público>.
+```
+
+O volume mínimo importa tanto quanto o número. "Não converteu" com 40 visitas não é informação.
+
+## 5. Ponte com o tracking
+
+Este bloco **declara** o que precisa ser verdade. Ele não instala nada e não confere nada.
+
+- Com `tracking-audit` instalada: o passo seguinte é rodar o modo implantação dela usando este bloco como entrada.
+- Sem ela: entregue o bloco como checklist manual e diga que a conferência não foi feita.

package/src/skills-lib/wizz-router/SKILL.md

@@ -20,7 +20,7 @@ Você é o **Diretor / porta de entrada** — não o orquestrador (esse é o `wi
 
 **Nota de escopo de instalação:** esta é a única skill do catálogo onde instalação **global** (`~/.claude/skills/wizz-router`) é o padrão operacionalmente correto, não uma exceção à regra "prefer local" (`skills-registry.yaml`, Doutrina de Instalação, regra 1) — sua razão de existir é rotear mesmo fora de um projeto Wizz. Fica sincronizada com o hook global `wizz-router-enforce.js` via `npm run sync:global`.
 
-**Economia de tokens:** o hook `rtk-rewrite.sh` já cuida do RTK automaticamente (não rode `rtk --version` a cada roteamento). Antes de ler arquivos crus, prefira `/graphify query`, `/cerebro ver`, ou `grep` específico.
+**Economia de tokens:** o hook `rtk-rewrite.sh` já cuida do RTK automaticamente (não rode `rtk --version` a cada roteamento). Antes de ler arquivos crus, prefira `/cerebro ver` ou `grep` específico.
 
 ## Triagem e delegação (o coração do Diretor)
 

package/src/skills-lib/wizz-router/references/routing-table-flat.md

@@ -61,6 +61,7 @@ Use esta tabela pra mapear skills/CLIs/MCPs direto **fora de projeto Wizz** (sem
 | Ideias de marketing, estratégia de marketing, posicionamento | `marketing-ideas` + `marketing-psychology` + `product-marketing-context` | 1 |
 | Paid ads, anúncios, Google Ads, Meta Ads, TikTok Ads, mídia paga | `paid-ads` + `ad-creative` + `analytics-tracking` + **MCP meta-ads** | 1 |
 | Gestão de campanha Meta/Facebook/Instagram via API real | **MCP meta-ads** (`mcp-meta-ads`) direto | 1 |
+| Pixel/UTM/atribuição erradas, "a venda não bate com o gerenciador", "onde está furando o funil", tráfego orgânico inflado, conferir tracking antes de subir campanha | `tracking-audit` (+ `analytics-tracking` se for SaaS/produto) | 1 |
 | Lançamento de feature, lançamento de produto, go-to-market | `launch-strategy` + `social-content` + `email-sequence` | 1 |
 | Site pronto pra subir, pré-lançamento de SITE, "revisa antes do deploy", checklist de go-live, ou item pontual pré-lançamento (og:image/prévia de link, FAQ com schema, robots.txt, LGPD, alt text) | `site-launch-kit` | 1 |
 | Preço, planos, pricing, monetização | `pricing-strategy` + `paywall-upgrade-cro` | 1 |
@@ -85,7 +86,6 @@ Use esta tabela pra mapear skills/CLIs/MCPs direto **fora de projeto Wizz** (sem
 | Intenção / palavras-chave | Skills a oferecer | Prioridade |
 |---|---|---|
 | O que foi decidido, contexto passado, aprendizados, histórico | `cerebro` (/ver ou /dia) | 1 |
-| Entender o codebase, mapear estrutura do projeto | `/graphify query` (antes de ler arquivos) | 1 |
 
 ---
 

package/tools/installer/commands/trace-report.js

@@ -36,7 +36,7 @@ function getRegistryFile() {
 // Lê e parseia skills-registry.yaml, devolvendo o catálogo de ids de
 // skills em ordem alfabética estável (mesma lista independente da ordem em
 // que as áreas/skills aparecem no YAML). Escopo deliberado: só as skills
-// `areas.*.skills[]` e as cross-cutting `utility[]` (graphify, find-skills,
+// `areas.*.skills[]` e as cross-cutting `utility[]` (find-skills,
 // enhance-prompt, wizz-router; também são skills de verdade em
 // src/skills-lib/). CLIs/MCPs/squads ficam de fora: `sel`/`desc` no
 // marcador de decisão podem citar agentes ou skills (ver encerramento.md),

package/tools/installer/modules/skills-lib.js

@@ -29,7 +29,7 @@ const { resolveAreaEntries } = require('./registry-resolve');
 /**
  * Resolve which skill ids to install from the registry for the chosen areas.
  * Empty / undefined / containing 'all' means every area. Utility skills
- * (graphify, find-skills, ...) are cross-cutting and always included.
+ * (find-skills, wizz-router, ...) are cross-cutting and always included.
  *
  * Wrapper fino sobre `resolveAreaEntries` (A16): a resolução por área vive em
  * `registry-resolve.js`; aqui só sobra reduzir as entradas resolvidas ao
@@ -43,6 +43,12 @@ function resolveSkillIds(registry, selectedAreas) {
   const entries = resolveAreaEntries(registry, selectedAreas, {
     listKey: 'skills',
     utilityKey: 'utility',
+    // Uma entrada com `module:` vem de src/modules/<module>/skills/, não de
+    // src/skills-lib/ — ela é instalada junto do módulo. Sem este gate o
+    // installer procuraria src/skills-lib/<id>/SKILL.md, não acharia, e
+    // reportaria a skill como "skipped" em toda instalação. Ela continua no
+    // registry porque o router/maestro precisa enxergá-la para rotear.
+    isActionable: (raw) => !raw.module,
   });
   return entries.map((entry) => entry.id);
 }

package/wizz-modules.yaml

@@ -40,6 +40,23 @@
 # aliases (optional) — prior `code` values this module was registered under.
 # An existing install recorded under an alias resolves to this entry instead of
 # being orphaned as "no source available" when the code changes.
+#
+# ─────────────────────────────────────────────────────────────────────────────
+# NOT LISTED HERE: bundled local modules.
+# ─────────────────────────────────────────────────────────────────────────────
+# This file registers modules that live in ANOTHER repository and are fetched
+# at install time. Modules that ship inside this repo under src/modules/<code>/
+# are auto-discovered by the installer (OfficialModules.listAvailable scans
+# src/modules/ for a module.yaml) and must NOT get an entry here — an entry
+# without a real upstream `url` would break resolution.
+#
+# Bundled local modules today:
+#   wizz       src/modules/wizz/       default_selected: true
+#   lowticket  src/modules/lowticket/  default_selected: false
+#
+# Their installable skills are declared in skills-registry.yaml with a
+# `module:` field, which keeps the router aware of them while telling the
+# skills-lib copier to leave them alone (see tools/installer/modules/skills-lib.js).
 
 modules:
   bmad-method-test-architecture-enterprise:

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

@@ -1,44 +0,0 @@
-# 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/graphify/.graphify_version

@@ -1 +0,0 @@
-0.3.19