wizz-method 1.19.0 → 2.1.0

package/skills-registry.yaml

@@ -9,6 +9,12 @@
 #
 # Skills vivem em src/skills-lib/<id>/. Squads em src/squads/<id>/ (via wizz-party-mode).
 #
+# CAMPOS SÓ-LLM (audit item 24): `door`, `rel` e `not_when` NÃO são lidos por
+# nenhum código — só pelo roteador LLM em runtime. O validador de schema
+# (tools/validate-registry-schema.js) checa a FORMA deles e rejeita qualquer
+# OUTRA chave não documentada aqui (whitelist fechada por tipo de entrada):
+# mudar/remover um desses campos quebra roteamento sem quebrar build.
+#
 # MCPs (Model Context Protocol servers) também são declarados aqui, por área, no
 # campo `mcps:` (e `mcp_utility:` para os cross-cutting). Cada entrada tem:
 #   id      — nome do server no config da IDE (chave em mcpServers)
@@ -77,57 +83,57 @@ areas:
     # soltas. Nada foi fundido: todos os arquivos e references continuam intactos.
     skills:
       # ── Porta 1: DIREÇÃO (decidir antes de construir) ──
-      - id: decision-maker
+      - id: wizz-decision-maker
         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)."
+        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: wizz-taste-skill (direção anti-slop de brief novo) e wizz-motion-3d-director (decidir caminho motion/3D/vídeo)."
         rel:
-          pairs_with: [taste-skill, motion-3d-director]
-      - id: taste-skill
+          pairs_with: [wizz-taste-skill, wizz-motion-3d-director]
+      - id: wizz-taste-skill
         door: direcao
         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
+      - id: wizz-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."
 
       # ── Porta 2: CONSTRUÇÃO E POLISH DE UI ──
-      - id: ui-ux-pro-max
+      - id: wizz-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-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
+        when: "PORTA de construção: criar/melhorar UI (design system, paleta, tipografia, componente, página). Puxa: wizz-premium-landing-ui-researcher (landing premium greenfield), wizz-ui-component-curator (1 componente em projeto existente), wizz-impeccable (gate de polish/acessibilidade), wizz-taste-skill (anti-slop em código existente, protocolo de redesign), wizz-huashu-design (protótipo HTML hi-fi/variantes/review) e wizz-react-components (Stitch→React)."
+      - id: wizz-premium-landing-ui-researcher
         door: construcao
         when: "Projeto NOVO (greenfield): cria landing premium do zero, hero, 3D high-end. Estratégia source-first."
-      - id: ui-component-curator
+      - id: wizz-ui-component-curator
         door: construcao
         when: "Projeto EXISTENTE: qual componente/efeito adicionar que combina com o estilo atual."
-      - id: impeccable
+      - id: wizz-impeccable
         door: construcao
         when: "Gate de polish/qualidade de frontend: hardening de UI, acessibilidade, anti-padrões. Refina o que já existe."
-      - id: huashu-design
+      - id: wizz-huashu-design
         door: construcao
         when: "Direção visual + protótipo HTML hi-fi, exploração de variantes, review 5-dim, export MP4/GIF."
-      - id: react-components
+      - id: wizz-react-components
         door: construcao
         when: "Converter design (Stitch MCP) em componentes React/Vite."
 
       # ── Porta 3: MOTION E ASSETS (executar animação e gerar mídia) ──
-      - id: animate
+      - id: wizz-animate
         entry: true
         door: motion
-        when: "PORTA de motion/assets: executar animação e gerar mídia. Craft de micro-interação (regras do Emil Kowalski: saída > entrada, só transform/opacity, reduced-motion). Puxa: design-motion-principles (auditar animação existente), remotion-best-practices (vídeo em React), canvas-design (PNG/PDF por código) e algorithmic-art (visual generativo)."
-      - id: design-motion-principles
+        when: "PORTA de motion/assets: executar animação e gerar mídia. Craft de micro-interação (regras do Emil Kowalski: saída > entrada, só transform/opacity, reduced-motion). Puxa: wizz-design-motion-principles (auditar animação existente), wizz-remotion-best-practices (vídeo em React), wizz-canvas-design (PNG/PDF por código) e wizz-algorithmic-art (visual generativo)."
+      - id: wizz-design-motion-principles
         door: motion
         when: "Auditor de movimento: revisa animação existente e aponta scale(0) no início, easing cru, reduced-motion faltando; pesa contenção/polimento/diversão pelo contexto."
