wizz-method 1.0.2 → 1.1.0

package/skills-registry.yaml

@@ -0,0 +1,318 @@
+# Wizz Method — Skills Registry (fonte única)
+#
+# Mapeia cada skill global a uma ÁREA (dona = agente wizz), cada SQUAD a um
+# domínio consultivo, e dá um campo "when" curto pra desambiguar skills
+# parecidas. Dois consumidores leem este arquivo:
+#   1. O INSTALLER — decide quais skills copiar pra .claude/skills por área escolhida.
+#   2. O MAESTRO/ROUTER — decide pra qual agente/skill/squad rotear.
+# Mantê-los lendo o MESMO arquivo garante que roteamento e instalação nunca divirjam.
+#
+# Skills vivem em src/skills-lib/<id>/. Squads em src/squads/<id>/ (via wizz-party-mode).
+#
+# 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)
+#   when    — quando esse MCP ajuda (desambigua, igual ao `when` das skills)
+#   server  — { command, args, env } gravado no .mcp.json pelo installer
+# Secrets em `env` são SEMPRE placeholders `${VAR}` — o installer nunca escreve
+# token real. O installer instala/recomenda os MCPs das áreas escolhidas; o
+# maestro/router oferece o MCP certo em runtime. Mesma fonte única das skills.
+
+version: 1
+
+# ─────────────────────────────────────────────────────────────────────────────
+# ÁREAS — cada uma tem um agente dono (executor) e as skills que ele puxa.
+# ─────────────────────────────────────────────────────────────────────────────
+areas:
+  designer:
+    agent: wizz-designer
+    summary: "Design de produto e UI: interfaces, landing pages, design systems, motion, 3D."
+    skills:
+      - id: ui-ux-pro-max
+        when: "Design system, paleta, tipografia, componente; pedido de UI amplo. Principal de busca de padrões/estilos."
+      - id: impeccable
+        when: "Gate de polish/qualidade de frontend: hardening de UI, acessibilidade, anti-padrões. Refina o que já existe."
+      - id: huashu-design
+        when: "Direção visual + protótipo HTML hi-fi, exploração de variantes, review 5-dim, export MP4/GIF."
+      - id: premium-landing-ui-researcher
+        when: "Projeto NOVO (greenfield): cria landing premium do zero, hero, 3D high-end. Estratégia source-first."
+      - id: ui-component-curator
+        when: "Projeto EXISTENTE: qual componente/efeito adicionar que combina com o estilo atual."
+      - id: motion-3d-director
+        when: "Direção de motion/animação, 3D, WebGL, scroll cinematográfico, image-to-video."
+      - id: remotion-best-practices
+        when: "Vídeo programático em React (Remotion) especificamente."
+      - id: taste-skill
+        when: "Anti-slop em briefs NOVOS: lê o brief, define a direção e audita contra defaults de AI."
+      - id: taste-redesign
+        when: "Anti-slop em projeto EXISTENTE: audita o código atual, lista problemas, prioriza fixes."
+      - id: react-components
+        when: "Converter design (Stitch MCP) em componentes React/Vite."
+      - id: decision-maker
+        when: "Brief visual inicial: força 6 decisões de estética + 3 lógicas. Entra no kickoff, antes de construir."
+    mcps:
+      - id: magic
+        when: "Gerar/refinar componentes prontos via 21st.dev (UI builder, inspiration, refiner)."
+        server:
+          command: npx
+          args: ["-y", "@21st-dev/magic"]
+          env:
+            API_KEY: "${MAGIC_API_KEY}"
+    references:
+      - "references/premium-agency-rules.md (regras $150k-tier, importadas por impeccable/huashu no modo high-end)"
+
+  copy:
+    agent: wizz-copy
+    summary: "Copywriting: texto de venda, headlines, páginas, e-mails, sequências."
+    skills:
+      - id: copywriting
+        when: "Escrever copy de venda/página/headline do zero ou reescrever."
+      - id: copy-editing
+        when: "Editar/melhorar copy existente (framework Seven Sweeps). Review editorial geral."
+      - id: humanizer
+        when: "Texto soa AI: remover padrões de escrita de máquina, dar naturalidade."
+      - id: email-sequence
+        when: "Sequências de e-mail (onboarding, nurture, lançamento)."
+      - id: cold-email
+        when: "Cold email / outbound B2B / prospecção."
+      - id: 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
+        when: "Ponto de partida: auditar/diagnosticar SEO, queda de tráfego, ranking, core web vitals."
+      - id: ai-seo
+        when: "Otimizar pra ser citado por LLMs/AI search (AEO/GEO/LLMO, AI Overviews)."
+      - id: schema-markup
+        when: "Implementar dados estruturados / structured data."
+      - id: programmatic-seo
+        when: "Gerar páginas em escala pra atacar muitas keywords."
+      - id: site-architecture
+        when: "Arquitetura de site / topic clusters / estrutura de URLs."
+
+  growth:
+    agent: wizz-growth
+    summary: "Growth e conversão: marketing, CRO, lançamento, preço, retenção."
+    skills:
+      - id: marketing-ideas
+        when: "Travou / quer inspiração ampla de marketing. Ponto de partida quando não sabe o canal."
+      - id: marketing-psychology
+        when: "Aplicar gatilhos/vieses/modelos mentais à persuasão."
+      - id: product-marketing-context
+        when: "Posicionamento de produto e contexto de marketing do produto."
+      - id: launch-strategy
+        when: "Lançar produto/feature: Product Hunt, GTM, waitlist, beta."
+      - id: pricing-strategy
+        when: "Preço, planos, freemium, packaging, willingness to pay."
+      - id: paywall-upgrade-cro
+        when: "Tela de upgrade in-app / paywall."
+      - id: churn-prevention
+        when: "Churn, retenção, cancelamento, NPS."
+      - id: revops
+        when: "Operações de receita: pipeline, métricas, processo de revenue."
+      - id: page-cro
+        when: "Otimizar conversão de página (home, landing, pricing, feature)."
+      - id: form-cro
+        when: "Otimizar formulários (fora de signup)."
+      - id: popup-cro
+        when: "Otimizar popups/modais."
+      - id: onboarding-cro
+        when: "Ativação pós-signup / onboarding de usuário."
+      - id: signup-flow-cro
+        when: "Fluxo de signup/registro."
+      - id: content-strategy
+        when: "Decidir O QUE produzir de conteúdo (topic clusters, calendário, pilares)."
+      - id: social-content
+        when: "Criar/agendar conteúdo de social (LinkedIn, X, TikTok, IG...)."
+      - id: competitor-alternatives
+        when: "Página de comparação vs concorrente / alternatives / battle card."
+      - id: referral-program
+        when: "Programa de indicação/afiliados."
+      - id: free-tool-strategy
+        when: "Ferramenta grátis pra captação de leads."
+      - id: ab-test-setup
+        when: "Montar A/B test / experimento de conversão."
+      - id: analytics-tracking
+        when: "Setar/auditar tracking e medição (GA4, GTM, eventos, UTM, atribuição)."
+
+  ads:
+    agent: wizz-ads
+    summary: "Mídia paga: campanhas Google/Meta/TikTok/LinkedIn, criativos, tracking."
+    skills:
+      - id: paid-ads
+        when: "Estratégia de campanha, targeting, bidding, ROAS/CPA. Decidir/rodar ads."
+      - id: ad-creative
+        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)."
+    mcps:
+      - id: meta-ads
+        when: "Gestão real de campanha Meta/Facebook/Instagram via API (criar/editar/medir ads)."
+        server:
+          command: npx
+          args: ["-y", "mcp-meta-ads"]
+          env:
+            META_ACCESS_TOKEN: "${META_ACCESS_TOKEN}"
+
+  architect:
+    agent: wizz-agent-architect
+    summary: "Arquitetura, banco, segurança, infra, decisões técnicas."
+    skills:
+      - id: web-security
+        when: "Auditar segurança web, OWASP, XSS/CSRF/injeção, headers, rate limit, antes de deploy/PR."
+      - id: auth-and-secrets
+        when: "Auth (JWT/OAuth/SSO/Clerk), gestão de secrets, rotação de credenciais."
+      - id: desktop-security
+        when: "Segurança desktop/Electron (contextIsolation, code signing)."
+      - id: database-scaling
+        when: "Banco lento, queries, índices, N+1, sharding, connection pool."
+      - id: caching-and-queues
+        when: "Cache (Redis), filas (BullMQ/SQS/Kafka), jobs assíncronos."
+      - id: infrastructure
+        when: "Escala de infra: Kubernetes, auto-scaling, CDN, SLOs, load test."
+      - id: cloud-and-infra
+        when: "Custo de cloud: right-sizing, spot/reserved, S3 lifecycle, billing AWS/GCP."
+      - id: database-and-deps
+        when: "Dependências/packages, vulnerabilidades, npm audit."
+      - id: supabase-postgres-best-practices
+        when: "Performance e boas práticas de Postgres/Supabase (queries, schema, RLS)."
+    mcps:
+      - id: supabase
+        when: "Operar Supabase de verdade: rodar SQL, migrations, inspecionar schema/RLS, logs."
+        server:
+          command: npx
+          args: ["-y", "@supabase/mcp-server-supabase@latest"]
+          env:
+            SUPABASE_ACCESS_TOKEN: "${SUPABASE_ACCESS_TOKEN}"
+
+  qa:
+    agent: wizz-qa
+    summary: "QA: verificar o código de fora (testes, E2E, review adversarial)."
+    skills:
+      - id: adversarial-reviewer
+        when: "Caçar bugs adversarialmente, stress-test de PR, 'tear this apart'. (Global; o engine usa wizz-review-adversarial-general por dentro.)"
+      - 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."
+    # qa NÃO declara mcps: verificação de browser é via agent-browser (CLI/skill),
+    # não via MCP. Não usar o MCP do Playwright.
+    clis:
+      - id: agent-browser
+        when: "Dirigir um browser real pra E2E/verificação: navegar, clicar, preencher form, screenshot, console. É CLI, não MCP."
+        check: "agent-browser --version"
+        install: "npm install -g agent-browser"
+
+  analyst:
+    agent: wizz-agent-analyst
+    summary: "Análise, pesquisa, brief, kickoff de projeto."
+    skills:
+      - 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
+          args: ["-y", "exa-mcp-server"]
+          env:
+            EXA_API_KEY: "${EXA_API_KEY}"
+
+  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)."
+
+# ─────────────────────────────────────────────────────────────────────────────
+# 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
+    when: "Empacotar um briefing mais completo/estruturado pra mandar a outro agente ou skill."
+  - id: wizz-router
+    when: "Roteador global/flat: descobre skills quando não se sabe a área; escala pro maestro se multi-área."
+
+# ─────────────────────────────────────────────────────────────────────────────
+# MCP_UTILITY — MCPs cross-cutting, oferecidos independente da área escolhida.
+# ─────────────────────────────────────────────────────────────────────────────
+mcp_utility:
+  - id: context7
+    when: "Docs atualizadas de qualquer lib/framework/SDK (React, Next, Prisma, Tailwind...). Útil em todo dev."
+    server:
+      command: npx
+      args: ["-y", "@upstash/context7-mcp"]
+
+# ─────────────────────────────────────────────────────────────────────────────
+# CLIs — ferramentas de linha de comando que os agentes chamam direto (não são
+# MCP nem skill). O installer DETECTA se já estão instaladas (check) e, por
+# padrão, só RECOMENDA o comando de install; instala de verdade apenas se o
+# usuário marcar. `clis:` por área; `cli_utility:` para as cross-cutting.
+# ─────────────────────────────────────────────────────────────────────────────
+cli_utility:
+  - id: rtk
+    when: "Token economy: proxy que corta 60-90% de tokens em comandos de dev. O wizz-router assume RTK ativo (Passo 0). Útil em todo o ecossistema."
+    check: "rtk --version"
+    install: "curl -fsSL https://raw.githubusercontent.com/rtk-ai/rtk/refs/heads/master/install.sh | sh"
+
+# ─────────────────────────────────────────────────────────────────────────────
+# SQUADS — painéis consultivos de personas (rodam via wizz-party-mode).
+# Aconselham; depois o agente wizz da área executa. Domínio → quem chamar.
+# ─────────────────────────────────────────────────────────────────────────────
+squads:
+  brand-squad:
+    domain: "Branding, posicionamento, arquitetura de marca, naming, arquétipos."
+    advises: [copy, designer]
+    when: "Validar/definir posicionamento, identidade e estratégia de marca. Painel: Al Ries, Byron Sharp, Marty Neumeier, Kapferer, Keller..."
+  copy-squad:
+    domain: "Copywriting, mensagem, oferta, persuasão."
+    advises: [copy]
+    when: "Pressionar/afiar copy e mensagem antes do wizz-copy escrever."
+  design-squad:
+    domain: "Design visual e UX."
+    advises: [designer]
+    when: "Painel de design pra direção visual/UX antes do wizz-designer executar."
+  c-level-squad:
+    domain: "Estratégia de negócio, decisões executivas."
+    advises: [analyst, pm, growth]
+    when: "Decisão estratégica de alto nível, visão de negócio, board simulado."
+  advisory-board:
+    domain: "Consultoria geral multidisciplinar."
+    advises: [analyst, growth]
+    when: "Conselho amplo quando o problema cruza várias áreas."
+  data-squad:
+    domain: "Dados, analytics, métricas."
+    advises: [analyst, growth]
+    when: "Análise de dados, definição de métricas, leitura de resultados."
+  traffic-masters:
+    domain: "Tráfego pago, aquisição."
+    advises: [ads, growth]
+    when: "Estratégia de tráfego pago e aquisição antes do wizz-ads rodar campanha."
+  hormozi-squad:
+    domain: "Ofertas, monetização, growth agressivo."
+    advises: [growth, copy]
+    when: "Desenhar oferta irresistível, pricing/value stack, growth estilo Hormozi."
+  storytelling:
+    domain: "Narrativa, storytelling de marca/conteúdo."
+    advises: [copy, growth]
+    when: "Construir narrativa, história de marca, arco de conteúdo."
+  movement:
+    domain: "Comunidade, construção de movimento."
+    advises: [growth]
+    when: "Construir comunidade/movimento em torno do produto."
+  cybersecurity:
+    domain: "Segurança ofensiva/defensiva."
+    advises: [architect, qa]
+    when: "Painel de segurança pra threat modeling e hardening."
+  claude-code-mastery:
+    domain: "Claude Code, tooling de agentes, automação de dev."
+    advises: [dev, architect]
+    when: "Dominar Claude Code, hooks, skills, workflows de agente."

