wizz-method 1.16.1 → 1.18.0

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.16.1",
+  "version": "1.18.0",
   "description": "Wizz Method — método de agência orientado por IA em PT-BR (fork independente do BMad Method)",
   "keywords": [
     "agile",
@@ -61,17 +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:quickupdate && npm run test:registry-schema && 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",
@@ -79,6 +83,7 @@
     "test:preflight-tools-check": "node test/test-preflight-tools-check.js",
     "test:quickupdate": "node test/test-quick-update-gate.js",
     "test:refs": "node test/test-file-refs-csv.js",
+    "test:registry-lib-parity": "node test/test-registry-lib-parity.js",
     "test:registry-schema": "node test/test-registry-schema.js",
     "test:rehype-plugins": "node test/test-rehype-plugins.mjs",
     "test:resolver": "node test/test-resolve-customization.js",

package/removals.txt

@@ -60,3 +60,12 @@ wizz-distillator
 # wizz-create-ux-design: renamed to wizz-ux (spine-based skill with separate
 # DESIGN.md and EXPERIENCE.md outputs).
 wizz-create-ux-design
+# taste-redesign: merged into taste-skill (P2 auditoria 360°, 2026-08-25).
+# The redesign audit checklist and upgrade techniques now live as
+# references/design-audit.md and references/upgrade-techniques.md inside
+# 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

@@ -80,9 +80,11 @@ areas:
         entry: true
         door: direcao
         when: "PORTA de direção: todo trabalho de decidir ANTES de construir. Brief visual inicial (6 decisões de estética + 3 lógicas) no kickoff. Puxa: taste-skill (direção anti-slop de brief novo) e motion-3d-director (decidir caminho motion/3D/vídeo)."
+        rel:
+          pairs_with: [taste-skill, motion-3d-director]
       - id: taste-skill
         door: direcao
-        when: "Anti-slop em briefs NOVOS: lê o brief, define a direção e audita contra defaults de AI."
+        when: "Anti-slop em briefs NOVOS: lê o brief, define a direção e audita contra defaults de AI. Também cobre projeto EXISTENTE: audita o código atual, lista problemas, prioriza fixes (protocolo de redesign)."
       - id: motion-3d-director
         door: direcao
         when: "Direção de motion/animação, 3D, WebGL, scroll cinematográfico, image-to-video. Decide o caminho ANTES de implementar."
@@ -91,7 +93,7 @@ areas:
       - id: ui-ux-pro-max
         entry: true
         door: construcao
-        when: "PORTA de construção: criar/melhorar UI (design system, paleta, tipografia, componente, página). Puxa: premium-landing-ui-researcher (landing premium greenfield), ui-component-curator (1 componente em projeto existente), impeccable (gate de polish/acessibilidade), taste-redesign (anti-slop em código existente), huashu-design (protótipo HTML hi-fi/variantes/review) e react-components (Stitch→React)."
+        when: "PORTA de construção: criar/melhorar UI (design system, paleta, tipografia, componente, página). Puxa: premium-landing-ui-researcher (landing premium greenfield), ui-component-curator (1 componente em projeto existente), impeccable (gate de polish/acessibilidade), taste-skill (anti-slop em código existente, protocolo de redesign), huashu-design (protótipo HTML hi-fi/variantes/review) e react-components (Stitch→React)."
       - id: premium-landing-ui-researcher
         door: construcao
         when: "Projeto NOVO (greenfield): cria landing premium do zero, hero, 3D high-end. Estratégia source-first."
@@ -101,9 +103,6 @@ areas:
       - id: impeccable
         door: construcao
         when: "Gate de polish/qualidade de frontend: hardening de UI, acessibilidade, anti-padrões. Refina o que já existe."
-      - id: taste-redesign
-        door: construcao
-        when: "Anti-slop em projeto EXISTENTE: audita o código atual, lista problemas, prioriza fixes."
       - id: huashu-design
         door: construcao
         when: "Direção visual + protótipo HTML hi-fi, exploração de variantes, review 5-dim, export MP4/GIF."
@@ -122,12 +121,17 @@ areas:
       - id: remotion-best-practices
         door: motion
         when: "MONTAR o filme: vídeo em React (Remotion) com áudio, SFX, legenda e timing com precisão de frame. No pipeline de vídeo é o Remotion que faz a montagem final; o hyperframes só desenha as telas mudas (regra: HyperFrames desenha, Remotion monta — ver _shared/video-pipeline.md do módulo wizz)."
+        rel:
+          after: [hyperframes]
       - id: canvas-design
         door: motion
         when: "Gerar PNG/PDF editável por código (carrossel, quote card, infográfico) com fonte/cor/logo sempre certos. Traz canvas-fonts."
       - id: algorithmic-art
         door: motion
         when: "Visual generativo por código (flow fields, ruído, partículas) para fundo/textura de hero, único a cada render, sem cara de banco de imagem."
+      - 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)."
@@ -140,41 +144,63 @@ areas:
     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.
