wizz-method 1.17.0 → 1.18.1

package/README.md

@@ -26,7 +26,7 @@ O ponto de entrada técnico é o `wizz-router`: ele faz a triagem e manda pedido
 
 Os papéis de dev e produto reusam os agentes WIZZ (Mary, John, Winston, Amelia, Sally, Paige), personalizados em PT-BR pelos overrides em `src/modules/wizz/overrides/`.
 
-A camada Wizz vale para todos os agentes: encerramento padrão (✅/➡️/🎯), economia de token (graphify, depois cérebro, depois grep antes de abrir arquivos), auto-load leve do cérebro na ativação e idioma à sua escolha. Detalhes em [src/modules/wizz/README.md](src/modules/wizz/README.md).
+A camada Wizz vale para todos os agentes: encerramento padrão (✅/➡️/🎯), economia de token (cérebro, depois grep antes de abrir arquivos), auto-load leve do cérebro na ativação e idioma à sua escolha. Detalhes em [src/modules/wizz/README.md](src/modules/wizz/README.md).
 
 ## Quick Start
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "wizz-method",
-  "version": "1.17.0",
+  "version": "1.18.1",
   "description": "Wizz Method — método de agência orientado por IA em PT-BR (fork independente do BMad Method)",
   "keywords": [
     "agile",
@@ -61,18 +61,21 @@
     "rebundle": "node tools/installer/bundlers/bundle-web.js rebundle",
     "sync:check": "node tools/sync-check.mjs",
     "sync:global": "node tools/sync-global.mjs",
-    "test": "npm run test:refs && npm run test:install && npm run test:urls && npm run test:channels && npm run test:mcp && npm run test:env-vars && npm run test:cli && npm run test:deps && npm run test:dispatch-rule && npm run test:hooks && npm run test:decision-trace && npm run test:quickupdate && npm run test:registry-schema && npm run test:registry-lib-parity && npm run test:module-registry && npm run test:method-refs-allowlist && npm run test:rtk-hook && npm run test:network-retry && npm run test:sync-check && npm run test:resolver && npm run test:fetch-assets && npm run test:install-smoke && npm run test:trace-report && npm run test:rehype-plugins && npm run test:workflow-path-regex && npm run test:preflight-tools-check && npm run lint && npm run lint:md && npm run format:check && npm run sync:check",
+    "test": "npm run test:refs && npm run test:install && npm run test:urls && npm run test:channels && npm run test:mcp && npm run test:env-vars && npm run test:cli && npm run test:cli-pin-consistency && npm run test:deps && npm run test:dispatch-rule && npm run test:hooks && npm run test:feature-context && npm run test:decision-trace && npm run test:quickupdate && npm run test:registry-schema && npm run test:registry-lib-parity && npm run test:lowticket-third-party && npm run test:module-registry && npm run test:method-refs-allowlist && npm run test:rtk-hook && npm run test:network-retry && npm run test:sync-check && npm run test:resolver && npm run test:fetch-assets && npm run test:install-smoke && npm run test:trace-report && npm run test:rehype-plugins && npm run test:workflow-path-regex && npm run test:preflight-tools-check && npm run lint && npm run lint:md && npm run format:check && npm run sync:check",
     "test:channels": "node test/test-installer-channels.js",
     "test:cli": "node test/test-cli-config.js",
+    "test:cli-pin-consistency": "node test/test-cli-pin-consistency.js",
     "test:decision-trace": "node test/test-decision-trace.js",
     "test:deps": "node test/test-deps-cache.js",
     "test:dispatch-rule": "node test/test-dispatch-rule-consistency.js",
     "test:env-vars": "node test/test-env-vars.js",
+    "test:feature-context": "node test/test-feature-context.js",
     "test:fetch-assets": "node test/test-fetch-assets.js",
     "test:hooks": "node test/test-router-hook.js",
     "test:install": "node test/test-installation-components.js",
     "test:install-smoke": "node test/test-install-smoke.js",
     "test:install-smoke-mcp": "node test/test-install-smoke-mcp.js",
+    "test:lowticket-third-party": "node test/test-lowticket-third-party.js",
     "test:mcp": "node test/test-mcp-config.js",
     "test:method-refs-allowlist": "node test/test-method-refs-allowlist.js",
     "test:module-registry": "node test/test-module-registry-fields.js",

package/removals.txt

@@ -66,3 +66,6 @@ wizz-create-ux-design
 # taste-skill; taste-skill's description and redesign-protocol.md cover
 # the same existing-project audit ground taste-redesign used to own.
 taste-redesign
+
+# Removida na auditoria de contexto (2026-08-28): knowledge graph descontinuado.
+graphify

package/skills-registry.yaml

@@ -64,7 +64,8 @@
 version: 1
 
 # ─────────────────────────────────────────────────────────────────────────────
-# ÁREAS — cada uma tem um agente dono (executor) e as skills que ele puxa.
+# ÁREAS — `agent` identifica uma SKILL de persona, invocada via Skill.
+# Não usar esse valor como subagent_type. Subagentes nativos são wizz-exec-*.
 # ─────────────────────────────────────────────────────────────────────────────
 areas:
   designer:
@@ -132,55 +133,48 @@ areas:
       - id: ctc-align
         door: motion
         when: "Timing por forced alignment: timestamps palavra a palavra de narração TTS para sincronizar legenda, corte de cena e animação com a fala. Fonte única de timing no pipeline de vídeo; substitui Whisper e estimativa manual."
-    mcps:
-      - id: magic
-        when: "Gerar/refinar componentes prontos via 21st.dev (UI builder, inspiration, refiner)."
-        server:
-          command: npx
-          # Pin de supply chain (2026-08-23): versão fixa; atualizar conscientemente.
-          args: ["-y", "@21st-dev/magic@0.2.2"]
-          env:
-            API_KEY: "${MAGIC_API_KEY}"
     clis:
-      - id: 21st-cli
-        when: "Fonte PAGA complementar (catálogos gratuitos como React Bits/Cult UI/Componentry vêm primeiro; gate de aprovação do usuário). Buscar, inspecionar, instalar e publicar componentes no 21st.dev via terminal (search/get/add/publish, registry do time @wizzdigitalagency). Complementa o Magic MCP (geração assistida); é o caminho de catálogo/registry e o fallback declarado quando o MCP está offline. O install traz também as skills oficiais 21st-cli-use, 21st-registry e 21st-design-sync. Login interativo: `21st login` (em CI usar env API_KEY_21ST)."
-        rel:
-          pairs_with: [magic]
-        check: "command -v 21st"
-        install: "npm i -g @21st-dev/cli && npx @21st-dev/cli install-skill"
       - id: hyperframes
         when: "DESENHAR telas de vídeo em HTML/CSS (HTML→MP4, agent-native, 20+ skills): cena isolada e MUDA — maqueta de WhatsApp/ChatGPT, gráfico animado, título, loop. NÃO usar para montagem com áudio/SFX/legenda sincronizada (posicionador de áudio falhou em produção, ~2,76s de drift; CSS vaza entre telas): a montagem final é do Remotion (regra: HyperFrames desenha, Remotion monta — ver _shared/video-pipeline.md do módulo wizz). Precisa ffmpeg + Node 22 + Chrome headless."
         not_when: "Montagem com áudio/SFX/legenda sincronizada (posicionador de áudio falhou em produção, ~2,76s de drift; CSS vaza entre telas)."
         rel:
           before: [remotion-best-practices]
         platform: [darwin, linux]
-        check: "test -d $HOME/.claude/skills/hyperframes"
+        # O check confere o SHA fixado, não só a existência da pasta: o bundle é
+        # copiado (não clonado), então o pin é gravado num marcador no install.
+        check: 'grep -qx 59a69a145bfbd0f10dee72246b68ee5d9bd71063 "$HOME/.claude/skills/hyperframes/.wizz-pin" 2>/dev/null'
         # Pin de supply chain (2026-08-23): clone temporário + checkout do SHA
         # + `skills add` do path local. Atualizar conscientemente.
         # Neutraliza remotion-to-hyperframes: o bundle instala uma skill de
         # migração Remotion→HyperFrames proibida pela regra do pipeline
         # (_shared/video-pipeline.md: HyperFrames desenha, Remotion monta).
-        install: 'd="$(mktemp -d)" && git clone https://github.com/heygen-com/hyperframes.git "$d" && git -C "$d" checkout 59a69a145bfbd0f10dee72246b68ee5d9bd71063 && npx skills add "$d" -g -y --copy && rm -rf "$d" && rm -rf "$HOME/.claude/skills/remotion-to-hyperframes"'
+        install: 'd="$(mktemp -d)" && git clone https://github.com/heygen-com/hyperframes.git "$d" && git -C "$d" checkout 59a69a145bfbd0f10dee72246b68ee5d9bd71063 && npx skills add "$d" -g -y --copy && printf "%s\\n" 59a69a145bfbd0f10dee72246b68ee5d9bd71063 > "$HOME/.claude/skills/hyperframes/.wizz-pin" && rm -rf "$d" && rm -rf "$HOME/.claude/skills/remotion-to-hyperframes"'
       - id: claude-video
         when: "Analisar/entender vídeo EXISTENTE: baixa, extrai frames e transcreve para resumir, achar momentos ou diagnosticar footage. NÃO cria vídeo. Precisa ffmpeg + yt-dlp (+ Groq/OpenAI p/ transcrição sem legenda)."
         platform: [darwin, linux]
-        check: "test -d $HOME/.claude/skills/watch"
+        # O check confere o SHA fixado, não só a existência da pasta: o bundle é
+        # copiado (não clonado), então o pin é gravado num marcador no install.
+        check: 'grep -qx 83da59fa78c3eee9e20f515fe75c438bb5166efd "$HOME/.claude/skills/watch/.wizz-pin" 2>/dev/null'
         # Pin de supply chain (2026-08-23): clone temporário + checkout do SHA
         # + `skills add` local. Atualizar conscientemente.
-        install: 'd="$(mktemp -d)" && git clone https://github.com/bradautomates/claude-video.git "$d" && git -C "$d" checkout 83da59fa78c3eee9e20f515fe75c438bb5166efd && npx skills add "$d" -g -y --copy && rm -rf "$d"'
+        install: 'd="$(mktemp -d)" && git clone https://github.com/bradautomates/claude-video.git "$d" && git -C "$d" checkout 83da59fa78c3eee9e20f515fe75c438bb5166efd && npx skills add "$d" -g -y --copy && printf "%s\\n" 83da59fa78c3eee9e20f515fe75c438bb5166efd > "$HOME/.claude/skills/watch/.wizz-pin" && rm -rf "$d"'
       - id: buttercut
         when: "EDITAR vídeo por IA: cortes, selects, cenas, roughcut via XML/FFmpeg. Sugerir quando o pedido for editar/cortar vídeo. Clone-and-run no PROJETO (não é skill add), pesado: Ruby + Python + FFmpeg + WhisperX. AVISOS: ~GB de modelos (WhisperX), build demorado, só Apple Silicon."
         platform: darwin-arm64
-        check: "test -d ./buttercut"
+        # Clone-and-run: o próprio repo responde o SHA, então o check compara com o
+        # pin. O install repara um clone existente em vez de falhar no git clone.
+        check: 'test "$(git -C ./buttercut rev-parse HEAD 2>/dev/null)" = f71d9537e2c22c3c4c1c659c4bdfb11e90ccd961'
         # Pin de supply chain (2026-08-23): checkout de SHA fixo; atualizar conscientemente.
-        install: "git clone https://github.com/barefootford/buttercut.git buttercut && git -C buttercut checkout f71d9537e2c22c3c4c1c659c4bdfb11e90ccd961"
+        install: "{ [ -d buttercut/.git ] || git clone https://github.com/barefootford/buttercut.git buttercut; } && git -C buttercut fetch --tags origin && git -C buttercut checkout f71d9537e2c22c3c4c1c659c4bdfb11e90ccd961"
         verify: "command -v ffmpeg >/dev/null 2>&1 && command -v ruby >/dev/null 2>&1 && command -v python3 >/dev/null 2>&1"
       - id: voicebox
         when: "Voz/TTS/clonagem de voz local para narração/VO de vídeo (7 engines TTS + Whisper STT). App desktop que expõe endpoint MCP local em runtime. Clone-and-run no projeto."
         platform: [darwin, linux]
-        check: "test -d ./voicebox"
+        # Clone-and-run: o próprio repo responde o SHA, então o check compara com o
+        # pin. O install repara um clone existente em vez de falhar no git clone.
+        check: 'test "$(git -C ./voicebox rev-parse HEAD 2>/dev/null)" = 2bcb98d1a8b6fe05e15fbc1559e3085669e4035d'
         # Pin de supply chain (2026-08-23): checkout de SHA fixo; atualizar conscientemente.
-        install: "git clone https://github.com/jamiepine/voicebox.git voicebox && git -C voicebox checkout 2bcb98d1a8b6fe05e15fbc1559e3085669e4035d"
+        install: "{ [ -d voicebox/.git ] || git clone https://github.com/jamiepine/voicebox.git voicebox; } && git -C voicebox fetch --tags origin && git -C voicebox checkout 2bcb98d1a8b6fe05e15fbc1559e3085669e4035d"
       - id: ctc-align
         when: "Timestamps palavra a palavra CONFIÁVEIS de narração TTS (texto conhecido): sincronizar legenda, corte de cena, animação e elemento gráfico com a fala. Fonte única de timing em vídeo — substitui timestamps do Whisper e estimativa manual. Skill da lib: ctc-align (instalação + helper align.py + regras de âncora monotônica e duração mínima). Roda em CPU, sem CUDA."
         platform: [darwin, linux]
@@ -231,9 +225,11 @@ areas:
       - id: distribb
         when: "EXECUTAR distribuição de SEO: publicar artigos + construir backlinks pela rede da Distribb, conectar Google Search Console, autopublicar notícias. Complementa (não duplica) as skills de SEO que só geram/auditam. Requer Distribb API + GSC (+ DataForSEO/Ahrefs no plano free)."
         platform: [darwin, linux]
-        check: "ls $HOME/.claude/skills 2>/dev/null | grep -qi distribb"
+        # O check confere o SHA fixado, não só a existência da pasta: o bundle é
+        # copiado (não clonado), então o pin é gravado num marcador no install.
+        check: 'grep -qx 061a055768e13cf09108932a90aeb2e957183858 "$HOME/.claude/skills/distribb/.wizz-pin" 2>/dev/null'
         # Pin de supply chain (2026-08-23): clone temporário + checkout do SHA. Atualizar conscientemente.
-        install: 'd="$(mktemp -d)" && git clone https://github.com/Bomx/distribb-skill.git "$d" && git -C "$d" checkout 061a055768e13cf09108932a90aeb2e957183858 && npx skills add "$d" -g -y --copy && rm -rf "$d"'
+        install: 'd="$(mktemp -d)" && git clone https://github.com/Bomx/distribb-skill.git "$d" && git -C "$d" checkout 061a055768e13cf09108932a90aeb2e957183858 && npx skills add "$d" -g -y --copy && printf "%s\\n" 061a055768e13cf09108932a90aeb2e957183858 > "$HOME/.claude/skills/distribb/.wizz-pin" && rm -rf "$d"'
 
   growth:
     agent: wizz-growth
@@ -281,6 +277,28 @@ areas:
         when: "Pesquisa profunda de público, VoC, níveis de consciência, matriz de ângulos e léxico nativo de oferta compilados em HTML (metodologia @soupiva)."
       - id: wizz-offer-forge
         when: "Forjar oferta irresistível de resposta direta/infoproduto (mecanismo único, empilhamento de valor, garantia reversa, ponte de tráfego)."
+      # Módulo lowticket (src/modules/lowticket) — ver nota em ads.skills.
+      - id: lowticket-metodologia
+        module: lowticket
+        when: "Roteador da base low ticket BR/PT: gatilho → um shard. Régua de preço, garantia e oferta que tem precedência sobre a skill genérica."
+        not_when:
+          - "SaaS, B2B, site de cliente, high ticket ou mentoria: os números não transferem."
+      - id: lowticket-funil
+        module: lowticket
+        when: "Escada pós-checkout de low ticket: upsell 1, upsell 2, downsell, oferta final, régua de preço por degrau e copy das páginas."
+        not_when:
+          - "Antes de existir um front-end que converte: estender funil sobre front que não vende multiplica zero."
+      - id: lowticket-minerador
+        module: lowticket
+        when: "Garimpo e veredito de oferta de concorrente: vocabulário de busca, veredito em 4 níveis, comparação lado a lado, diagnóstico de por que não escalou."
+        not_when:
+          - "A oferta já está definida: aí é wizz-offer-forge."
+      - id: lowticket-pagina
+        module: lowticket
+        when: "Engenharia de performance da página de venda low ticket: connect rate, ordem do pixel, LCP/TTFB/CLS, peso acima da dobra, relatório antes e depois."
+        not_when:
+          - "Reescrever copy, preço ou estrutura de oferta: esta skill é o engenheiro, não o copywriter."
+          - "Site institucional ou app."
     mcps:
       - id: scrapling
         when: "Scraping/crawl web para pesquisa de mercado, prospecção de leads e inteligência competitiva. Bypass anti-bot (Cloudflare), parsing adaptativo, spider concorrente. Requer: pip install 'scrapling[ai]' && scrapling install."
@@ -315,6 +333,28 @@ areas:
         when: "Gerar/iterar criativos e headlines de anúncio em escala (RSA, variações)."
       - id: analytics-tracking
         when: "Tracking de conversão pros anúncios (compartilhada com growth)."
+      - id: tracking-audit
+        when: "Auditar rastreamento de oferta de resposta direta. Modo implantação: pixel, CAPI, domínio verificado, eventos priorizados, UTM com ID, repasse do parâmetro nativo pelo checkout, higiene de nomenclatura, compra-teste por rota. Modo diagnóstico: qual transição do funil está furando, medição contra conversão, ROI verdadeiro contra falso, qual dado falta pra decidir."
+        not_when:
+          - "Plano de medição de SaaS ou produto instrumentado por evento de uso: é analytics-tracking."
+          - "Decidir bid, orçamento ou estrutura de campanha: é paid-ads."
+        rel:
+          pairs_with: [analytics-tracking, paid-ads]
+          before: [page-cro]
+      # Módulo lowticket (src/modules/lowticket) — instaladas COM O MÓDULO, não
+      # por skills-lib. O campo `module` é o gate: resolveSkillIds as ignora ao
+      # copiar de src/skills-lib, e o router continua enxergando as entradas.
+      - id: lowticket-metodologia
+        module: lowticket
+        when: "Roteador da base low ticket BR/PT: gatilho → um shard (diagnóstico de funil, bid cap, criativo, oferta, página, Instagram, upsell, mineração). Carrega guardrails junto."
+        not_when:
+          - "SaaS, B2B, site de cliente, high ticket ou mentoria: os números não transferem."
+      - id: lowticket-trafego
+        module: lowticket
+        when: "Diagnóstico e régua de campanha Meta de low ticket: estrutura 1-1-X, bid cap, régua de 3x, quando cortar, como escalar, ler print do gerenciador ou do funil."
+        not_when:
+          - "Google Ads institucional, campanha de marca, lead gen B2B."
+          - "Escrever copy ou criativo: a skill lê número, não produz anúncio."
     mcps:
       - id: meta-ads
         when: "Gestão real de campanha Meta/Facebook/Instagram via API (criar/editar/medir ads)."
@@ -418,14 +458,12 @@ areas:
     summary: "Memória do projeto: o que foi decidido, salvar, ver estado."
     skills:
       - id: cerebro
-        when: "Recuperar/salvar decisões, contexto, aprendizados; ver estado do projeto (/ver, /salvar, /decisao, /dump)."
+        when: "Recuperar/salvar decisões, contexto, aprendizados; ver estado do projeto (/ver, /salvar, /decisao, /dump); ler a auto-memória fora do Claude Code (/memoria)."
 
 # ─────────────────────────────────────────────────────────────────────────────
 # UTILITÁRIOS — cross-cutting, não pertencem a uma área só.
 # ─────────────────────────────────────────────────────────────────────────────
 utility:
-  - id: graphify
-    when: "Transformar código/docs em knowledge graph; navegar estrutura antes de ler arquivos crus."
   - id: find-skills
     when: "Nenhuma skill cobre o pedido: buscar/instalar no marketplace (npx skills find)."
   - id: enhance-prompt

package/src/bmm-skills/1-analysis/wizz-agent-analyst/customize.toml

@@ -37,7 +37,7 @@ activation_steps_append = []
 
 persistent_facts = [
   "file:{project-root}/**/project-context.md",
-  "If active_feature is set in {project-root}/_wizz/bmm/config.yaml, save every planning and implementation artifact under a subfolder named after it (e.g. {planning_artifacts}/{active_feature}/, {implementation_artifacts}/{active_feature}/). If it is empty or unset, write to the artifact roots as usual.",
+  "FEATURE: o hook SessionStart já resolve a feature ativa a partir do branch git e injeta 'FEATURE ATIVA: <slug>'. Se ela existir, salve TODO artefato de planejamento e implementação na subpasta com esse nome ({planning_artifacts}/{active_feature}/, {implementation_artifacts}/{active_feature}/) e grave o slug em active_feature no {project-root}/_wizz/bmm/config.yaml na primeira escrita, avisando em UMA linha. Memória gravada nesta sessão leva o mesmo slug como tema. Sem feature resolvida, escreva nas raízes. NUNCA pergunte a feature ao usuário: invoque wizz-set-feature só se ele pedir para trocar, ou se houver duas features abertas e o pedido não decidir entre elas.",
 ]
 
 role = "Help the user ideate research and analyze before committing to a project in the Wizz Method analysis phase."

package/src/bmm-skills/1-analysis/wizz-set-feature/SKILL.md

@@ -1,74 +1,78 @@
 ---
 name: wizz-set-feature
-description: 'Set or switch the active feature context so planning and implementation artifacts are organized into a named subfolder. Use when the user says "set feature", "switch feature", "new feature", or asks "what feature is active".'
+description: 'Resolve, switch or clear the active feature context so planning artifacts, implementation artifacts and memory are organized under one named slug. Runs automatically from the git branch; only invoke it when the user says "set feature", "switch feature", "new feature", "clear feature", or asks "what feature is active".'
 ---
 
 # Set Feature
 
-**Goal:** Set or switch the `active_feature` context so all subsequent planning and implementation artifacts are saved into a named subfolder.
+**Goal:** Keep `active_feature` correct so planning artifacts, implementation artifacts and memory entries all land under the same named slug.
+
+**Default mode is automatic.** The `session-rules.js` SessionStart hook already resolves the feature from the git branch and injects it as `FEATURE ATIVA: <slug>`. In the normal case nobody invokes this skill and nobody is asked anything. Invoke it only for the three explicit cases in "When this skill runs" below.
 
 ## Conventions
 
 - `{project-root}`-prefixed paths resolve from the project working directory.
 
-## On Activation
+## Resolution order (never ask before exhausting it)
 
-### Step 1: Load Config
+1. **Git branch.** `feat/dashboard-financeiro` → `dashboard-financeiro`. Strip the type prefix (`feat/`, `feature/`, `fix/`, `bugfix/`, `hotfix/`, `chore/`, `refactor/`, `docs/`, `test/`, `perf/`, `ci/`, `build/`, `style/`), lowercase, kebab-case. Trunk branches (`main`, `master`, `develop`, `dev`, `staging`, `prod`, `production`, `release`) and release branches yield **no** feature, not a bad one.
+2. **`active_feature` in `{project-root}/_wizz/bmm/config.yaml`.** Used when the branch gives nothing.
+3. **The request itself.** Only when 1 and 2 are both empty AND the user is clearly starting named work ("vamos fazer o painel de assinaturas"). Derive the slug, write it, and say so in **one line**. Do not ask.
+4. **Nothing.** Artifacts go to the roots and memory carries no feature tag. This is a valid state, not a problem to fix.
 
-Load config from `{project-root}/_wizz/bmm/config.yaml` and resolve:
+The branch wins over the config: it describes the work happening now, while the config may be stale from a feature nobody switched off.
 
-- `project_name`, `user_name`, `communication_language`
-- `planning_artifacts`, `implementation_artifacts`
-- `active_feature` (current value, may be empty or absent)
+## When this skill runs
 
-Always speak in `{communication_language}`.
+- **The user asks what is active** → answer from the resolution order and stop. Do not write anything.
+- **The user asks to set, switch or clear** → they already named it (or asked to clear); normalize, write, confirm in one line. Do not ask for a slug they just gave you.
+- **Genuine ambiguity** → two or more features are open and the request does not decide between them. This is the only case where you ask, and you ask once, offering the open features as options.
 
-### Step 2: Show Current State
+## Steps
 
-- If `active_feature` is set: "Active feature: **{active_feature}**".
-- If empty or absent: "No active feature set. Artifacts are saving to the roots."
+### Step 1: Load config
 
-If the user only asked which feature is active, stop here.
+Load `{project-root}/_wizz/bmm/config.yaml` and resolve `project_name`, `communication_language`, `planning_artifacts`, `implementation_artifacts`, and the current `active_feature`. Always speak in `{communication_language}`.
 
-### Step 3: Ask for the Feature Slug
+### Step 2: Resolve the slug
 
-Ask: "What is the feature name? Use a short kebab-case slug (e.g. `admin-panel`, `auth-refactor`, `dashboard-financeiro`). It becomes the subfolder name inside `planning-artifacts/` and `implementation-artifacts/`."
+Apply the resolution order above. Normalize to kebab-case: lowercase, strip accents, non-alphanumerics become hyphens, no leading or trailing hyphen, 60 characters max.
 
-Wait for the user's answer.
+Confirm with the user **only** in the ambiguity case. A slug that came from the branch, from an explicit user instruction, or from a clear request is written without a confirmation round.
 
-### Step 4: Validate and Confirm
+### Step 3: Write the config
 
-- Reject empty input.
-- Normalize: lowercase and replace spaces with hyphens.
-- Show the normalized slug and confirm it with the user before proceeding.
+Set `active_feature:` to the slug (add the key if absent). To clear it, set it to `""`.
 
-### Step 5: Update Config
+### Step 4: Create the subfolders
 
-Edit `{project-root}/_wizz/bmm/config.yaml`:
+Create if missing:
 
-- If an `active_feature:` key exists, set its value to the confirmed slug.
-- If it does not exist, add the line `active_feature: "{slug}"`.
-- Save the file.
+- `{planning_artifacts}/{active_feature}/`
+- `{implementation_artifacts}/{active_feature}/`
 
-### Step 6: Create Subfolders
+Skip this step when clearing.
 
-Create these directories if they do not already exist:
+### Step 5: Report in one line
 
-- `{planning_artifacts}/{active_feature}/`
-- `{implementation_artifacts}/{active_feature}/`
+"Feature: **{active_feature}**. Artefatos em `{planning_artifacts}/{active_feature}/` e `{implementation_artifacts}/{active_feature}/`, memória desta sessão marcada com o mesmo tema."
 
-### Step 7: Confirm
+When clearing: "Feature limpa. Artefatos voltam para as raízes e a memória sai sem tema de feature."
 
-Tell the user:
+## The feature is also the memory tag
 
-"Feature set to **{active_feature}**. New planning and implementation artifacts will be saved under:
-- `{planning_artifacts}/{active_feature}/`
-- `{implementation_artifacts}/{active_feature}/`
+The slug is the single organizing axis, not a folder rule that stops at artifacts. While a feature is active:
+
+- A decision saved to the Cérebro carries `tema: {active_feature}` in its frontmatter.
+- The project state block records which feature the work sits under.
+- An auto-memory entry about this work mentions the feature in its description, so a later `grep` by slug finds artifact, decision and trap together.
 
-Run this skill again anytime to switch features, or clear the slug to go back to the roots."
+This reuses the `tema` axis that already exists for decisions. Do not create a second, parallel `feature:` field alongside it.
 
 ## Success Criteria
 
+- ✅ The slug was resolved without asking the user, except in genuine ambiguity.
 - ✅ `active_feature` updated in `_wizz/bmm/config.yaml`.
-- ✅ Subfolders created in planning-artifacts and implementation-artifacts.
-- ✅ User clearly informed of the new artifact paths.
+- ✅ Subfolders exist under planning-artifacts and implementation-artifacts.
+- ✅ Memory written during the session carries the same slug as `tema`.
+- ✅ The user got one line, not a dialogue.

package/src/bmm-skills/2-plan-workflows/wizz-agent-pm/customize.toml

@@ -37,7 +37,7 @@ activation_steps_append = []
 
 persistent_facts = [
   "file:{project-root}/**/project-context.md",
-  "If active_feature is set in {project-root}/_wizz/bmm/config.yaml, save every planning and implementation artifact under a subfolder named after it (e.g. {planning_artifacts}/{active_feature}/, {implementation_artifacts}/{active_feature}/). If it is empty or unset, write to the artifact roots as usual.",
+  "FEATURE: o hook SessionStart já resolve a feature ativa a partir do branch git e injeta 'FEATURE ATIVA: <slug>'. Se ela existir, salve TODO artefato de planejamento e implementação na subpasta com esse nome ({planning_artifacts}/{active_feature}/, {implementation_artifacts}/{active_feature}/) e grave o slug em active_feature no {project-root}/_wizz/bmm/config.yaml na primeira escrita, avisando em UMA linha. Memória gravada nesta sessão leva o mesmo slug como tema. Sem feature resolvida, escreva nas raízes. NUNCA pergunte a feature ao usuário: invoque wizz-set-feature só se ele pedir para trocar, ou se houver duas features abertas e o pedido não decidir entre elas.",
 ]
 
 role = "Translate product vision into a validated PRD, epics, and stories that development can execute during the Wizz Method planning phase."

package/src/bmm-skills/2-plan-workflows/wizz-agent-ux-designer/customize.toml

@@ -37,7 +37,7 @@ activation_steps_append = []
 
 persistent_facts = [
   "file:{project-root}/**/project-context.md",
-  "If active_feature is set in {project-root}/_wizz/bmm/config.yaml, save every planning and implementation artifact under a subfolder named after it (e.g. {planning_artifacts}/{active_feature}/, {implementation_artifacts}/{active_feature}/). If it is empty or unset, write to the artifact roots as usual.",
+  "FEATURE: o hook SessionStart já resolve a feature ativa a partir do branch git e injeta 'FEATURE ATIVA: <slug>'. Se ela existir, salve TODO artefato de planejamento e implementação na subpasta com esse nome ({planning_artifacts}/{active_feature}/, {implementation_artifacts}/{active_feature}/) e grave o slug em active_feature no {project-root}/_wizz/bmm/config.yaml na primeira escrita, avisando em UMA linha. Memória gravada nesta sessão leva o mesmo slug como tema. Sem feature resolvida, escreva nas raízes. NUNCA pergunte a feature ao usuário: invoque wizz-set-feature só se ele pedir para trocar, ou se houver duas features abertas e o pedido não decidir entre elas.",
 ]
 
 role = "Turn user needs and the PRD into UX design specifications that inform architecture and implementation during the Wizz Method planning phase."

package/src/bmm-skills/3-solutioning/wizz-agent-architect/customize.toml

@@ -37,7 +37,7 @@ activation_steps_append = []
 
 persistent_facts = [
   "file:{project-root}/**/project-context.md",
-  "If active_feature is set in {project-root}/_wizz/bmm/config.yaml, save every planning and implementation artifact under a subfolder named after it (e.g. {planning_artifacts}/{active_feature}/, {implementation_artifacts}/{active_feature}/). If it is empty or unset, write to the artifact roots as usual.",
+  "FEATURE: o hook SessionStart já resolve a feature ativa a partir do branch git e injeta 'FEATURE ATIVA: <slug>'. Se ela existir, salve TODO artefato de planejamento e implementação na subpasta com esse nome ({planning_artifacts}/{active_feature}/, {implementation_artifacts}/{active_feature}/) e grave o slug em active_feature no {project-root}/_wizz/bmm/config.yaml na primeira escrita, avisando em UMA linha. Memória gravada nesta sessão leva o mesmo slug como tema. Sem feature resolvida, escreva nas raízes. NUNCA pergunte a feature ao usuário: invoque wizz-set-feature só se ele pedir para trocar, ou se houver duas features abertas e o pedido não decidir entre elas.",
 ]
 
 role = "Convert the PRD and UX into technical architecture decisions that keep implementation on track during the Wizz Method solutioning phase."

package/src/bmm-skills/4-implementation/wizz-agent-dev/customize.toml

@@ -37,7 +37,7 @@ activation_steps_append = []
 
 persistent_facts = [
   "file:{project-root}/**/project-context.md",
-  "If active_feature is set in {project-root}/_wizz/bmm/config.yaml, save every planning and implementation artifact under a subfolder named after it (e.g. {planning_artifacts}/{active_feature}/, {implementation_artifacts}/{active_feature}/). If it is empty or unset, write to the artifact roots as usual.",
+  "FEATURE: o hook SessionStart já resolve a feature ativa a partir do branch git e injeta 'FEATURE ATIVA: <slug>'. Se ela existir, salve TODO artefato de planejamento e implementação na subpasta com esse nome ({planning_artifacts}/{active_feature}/, {implementation_artifacts}/{active_feature}/) e grave o slug em active_feature no {project-root}/_wizz/bmm/config.yaml na primeira escrita, avisando em UMA linha. Memória gravada nesta sessão leva o mesmo slug como tema. Sem feature resolvida, escreva nas raízes. NUNCA pergunte a feature ao usuário: invoque wizz-set-feature só se ele pedir para trocar, ou se houver duas features abertas e o pedido não decidir entre elas.",
   "When implementing against a library or framework, consult Context7 for current docs, APIs, and version-specific syntax before relying on training data or web search: call resolve-library-id with the library name, then query-docs with the returned /org/project id and a specific question. If Context7 is unavailable, tell the user once that they can enable it with `npx ctx7 setup`, then fall back to web research.",
 ]
 

package/src/core-skills/_shared/handoff-protocol.md

@@ -4,10 +4,11 @@ Contrato mínimo que todo orquestrador ou spawn de subagente usa ao delegar
 trabalho: wizz-router, wizz-maestro, wizz-party-mode (subagent/agent-team)
 e swarm-orchestrator. Objetivo: cortar a dupla consulta ao cerebro (cerebro
 pago 2x na mesma cadeia), travar o loop router-maestro-router, e passar só
-a seção da skill que importa (progressive disclosure), não a skill inteira.
+o entrypoint da skill e apenas as referências necessárias (progressive disclosure), não o pacote inteiro.
 
 ## Campos do brief
 
+- skill de área: nome canônico da persona a invocar via `Skill` (ex.: `wizz-growth`). Não é `subagent_type`: para isolar a tarefa, escolha um executor nativo disponível (`wizz-exec-*`) e instrua-o a carregar essa skill antes de trabalhar. A ausência de um executor não impede invocar a skill na sessão atual.
 - origem: quem está delegando (ex: wizz-router, wizz-maestro). Regra
   anti-loop: nunca invoque quem já está na cadeia de origem. Exemplo
   proibido: router delega pro maestro, maestro devolve pro router.
@@ -17,9 +18,10 @@ a seção da skill que importa (progressive disclosure), não a skill inteira.
   novo, usa o resumo recebido.
 - decisões já tomadas na cadeia: lista curta do que já foi decidido antes
   deste handoff (ex: paleta aprovada, escopo definido).
-- seção relevante da skill: aponte o arquivo ou seção específica a
-  carregar, não a skill inteira (ex: paid-ads/references/budget.md). Quem
-  recebe carrega só isso, não o pacote completo da skill.
+- seção relevante da skill: indique o assunto e as referências necessárias.
+  Quem recebe carrega primeiro o SKILL.md completo via invocação da skill;
+  depois lê apenas as referências exigidas pela tarefa. Skills carregadas
+  pelo lead não são herdadas automaticamente por um subagente.
 - model_hint (opcional): degrau da escada, não modelo cru. Valores:
   `haiku | sonnet | opus | review`. Quem recebe despacha `wizz-exec-<hint>`
   (nativo em Claude Code, Codex, OpenCode e Gemini CLI). Escalada: no

package/src/modules/lowticket/README.md

@@ -0,0 +1,55 @@
+# Wizz Low Ticket
+
+A portable knowledge base and four operating skills for **low ticket direct response** in Brazil and Portugal: offers between roughly R$19 and R$97, sold cold on Meta Ads, on a phone, mostly inside the Instagram in-app browser.
+
+Install it and a fresh machine has the methodology and the four agents working, with no extra setup.
+
+## What ships
+
+| Skill | Does | Use when | Do not use when |
+|---|---|---|---|
+| `lowticket-metodologia` | routes a request to the one knowledge shard that answers it, loads the guardrails alongside | any low ticket work: offer, creative, page, campaign, funnel | SaaS, B2B, client site, high ticket |
+| `lowticket-trafego` | campaign diagnosis and ruler: structure, bid cap, when to cut, how to scale | reading, cutting or scaling a Meta campaign | Google Ads, brand campaigns, writing ads |
+| `lowticket-funil` | the post-checkout ladder: upsell, downsell, final offer, price rules | after the front-end converts, to raise average order value | before a front-end that converts exists |
+| `lowticket-minerador` | mining and judging a competitor offer, with a cut-off rubric | hunting a new offer to model | the offer is already defined (use `wizz-offer-forge`) |
+| `lowticket-pagina` | page performance: connect rate, LCP, pixel order, acceptance targets | optimizing or building a low ticket sales page | institutional sites or apps |
+
+All five read the Cérebro on activation and **none of them keeps its own memory**, the same contract as `wizz-offer-forge`. What is decided lives in the Cérebro; what is known lives in the shards.
+
+## The loading contract
+
+The knowledge base is 20 shards. It is not loaded whole. Reading everything costs around 36k tokens; a typical answer needs under 5k.
+
+| Step | Read | When |
+|---|---|---|
+| 0 | `knowledge/INDEX.md` + `knowledge/guardrails.md` | always |
+| 1 | **one** shard named by the INDEX | the request matches a trigger |
+| 2 | the raw source on the operator's machine | rare: the shard did not answer |
+
+## Language
+
+The framework surface is English: this file, the module definition, the SKILL.md frontmatter, the registry entry. **The knowledge is Portuguese**: the shard bodies, their filenames, the INDEX, the guardrails, the table headers.
+
+That split is deliberate. The market this describes is BR/PT and the vocabulary is native (`bid cap`, `connect rate`, `order bump`, `Utmify`, `Pix`); translating it would make it less precise, not more portable. Decision recorded 2026-08-28.
+
+## Origin
+
+The knowledge here is a distillation: facts, benchmarks, checklists and critical analysis, written from scratch. **No third-party lesson text, transcript, PDF or prompt ships in this package.** Raw sources stay on the author's machine, outside npm and outside git.
+
+If you extend a shard, keep it that way: write the fact, never the quote. `knowledge/15-como-estender.md` has the full process.
+
+Three tactics present in the source material are recorded and **not adopted** in `knowledge/guardrails.md`: buying engagement, AI avatars passing as real people, and synthetic testimonials. They are loaded on every activation and stay blocked until the operation's owner decides otherwise.
+
+## Optional config
+
+The creative swipe file (155 real pieces, ~2 GB of video and image) does not travel. The written analysis of it, `CATALOGO.md`, does, and it is enough to work from.
+
+To let the agent open a specific piece, point at the folder during install, or pin it by hand:
+
+```toml
+# _wizz/custom/config.user.toml  (never overwritten by the installer)
+[modules.lowticket]
+swipe_file_path = "/absolute/path/to/the/swipe/file"
+```
+
+Resolution order and the exact wording to use when the folder is absent: `skills/lowticket-metodologia/references/swipe-file.md`.

package/src/modules/lowticket/module.yaml

@@ -0,0 +1,31 @@
+code: lowticket
+name: "Wizz Low Ticket"
+description: "Low ticket direct-response playbook for Meta Ads (BR/PT): funnel diagnosis, bid-cap campaigns, creatives, sales pages, upsell ladders and offer mining. Knowledge base in Portuguese, loaded one shard at a time."
+default_selected: false
+
+# --- Origin note (read this before editing the knowledge base) ---
+#
+# The knowledge under skills/lowticket-metodologia/knowledge/ is a distillation
+# written from scratch: facts, benchmarks, checklists and critical analysis.
+# No third-party lesson text, transcript, PDF or prompt ships in this package.
+# The raw sources stay on the author's machine, outside npm and outside git.
+# Keep it that way: when you extend a shard, write the fact, never the quote.
+#
+# The knowledge body, the shard filenames and the INDEX are in Portuguese on
+# purpose (the market it describes is BR/PT and the vocabulary is native).
+# The framework surface (this file, SKILL.md frontmatter, the registry entry,
+# the README) stays in English like the rest of Wizz Method.
+# Decision recorded 2026-08-28.
+
+# --- Module-specific config ---
+
+swipe_file_path:
+  prompt:
+    - "Absolute path to your creative swipe file (the folder holding the reference videos and images)?"
+    - "Optional. Leave it empty: the skills still work from the written analysis in CATALOGO.md."
+  scope: user
+  default: ""
+  result: "{value}"
+
+directories:
+  - "{output_folder}/lowticket"