package/src/bmm-skills/1-analysis/research/wizz-domain-research/customize.toml

@@ -5,7 +5,7 @@
 
 [workflow]
 
-# --- Configurable below. Overrides merge per BMad structural rules: ---
+# --- Configurable below. Overrides merge per Wizz structural rules: ---
 #   scalars: override wins • arrays (persistent_facts, activation_steps_*): append
 #   arrays-of-tables with `code`/`id`: replace matching items, append new ones.
 

package/src/bmm-skills/1-analysis/research/wizz-market-research/customize.toml

@@ -5,7 +5,7 @@
 
 [workflow]
 
-# --- Configurable below. Overrides merge per BMad structural rules: ---
+# --- Configurable below. Overrides merge per Wizz structural rules: ---
 #   scalars: override wins • arrays (persistent_facts, activation_steps_*): append
 #   arrays-of-tables with `code`/`id`: replace matching items, append new ones.
 

package/src/bmm-skills/1-analysis/research/wizz-technical-research/customize.toml

@@ -5,7 +5,7 @@
 
 [workflow]
 
-# --- Configurable below. Overrides merge per BMad structural rules: ---
+# --- Configurable below. Overrides merge per Wizz structural rules: ---
 #   scalars: override wins • arrays (persistent_facts, activation_steps_*): append
 #   arrays-of-tables with `code`/`id`: replace matching items, append new ones.
 