-        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"'
+        # 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 && 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]
         check: "test -x ./tools/ctc-align/.venv/bin/ctc-forced-aligner"
         install: 'mkdir -p tools/ctc-align && uv venv --python 3.12 tools/ctc-align/.venv && uv pip install --python tools/ctc-align/.venv/bin/python "git+https://github.com/MahmoudAshraf97/ctc-forced-aligner.git"'
         verify: "command -v ffmpeg >/dev/null 2>&1 && command -v uv >/dev/null 2>&1"
+      - id: fal-video
+        when: "GERAR vídeo/imagem por IA (Veo/Kling/Wan e outros modelos via API da fal.ai), estilo UGC/ad-ready. Substitui o arcads: mesmo caso de uso (vídeo gerado por IA), custo 50-95% menor por vídeo, sem clone-and-run pesado. Precisa FAL_KEY em .env. Sem CLI binária oficial: usa o client Node oficial @fal-ai/client como dependência do projeto."
+        platform: [darwin, linux]
+        check: "test -f node_modules/@fal-ai/client/package.json"
+        # Pin de supply chain (2026-08-25): versão fixa (client oficial fal.ai); atualizar conscientemente.
+        install: "npm install @fal-ai/client@1.10.1"
     references:
       - "references/premium-agency-rules.md (regras $150k-tier, importadas por impeccable/huashu no modo high-end)"
 
@@ -213,9 +239,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
@@ -263,6 +291,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."
@@ -297,6 +347,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)."
@@ -306,14 +378,6 @@ areas:
           args: ["-y", "mcp-meta-ads@1.0.0"]
           env:
             META_ACCESS_TOKEN: "${META_ACCESS_TOKEN}"
-    clis:
-      - id: arcads
-        when: "GERAR vídeo-ad e imagem por IA (Seedance/Sora/Veo/Kling/OmniHuman + Nano Banana) e publicar como Meta ad. Clone-and-run no projeto: git clone + ./scripts/setup.sh; precisa Python 3.10+ e ARCADS API key em .env (META_ACCESS_TOKEN opcional p/ publicar)."
-        platform: [darwin, linux]
-        check: "test -d ./arcads-claude-code"
-        # Pin de supply chain (2026-08-23): checkout de SHA fixo; atualizar conscientemente.
-        install: "git clone https://github.com/krusemediallc/arcads-claude-code.git arcads-claude-code && git -C arcads-claude-code checkout 0bfafb256cfce3ff4447d7ea1611a37f0af536be"
-        verify: "command -v python3 >/dev/null 2>&1 && python3 -c 'import sys; sys.exit(0 if sys.version_info >= (3, 10) else 1)'"
 
   architect:
     agent: wizz-agent-architect
@@ -348,6 +412,15 @@ areas:
           args: ["-y", "@supabase/mcp-server-supabase@0.11.0", "--read-only", "--project-id", "${SUPABASE_PROJECT_REF}"]
           env:
             SUPABASE_ACCESS_TOKEN: "${SUPABASE_ACCESS_TOKEN}"
+    clis:
+      - id: sentry-cli
+        when: "CONDICIONAL — só ofereça se o projeto JÁ usa Sentry (existe SENTRY_DSN no env, sentry.properties, ou '@sentry/' no package.json) E o estágio é produção: subir release/sourcemaps, associar commits, monitorar erro em deploy. Nunca default e nunca sugerir ADOTAR Sentry só por causa desta CLI — é suporte a um Sentry que já existe, não uma recomendação de ferramenta."
+        not_when:
+          - "Projeto ainda não usa Sentry (sem SENTRY_DSN, sentry.properties ou '@sentry/' no package.json)."
+          - "Fora de estágio de produção."
+        check: "sentry-cli --version"
+        # Pin de supply chain (2026-08-25): versão fixa; atualizar conscientemente.
+        install: "npm install -g @sentry/cli@3.6.2"
 
   qa:
     agent: wizz-qa