-      - id: remotion-best-practices
+      - id: wizz-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
+      - id: wizz-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
+      - id: wizz-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
@@ -138,7 +144,7 @@ areas:
         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]
+          before: [wizz-remotion-best-practices]
         platform: [darwin, linux]
         # 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.
@@ -187,6 +193,19 @@ areas:
         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"
+      - id: apple-design
+        when: "Revisar/auditar UI NATIVA (iOS/macOS: SwiftUI, Flutter, React Native, Tauri, Electron) contra o Apple HIG e o Liquid Glass — compliance com o HIG, acessibilidade, dark mode, navegação. Cobre o gap que o wizz-taste-skill declara fora de escopo ('native mobile: use Apple HIG directly')."
+        not_when: "UI web: aí é wizz-ui-ux-pro-max / wizz-impeccable."
+        rel:
+          pairs_with: [wizz-taste-skill]
+        platform: [darwin, linux]
+        # Upstream sem licença declarada e reproduz texto do Apple HIG (122
+        # páginas): o Wizz só instala a partir do upstream, no opt-in do
+        # usuário, e nunca vendoriza/copia o conteúdo pra este repo (auditoria
+        # 2026-09-11, Parte 3.14, item 25). Escopo LOCAL. Pin de supply chain
+        # (2026-09-12): HEAD do upstream em 2026-09-09 (sem tags de release).
+        check: "grep -qx da2da6dd03aacf06da3fecf205347601d38bb141 ./.claude/skills/apple-design/.wizz-pin 2>/dev/null"
+        install: 'd="$(mktemp -d)" && git clone https://github.com/dickwu/apple-design-skill.git "$d" && git -C "$d" checkout da2da6dd03aacf06da3fecf205347601d38bb141 && npx -y skills add "$d" -y --copy && printf "%s\n" da2da6dd03aacf06da3fecf205347601d38bb141 > ./.claude/skills/apple-design/.wizz-pin && rm -rf "$d"'
     references:
       - "references/premium-agency-rules.md (regras $150k-tier, importadas por impeccable/huashu no modo high-end)"
 
@@ -194,32 +213,32 @@ areas:
     agent: wizz-copy
     summary: "Copywriting: texto de venda, headlines, páginas, e-mails, sequências."
     skills:
-      - id: copywriting
+      - id: wizz-copywriting
         when: "Escrever copy de venda/página/headline do zero ou reescrever."
-      - id: copy-editing
+      - id: wizz-copy-editing
         when: "Editar/melhorar copy existente (framework Seven Sweeps). Review editorial geral."
-      - id: humanizer
+      - id: wizz-humanizer
         when: "Texto soa AI: remover padrões de escrita de máquina, dar naturalidade."
-      - id: email-sequence
+      - id: wizz-email-sequence
         when: "Sequências de e-mail (onboarding, nurture, lançamento)."
-      - id: cold-email
+      - id: wizz-cold-email
         when: "Cold email / outbound B2B / prospecção."
-      - id: sales-enablement
+      - id: wizz-sales-enablement
         when: "Material de vendas: deck, one-pager, objeções, demo script, playbook."
 
   seo:
     agent: wizz-seo
     summary: "SEO: auditoria, busca, AI search, schema, SEO programático."
     skills:
-      - id: seo-audit
+      - id: wizz-seo-audit
         when: "Ponto de partida: auditar/diagnosticar SEO, queda de tráfego, ranking, core web vitals."
-      - id: ai-seo
+      - id: wizz-ai-seo
         when: "Otimizar pra ser citado por LLMs/AI search (AEO/GEO/LLMO, AI Overviews)."
-      - id: schema-markup
+      - id: wizz-schema-markup
         when: "Implementar dados estruturados / structured data."
-      - id: programmatic-seo
+      - id: wizz-programmatic-seo
         when: "Gerar páginas em escala pra atacar muitas keywords."
-      - id: site-architecture
+      - id: wizz-site-architecture
         when: "Arquitetura de site / topic clusters / estrutura de URLs."
     clis:
       - id: distribb
