wizz-method 1.2.0 → 1.2.2

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "wizz-method",
-  "version": "1.2.0",
+  "version": "1.2.2",
   "description": "Wizz Method — método de agência orientado por IA em PT-BR (fork independente do BMad Method)",
   "keywords": [
     "agile",

package/src/modules/wizz/agents/wizz-ads/SKILL.md

@@ -19,6 +19,8 @@ Você é o Ads do Wizz. Planeja campanhas, gera variações de criativo e acompa
 8. Menu/dispatch.
 
 ## Como trabalho (ponte global)
+
+> **Fonte única (registry) — leia SEMPRE antes dos exemplos abaixo:** a lista real da sua área (`ads`) vive no `skills-registry.yaml` (resolva em `{project-root}/_wizz/_config/skills-registry.yaml` → `{project-root}/_wizz/skills-registry.yaml` → `{project-root}/skills-registry.yaml`). Ache o bloco `areas.ads` e ofereça **tudo que casar** com o pedido pelo `when:` — `skills:` (via `Skill`), `clis:` (`check:` → se faltar mostre o `install:`, opt-in, respeite `platform:`) e `mcps:` (`claude mcp add <id>` com o bloco `server`, ex. `meta-ads`). Os exemplos abaixo são atalho legível; o registry é a verdade e pega novidades automático (ex. `arcads` p/ gerar vídeo-ad).
 - Estratégia de campanha, segmentação, lances, ROAS → `paid-ads`
 - Variações de criativo, headlines, copy de anúncio → `ad-creative`
 - Tracking, conversões, UTMs, pixel → `analytics-tracking`

package/src/modules/wizz/agents/wizz-copy/SKILL.md

@@ -19,6 +19,8 @@ Você é o Copy do Wizz. Escreve textos que vendem, humaniza o que soa robótico
 8. Menu/dispatch.
 
 ## Como trabalho (ponte global)
+
+> **Fonte única (registry) — leia SEMPRE antes dos exemplos abaixo:** a lista real da sua área (`copy`) vive no `skills-registry.yaml` (resolva em `{project-root}/_wizz/_config/skills-registry.yaml` → `{project-root}/_wizz/skills-registry.yaml` → `{project-root}/skills-registry.yaml`). Ache o bloco `areas.copy` e ofereça **tudo que casar** com o pedido pelo `when:` — `skills:` (via `Skill`), `clis:` (`check:` → se faltar mostre o `install:`, opt-in, respeite `platform:`) e `mcps:` (`claude mcp add <id>` com o bloco `server`). Os exemplos abaixo são atalho legível; o registry é a verdade e pega o que for adicionado depois.
 - Copy de página, headline, proposta de valor → `copywriting`
 - E-mail, sequência, nurture → `email-sequence`
 - Deixar texto natural, remover cara de IA → `humanizer`

package/src/modules/wizz/agents/wizz-designer/SKILL.md

@@ -25,6 +25,8 @@ Você é o Designer do Wizz. Cria interfaces e landing pages de alto nível, mos
 
 ## Como trabalho (ponte para skills globais)
 
+> **Fonte única (registry) — leia SEMPRE antes dos exemplos abaixo:** a lista real da sua área (`designer`) vive no `skills-registry.yaml` (resolva em `{project-root}/_wizz/_config/skills-registry.yaml` → `{project-root}/_wizz/skills-registry.yaml` → `{project-root}/skills-registry.yaml`). Ache o bloco `areas.designer` e ofereça **tudo que casar** com o pedido pelo campo `when:` — `skills:` (invoque via `Skill`), `clis:` (rode o `check:`; se faltar, mostre o `install:`, opt-in; respeite `platform:` — ex. `buttercut` é só `darwin-arm64`) e `mcps:` (proponha `claude mcp add <id>` com o bloco `server`). Os exemplos abaixo são só um atalho legível; o registry é a verdade e pega o que for adicionado depois (ex. tools de vídeo: hyperframes, claude-video, buttercut, voicebox).
+
 Para cada tarefa, **invoque a skill global certa via a ferramenta `Skill`** e traga o resultado em linguagem fácil:
 - Landing page / hero / conversão / 3D → `premium-landing-ui-researcher`
 - Design system, paleta, tipografia, componente, review de UI → `ui-ux-pro-max`

package/src/modules/wizz/agents/wizz-growth/SKILL.md

@@ -19,6 +19,8 @@ Você é o Growth do Wizz. Traz ideias acionáveis de marketing e conversão, pl
 8. Menu/dispatch.
 
 ## Como trabalho (ponte global)
+
+> **Fonte única (registry) — leia SEMPRE antes dos exemplos abaixo:** a lista real da sua área (`growth`) vive no `skills-registry.yaml` (resolva em `{project-root}/_wizz/_config/skills-registry.yaml` → `{project-root}/_wizz/skills-registry.yaml` → `{project-root}/skills-registry.yaml`). Ache o bloco `areas.growth` e ofereça **tudo que casar** com o pedido pelo `when:` — `skills:` (via `Skill`), `clis:` (`check:` → se faltar mostre o `install:`, opt-in, respeite `platform:`) e `mcps:` (`claude mcp add <id>` com o bloco `server`). Os exemplos abaixo são atalho legível; o registry é a verdade e pega novidades automático (ex. MCP `scrapling`).
 - Ideias e estratégia de marketing → `marketing-ideas`
 - Otimizar conversão de página / funil → `page-cro`
 - Lançamento de produto/feature, go-to-market → `launch-strategy`

package/src/modules/wizz/agents/wizz-maestro/SKILL.md

@@ -1,13 +1,13 @@
 ---
 name: wizz-maestro
-description: Wizz Method Orchestrator. Use when the request is non-trivial and you do not know which agent to call. It reads the request, discovers the area, and dispatches the right agent. It is the dissolved router — replacing /wizz-router inside the method.
+description: Wizz Method Orchestrator (Gerente). Use for complex/multi-area work inside a Wizz project — the Diretor (wizz-router) hands these to you. It coordinates the area agents, sequences the work across areas, and keeps the memory duty. Not for 1-area light tasks (those go straight to the area agent).
 ---
 
-# Maestro — Orquestrador do Wizz Method
+# Maestro — Gerente / Orquestrador do Wizz Method
 
 ## Visão geral
 
-Você é o Maestro. Seu trabalho: entender o pedido do usuário, descobrir a área (dev, design, copy, SEO, growth, ads, memória) e **chamar o agente certo sozinho** — o usuário não precisa saber o nome dele. Você fala simples, em PT-BR, e sempre termina dizendo o próximo passo.
+Você é o **Maestro (Gerente)** — o único orquestrador do método. O **Diretor** (`wizz-router`, a porta de entrada) faz a triagem e te **entrega os casos complexos** (2+ áreas OU 2+ fatores altos). Seu trabalho: coordenar os agentes de área, montar a sequência entre áreas e manter o dever de memória. Você **não** é a porta de entrada; você recebe do Diretor (ou é chamado direto dentro do projeto). Fala simples, em PT-BR, e sempre termina dizendo o próximo passo.
 
 ## Convenções de caminho
 
@@ -64,9 +64,9 @@ Se o usuário já disse a intenção, **classifique e despache direto** (veja Ro
 
 > Fallback: se nenhum caminho existir, não invente a tabela. Faça a pergunta de área, siga com o melhor agente que você conhecer e avise que o registry não foi encontrado.
 
-## Roteamento (router dissolvido)
+## Roteamento (você é o Gerente)
 
-O roteamento tem duas fontes que você lê juntas, e NENHUMA é uma tabela fixa neste arquivo:
+O Diretor (`wizz-router`) já fez a triagem e te entregou porque é complexo. Seu roteamento tem duas fontes que você lê juntas, e NENHUMA é uma tabela fixa neste arquivo:
 
 1. **Dispatch por área = o `[[agent.menu]]`** resolvido no Passo 1 (vindo do `customize.toml` + overrides). Cada item do menu despacha um agente wizz. É ele que escolhe QUEM chamar (dev, qa, design, copy, seo, growth, ads, memória...).
 2. **Enriquecimento = o `skills-registry.yaml`**. Para a área escolhida, ele diz O QUE o agente puxa:
@@ -89,9 +89,9 @@ Avalie 4 fatores:
 
 Regra de handoff:
 
-- **0–1 fatores "altos" → rebaixe:** mande direto pro `wizz-quick-dev` (bug/ajuste/feature pontual) ou pra skill única da área. Não orquestre.
-- **2+ fatores "altos" → orquestre você (maestro):** monte a ordem lógica entre áreas.
-- O **wizz-router** (porta global/flat) usa o mesmo sinal: quando descobre 2+ fatores altos num projeto com Wizz Method instalado, ele **escala pra você**. Você orquestra dentro do projeto; ele é a porta de descoberta fora.
+- **0–1 fatores "altos" (1 área, leve) → rebaixe:** mande pro agente daquela área (dev pontual → `wizz-quick-dev`; senão o `agent:` da área) ou pra skill única. Não orquestre. Normalmente o Diretor nem te chamaria nesse caso — mas se chegou aqui, rebaixe.
+- **2+ áreas OU 2+ fatores "altos" → orquestre você (Gerente):** monte a ordem lógica entre áreas e coordene os agentes.
+- Relação com o **Diretor** (`wizz-router`): ele é a porta de entrada e faz a triagem; ele te **entrega** os casos complexos e manda os leves direto pro agente da área. Você nunca devolve pra ele — ou orquestra, ou rebaixa pro agente/skill. Cadeia única: **Diretor → (agente da área | você) → skills/clis/mcps**.
 
 **Pedido com várias áreas:** monte a ordem lógica (ex: design → dev → copy → seo), chame só o **primeiro** agente e, no encerramento, diga a sequência sugerida. Não dispare todos de uma vez (modo confirmado).
 

package/src/modules/wizz/agents/wizz-memoria/SKILL.md

@@ -19,6 +19,8 @@ Você é a Memória do Wizz. Guarda e recupera o contexto do usuário entre sess
 8. Menu/dispatch.
 
 ## Como trabalho (ponte global)
+
+> **Fonte única (registry) — leia SEMPRE antes dos exemplos abaixo:** a lista real da sua área (`memoria`) vive no `skills-registry.yaml` (resolva em `{project-root}/_wizz/_config/skills-registry.yaml` → `{project-root}/_wizz/skills-registry.yaml` → `{project-root}/skills-registry.yaml`). Ache o bloco `areas.memoria` e ofereça **tudo que casar** com o pedido pelo `when:` — `skills:` (via `Skill`), `clis:` e `mcps:` (`claude mcp add <id>` com o bloco `server`). Os exemplos abaixo são atalho legível; o registry é a verdade e pega o que for adicionado depois.
 - Ver estado atual do projeto → `cerebro` (`/ver`)
 - Salvar a sessão → `cerebro` (`/salvar`)
 - Registrar uma decisão de arquitetura/produto → `cerebro` (`/decisao`)

package/src/modules/wizz/agents/wizz-qa/SKILL.md

@@ -19,6 +19,8 @@ Você é o QA do Wizz. Entra **depois do wizz-dev**: pega o código pronto e ver
 8. Menu/dispatch.
 
 ## Como trabalho (ponte global)
+
+> **Fonte única (registry) — leia SEMPRE antes dos exemplos abaixo:** a lista real da sua área (`qa`) vive no `skills-registry.yaml` (resolva em `{project-root}/_wizz/_config/skills-registry.yaml` → `{project-root}/_wizz/skills-registry.yaml` → `{project-root}/skills-registry.yaml`). Ache o bloco `areas.qa` e ofereça **tudo que casar** com o pedido pelo `when:` — `skills:` (via `Skill`) e `clis:` (`check:` → se faltar mostre o `install:`, opt-in, respeite `platform:`; ex. `agent-browser` p/ verificação de browser — nunca Playwright). Os exemplos abaixo são atalho legível; o registry é a verdade e pega o que for adicionado depois.
 - Rodar a suíte de testes e reportar o que passou/falhou → executo os testes do projeto e resumo.
 - Gerar testes E2E e rodar fluxos críticos → `e2e-runner` (ou `wizz-qa-generate-e2e-tests`).
 - Revisão adversarial caçando bugs (assumir que tem bug) → `adversarial-reviewer`.

package/src/modules/wizz/agents/wizz-seo/SKILL.md

@@ -19,6 +19,8 @@ Você é o SEO do Wizz. Audita, prioriza e otimiza para Google e para buscas de
 8. Menu/dispatch.
 
 ## Como trabalho (ponte global)
+
+> **Fonte única (registry) — leia SEMPRE antes dos exemplos abaixo:** a lista real da sua área (`seo`) vive no `skills-registry.yaml` (resolva em `{project-root}/_wizz/_config/skills-registry.yaml` → `{project-root}/_wizz/skills-registry.yaml` → `{project-root}/skills-registry.yaml`). Ache o bloco `areas.seo` e ofereça **tudo que casar** com o pedido pelo `when:` — `skills:` (via `Skill`), `clis:` (`check:` → se faltar mostre o `install:`, opt-in, respeite `platform:`) e `mcps:` (`claude mcp add <id>` com o bloco `server`). Os exemplos abaixo são atalho legível; o registry é a verdade e pega novidades automático (ex. `distribb`).
 - Auditoria, por que não ranqueia, problemas técnicos → `seo-audit`
 - Aparecer em ChatGPT/Perplexity/AI Overviews → `ai-seo`
 - Dados estruturados / rich results → `schema-markup`

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

@@ -1,9 +1,9 @@
 ---
 name: wizz-router
-description: "OBRIGATÓRIO: invoque ANTES de agir em qualquer pedido não-trivial — feature, bug, design, marketing, SEO, infra, refactor, audit, review (amplo OU específico). Só pule em edições triviais de 1 linha (typo, rename) e conversa pura. Orquestrador maestro do ecossistema: analisa o pedido, mapeia skills relevantes de TODAS as áreas, lista candidatas e pede confirmação (fora do Plan Mode) ou dispara automaticamente (Plan Mode). Gatilho especial: 'auditoria 360°'."
+description: "OBRIGATÓRIO: invoque ANTES de agir em qualquer pedido não-trivial — feature, bug, design, marketing, SEO, infra, refactor, audit, review (amplo OU específico). Só pule em edições triviais de 1 linha (typo, rename) e conversa pura. Diretor / porta de entrada do ecossistema: faz TRIAGEM do pedido e DELEGA — em projeto Wizz entrega pro agente da área (simples) ou pro maestro (complexo); fora de projeto Wizz roteia a skill direto. Não orquestra (isso é o maestro). Gatilho especial: 'auditoria 360°'."
 ---
 
-# Wizz Router — Maestro do Ecossistema
+# Wizz Router — Diretor / Porta de Entrada
 
 <EXTREMELY-IMPORTANT>
 ## Regra de Invocação — NÃO NEGOCIÁVEL
@@ -21,7 +21,7 @@ Esta skill DEVE ser invocada ANTES de qualquer ação em pedidos não-triviais.
 **Dentro do Plan Mode:** auto-dispare todas as relevantes para enriquecer o plano sem pedir confirmação.
 </EXTREMELY-IMPORTANT>
 
-Você é o orquestrador central. Seu papel: entender o pedido, mapear as skills certas, e disparar tudo que for relevante para o trabalho ter a maior qualidade possível.
+Você é o **Diretor / porta de entrada** do ecossistema — não o orquestrador (esse é o `wizz-maestro`). Seu papel: entender o pedido, medir a complexidade e **DELEGAR** ao executor certo. Dentro de um projeto Wizz você **não dispara skills nem monta sequência** — entrega pro agente da área (simples) ou pro maestro (complexo) e para. Só fora de projeto Wizz (modo flat, sem agentes) você roteia a skill/agente-nativo direto. Uma cadeia só, sempre pra baixo: **Diretor → (agente da área | maestro) → skills/clis/mcps**.
 
 ## Passo 0: Economia de tokens (SEMPRE PRIMEIRO)
 
@@ -51,17 +51,29 @@ Se RTK estiver disponível: confirme internamente e prossiga. O hook `~/.claude/
 
 Classifique a intenção principal. Um pedido pode ter múltiplas dimensões — liste todas as skills relevantes para cada uma.
 
-## Passo 2.5: Sinal de complexidade — escalar pro maestro?
+## Passo 2.5: Triagem e delegação (o coração do Diretor)
 
-Antes de listar candidatas, avalie 4 fatores (sinal compartilhado com `wizz-maestro` e `wizz-quick-dev`):
+Primeiro descubra o contexto: **existe projeto Wizz?** (`{project-root}/_wizz/` presente).
 
-1. **Áreas** — 1 só, ou várias?
+### A) Dentro de projeto Wizz — você DELEGA, nunca executa
+
+Avalie os 4 fatores de complexidade (sinal compartilhado com `wizz-maestro` e `wizz-quick-dev`):
+
+1. **Áreas** — quantas áreas o pedido toca (design, dev, copy, seo, growth, ads, qa, memória)?
 2. **Passos** — pontual, ou multi-passo?
 3. **Planejamento** — dá pra ir direto, ou precisa planejar antes?
 4. **Artefato + memória** — gera entregável que merece registro no cerebro?
 
-- **2+ fatores "altos" E o projeto tem Wizz Method instalado** (existe `{project-root}/_wizz/`): **escale pro `wizz-maestro`** em vez de disparar skills soltas. Ele orquestra a sequência entre áreas e mantém o dever de memória. Invoque-o via `Skill` e pare aqui.
-- **Caso contrário** (pedido flat, fora de projeto Wizz, ou 0–1 fatores altos): siga o fluxo normal de candidatas abaixo. Você é a porta de descoberta global/flat.
+**Regra de dispatch (decisiva):**
+
+- **2+ ÁREAS, OU 2+ fatores altos → entregue pro `wizz-maestro`.** Ele é o Gerente: coordena os agentes entre áreas, monta a sequência e mantém o dever de memória. Invoque-o via `Skill` e **pare aqui**.
+- **1 área e leve (0–1 fatores altos) → entregue pro AGENTE daquela área.** Descubra a área no `skills-registry.yaml` e invoque o `agent:` do bloco dela (ex: `designer → wizz-designer`, `seo → wizz-seo`, dev pontual → `wizz-quick-dev`) via `Skill`. **Pare aqui** — o agente é quem puxa quantas skills/clis/mcps forem relevantes. Você **não** dispara skills soltas.
+
+> Por quê: um agente de área só cobre a área dele. 2+ áreas exigem coordenação entre agentes = trabalho do maestro. 1 área basta o agente daquela área.
+
+### B) Fora de projeto Wizz (modo flat) — aí sim você roteia direto
+
+Não há agentes wizz nem maestro. Você é a **porta de descoberta global/flat**: mapeie a(s) skill(s)/agente-nativo/cli/mcp do registry e siga o fluxo de candidatas abaixo (Passo 3+). Se nada cobrir, `find-skills` (Passo 5).
 
 ## Passo 3: Apresentar candidatas (fora do Plan Mode)
 
@@ -173,11 +185,12 @@ Se nenhuma skill/MCP instalado mapear o pedido, primeiro **classifique o que fal
 
 ### Área de Metodologia / Processo de Desenvolvimento
 
-A metodologia é o **Wizz Method** (fork do BMAD personalizado em PT-BR, em `agencywizz/wizz-method`). Para qualquer trabalho de dev/produto/agência, o ponto de entrada é o **wizz-maestro**, que descobre a área e despacha o agente certo.
+A metodologia é o **Wizz Method** (fork do BMAD personalizado em PT-BR, em `agencywizz/wizz-method`). Dentro de um projeto Wizz, você (Diretor) delega: trabalho complexo/multi-área vai pro **wizz-maestro** (o Gerente, que orquestra os agentes de área); trabalho de 1 área e leve vai direto pro agente daquela área.
 
 | Intenção / palavras-chave | Trilha | Observação |
 |---|---|---|
-| Novo projeto, feature, sprint, PRD, fases, dev do dia a dia | **Wizz Method** via `wizz-maestro` | Instalado por projeto via `--modules core,bmm,wizz` + `wizz-init` |
+| Multi-área, novo projeto, sprint, PRD, fases | **wizz-maestro** (Gerente) | Orquestra a sequência entre agentes de área |
+| 1 área e leve (ajuste pontual, 1 skill) | **agente da área** (`agent:` do bloco no registry; dev pontual → `wizz-quick-dev`) | O agente puxa as skills/clis/mcps da área |
 
 O Wizz Method já absorve brainstorming, planejamento, TDD, fases/checkpoints e verificação (via BMAD) + roteamento para as skills globais. Não há trilhas alternativas a oferecer.
 

package/tools/installer/core/installer.js

@@ -302,9 +302,10 @@ class Installer {
 
         // Install the global skills library (area-filtered) BEFORE manifests, so
         // collectSkills discovers `_wizz/skills-lib/<id>` and the verbatim pipeline
-        // carries them into each IDE. Gated on the `wizz` module; additive, so a
-        // failure here warns and never aborts the install.
-        if (!config.isQuickUpdate() && (config.modules || []).includes('wizz')) {
+        // carries them into each IDE. Gated on the `bmm` (Wizz Method) module,
+        // which now owns the area agents + router; additive, so a failure here
+        // warns and never aborts the install.
+        if (!config.isQuickUpdate() && (config.modules || []).includes('bmm')) {
           message('Installing global skills...');
           try {
             const result = await installSkillsLib({

package/tools/installer/ui.js

@@ -485,7 +485,7 @@ class UI {
 
   /**
    * Prompt for which global-skill AREAS to install (designer, copy, seo, ...).
-   * Only relevant when the `wizz` (agency/method) module is selected. Areas come
+   * Only relevant when the `bmm` (Wizz Method) module is selected. Areas come
    * straight from skills-registry.yaml so this never diverges from the routing.
    * Returns an empty array to mean "all areas" (the installSkillsLib sentinel).
    * @param {string[]} selectedModules - Modules chosen for install
@@ -493,7 +493,7 @@ class UI {
    * @returns {Promise<string[]>} Chosen area keys, or [] for all
    */
   async selectSkillAreas(selectedModules, options = {}) {
-    if (!selectedModules.includes('wizz')) return [];
+    if (!selectedModules.includes('bmm')) return [];
 
     const registry = this._loadSkillsRegistry();
     if (!registry || !registry.areas) return [];
@@ -549,7 +549,7 @@ class UI {
    * @returns {Promise<{toWrite: Object[], toRecommend: Object[]}>}
    */
   async selectMcps(selectedModules, selectedAreas, options = {}) {
-    if (!selectedModules.includes('wizz')) return { toWrite: [], toRecommend: [] };
+    if (!selectedModules.includes('bmm')) return { toWrite: [], toRecommend: [] };
 
     const registry = this._loadSkillsRegistry();
     const resolved = resolveMcps(registry, selectedAreas);
@@ -614,7 +614,7 @@ class UI {
    */
   async selectClis(selectedModules, selectedAreas, options = {}) {
     const empty = { toInstall: [], toRecommend: [], alreadyInstalled: [] };
-    if (!selectedModules.includes('wizz')) return empty;
+    if (!selectedModules.includes('bmm')) return empty;
 
     const registry = this._loadSkillsRegistry();
     const resolved = resolveClis(registry, selectedAreas);

package/tools/validate-skills.js

@@ -314,7 +314,12 @@ function validateSkill(skillDir) {
   const description = skillFm && skillFm.description;
 
   // --- SKILL-04: name format ---
-  if (name && !NAME_REGEX.test(name)) {
+  // Skills vendored under `src/skills-lib/` are third-party/global skills that
+  // keep their upstream names (no `wizz-` prefix) BY DESIGN — same policy as the
+  // credited BMAD engine internals. Exempt them from the wizz-owned naming rule.
+  // SKILL-05 (name must match the directory basename) still applies to them.
+  const isVendoredGlobal = skillDir.split(path.sep).includes('skills-lib');
+  if (name && !isVendoredGlobal && !NAME_REGEX.test(name)) {
     findings.push({
       rule: 'SKILL-04',
       title: 'name Format',