@@ -32,6 +32,7 @@ activation_steps_append = []
 
 persistent_facts = [
   "file:{project-root}/**/project-context.md",
+  "When researching a specific library, framework, or SDK, consult Context7 for current docs and version-specific facts as a preferred source alongside 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, note the gap and proceed with web research.",
 ]
 
 # Scalar: executed when the workflow reaches its terminal stage (Step 6: Technical Synthesis),

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

@@ -9,7 +9,7 @@
 name="Mary"
 title="Business Analyst"
 
-# --- Configurable below. Overrides merge per BMad structural rules: ---
+# --- Configurable below. Overrides merge per Wizz structural rules: ---
 #   scalars: override wins • arrays (persistent_facts, principles, activation_steps_*): append
 #   arrays-of-tables with `code`/`id`: replace matching items, append new ones.
 
@@ -40,7 +40,7 @@ persistent_facts = [
   "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.",
 ]
 
-role = "Help the user ideate research and analyze before committing to a project in the BMad Method analysis phase."
+role = "Help the user ideate research and analyze before committing to a project in the Wizz Method analysis phase."
 identity = "Channels Michael Porter's strategic rigor and Barbara Minto's Pyramid Principle discipline."
 communication_style = "Treasure hunter's excitement for patterns, McKinsey memo's structure for findings."
 

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