@@ -355,6 +428,15 @@ areas:
     skills:
       - id: adversarial-reviewer
         when: "Passe único adversarial, ad hoc, fora de workflow — 'tear this apart' num trecho colado, sem contexto de projeto. Não confundir com wizz-review-adversarial-general (camada interna 'Blind Hunter' chamada só por wizz-code-review) nem com wizz-code-review (orquestrador bmm: 3 camadas paralelas + triagem, para review real de diff/PR)."
+      - id: security-audit-pentest
+        when: "Auditoria/pentest de segurança do app inteiro — 'auditar segurança', 'pentest', 'encontrar vulnerabilidades', varredura antes de release. Só para teste de segurança AUTORIZADO (seus sistemas ou de clientes com permissão): ferramenta dual-use, nunca usar contra alvo sem autorização."
+      - id: launch-readiness
+        when: "Auditoria de prontidão pra lançamento (Pre-launch Audit), multi-área: técnico/build, segurança, SEO/descoberta, analytics/medição, conteúdo/copy/prova social, legal/LGPD, infra/deploy/rollback. Gatilhos: 'tá pronto pra lançar?', 'auditoria de pré-lançamento', 'checklist de release amplo', 'o que falta antes de ir pra produção'. Gate por estágio: só roda de verdade em mvp/production, e recusa educadamente em estágio de descoberta/ideação. Diagnostica e prioriza por severidade (bloqueia/alto/médio/ok), nunca corrige cego: aponta security-audit-pentest pra aprofundar segurança com prova de exploração e site-launch-kit pra executar a correção quando a superfície do achado é site. Resultado persiste numa seção datada do project-context.md."
+        not_when:
+          - "Estágio de descoberta/ideação: projeto ainda sem superfície construída pra auditar (sem project-context.md, ou stage 'prototype' vazio)."
+          - "Correção de um achado isolado de site já identificado: nesse caso vá direto pra site-launch-kit."
+        rel:
+          pairs_with: [site-launch-kit, security-audit-pentest]
       - id: agent-browser
         when: "Verificação visual/browser, preencher forms, screenshots, testar UI no navegador. CLI já instalado (não é MCP); browser SEMPRE via agent-browser, nunca Playwright."
     clis:
@@ -363,6 +445,18 @@ areas:
         check: "agent-browser --version"
         # Pin de supply chain (2026-08-23): versão fixa; atualizar conscientemente.
         install: "npm install -g agent-browser@0.34.0"
+      - id: strix
+        when: "CONDICIONAL, nunca default — executor de pentest AUTÔNOMO e OFENSIVO (agentes de IA que rodam o app, exploram e VALIDAM vulnerabilidades com PoC real). Complementa security-audit-pentest: aquela skill é a metodologia/checklist humana; o Strix é o executor automatizado. Ferramenta dual-use: SÓ contra alvo próprio ou com AUTORIZAÇÃO ESCRITA do dono do sistema e ESCOPO definido — nunca contra alvo de terceiros sem permissão. Roda SEMPRE dentro do sandbox Docker isolado que a própria ferramenta provê (jamais direto no host). Gate condicional: ofereça apenas mediante confirmação explícita do usuário, com escopo e autorização declarados; jamais acione por padrão silencioso. RETORNO DEFENSIVO OBRIGATÓRIO: o executor (subagente) SEMPRE devolve o achado em formato defensivo — falha, severidade, evidência mínima e correção — nunca payload/exploit cru ou arma pronta; assim o revisor recebe conteúdo defensivo pra corrigir, não instrução de ataque. Precisa de Docker rodando e de uma LLM API key configurada."
+        not_when: "Sem alvo próprio ou sem autorização escrita e escopo definido do dono do sistema; nunca acionar por padrão silencioso."
+        rel:
+          pairs_with: [security-audit-pentest]
+        platform: [darwin, linux]
+        check: "command -v strix"
+        # Pin de supply chain (2026-08-25): versão fixa do pacote pip; o sandbox
+        # é a imagem pinada ghcr.io/usestrix/strix-sandbox:1.3.0, puxada no 1º run
+        # dentro do Docker isolado. Atualizar conscientemente.
+        install: "pipx install strix-agent==1.5.3"
+        verify: "command -v docker >/dev/null 2>&1 && docker info >/dev/null 2>&1"
 
   analyst:
     agent: wizz-agent-analyst