@@ -235,41 +254,41 @@ areas:
     agent: wizz-growth
     summary: "Growth e conversão: marketing, CRO, lançamento, preço, retenção."
     skills:
-      - id: marketing-ideas
+      - id: wizz-marketing-ideas
         when: "Travou / quer inspiração ampla de marketing. Ponto de partida quando não sabe o canal."
-      - id: marketing-psychology
+      - id: wizz-marketing-psychology
         when: "Aplicar gatilhos/vieses/modelos mentais à persuasão."
-      - id: product-marketing-context
+      - id: wizz-product-marketing-context
         when: "Posicionamento de produto e contexto de marketing do produto."
-      - id: launch-strategy
+      - id: wizz-launch-strategy
         when: "Lançar produto/feature: Product Hunt, GTM, waitlist, beta."
-      - id: pricing-strategy
+      - id: wizz-pricing-strategy
         when: "Preço, planos, freemium, packaging, willingness to pay."
-      - id: paywall-upgrade-cro
+      - id: wizz-paywall-upgrade-cro
         when: "Tela de upgrade in-app / paywall."
-      - id: churn-prevention
+      - id: wizz-churn-prevention
         when: "Churn, retenção, cancelamento, NPS."
-      - id: revops
+      - id: wizz-revops
         when: "Operações de receita: pipeline, métricas, processo de revenue."
-      - id: page-cro
+      - id: wizz-page-cro
         when: "Otimizar conversão de página (home, landing, pricing, feature)."
-      - id: form-cro
+      - id: wizz-form-cro
         when: "Otimizar formulários (fora de signup)."
-      - id: popup-cro
+      - id: wizz-popup-cro
         when: "Otimizar popups/modais."
-      - id: onboarding-cro
+      - id: wizz-onboarding-cro
         when: "Ativação pós-signup / onboarding de usuário."
-      - id: signup-flow-cro
+      - id: wizz-signup-flow-cro
         when: "Fluxo de signup/registro."
-      - id: competitor-alternatives
+      - id: wizz-competitor-alternatives
         when: "Página de comparação vs concorrente / alternatives / battle card."
-      - id: referral-program
+      - id: wizz-referral-program
         when: "Programa de indicação/afiliados."
-      - id: free-tool-strategy
+      - id: wizz-free-tool-strategy
         when: "Ferramenta grátis pra captação de leads."
-      - id: ab-test-setup
+      - id: wizz-ab-test-setup
         when: "Montar A/B test / experimento de conversão."
-      - id: analytics-tracking
+      - id: wizz-analytics-tracking
         when: "Setar/auditar tracking e medição (GA4, GTM, eventos, UTM, atribuição)."
       - id: site-launch-kit
         when: "Site pronto ou quase pronto pra ir ao ar: revisão de pré-lançamento em 15 rodadas corretivas (CTA acima da dobra, barra fixa mobile, tempo de resposta, prova social real, FAQ+FAQPage, imagens reais, endereço, titles, Open Graph, breadcrumbs, alt text, schema local, robots/sitemap, LGPD, medição), com regra anti-invenção e PENDÊNCIAS. Gatilhos: 'vamos subir o site', 'checklist de lançamento', 'revisa antes do deploy', pré-go-live, ou um item isolado (og:image, FAQ com schema, robots.txt). Roda DEPOIS do site construído, ANTES do deploy."
@@ -278,22 +297,22 @@ areas:
       - 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
+      - id: wizz-lowticket-metodologia
         module: lowticket
         when: "Roteador da base low ticket BR/PT: gatilho → um shard. Régua de preço, garantia, copy e rastreamento 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
+      - id: wizz-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
+      - id: wizz-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
+      - id: wizz-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:
@@ -316,40 +335,53 @@ areas:
     agent: wizz-social
     summary: "Social e roteiros virais: Reels/Shorts, hooks, calendário de conteúdo. Persona Rafa, aplica o Blueprint de Roteiro Viral e roteia para as CLIs de vídeo quando o roteiro vira vídeo."
     skills:
-      - id: social-content
+      - id: wizz-social-content
         when: "Criar/agendar conteúdo de social (LinkedIn, X, TikTok, IG...)."
-      - id: content-strategy
+      - id: wizz-content-strategy
         when: "Decidir O QUE produzir de conteúdo (topic clusters, calendário, pilares)."
-      - id: copy-editing
+      - id: wizz-copy-editing
         when: "Revisar/editar o texto do roteiro ou da legenda antes de publicar."
+    clis:
+      - id: postiz
+        when: "PUBLICAR/agendar de verdade em redes sociais (30+ integrações) a partir do conteúdo que o wizz-social já gerou. Separa 'gerar' (Wizz) de 'publicar' (Postiz). Precisa autenticar antes (`postiz auth:login` ou env `POSTIZ_API_KEY`); para imagem/vídeo a própria CLI faz o upload."
+        not_when: "Escrever o roteiro ou a legenda: isso é skill da área (wizz-social-content, wizz-copy-editing)."
+        # Item 30 da auditoria (2026-09-11, Parte 3.7). Pin de supply chain
+        # (2026-09-12): versão publicada fixa no npm, atualizar conscientemente.
+        # CLI, não MCP: o schema de `mcps:` deste registry só aceita stdio
+        # ({command,args,env}) e o MCP hospedado da Postiz é HTTP+OAuth
+        # (https://mcp.postiz.com/mcp-oauth-dynamic) — não encaixa. Existe uma
+        # skill wrapper (`gitroomhq/postiz-agent`) que só dirige esta mesma CLI;
+        # opcional, não registrada aqui.
+        check: "command -v postiz >/dev/null 2>&1"
+        install: "npm install -g postiz@2.0.16"
 
   ads:
     agent: wizz-ads
     summary: "Mídia paga: campanhas Google/Meta/TikTok/LinkedIn, criativos, tracking."
     skills:
-      - id: paid-ads
+      - id: wizz-paid-ads
         when: "Estratégia de campanha, targeting, bidding, ROAS/CPA. Decidir/rodar ads."
-      - id: ad-creative
+      - id: wizz-ad-creative
         when: "Gerar/iterar criativos e headlines de anúncio em escala (RSA, variações)."
-      - id: analytics-tracking
+      - id: wizz-analytics-tracking
         when: "Tracking de conversão pros anúncios (compartilhada com growth)."
-      - id: tracking-audit
+      - id: wizz-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]
+          pairs_with: [wizz-analytics-tracking, wizz-paid-ads]
+          before: [wizz-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
+      - id: wizz-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, player de VSL, upsell, copy, rastreamento, 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
+      - id: wizz-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:
@@ -360,25 +392,25 @@ areas:
     agent: wizz-agent-architect
     summary: "Arquitetura, banco, segurança, infra, decisões técnicas."
     skills:
-      - id: web-security
+      - id: wizz-web-security
         when: "Auditar segurança web, OWASP, XSS/CSRF/injeção/SQLi, IDOR, headers, rate limit (IP+conta), CORS, clickjacking, vazamento de PII na resposta, antes de deploy/PR."
-      - id: auth-and-secrets
+      - id: wizz-auth-and-secrets
         when: "Auth (JWT/OAuth/SSO/Clerk), token no header vs URL, revogar no logout, enumeração de usuário, gestão de secrets, rotação de credenciais."
-      - id: desktop-security
+      - id: wizz-desktop-security
         when: "Segurança desktop/Electron (contextIsolation, code signing)."
-      - id: database-scaling
+      - id: wizz-database-scaling
         when: "Banco lento, queries, índices, N+1, sharding, connection pool."
-      - id: caching-and-queues
+      - id: wizz-caching-and-queues
         when: "Cache (Redis), filas (BullMQ/SQS/Kafka), jobs assíncronos."
-      - id: infrastructure
+      - id: wizz-infrastructure
         when: "Escala de infra: Kubernetes, auto-scaling, CDN, SLOs, load test."
-      - id: cloud-and-infra
+      - id: wizz-cloud-and-infra
         when: "Custo de cloud: right-sizing, spot/reserved, S3 lifecycle, billing AWS/GCP."
-      - id: database-and-deps
+      - id: wizz-database-and-deps
         when: "Dependências/packages, vulnerabilidades, npm audit."
-      - id: supabase-postgres-best-practices
+      - id: wizz-supabase-postgres-best-practices
         when: "Performance e boas práticas de Postgres/Supabase (queries, schema, RLS)."
-      - id: ai-product-design
+      - id: wizz-ai-product-design
         when: "Construir/melhorar um agente ou produto de IA: escrever/revisar system prompt, definir persona/tom, guardrails e recusas, few-shot, chain-of-thought, orquestração multi-agente, handoff, detecção de frustração, generative UI, avaliar qualidade de saída. Base para desenhar os próprios agentes do método. 44 padrões (Owl-Listener, MIT)."
     mcps:
       - id: supabase
@@ -398,24 +430,42 @@ areas:
         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"
+      - id: archify
+        when: "DESENHAR um diagrama VALIDADO de arquitetura/workflow/sequência/dataflow/estado como HTML+SVG navegável (aceita Mermaid) — no passo 'Renderings & polish' do wizz-architecture, ou quando o usuário pedir um diagrama assim. Protocolo obrigatório validate → deliver → visual-check: nunca declarar sucesso sem ler o JSON do comando. Ele DESENHA o que já foi decidido; a decisão e o porquê continuam no wizz-architecture (memlog, AD-n)."
+        not_when:
+          - "Registrar a decisão de arquitetura em si: isso é o wizz-architecture."
+          - "Diagrama descartável de conversa: Mermaid inline já basta."
+        platform: [darwin, linux]
+        # Origem: auditoria 2026-09-11, Parte 3.10, item 25. Pin de supply chain
+        # (2026-09-12): tag de release v2.16.0, não main — upstream tem 155
+        # issues abertas, pin conservador. Atualizar conscientemente.
+        # Escopo LOCAL (diferente do hyperframes, que é global por escolha
+        # antiga): regra 1 da Doutrina de Instalação prefere local, sem motivo
+        # documentado pra abrir exceção aqui. A skill vive no subdiretório
+        # archify/ do repo (a raiz não tem SKILL.md), daí o `-s archify`.
+        # O bin faz um GET opcional de checagem de update ao rodar; desativar
+        # com o env ARCHIFY_UPDATE_CHECK_DISABLED=1 (sem campo `env` em clis).
+        check: "grep -qx c826e6c3a7abad19c0f3cd1ca57207d54b1ad8de ./.claude/skills/archify/.wizz-pin 2>/dev/null"
+        install: 'd="$(mktemp -d)" && git clone https://github.com/tt-a1i/archify.git "$d" && git -C "$d" checkout c826e6c3a7abad19c0f3cd1ca57207d54b1ad8de && npx -y skills add "$d" -s archify -y --copy && printf "%s\n" c826e6c3a7abad19c0f3cd1ca57207d54b1ad8de > ./.claude/skills/archify/.wizz-pin && rm -rf "$d"'
+        verify: "command -v node >/dev/null 2>&1"
 
   qa:
     agent: wizz-qa
     summary: "QA: verificar o código de fora (testes, E2E, review adversarial)."
     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: wizz-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 (persona do 'Blind Hunter'; o prompt operacional vive em review-prompts/blind-hunter.md e nenhum workflow invoca a skill) 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
+      - id: wizz-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."
+      - id: wizz-agent-browser
+        when: "Verificação visual/browser, preencher forms, screenshots, testar UI no navegador. CLI já instalado (não é MCP); browser SEMPRE via wizz-agent-browser, nunca Playwright."
     clis:
       - id: agent-browser
         when: "Dirigir um browser real pra E2E/verificação: navegar, clicar, preencher form, screenshot, console. É CLI, não MCP."
@@ -439,11 +489,82 @@ areas:
     agent: wizz-agent-analyst
     summary: "Análise, pesquisa, brief, kickoff de projeto."
     skills:
-      - id: inicio-de-projeto
+      - id: wizz-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
+      - id: wizz-implementation-planner
         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)."
 
+  # ── Áreas dev/produto (item 18 da auditoria de 2026-09-11, finding RT-H2):
+  # "dev" era citado dezenas de vezes no método (router, maestro,
+  # token-economy, encerramento) sem existir como chave de `areas:`. As 4
+  # chaves abaixo apontam para os agents do módulo bmm (src/bmm-skills,
+  # team software-development: Amelia/John/Paige/Sally) e listam as skills
+  # bmm correspondentes via `module: bmm` — mesmo mecanismo do módulo
+  # lowticket: NÃO são copiadas para `_wizz/skills-lib/` (são instaladas
+  # junto do módulo bmm), ficam no registry só para o router/maestro
+  # enxergarem e rotearem.
+  dev:
+    agent: wizz-agent-dev
+    summary: "Desenvolvimento de software: implementar story/bug/feature, TDD, review de código, sprint."
+    skills:
+      - id: wizz-quick-dev
+        module: bmm
+        when: "DEV PONTUAL: ajuste, bug fix, feature única sem cerimônia de story. Fluxo unificado: clarificar → planejar → implementar → review → apresentar. É o destino padrão quando o router/maestro diz 'dev pontual'."
+      - id: wizz-dev-story
+        module: bmm
+        when: "Implementar UMA story específica com spec preenchida ('dev this story', 'implementa a próxima story do sprint')."
+      - id: wizz-create-story
+        module: bmm
+        when: "Preparar story com todo o contexto de implementação ('cria a story', 'prepara a story'). Antes do dev, no gate de planejamento."
+      - id: wizz-code-review
+        module: bmm
+        when: "Review de código real de diff/PR: 3 camadas paralelas (Blind Hunter, Edge Case, Verification Gap) + triagem. Diferente de wizz-adversarial-reviewer (passe único ad hoc, área qa)."
+      - id: wizz-investigate
+        module: bmm
+        when: "Investigar bug/incidente, rastrear causa, construir modelo mental de uma área de código antes de mexer."
+      - id: wizz-sprint-planning
+        module: bmm
+        when: "Gerar/atualizar o sprint plan que sequencia stories para implementação."
+      - id: wizz-correct-course
+        module: bmm
+        when: "Mudança significativa durante o sprint: propor ajuste de curso ('correct course')."
+      - id: wizz-retrospective
+        module: bmm
+        when: "Review do trabalho concluído no epic (party mode)."
+
+  pm:
+    agent: wizz-agent-pm
+    summary: "Produto: PRD, brief, requisitos, escopo, priorização."
+    skills:
+      - id: wizz-prd
+        module: bmm
+        when: "Criar, atualizar ou validar PRD ('cria o PRD', 'documento de requisitos', 'define o escopo'). Consolida os antigos create/edit/validate-prd (removidos em v7)."
+      - id: wizz-product-brief
+        module: bmm
+        when: "Criar, atualizar ou validar o brief do produto ('cria o brief'). Antes do PRD, no kickoff de produto."
+      - id: wizz-prfaq
+        module: bmm
+        when: "Desafio Working Backwards PRFAQ para forjar conceito de produto ('cria a PRFAQ', 'work backwards')."
+      - id: wizz-set-feature
+        module: bmm
+        when: "Definir feature específica dentro do produto (análise de feature única)."
+
+  tech-writer:
+    agent: wizz-agent-tech-writer
+    summary: "Documentação: docs técnicas, diagramas, estrutura de conhecimento."
+    skills:
+      - id: wizz-document-project
+        module: bmm
+        when: "Documentar o projeto: gerar/atualizar docs de arquitetura e estrutura para contexto de agentes e humanos."
+
+  ux-designer:
+    agent: wizz-agent-ux-designer
+    summary: "UX: fluxos, user stories, especificação de experiência."
+    skills:
+      - id: wizz-ux
+        module: bmm
+        when: "Especificar experiência do usuário: fluxos, wireframes de conteúdo, user stories de UX (diferente da área designer, que constrói UI visual)."
+
   memoria:
     agent: wizz-memoria
     summary: "Memória do projeto: o que foi decidido, salvar, ver estado."

package/src/bmm-skills/1-analysis/research/wizz-domain-research/SKILL.md

@@ -14,7 +14,6 @@ description: 'Conduct domain and industry research. Use when the user says wants
 - Bare paths (e.g. `domain-steps/step-01-init.md`) resolve from the skill root.
 - `{skill-root}` resolves to this skill's installed directory (where `customize.toml` lives).
 - `{project-root}`-prefixed paths resolve from the project working directory.
-- `{skill-name}` resolves to the skill directory's basename.
 
 ## PREREQUISITE
 
@@ -24,13 +23,13 @@ description: 'Conduct domain and industry research. Use when the user says wants
 
 ### Step 1: Resolve the Workflow Block
 
-Run: `python3 {project-root}/_wizz/scripts/resolve_customization.py --skill {skill-root} --key workflow`
+Run: read `{project-root}/_wizz/_resolved/wizz-domain-research.json` (subtree `workflow`). If the file is missing, empty or not valid JSON, run `npx wizz-method resolve --skill wizz-domain-research` from the project root and read the snapshot again
 
 **If the script fails**, resolve the `workflow` block yourself by reading these three files in base → team → user order and applying the same structural merge rules as the resolver:
 
 1. `{skill-root}/customize.toml` — defaults
-2. `{project-root}/_wizz/custom/{skill-name}.toml` — team overrides
-3. `{project-root}/_wizz/custom/{skill-name}.user.toml` — personal overrides
+2. `{project-root}/_wizz/custom/wizz-domain-research.toml` — team overrides
+3. `{project-root}/_wizz/custom/wizz-domain-research.user.toml` — personal overrides
 
 Any missing file is skipped. Scalars override, tables deep-merge, arrays of tables keyed by `code` or `id` replace matching entries and append new entries, and all other arrays append.
 

package/src/bmm-skills/1-analysis/research/wizz-domain-research/domain-steps/step-06-research-synthesis.md

@@ -443,7 +443,7 @@ Complete authoritative research document on {{research_topic}} that:
 
 ## On Complete
 
-Run: `python3 {project-root}/_wizz/scripts/resolve_customization.py --skill {skill-root} --key workflow.on_complete`
+Run: read `workflow.on_complete` from the `{project-root}/_wizz/_resolved/wizz-domain-research.json` snapshot loaded in step 1
 
 If the resolved `workflow.on_complete` is non-empty, follow it as the final terminal instruction before exiting.
 

package/src/bmm-skills/1-analysis/research/wizz-market-research/SKILL.md

@@ -14,7 +14,6 @@ description: 'Conduct market research on competition and customers. Use when the
 - Bare paths (e.g. `steps/step-01-init.md`) resolve from the skill root.
 - `{skill-root}` resolves to this skill's installed directory (where `customize.toml` lives).
 - `{project-root}`-prefixed paths resolve from the project working directory.
-- `{skill-name}` resolves to the skill directory's basename.
 
 ## PREREQUISITE
 
@@ -24,13 +23,13 @@ description: 'Conduct market research on competition and customers. Use when the
 
 ### Step 1: Resolve the Workflow Block
 
-Run: `python3 {project-root}/_wizz/scripts/resolve_customization.py --skill {skill-root} --key workflow`
+Run: read `{project-root}/_wizz/_resolved/wizz-market-research.json` (subtree `workflow`). If the file is missing, empty or not valid JSON, run `npx wizz-method resolve --skill wizz-market-research` from the project root and read the snapshot again
 
 **If the script fails**, resolve the `workflow` block yourself by reading these three files in base → team → user order and applying the same structural merge rules as the resolver:
 
 1. `{skill-root}/customize.toml` — defaults
-2. `{project-root}/_wizz/custom/{skill-name}.toml` — team overrides
-3. `{project-root}/_wizz/custom/{skill-name}.user.toml` — personal overrides
+2. `{project-root}/_wizz/custom/wizz-market-research.toml` — team overrides
+3. `{project-root}/_wizz/custom/wizz-market-research.user.toml` — personal overrides
 
 Any missing file is skipped. Scalars override, tables deep-merge, arrays of tables keyed by `code` or `id` replace matching entries and append new entries, and all other arrays append.
 

package/src/bmm-skills/1-analysis/research/wizz-market-research/steps/step-06-research-completion.md

@@ -477,7 +477,7 @@ Comprehensive market research workflow complete. User may:
 
 ## On Complete
 
-Run: `python3 {project-root}/_wizz/scripts/resolve_customization.py --skill {skill-root} --key workflow.on_complete`
+Run: read `workflow.on_complete` from the `{project-root}/_wizz/_resolved/wizz-market-research.json` snapshot loaded in step 1
 
 If the resolved `workflow.on_complete` is non-empty, follow it as the final terminal instruction before exiting.
 

package/src/bmm-skills/1-analysis/research/wizz-technical-research/SKILL.md

@@ -14,7 +14,6 @@ description: 'Conduct technical research on technologies and architecture. Use w
 - Bare paths (e.g. `technical-steps/step-01-init.md`) resolve from the skill root.
 - `{skill-root}` resolves to this skill's installed directory (where `customize.toml` lives).
 - `{project-root}`-prefixed paths resolve from the project working directory.
-- `{skill-name}` resolves to the skill directory's basename.
 
 ## PREREQUISITE
 
@@ -24,13 +23,13 @@ description: 'Conduct technical research on technologies and architecture. Use w
 
 ### Step 1: Resolve the Workflow Block
 
-Run: `python3 {project-root}/_wizz/scripts/resolve_customization.py --skill {skill-root} --key workflow`
+Run: read `{project-root}/_wizz/_resolved/wizz-technical-research.json` (subtree `workflow`). If the file is missing, empty or not valid JSON, run `npx wizz-method resolve --skill wizz-technical-research` from the project root and read the snapshot again
 
 **If the script fails**, resolve the `workflow` block yourself by reading these three files in base → team → user order and applying the same structural merge rules as the resolver:
 
 1. `{skill-root}/customize.toml` — defaults
-2. `{project-root}/_wizz/custom/{skill-name}.toml` — team overrides
-3. `{project-root}/_wizz/custom/{skill-name}.user.toml` — personal overrides
+2. `{project-root}/_wizz/custom/wizz-technical-research.toml` — team overrides
+3. `{project-root}/_wizz/custom/wizz-technical-research.user.toml` — personal overrides
 
 Any missing file is skipped. Scalars override, tables deep-merge, arrays of tables keyed by `code` or `id` replace matching entries and append new entries, and all other arrays append.
 

package/src/bmm-skills/1-analysis/research/wizz-technical-research/technical-steps/step-06-research-synthesis.md

@@ -486,7 +486,7 @@ Complete authoritative technical research document on {{research_topic}} that:
 
 ## On Complete
 
-Run: `python3 {project-root}/_wizz/scripts/resolve_customization.py --skill {skill-root} --key workflow.on_complete`
+Run: read `workflow.on_complete` from the `{project-root}/_wizz/_resolved/wizz-technical-research.json` snapshot loaded in step 1
 
 If the resolved `workflow.on_complete` is non-empty, follow it as the final terminal instruction before exiting.
 

package/src/bmm-skills/1-analysis/wizz-agent-analyst/SKILL.md

@@ -14,19 +14,18 @@ You are Mary, the Business Analyst. You bring deep expertise in market research,
 - Bare paths (e.g. `references/guide.md`) resolve from the skill root.
 - `{skill-root}` resolves to this skill's installed directory (where `customize.toml` lives).
 - `{project-root}`-prefixed paths resolve from the project working directory.
-- `{skill-name}` resolves to the skill directory's basename.
 
 ## On Activation
 
 ### Step 1: Resolve the Agent Block
 
-Run: `python3 {project-root}/_wizz/scripts/resolve_customization.py --skill {skill-root} --key agent`
+Run: read `{project-root}/_wizz/_resolved/wizz-agent-analyst.json` (subtree `agent`). If the file is missing, empty or not valid JSON, run `npx wizz-method resolve --skill wizz-agent-analyst` from the project root and read the snapshot again
 
 **If the script fails**, resolve the `agent` block yourself by reading these three files in base → team → user order and applying the same structural merge rules as the resolver:
 
 1. `{skill-root}/customize.toml` — defaults
-2. `{project-root}/_wizz/custom/{skill-name}.toml` — team overrides
-3. `{project-root}/_wizz/custom/{skill-name}.user.toml` — personal overrides
+2. `{project-root}/_wizz/custom/wizz-agent-analyst.toml` — team overrides
+3. `{project-root}/_wizz/custom/wizz-agent-analyst.user.toml` — personal overrides
 
 Any missing file is skipped. Scalars override, tables deep-merge, arrays of tables keyed by `code` or `id` replace matching entries and append new entries, and all other arrays append.