@@ -9,7 +9,7 @@
 name = "Paige"
 title = "Technical Writer"
 
-# --- Configurable below. Overrides merge per BMad structural rules: ---
+# --- Configurable below. Overrides merge per Wizz structural rules: ---
 
 #   scalars: override wins • arrays (persistent_facts, principles, activation_steps_*): append
 #   arrays-of-tables with `code`/`id`: replace matching items, append new ones.
@@ -40,7 +40,7 @@ persistent_facts = [
   "file:{project-root}/**/project-context.md",
 ]
 
-role = "Capture and curate project knowledge so humans and future LLM agents stay in sync during the BMad Method analysis phase."
+role = "Capture and curate project knowledge so humans and future LLM agents stay in sync during the Wizz Method analysis phase."
 identity = "Writes with Julia Evans's accessibility and Edward Tufte's visual precision."
 communication_style = "Patient educator — explains like teaching a friend. Every analogy earns its place."
 

package/src/bmm-skills/1-analysis/wizz-document-project/customize.toml

@@ -5,7 +5,7 @@
 
 [workflow]
 
-# --- Configurable below. Overrides merge per BMad structural rules: ---
+# --- Configurable below. Overrides merge per Wizz structural rules: ---
 #   scalars: override wins • arrays (persistent_facts, activation_steps_*): append
 #   arrays-of-tables with `code`/`id`: replace matching items, append new ones.
 

package/src/bmm-skills/1-analysis/wizz-document-project/templates/index-template.md

@@ -166,4 +166,4 @@ This documentation was generated specifically to enable AI agents to understand
 
 ---
 
-_Documentation generated by BMAD Method `document-project` workflow_
+_Documentation generated by WIZZ Method `document-project` workflow_

package/src/bmm-skills/1-analysis/wizz-document-project/templates/project-overview-template.md

@@ -100,4 +100,4 @@ For detailed information, see:
 
 ---
 
-_Generated using BMAD Method `document-project` workflow_
+_Generated using WIZZ Method `document-project` workflow_

package/src/bmm-skills/1-analysis/wizz-document-project/templates/source-tree-template.md

@@ -132,4 +132,4 @@ This project is organized into {{parts_count}} distinct parts:
 
 ---
 
-_Generated using BMAD Method `document-project` workflow_
+_Generated using WIZZ Method `document-project` workflow_

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

@@ -5,7 +5,7 @@
 
 [workflow]
 
-# --- Configurable below. Overrides merge per BMad structural rules: ---
+# --- Configurable below. Overrides merge per Wizz structural rules: ---
 #   scalars: override wins • arrays (persistent_facts, activation_steps_*): append
 #   arrays-of-tables with `code`/`id`: replace matching items, append new ones.
 

package/src/bmm-skills/1-analysis/wizz-product-brief/SKILL.md

@@ -87,5 +87,5 @@ The workspace persists; stop and resume freely. The opener's philosophy (not in
 1. Decision log audit + addendum review: the user ends this step with an explicit, shared accounting of how the meaningful contents of `.decision-log.md` were handled — captured in the brief, captured in `addendum.md` (which may already hold detail captured during the conversation — see `## Constraints` for what belongs there), or set aside as process noise.
 2. Polish: apply each entry in `{workflow.doc_standards}` (a `skill:`, `file:`, or plain-text directive) to `brief.md` (and `addendum.md` if it exists). Run passes as parallel subagents - apply all doc standards to `brief.md` first, then `addendum.md` so we present a high-quality draft for the user to review and finalize.
 3. External handoffs: execute each entry in `{workflow.external_handoffs}` to route artifacts beyond local files (Confluence, Notion, ticket systems, etc.) — each directive names the MCP tool and the fields it needs. Invoke the tool, capture any URLs or IDs returned, and surface them in the user message. If a named tool is unavailable, skip that handoff and flag it; local files always exist regardless.
-4. Tell the user it is ready: local paths and external destinations (URLs returned from handoffs). Invoke `wizz-help` to suggest what next steps make sense in the bmad method ecosystem.
+4. Tell the user it is ready: local paths and external destinations (URLs returned from handoffs). Invoke `wizz-help` to suggest what next steps make sense in the wizz method ecosystem.
 5. Run `{workflow.on_complete}` if non-empty. Treat a string scalar as a single instruction and an array as a sequence of instructions executed in order.

package/src/bmm-skills/1-analysis/wizz-product-brief/customize.toml

@@ -8,7 +8,7 @@
 
 [workflow]
 
-# --- Configurable below. Overrides merge per BMad structural rules: ---
+# --- Configurable below. Overrides merge per Wizz structural rules: ---
 #   scalars: override wins • arrays: append
 
 # Steps to run before the standard activation (config load, greet).

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

@@ -9,7 +9,7 @@
 name = "John"
 title = "Product Manager"
 
-# --- Configurable below. Overrides merge per BMad structural rules: ---
+# --- Configurable below. Overrides merge per Wizz structural rules: ---
 #   scalars: override wins • arrays (persistent_facts, principles, activation_steps_*): append
 #   arrays-of-tables with `code`/`id`: replace matching items, append new ones.
 
@@ -40,7 +40,7 @@ persistent_facts = [
   "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.",
 ]
 
-role = "Translate product vision into a validated PRD, epics, and stories that development can execute during the BMad Method planning phase."
+role = "Translate product vision into a validated PRD, epics, and stories that development can execute during the Wizz Method planning phase."
 identity = "Thinks like Marty Cagan and Teresa Torres. Writes with Bezos's six-pager discipline."
 communication_style = "Detective's 'why?' relentless. Direct, data-sharp, cuts through fluff to what matters."
 

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

@@ -9,7 +9,7 @@
 name = "Sally"
 title = "UX Designer"
 
-# --- Configurable below. Overrides merge per BMad structural rules: ---
+# --- Configurable below. Overrides merge per Wizz structural rules: ---
 #   scalars: override wins • arrays (persistent_facts, principles, activation_steps_*): append
 #   arrays-of-tables with `code`/`id`: replace matching items, append new ones.
 
@@ -40,7 +40,7 @@ persistent_facts = [
   "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.",
 ]
 
-role = "Turn user needs and the PRD into UX design specifications that inform architecture and implementation during the BMad Method planning phase."
+role = "Turn user needs and the PRD into UX design specifications that inform architecture and implementation during the Wizz Method planning phase."
 identity = "Grounded in Don Norman's human-centered design and Alan Cooper's persona discipline."
 communication_style = "Paints pictures with words. User stories that make you feel the problem. Empathetic advocate."
 

package/src/bmm-skills/2-plan-workflows/wizz-create-prd/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: wizz-create-prd
-description: 'DEPRECATED — consolidated into wizz-prd create intent - this skill will be removed in v7 in favor of `wizz-prd`.'
+description: 'DEPRECATED — consolidated into wizz-prd create intent - this skill will be removed in v7 in favor of `wizz-prd`. Use when needed for backwards compatibility.'
 ---
 
 # DEPRECATED — forwards to wizz-prd (create intent)

package/src/bmm-skills/2-plan-workflows/wizz-create-prd/customize.toml

@@ -5,7 +5,7 @@
 
 [workflow]
 
-# --- Configurable below. Overrides merge per BMad structural rules: ---
+# --- Configurable below. Overrides merge per Wizz structural rules: ---
 #   scalars: override wins • arrays (persistent_facts, activation_steps_*): append
 #   arrays-of-tables with `code`/`id`: replace matching items, append new ones.
 

package/src/bmm-skills/2-plan-workflows/wizz-edit-prd/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: wizz-edit-prd
-description: 'DEPRECATED — consolidated into wizz-prd update intent - this skill will be removed in v7 in favor of `wizz-prd`.'
+description: 'DEPRECATED — consolidated into wizz-prd update intent - this skill will be removed in v7 in favor of `wizz-prd`. Use when needed for backwards compatibility.'
 ---
 
 # DEPRECATED — forwards to wizz-prd (update intent)

package/src/bmm-skills/2-plan-workflows/wizz-edit-prd/customize.toml

@@ -5,7 +5,7 @@
 
 [workflow]
 
-# --- Configurable below. Overrides merge per BMad structural rules: ---
+# --- Configurable below. Overrides merge per Wizz structural rules: ---
 #   scalars: override wins • arrays (persistent_facts, activation_steps_*): append
 #   arrays-of-tables with `code`/`id`: replace matching items, append new ones.
 

package/src/bmm-skills/2-plan-workflows/wizz-prd/SKILL.md

@@ -2,14 +2,14 @@
 name: wizz-prd
 description: Create, update, or validate a PRD. Use when the user wants help producing, editing, or validating a PRD.
 ---
-# BMad PRD
+# Wizz PRD
 
 You are a master facilitator and coach helping the user create, edit, or validate a high quality PRD scoped to the level and rigor appropriate to their stated needs. Fight the urge to do the thinking for them unless they put you into Fast path.
 
 ## Conventions
 
 - Bare paths resolve from skill root; `{skill-root}` is this skill's install dir; `{project-root}` is the project working dir.
-- `{workflow.<name>}` resolves to fields in `customize.toml`'s `[workflow]` table (overrides win per BMad merge rules).
+- `{workflow.<name>}` resolves to fields in `customize.toml`'s `[workflow]` table (overrides win per Wizz merge rules).
 - `{doc_workspace}` is the bound run folder.
 - **File roles.** `.decision-log.md` is canonical memory and audit trail — every decision, change, and override (including headless overrides) is recorded there as the conversation unfolds. `addendum.md` preserves user-contributed depth that belongs in a downstream document (architecture, solution design, UX spec) or earned a place but does not fit the PRD itself — rejected-alternative rationale, options-considered matrices, mechanism/transport decisions, technical-how, in-depth personas, sizing data. Capture to the addendum *during* the conversation when the user volunteers such content — do not wait for finalize. Audit and override information never goes in the addendum.
 
@@ -18,7 +18,7 @@ You are a master facilitator and coach helping the user create, edit, or validat
 1. Resolve customization: `python3 {project-root}/_wizz/scripts/resolve_customization.py --skill {skill-root} --key workflow`. On failure, read `{skill-root}/customize.toml` directly and use defaults.
 2. Run `{workflow.activation_steps_prepend}`. Treat `{workflow.persistent_facts}` as foundational context (entries prefixed `file:` are loaded). `{workflow.external_sources}` is an org-configured registry of internal tools (knowledge bases, MCP tools); consult them alongside generic web research on the same triggers, org tools preferred when their directive matches. Research itself fires during Discovery — see **Research subagents**.
 3. Load `{project-root}/_wizz/bmm/config.yaml` (+ `config.user.yaml` if present). Resolve `{user_name}`, `{communication_language}`, `{document_output_language}`, `{planning_artifacts}`, `{project_name}`, `{date}`. Missing keys → neutral defaults; never block.
-4. If headless, follow `references/headless.md` for the whole run. Otherwise greet the user **by name** using `{user_name}` and **in their language** using `{communication_language}` — and stay in `{communication_language}` for every turn for the entire run, not just the greeting. In the greeting, let the user know that at any point they can invoke `wizz-party-mode` for multi-agent perspectives or `wizz-advanced-elicitation` for deeper exploration on a specific section. Then scan for misroute on the first message: if the signal points elsewhere (game → BMad GDS; express build → `wizz-quick-dev`; one-pager → `wizz-product-brief`; vet product idea → `wizz-prfaq`; agent skill or custom agent → `bmad-workflow-builder`), suggest they might want the other options before continuing.
+4. If headless, follow `references/headless.md` for the whole run. Otherwise greet the user **by name** using `{user_name}` and **in their language** using `{communication_language}` — and stay in `{communication_language}` for every turn for the entire run, not just the greeting. In the greeting, let the user know that at any point they can invoke `wizz-party-mode` for multi-agent perspectives or `wizz-advanced-elicitation` for deeper exploration on a specific section. Then scan for misroute on the first message: if the signal points elsewhere (game → Wizz GDS; express build → `wizz-quick-dev`; one-pager → `wizz-product-brief`; vet product idea → `wizz-prfaq`; agent skill or custom agent → `wizz-workflow-builder`), suggest they might want the other options before continuing.
 5. Detect intent: **Create** (no PRD), **Update** (existing PRD), **Validate** (critique only). If ambiguous, ask. For Create intent, before binding a fresh workspace, scan `{workflow.prd_output_path}` for prior in-progress runs (folders matching `{workflow.run_folder_pattern}` whose `prd.md` frontmatter `status` is not `final`); if any exist, offer to resume rather than starting over.
 
 Run `{workflow.activation_steps_append}`.

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

@@ -8,7 +8,7 @@
 
 [workflow]
 
-# --- Configurable below. Overrides merge per BMad structural rules: ---
+# --- Configurable below. Overrides merge per Wizz structural rules: ---
 #   scalars: override wins • arrays: append
 
 # Steps to run before the standard activation (config load, greet).
@@ -140,7 +140,7 @@ external_handoffs = []
 #                  subagent applying that prompt to prd.md
 #   plain text     use the text directly as the subagent's review prompt
 #
-# Override TOML may append additional reviewers. Arrays append per BMad rules.
+# Override TOML may append additional reviewers. Arrays append per Wizz rules.
 #
 # Resolved on-demand by the authoring skill (not pulled at activation): only
 # when entering the Validate intent or assembling the gate at Finalize step 3.

package/src/bmm-skills/2-plan-workflows/wizz-ux/SKILL.md

@@ -2,7 +2,7 @@
 name: wizz-ux
 description: Plan UX patterns and design specifications. Use when the user says "lets create UX design" or "create UX specifications" or "help me plan the UX"
 ---
-# BMad UX
+# Wizz UX
 
 ## Overview
 
@@ -33,7 +33,7 @@ UX may lead, follow, or stand alone. Inherit `sources:` by reference; the spines
 1. Resolve customization: `python3 {project-root}/_wizz/scripts/resolve_customization.py --skill {skill-root} --key workflow`. On failure, read `{skill-root}/customize.toml` directly and use defaults.
 2. Run `{workflow.activation_steps_prepend}`. Treat `{workflow.persistent_facts}` as foundational context (entries prefixed `file:` are loaded). `{workflow.external_sources}` is an org-configured registry of internal tools; consult them alongside generic web research on the same triggers, org tools preferred when their directive matches.
 3. Load `{project-root}/_wizz/bmm/config.yaml` (+ `config.user.yaml` if present). Resolve `{user_name}`, `{communication_language}`, `{document_output_language}`, `{planning_artifacts}`, `{project_name}`, `{date}`. Missing keys → neutral defaults; never block.
-4. If headless, follow `references/headless.md` for the whole run. Otherwise greet the user **by name** using `{user_name}` and **in their language** using `{communication_language}` — and stay in `{communication_language}` for every turn. In the greeting, let the user know `wizz-party-mode` and `wizz-advanced-elicitation` are always available. Then scan for misroute on the first message: PRD → `wizz-prd`; architecture → `wizz-architecture`; game UX → BMad GDS; agent/skill → `bmad-workflow-builder`; brief → `wizz-product-brief`.
+4. If headless, follow `references/headless.md` for the whole run. Otherwise greet the user **by name** using `{user_name}` and **in their language** using `{communication_language}` — and stay in `{communication_language}` for every turn. In the greeting, let the user know `wizz-party-mode` and `wizz-advanced-elicitation` are always available. Then scan for misroute on the first message: PRD → `wizz-prd`; architecture → `wizz-architecture`; game UX → Wizz GDS; agent/skill → `wizz-workflow-builder`; brief → `wizz-product-brief`.
 5. Detect intent: **Create**, **Update**, **Validate**. For Create, before binding a fresh workspace, scan `{workflow.ux_output_path}` for prior in-progress runs (folders matching `{workflow.run_folder_pattern}` whose `DESIGN.md` frontmatter `status` is not `final`) and offer to resume rather than starting over.
 
 Run `{workflow.activation_steps_append}`.

package/src/bmm-skills/2-plan-workflows/wizz-validate-prd/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: wizz-validate-prd
-description: 'DEPRECATED — consolidated into wizz-prd validate intent - this skill will be removed in v7 in favor of `wizz-prd`.'
+description: 'DEPRECATED — consolidated into wizz-prd validate intent - this skill will be removed in v7 in favor of `wizz-prd`. Use when needed for backwards compatibility.'
 ---
 
 # DEPRECATED — forwards to wizz-prd (validate intent)

package/src/bmm-skills/2-plan-workflows/wizz-validate-prd/customize.toml

@@ -5,7 +5,7 @@
 
 [workflow]
 
-# --- Configurable below. Overrides merge per BMad structural rules: ---
+# --- Configurable below. Overrides merge per Wizz structural rules: ---
 #   scalars: override wins • arrays (persistent_facts, activation_steps_*): append
 #   arrays-of-tables with `code`/`id`: replace matching items, append new ones.