@@ -371,30 +465,19 @@ areas:
       - id: inicio-de-projeto
         when: "Kickoff LEVE de engenharia: stack, personas, glossário, princípios, estrutura de pastas, checklist. Atalho sem cerimônia de PRD."
       - id: implementation-planner
-        when: "Plano técnico de implementação de site/app premium pós-direção aprovada."
-    mcps:
-      - id: exa
-        when: "Pesquisa web/prior-art durante planejamento (web search, descoberta de fontes)."
-        server:
-          command: npx
-          # Pin de supply chain (2026-08-23): versão fixa; atualizar conscientemente.
-          args: ["-y", "exa-mcp-server@3.4.1"]
-          env:
-            EXA_API_KEY: "${EXA_API_KEY}"
+        when: "Plano técnico de implementação de site/app premium pós-direção aprovada. Pesquisa web/prior-art durante o planejamento usa a tool nativa WebSearch (sem custo/MCP metered — o MCP exa foi removido em 2026-08-25)."
 
   memoria:
     agent: wizz-memoria
     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/3-solutioning/wizz-generate-project-context/project-context-template.md

@@ -4,6 +4,7 @@ user_name: '{{user_name}}'
 date: '{{date}}'
 sections_completed: ['technology_stack']
 existing_patterns_found: { { number_of_patterns_discovered } }
+stage: '{{project_stage}}' # prototype|mvp|production|maintenance
 ---
 
 # Project Context for AI Agents
@@ -12,6 +13,10 @@ _This file contains critical rules and patterns that AI agents must follow when
 
 ---
 
+## Estado do Projeto
+
+_Documented after discovery phase (estágio atual, o que está no ar, o que falta)_
+
 ## Technology Stack & Versions
 
 _Documented after discovery phase_

package/src/bmm-skills/3-solutioning/wizz-generate-project-context/steps/step-01-discover.md

@@ -38,7 +38,18 @@ First, check if project context already exists:
 - If exists: Read complete file to understand existing rules
 - Present to user: "Found existing project context with {number_of_sections} sections. Would you like to update this or create a new one?"
 
-### 2. Discover Project Technology Stack
+### 2. Determine Project Stage
+
+Infer the project's lifecycle stage from repo signals before going deeper:
+
+- No deploy config, few commits, scaffolding only → likely `prototype`
+- Deployed but still shaping core flows, no monitoring/CI → likely `mvp`
+- CI/CD, monitoring, error tracking, real users → likely `production`
+- Low commit velocity, mostly fixes/deps → likely `maintenance`
+
+Present the inferred stage and confirm with the user: "Pelos sinais do repo, este projeto parece estar em **{{inferred_stage}}**. Confere?" Use the confirmed value for `stage:` in the frontmatter.
+
+### 3. Discover Project Technology Stack
 
 Load and analyze project files to identify technologies:
 
@@ -61,7 +72,7 @@ Load and analyze project files to identify technologies:
 - Linting and formatting configs (.eslintrc, .prettierrc, etc.)
 - Testing configurations (jest.config.js, vitest.config.ts, etc.)
 
-### 3. Identify Existing Code Patterns
+### 4. Identify Existing Code Patterns
 
 Search through existing codebase for patterns:
 
@@ -85,7 +96,7 @@ Search through existing codebase for patterns:
 - Documentation requirements
 - README and API doc patterns
 
-### 4. Extract Critical Implementation Rules
+### 5. Extract Critical Implementation Rules
 
 Look for rules that AI agents might miss:
 
@@ -117,7 +128,7 @@ Look for rules that AI agents might miss:
 - PR review requirements
 - Deployment procedures
 
-### 5. Initialize Project Context Document
+### 6. Initialize Project Context Document
 
 Based on discovery, create or update the context document:
 
@@ -131,7 +142,7 @@ Initialize frontmatter fields.
 Load existing context and prepare for updates
 Set frontmatter `sections_completed` to track what will be updated
 
-### 6. Present Discovery Summary
+### 7. Present Discovery Summary
 
 Report findings to user: