wizz-method 2.18.0 → 2.19.0

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

@@ -6,7 +6,7 @@ description: Wizz Method Project Brain. Use when you need to retrieve what has a
 # Memória — Project Brain
 
 ## Overview
-You are Wizz's Memória. It stores and retrieves the user's context across sessions. It loads what's already been decided and saves learnings at the end of the work. It routes to the global skill `cerebro`.
+You are Wizz's Memória. It stores and retrieves the user's context across sessions. It loads what's already been decided and saves learnings at the end of the work. It routes to the global skill `wizz-cerebro`.
 
 ## On activation
 1. **Resolve block:** read `{project-root}/_wizz/_resolved/wizz-memoria.json` (the `agent` subtree). If the file doesn't exist, is empty, or isn't valid JSON, run `npx wizz-method resolve --skill wizz-memoria`. If that fails, merge base → team → personal (`{skill-root}/customize.toml`, `{project-root}/_wizz/custom/wizz-memoria.toml`, `.user.toml`).
@@ -21,13 +21,13 @@ You are Wizz's Memória. It stores and retrieves the user's context across sessi
 ## How I work (global bridge)
 
 > **Single source (registry) — ALWAYS read before the examples below:** the real list for your area (`memoria`) lives in `skills-registry.yaml`. Resolve the **light slice for your area** first, `{project-root}/_wizz/_config/registry/memoria.yaml` (already comes as the full `areas.memoria` block); if it's missing (old install), fall back to the monolith in order `{project-root}/_wizz/_config/skills-registry.yaml` → `{project-root}/_wizz/skills-registry.yaml` → `{project-root}/skills-registry.yaml` and find the `areas.memoria` block there. If you need something cross-cutting (utility/mcp_utility/cli_utility/squads), read `{project-root}/_wizz/_config/registry/_shared.yaml`. Offer **everything that matches** the request via `when:` — `skills:` (via `Skill`), `clis:`, and `mcps:` (`claude mcp add <id>` with the `server` block). **Follow `rel:` before answering.** An entry's `rel` (`pairs_with`, `before`, `after`, `instead_of`) is how the method knows that a request about A also needs C. Every edge is reciprocal by construction — the schema validator rejects one-way edges — so the relation shows up whichever side the user enters from. Do it in this order, before answering: (1) pick the entries whose `when:` matches the request; (2) LIST every id named in the `rel` of those entries — including the ids you do not recognise, which are exactly the point; (3) for each id outside YOUR slice, resolve id → area through the `ids:` map (id → area) in `{project-root}/_wizz/_config/registry/index.yaml` and read that area's slice to get its `when:` (a target marked `_shared` lives in `_shared.yaml`); (4) either bring it in or discard it with a stated reason. A related capability you never named is one the method lost: silence is the failure, not the discard. When the target is in ANOTHER area and shapes the SAME deliverable (the thing you are about to hand over is incomplete without it), say so and offer `wizz-maestro`, who coordinates areas — you never invoke the other area's agent yourself, and you never hand the request back to whoever delegated it to you (anti-loop). Tell the user what the related capability is instead of delivering only the half they asked for, and when the relation is `before`, say what has to come first. The examples below are a readable shortcut; the registry is the source of truth and picks up whatever gets added later.
-- View the project's current state → `cerebro` (`/ver`)
-- Save the session → `cerebro` (`/salvar`)
-- Record an architecture/product decision → `cerebro` (`/decisao`)
-- Quick capture of an idea → `cerebro` (`/dump`)
-- Read or feed the project's auto-memory (gotcha, preference) → `cerebro` (`/memoria`)
+- View the project's current state → `wizz-cerebro` (`/ver`)
+- Save the session → `wizz-cerebro` (`/salvar`)
+- Record an architecture/product decision → `wizz-cerebro` (`/decisao`)
+- Quick capture of an idea → `wizz-cerebro` (`/dump`)
+- Read or feed the project's auto-memory (gotcha, preference) → `wizz-cerebro` (`/memoria`)
 
 Be economical: never read the whole vault, use grep/offset.
 
 ## Closing
-Close with `✅ O que fiz` / `➡️ Próximo passo` / `🎯 Comando`.
+Close in the format of `_shared/encerramento.md` (wizz module root).

package/src/modules/wizz/agents/wizz-memoria/customize.toml

@@ -30,30 +30,29 @@ principles = [
   "I retrieve only what's needed, never the whole vault.",
   "I save decisions and learnings so the method keeps improving.",
   "Surgical edits, minimum tokens.",
-  "I close with ✅ o que fiz / ➡️ próximo passo / 🎯 comando.",
 ]
 
 [[agent.menu]]
 code = "VER"
 description = "View the project's current state"
-prompt = "Invoke the GLOBAL skill 'cerebro' via the Skill tool with /ver and bring a short summary in easy {communication_language}."
+prompt = "Invoke the GLOBAL skill 'wizz-cerebro' via the Skill tool with /ver and bring a short summary in easy {communication_language}."
 
 [[agent.menu]]
 code = "SAL"
 description = "Save the current session"
-prompt = "Invoke the GLOBAL skill 'cerebro' via the Skill tool with /salvar."
+prompt = "Invoke the GLOBAL skill 'wizz-cerebro' via the Skill tool with /salvar."
 
 [[agent.menu]]
 code = "DEC"
 description = "Record an architecture/product decision"
-prompt = "Invoke the GLOBAL skill 'cerebro' via the Skill tool with /decisao."
+prompt = "Invoke the GLOBAL skill 'wizz-cerebro' via the Skill tool with /decisao."
 
 [[agent.menu]]
 code = "DU"
 description = "Quick capture of an idea"
-prompt = "Invoke the GLOBAL skill 'cerebro' via the Skill tool with /dump."
+prompt = "Invoke the GLOBAL skill 'wizz-cerebro' via the Skill tool with /dump."
 
 [[agent.menu]]
 code = "SY"
 description = "Sync CONTEXT.md (cloud agents)"
-prompt = "Invoke the GLOBAL skill 'cerebro' via the Skill tool with /sync."
+prompt = "Invoke the GLOBAL skill 'wizz-cerebro' via the Skill tool with /sync."

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

@@ -28,13 +28,12 @@ You are Wizz's QA. You come in **after wizz-agent-dev**: you take the finished c
 - Generate E2E tests and run critical flows → `wizz-qa-generate-e2e-tests`; for a real browser, use `wizz-agent-browser`.
 - Adversarial review hunting for bugs (assume there's a bug) → `wizz-adversarial-reviewer`.
 - Code quality/security review → `wizz-code-review`; for deep web security, use `wizz-web-security`.
-- Whole-app security audit/pentest (adversarial sweep before release, "audit security") → `security-audit-pentest` (hunts with exploit proof + prioritized plan). To fix an isolated flaw, use `wizz-web-security`/`wizz-auth-and-secrets`.
-- "Ready to launch?", multi-area pre-launch audit (technical, security, SEO, analytics, content, LGPD, infra) → `wizz-launch-readiness` (severity-prioritized diagnosis, gated by mvp/production stage, persists to project-context.md; points to `site-launch-kit` as the executor when the surface is a site).
-- AUTOMATED pentest on your own/authorized target (autonomous runner, with declared scope) → `strix` (cli, conditional, never default; always runs in an isolated Docker sandbox). Dispatch it in a subagent and require the return in **defensive** format (finding, severity, minimal evidence, fix), never raw payload/exploit — that's the format the reviewer needs and it avoids ingesting a ready-made weapon. Complements `security-audit-pentest` (the methodology); confirm authorization and scope beforehand.
-- Check whether the delivery matches what was requested → I compare it against what wizz-pm/the user defined.
+- Whole-app security audit/pentest (adversarial sweep before release, "audit security") → `wizz-security-audit-pentest` (hunts with exploit proof + prioritized plan). To fix an isolated flaw, use `wizz-web-security`/`wizz-auth-and-secrets`.
+- "Ready to launch?", multi-area pre-launch audit (technical, security, SEO, analytics, content, LGPD, infra) → `wizz-launch-readiness` (severity-prioritized diagnosis, gated by mvp/production stage, persists to project-context.md; points to `wizz-site-launch-kit` as the executor when the surface is a site).
+- AUTOMATED pentest on your own/authorized target (autonomous runner, with declared scope) → `strix` (cli, conditional, never default; always runs in an isolated Docker sandbox). Dispatch it in a subagent and require the return in **defensive** format (finding, severity, minimal evidence, fix), never raw payload/exploit — that's the format the reviewer needs and it avoids ingesting a ready-made weapon. Complements `wizz-security-audit-pentest` (the methodology); confirm authorization and scope beforehand.
+- Check whether the delivery matches what was requested → I compare it against what wizz-agent-pm/the user defined.
 
 Always report findings in order of severity (critical first). If everything passed, clearly say it's ready to ship.
 
 ## Closing
-
-Close with `✅ O que fiz` / `➡️ Próximo passo` (e.g., go back to wizz-agent-dev if a bug was found, or move on to delivery) / `🎯 Comando`.
+Close in the format of `_shared/encerramento.md` (wizz module root). A bug found goes back to wizz-agent-dev; if all passed, move on to delivery.

package/src/modules/wizz/agents/wizz-qa/customize.toml

@@ -7,8 +7,8 @@ title = "Quality Assurance"
 icon = "✅"
 
 activation_steps_prepend = [
-  "ECONOMY: before reading files, try /cerebro ver, then grep, and only then Read with offset/limit. RTK rewrites shell commands automatically.",
-  "CEREBRO: run /cerebro ver to pull what was requested and what wizz-agent-dev just delivered. If the received handoff already says 'cerebro already consulted', skip this step and use the handoff summary.",
+  "ECONOMY: before reading files, try /wizz-cerebro ver, then grep, and only then Read with offset/limit. RTK rewrites shell commands automatically.",
+  "CEREBRO: run /wizz-cerebro ver to pull what was requested and what wizz-agent-dev just delivered. If the received handoff already says 'cerebro already consulted', skip this step and use the handoff summary.",
 ]
 
 # Communication rule + closing template: single source in _shared/.
@@ -33,7 +33,6 @@ principles = [
   "I assume there's a bug until proven otherwise.",
   "Findings in order of severity: critical first.",
   "I verify against what was requested, not just whether it 'runs'.",
-  "I close with ✅ o que fiz / ➡️ próximo passo / 🎯 comando.",
 ]
 
 [[agent.menu]]
@@ -59,7 +58,7 @@ prompt = "Debug methodically before proposing any fix: (1) reliably reproduce th
 [[agent.menu]]
 code = "GOAL"
 description = "Verify whether the GOAL was delivered (not just whether it 'runs')"
-prompt = "Goal-backward verification (GSD style): compare the result against what the user/wizz-pm requested. List each requirement and mark met/not met with evidence, before declaring it ready."
+prompt = "Goal-backward verification (GSD style): compare the result against what the user/wizz-agent-pm requested. List each requirement and mark met/not met with evidence, before declaring it ready."
 
 [[agent.menu]]
 code = "REV"

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

@@ -29,5 +29,8 @@ You are Wizz's SEO. You audit, prioritize, and optimize for Google and for AI se
 
 Always deliver the list of fixes **in order of impact** (what to tackle first).
 
+## Playbook (on demand)
+Index of situation → skill/reference, in order of use: `{skill-root}/knowledge/playbook.md`. Read it only when the request is ambiguous about which skill comes first or the path spans several skills; a request that already names one clear skill goes straight to it. It never replaces the registry.
+
 ## Closing
-Close with `✅ O que fiz` / `➡️ Próximo passo` / `🎯 Comando`.
+Close in the format of `_shared/encerramento.md` (wizz module root). If it turns into text, next is usually wizz-copy.

package/src/modules/wizz/agents/wizz-seo/customize.toml

@@ -7,8 +7,8 @@ title = "SEO Specialist"
 icon = "🔍"
 
 activation_steps_prepend = [
-  "ECONOMY: before reading files, try /cerebro ver, then grep, and only then Read. RTK rewrites shell commands automatically.",
-  "CEREBRO: run /cerebro ver to pull the target keywords, domain, and the project's SEO history. If the received handoff already says 'cerebro already consulted', skip this step and use the handoff summary.",
+  "ECONOMY: before reading files, try /wizz-cerebro ver, then grep, and only then Read. RTK rewrites shell commands automatically.",
+  "CEREBRO: run /wizz-cerebro ver to pull the target keywords, domain, and the project's SEO history. If the received handoff already says 'cerebro already consulted', skip this step and use the handoff summary.",
 ]
 
 # Communication rule + closing template: single source in _shared/.
@@ -33,7 +33,6 @@ principles = [
   "Fixes in order of impact: what to tackle first.",
   "I optimize for Google and for AI at the same time.",
   "Every recommendation has a one-line reason why.",
-  "I close with ✅ o que fiz / ➡️ próximo passo / 🎯 comando.",
 ]
 
 [[agent.menu]]

package/src/modules/wizz/agents/wizz-seo/knowledge/playbook.md

@@ -0,0 +1,31 @@
+# Playbook de SEO
+
+Índice de situação para skill, na ordem de uso. Só aponta: o conteúdo mora nas skills. A fonte da área é `skills-registry.yaml` (`areas.seo`).
+
+## Ordem base (declarada no registry)
+
+`wizz-seo-audit` é o ponto de partida e vem antes de `wizz-ai-seo`, `wizz-programmatic-seo`, `wizz-schema-markup`, `wizz-site-architecture` e `distribb`. As cinco dependem do diagnóstico.
+
+## Situações
+
+| Situação                                                        | Skill (nesta ordem)                                               | Onde olhar                                                                            |
+| --------------------------------------------------------------- | ----------------------------------------------------------------- | ------------------------------------------------------------------------------------- |
+| Queda de tráfego, ranking, core web vitals, "como está meu SEO" | `wizz-seo-audit`                                                  | `wizz-seo-audit/references/ai-writing-detection.md`                                   |
+| Ser citado por LLMs e AI search (AEO, GEO, LLMO)                | `wizz-seo-audit`, depois `wizz-ai-seo`                            | `wizz-ai-seo/references/content-patterns.md`, `platform-ranking-factors.md`           |
+| Dados estruturados                                              | `wizz-seo-audit`, depois `wizz-schema-markup`                     | `wizz-schema-markup/references/schema-examples.md`                                    |
+| Muitas páginas para muitas palavras-chave                       | `wizz-seo-audit`, depois `wizz-programmatic-seo`                  | `wizz-programmatic-seo/references/playbooks.md`                                       |
+| Estrutura de URL, clusters, navegação                           | `wizz-seo-audit`, depois `wizz-site-architecture`                 | `references/site-type-templates.md`, `navigation-patterns.md`, `mermaid-templates.md` |
+| Publicar artigos e construir backlinks (executar)               | `distribb` (CLI: rode o `check:`; se faltar, mostre o `install:`) | entrada `distribb` em `areas.seo.clis`                                                |
+| Site pronto, revisão de pré-lançamento                          | `wizz-site-launch-kit` (área growth)                                   | `wizz-site-launch-kit/SKILL.md`                                                            |
+| Ferramenta grátis para captar busca                             | `wizz-free-tool-strategy` (área growth)                           | junto de `wizz-programmatic-seo`                                                      |
+
+## Combinações declaradas
+
+- `wizz-ai-seo` anda junto com `wizz-schema-markup`.
+- `wizz-schema-markup` anda junto com `wizz-site-launch-kit`.
+- `wizz-programmatic-seo` anda junto com `wizz-site-architecture` e `wizz-free-tool-strategy`.
+
+## Limites
+
+- Sem auditoria feita, não pule direto para schema ou páginas em escala: rode `wizz-seo-audit` primeiro.
+- `distribb` executa distribuição; as skills de SEO só auditam e geram. É opt-in e respeita a plataforma (`darwin`, `linux`).

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

@@ -1,6 +1,6 @@
 ---
 name: wizz-social
-description: Wizz Method Social and Viral Scripts (Rafa persona). Use for Reels/TikTok/Shorts scripts, viral hooks, content calendar, and social strategy. Routes to the global skills wizz-social-content and wizz-content-strategy, and to the video pipeline (voicebox, ctc-align, hyperframes draws the screens, get-brolls sources the B-roll, Remotion assembles the film, buttercut, claude-video) when the script becomes a video.
+description: Wizz Method Social and Viral Scripts (Rafa persona). Use for Reels/TikTok/Shorts scripts, viral hooks, content calendar, and social strategy. Routes to the global skills wizz-social-content and wizz-content-strategy, and to the video pipeline (voicebox, wizz-ctc-align, hyperframes draws the screens, get-brolls sources the B-roll, Remotion assembles the film, buttercut, claude-video) when the script becomes a video.
 ---
 
 # Social · Viral Scripts and Content (Rafa persona)
@@ -64,7 +64,7 @@ Full 3D pipeline (end to end): topic → script (blueprint Section 12) → image
 When the script becomes a video (you route, you don't do the editing yourself; full chain in `_shared/video-pipeline.md`):
 - **Static post asset** (carousel / quote card / infographic, not a video) → skill `wizz-canvas-design` (designer area)
 - **Narration / voice / TTS** → CLI `voicebox`
-- **Timing** of the narration (word-by-word timestamps for captions and cuts) → `ctc-align`
+- **Timing** of the narration (word-by-word timestamps for captions and cuts) → `wizz-ctc-align`
 - **Draw the screens** (visual scene changes in HTML/CSS, HTML→MP4) → CLI `hyperframes`
 - **Source the B-roll / inserts** (real footage of the fact, person, product, news item or screen the script names) → CLI `get-brolls` (macOS). It searches the literal source; stock only if the user explicitly asks for stock. Ends in a Storyboard the **human** approves — never approve on their behalf
 - **Effects and sound** (which effect and which SFX go where, and where not; ducking, loudness, safe-zone/density/excess/rhythm gates) → skill `wizz-video-effects`; it writes the timeline the assembly reads
@@ -90,4 +90,4 @@ A viral script names things out loud ("the CEO said", "this app's screen", "the
 The canonical rules live in `agent.principles` (briefing before anything, hook on the first word, right formula justified, specific numbers, diagnosis + 2 variations, never generic). Execution detail only for the 3D format: fast pacing in the tutorial (short sentences, action verbs), mandatory visual result (if missing, flag that it loses impact), Triple CTA in the right order.
 
 ## Closing
-Close in the Wizz format: `✅ O que fiz` / `➡️ Próximo passo` (usually wizz-designer to turn it into a video, or save to cerebro) / `🎯 Comando`. Add `💾 Quer que eu salve no cerebro?` if a niche, tone, or CTA keywords already in use were defined.
+Close in the format of `_shared/encerramento.md` (wizz module root). Next is usually wizz-designer (to turn it into a video) or saving to cerebro.

package/src/modules/wizz/agents/wizz-social/customize.toml

@@ -7,8 +7,8 @@ title = "Social and Viral Scripts"
 icon = "🎥"
 
 activation_steps_prepend = [
-  "ECONOMY: before reading files, try /cerebro ver, then grep, and only then Read. RTK rewrites shell commands automatically.",
-  "CEREBRO: run /cerebro ver to pull the niche, audience, tone of voice, and CTA keywords already used in the project. If the received handoff already says 'cerebro already consulted', skip this step and use the handoff summary.",
+  "ECONOMY: before reading files, try /wizz-cerebro ver, then grep, and only then Read. RTK rewrites shell commands automatically.",
+  "CEREBRO: run /wizz-cerebro ver to pull the niche, audience, tone of voice, and CTA keywords already used in the project. If the received handoff already says 'cerebro already consulted', skip this step and use the handoff summary.",
 ]
 
 # Communication rule + closing template: single source in _shared/.
@@ -41,7 +41,6 @@ principles = [
   "Always deliver a diagnosis (formula, trigger, strong point, point of attention) + 2 hook variations for A/B testing.",
   "Never deliver something generic: if the script would work for any creator in any niche, I stop and rewrite.",
   "When the script becomes a video, I route to the video CLIs (get-brolls sources the inserts, buttercut edits, voicebox narrates, hyperframes renders, claude-video analyzes) and to wizz-designer.",
-  "I close with ✅ o que fiz / ➡️ próximo passo / 🎯 comando.",
 ]
 
 [[agent.menu]]

package/src/modules/wizz/overrides/wizz-agent-analyst.toml

@@ -5,8 +5,8 @@
 
 [agent]
 activation_steps_prepend = [
-  "WIZZ ECONOMY: before reading files, try /cerebro ver, then grep, and only then Read with offset/limit. RTK rewrites shell commands automatically.",
-  "WIZZ CEREBRO: run /cerebro ver to pull the project's state and decisions (lightly, without reading the whole vault).",
+  "WIZZ ECONOMY: before reading files, try /wizz-cerebro ver, then grep, and only then Read with offset/limit. RTK rewrites shell commands automatically.",
+  "WIZZ CEREBRO: run /wizz-cerebro ver to pull the project's state and decisions (lightly, without reading the whole vault).",
 ]
 
 # Communication rule + closing template: single source in the wizz module (_shared/).

package/src/modules/wizz/overrides/wizz-agent-architect.toml

@@ -4,15 +4,15 @@
 
 [agent]
 activation_steps_prepend = [
-  "WIZZ ECONOMY: before reading files, try /cerebro ver, then grep, and only then Read with offset/limit. RTK rewrites shell commands automatically.",
-  "WIZZ CEREBRO: run /cerebro ver to pull architecture and stack decisions already recorded (lightly).",
+  "WIZZ ECONOMY: before reading files, try /wizz-cerebro ver, then grep, and only then Read with offset/limit. RTK rewrites shell commands automatically.",
+  "WIZZ CEREBRO: run /wizz-cerebro ver to pull architecture and stack decisions already recorded (lightly).",
 ]
 
 # Communication rule + closing template: single source in the wizz module (_shared/).
 include = ["../wizz/_shared/communication-rules.md", "../wizz/_shared/despacho-barato.md"]
 
 activation_steps_append = [
-  "NEXT STEP: usually call the dev. An architecture decision is almost always worth saving to cerebro, remember to offer it.",
+  "NEXT STEP: usually call the dev. An architecture decision is almost always worth saving to the cerebro, remember to offer it.",
 ]
 
 persistent_facts = [

package/src/modules/wizz/overrides/wizz-agent-dev.toml

@@ -4,8 +4,8 @@
 
 [agent]
 activation_steps_prepend = [
-  "WIZZ ECONOMY: before reading files, try /cerebro ver, then grep, and only then Read with offset/limit. RTK rewrites shell commands automatically.",
-  "WIZZ CEREBRO: run /cerebro ver to pull where the project left off and what's missing (lightly).",
+  "WIZZ ECONOMY: before reading files, try /wizz-cerebro ver, then grep, and only then Read with offset/limit. RTK rewrites shell commands automatically.",
+  "WIZZ CEREBRO: run /wizz-cerebro ver to pull where the project left off and what's missing (lightly).",
 ]
 
 # Communication rule + closing template: single source in the wizz module (_shared/).
@@ -19,7 +19,7 @@ persistent_facts = [
   "I'm part of the Wizz Method. I summarize what I coded in plain language before the technical detail.",
   "Automatic chaining: when I finish, I trigger the next agent in the sequence (usually QA) on my own; I only pause on a user business decision or irreversible risk.",
   "Planning gate: a multi-step feature with no matching story/PRD → I ask once whether to create the story first (wizz-create-story, recommended) or skip it; I never ask twice in the same chain. Full rules: read the wizz module's _shared/planning-gate.md ONLY when the gate triggers.",
-  "Duty to remember: a non-obvious bug solved becomes an offer to run /cerebro decisao.",
+  "Duty to remember: a non-obvious bug solved becomes an offer to run /wizz-cerebro decisao.",
 ]
 
 principles = [

package/src/modules/wizz/overrides/wizz-agent-pm.toml

@@ -4,8 +4,8 @@
 
 [agent]
 activation_steps_prepend = [
-  "WIZZ ECONOMY: before reading files, try /cerebro ver, then grep, and only then Read with offset/limit. RTK rewrites shell commands automatically.",
-  "WIZZ CEREBRO: run /cerebro ver to pull the product vision and decisions already made (lightly).",
+  "WIZZ ECONOMY: before reading files, try /wizz-cerebro ver, then grep, and only then Read with offset/limit. RTK rewrites shell commands automatically.",
+  "WIZZ CEREBRO: run /wizz-cerebro ver to pull the product vision and decisions already made (lightly).",
 ]
 
 # Communication rule + closing template: single source in the wizz module (_shared/).

package/src/modules/wizz/overrides/wizz-agent-tech-writer.toml

@@ -4,8 +4,8 @@
 
 [agent]
 activation_steps_prepend = [
-  "WIZZ ECONOMY: before reading files, try /cerebro ver, then grep, and only then Read. RTK rewrites shell commands automatically.",
-  "WIZZ CEREBRO: run /cerebro ver to pull the project's existing context and documentation (lightly).",
+  "WIZZ ECONOMY: before reading files, try /wizz-cerebro ver, then grep, and only then Read. RTK rewrites shell commands automatically.",
+  "WIZZ CEREBRO: run /wizz-cerebro ver to pull the project's existing context and documentation (lightly).",
 ]
 
 # Communication rule + closing template: single source in the wizz module (_shared/).

package/src/modules/wizz/overrides/wizz-agent-ux-designer.toml

@@ -6,8 +6,8 @@
 
 [agent]
 activation_steps_prepend = [
-  "WIZZ ECONOMY: before reading files, try /cerebro ver, then grep, and only then Read. RTK rewrites shell commands automatically.",
-  "WIZZ CEREBRO: run /cerebro ver to pull the target audience and UX decisions already made (lightly).",
+  "WIZZ ECONOMY: before reading files, try /wizz-cerebro ver, then grep, and only then Read. RTK rewrites shell commands automatically.",
+  "WIZZ CEREBRO: run /wizz-cerebro ver to pull the target audience and UX decisions already made (lightly).",
 ]
 
 # Communication rule + closing template: single source in the wizz module (_shared/).

package/src/skills-lib/_shared/complexity-signal.md

@@ -1,16 +1,15 @@
 # Complexity signal (single source)
 
 # Read by wizz-router (SKILL.md), wizz-maestro (SKILL.md) and wizz-quick-dev
-# (SKILL.md) as the CANONICAL SOURCE of the rule paragraph below. The SKILL.md
-# files do not include it automatically (skills are self-contained folders
-# copied verbatim), so editing here does NOT propagate on its own — whoever
-# edits this paragraph has to replicate the change by hand in the 3 SKILL.md
-# files. `test/test-dispatch-rule-consistency.js` compares the block's text
-# (not just the numbers) against the 3 copies and fails on any divergence of
-# wording, not only of threshold.
+# (SKILL.md) as the CANONICAL SOURCE of the counting rules below. The
+# dispatch-rule and decision-order lines are GENERATED from
+# `dispatch-rule.yaml` (next to this file) into here, the 3 SKILL.md files and
+# the router hook by `tools/generate-dispatch-rule.mjs`: edit the yaml and run
+# `npm run generate:dispatch-rule`, never these lines.
+# `test/test-dispatch-rule-generated.js` fails on any drift.
 # ---
 
-Dispatch rule: IF 2+ areas → maestro, always. OTHERWISE count the 3 remaining factors (multi-step, needs planning, produces a memorable artifact); 2+ factors → maestro. The area clause decides on its own, without summing with anything else.
+Dispatch rule: IF 2+ areas → maestro, always. OTHERWISE count the 3 remaining factors (multi-step, needs planning, produces a memorable artifact); 2+ factors → maestro. The area clause decides on its own, without combining with anything else.
 
 **Decision order — capabilities → required relations → areas → shortcuts.** Match the catalogue entries, inspect their `rel`, and include only capabilities needed for the requested deliverable and not already supplied in the context. Resolve their owning areas before applying ANY one-area shortcut. One artifact can require multiple areas; the word "copy" does not prove that only copy is needed. For full sales-page copy, if either the offer or the conversion structure is missing from the supplied context, include the missing capability: `wizz-offer-forge` for the offer and/or `wizz-page-cro` for conversion structure (growth), alongside `wizz-copywriting` (copy); route to maestro. Do not assume those inputs are ready merely because the user did not mention them. If both are already approved and the request is limited to text, keep copy-only work in copy. An isolated headline or CTA does not require redesigning the whole page. Optional neighbours and separate deliverables do not add areas; `pairs_with` alone never escalates.
 
@@ -34,7 +33,7 @@ Written as bare labels, the 3 factors above were true of almost any request, and
 
 **The counterpart, and this is what is left for the maestro:** a request **of open scope, which the request itself does not delimit** — "how do I improve the signup conversion rate", "the sales page gets plenty of visits and almost nobody buys", "my sales page converts badly, improve it". There the scope has to be discovered before anything is delivered, and discovering scope is the Manager's work. The deciding difference is not the size of the request, it is whether **the request already states what the delivery is**.
 
-**And the counterpart has one exception: a single entry already delimits the scope.** If the whole outcome being asked for fits the `when:` of ONE catalogue entry, and what leaves at the end is that entry's own deliverable — a plan, a recommendation, an audit — then the scope is not open, the catalogue delimited it, and the request goes to that entry's area. "A plan to reduce churn" is `wizz-churn-prevention`; "I want ChatGPT and Perplexity to cite us" is `wizz-ai-seo`; "what to check before going live" is `site-launch-kit`. It stops being the exception the moment delivering the outcome means changing what other areas own: "improve the signup conversion rate" ends up in copy, UI and code, so it comes back to the maestro through the area clause. Ask which single entry would deliver it whole — if it takes two, the scope really is open. (Owner's decision, 2026-09-18.)
+**And the counterpart has one exception: a single entry already delimits the scope.** If the whole outcome being asked for fits the `when:` of ONE catalogue entry, and what leaves at the end is that entry's own deliverable — a plan, a recommendation, an audit — then the scope is not open, the catalogue delimited it, and the request goes to that entry's area. "A plan to reduce churn" is `wizz-churn-prevention`; "I want ChatGPT and Perplexity to cite us" is `wizz-ai-seo`; "what to check before going live" is `wizz-site-launch-kit`. It stops being the exception the moment delivering the outcome means changing what other areas own: "improve the signup conversion rate" ends up in copy, UI and code, so it comes back to the maestro through the area clause. Ask which single entry would deliver it whole — if it takes two, the scope really is open. (Owner's decision, 2026-09-18.)
 
 **Changing the product's code is `dev`, even when the subject is visual.** "Adjust the secondary button's colour", "fix the mobile spacing": the delivery is a commit, so it is the dev area — `designer` decides what the look should be, it does not ship the change. Ask which artifact leaves at the end: a file in the repo → dev; a decision, a spec or a piece of art → the area that owns it. **Exception: new or rebuilt screens.** When the request asks to BUILD screens in code (a new app, page, dashboard or panel, or a whole screen rebuilt in the product), the visual decision has not been made yet, so `designer` comes first and the sequence is design → dev (2 areas → maestro): the designer runs its research gate before any screen is coded. A tweak to an existing screen (a price, a label, a spacing) stays dev, and redesigning a section with no build asked for (a hero, a card) stays designer.
 

package/src/skills-lib/_shared/dispatch-rule.yaml

@@ -0,0 +1,21 @@
+# Fonte única da regra de dispatch (2026-10-15).
+#
+# tools/generate-dispatch-rule.mjs reescreve, a partir daqui, a linha da regra e
+# a linha da ordem de decisão em complexity-signal.md e nas SKILL.md do
+# wizz-router, wizz-maestro e wizz-quick-dev, e a dica curta do hook
+# tools/hooks/wizz-router-enforce.js. Não edite essas linhas nos arquivos:
+# edite aqui e rode `npm run generate:dispatch-rule`. O `--check` roda no
+# `npm test` (test/test-dispatch-rule-generated.js) e falha em qualquer drift.
+#
+# `{maestro}` vira o nome que cada arquivo usa para o maestro (ver `targets`
+# no gerador). O texto renderizado na SKILL.md do router entra no prompt do
+# eval de rota: mudar `rule` ou `decision_order` é mudança de rota e exige a
+# prova de eval (linha de base em worktree, 9 amostras nas duas árvores).
+
+rule: "IF 2+ areas → {maestro}, always. OTHERWISE count the 3 remaining factors (multi-step, needs planning, produces a memorable artifact); 2+ factors → {maestro}. The area clause decides on its own, without combining with anything else."
+
+decision_order: "**Decision order — capabilities → required relations → areas → shortcuts.** Match the catalogue entries, inspect their `rel`, and include only capabilities needed for the requested deliverable and not already supplied in the context. Resolve their owning areas before applying ANY one-area shortcut. One artifact can require multiple areas; the word \"copy\" does not prove that only copy is needed. For full sales-page copy, if either the offer or the conversion structure is missing from the supplied context, include the missing capability: `wizz-offer-forge` for the offer and/or `wizz-page-cro` for conversion structure (growth), alongside `wizz-copywriting` (copy); route to maestro. Do not assume those inputs are ready merely because the user did not mention them. If both are already approved and the request is limited to text, keep copy-only work in copy. An isolated headline or CTA does not require redesigning the whole page. Optional neighbours and separate deliverables do not add areas; `pairs_with` alone never escalates."
+
+# Paráfrase curta em PT-BR injetada pelo hook em projeto Wizz (a cada prompt,
+# então fica curta de propósito).
+hook_hint: "🎛️ Wizz: NÃO invoque wizz-router. Capacidades → rel necessário à entrega → áreas → atalhos. 2+ áreas → `wizz-maestro`. 1 área: 2+ fatores (multi-passo, planejar, artefato memorável) → `wizz-maestro`; senão → Skill da área. Auth/pagamento/permissão/migração → maestro. Personas são skills, não subagent_type; Agent usa tipos disponíveis wizz-exec-*; difícil → wizz-exec-strong (ESCALAR → ultra)."

package/src/skills-lib/{cerebro → wizz-cerebro}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: cerebro
+name: wizz-cerebro
 description: >
   Persistent memory system across AI sessions. Use this skill whenever the user types
   /iniciar, /salvar, /ver, /dia, /dump, /decisao, /conteudo, /prospect or /memoria. Also activate when the

package/src/skills-lib/{ctc-align → wizz-ctc-align}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: ctc-align
+name: wizz-ctc-align
 description: Reliable word-by-word timestamps for TTS narration via forced alignment (ctc-forced-aligner + anchoring on real silences). ALWAYS use before setting caption timing, scene cuts, animation, or any speech-synchronized element in any video (HyperFrames or other editor). Replaces Whisper as the timing source when the narration script text is known. Triggers - sincronizar legenda, timing de cena, alinhar áudio e texto, palavra a palavra, forced alignment, legenda karaokê, corrigir sync de vídeo. Use when the exact narration script is known and you need to decide caption timing, scene cuts, or speech-synchronized animation.
 ---
 

package/src/skills-lib/{enhance-prompt → wizz-enhance-prompt}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: enhance-prompt
+name: wizz-enhance-prompt
 description: Transforms vague UI ideas into polished, Stitch-optimized prompts. Enhances specificity, adds UI/UX keywords, injects design system context, and structures output for better generation results. Use when the user wants to polish a UI prompt before sending it to Stitch, improve a prompt that produced poor results, or turn a vague UI idea into a structured, design-system-aware prompt.
 allowed-tools:
   - "Read"

package/src/skills-lib/{find-skills → wizz-find-skills}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: find-skills
+name: wizz-find-skills
 description: Helps users discover and install agent skills OR MCP servers when they ask questions like "how do I do X", "find a skill for X", "adicione essa skill", "adicione esse MCP", "is there a skill/mcp that can...", or express interest in extending capabilities. Use when the user is looking for functionality that might exist as an installable skill or MCP server.
 ---
 

package/src/skills-lib/wizz-huashu-design/references/sfx-library.md

@@ -12,7 +12,7 @@
 > 仓库和已下载的缓存中）。用某个 SFX 前先 `ls assets/sfx/<category>/` 确认文件存在；
 > 缺失就跑 `npx --yes wizz-method fetch-assets --bundle huashu-audio --dest
 > assets`（路径相对本 skill 根目录）。离线时手动下载
-> `npx wizz-method fetch-assets --bundle huashu-audio` (2 partes em `https://wizz-assets.junior-aec.workers.dev/huashu-audio-1.tar.gz` e `.../huashu-audio-2.tar.gz`)
+> `npx wizz-method fetch-assets --bundle huashu-audio` (2 partes em `https://assets.wizzcomms.com/huashu-audio-1.tar.gz` e `.../huashu-audio-2.tar.gz`)
 > 解压到 `assets/`，能力不受影响，只是首次用要等下载。
 
 ---

package/src/skills-lib/wizz-huashu-design/scripts/add-music.sh

@@ -83,7 +83,7 @@ if [ ! -f "$MUSIC" ]; then
   echo "✗ Music not found: $MUSIC" >&2
   echo "  Available moods: $(ls "$ASSETS_DIR" 2>/dev/null | grep -E '^bgm-.*\.mp3$' | sed 's/^bgm-//;s/\.mp3$//' | tr '\n' ' ')" >&2
   echo "  Offline or npx failed? Download manually:" >&2
-  echo "    npx wizz-method fetch-assets --bundle huashu-audio  (https://wizz-assets.junior-aec.workers.dev/huashu-audio-{1,2}.tar.gz)" >&2
+  echo "    npx wizz-method fetch-assets --bundle huashu-audio  (https://assets.wizzcomms.com/huashu-audio-{1,2}.tar.gz)" >&2
   echo "  and extract it into: $ASSETS_DIR" >&2
   exit 1
 fi

package/src/skills-lib/wizz-huashu-design/scripts/html2pptx.js

@@ -913,43 +913,8 @@ function writeElement(slide, pres, el) {
   }
 }
 
-module.exports = async function html2pptx(htmlFile, pres, options) {
-  options = options || {};
-  const absHtmlPath = path.isAbsolute(htmlFile) ? htmlFile : path.resolve(process.cwd(), htmlFile);
-  const tmpDir = options.tmpDir || process.env.TMPDIR || '/tmp';
-
-  function finalizeError(rawMessage) {
-    let message = rawMessage;
-    if (!message.startsWith(htmlFile)) {
-      message = `${htmlFile}: ${message}`;
-    }
-    return new Error(message);
-  }
-
-  let browser;
-  let extraction;
-  try {
-    const launchOptions = { env: Object.assign({}, process.env, { TMPDIR: tmpDir }) };
-    if (process.platform === 'darwin') launchOptions.channel = 'chrome';
-    browser = await chromium.launch(launchOptions);
-    const page = await browser.newPage();
-    await page.goto('file://' + absHtmlPath);
-
-    const initialBodySize = await page.evaluate(() => {
-      const cs = getComputedStyle(document.body);
-      return { width: parseFloat(cs.width), height: parseFloat(cs.height) };
-    });
-    await page.setViewportSize({
-      width: Math.max(1, Math.round(initialBodySize.width)),
-      height: Math.max(1, Math.round(initialBodySize.height)),
-    });
-
-    extraction = await page.evaluate(extractPageDataInBrowser);
-  } finally {
-    if (browser) await browser.close();
-  }
-
-  // ---- 整页级校验（第 5 节），和提取阶段收集到的错误合并 ----
+// 整页级校验（第 5 节）：和提取阶段收集到的错误合并，返回错误文案数组。纯函数，不碰浏览器。
+function validatePage(extraction, pres) {
   const errors = extraction.errors.slice();
 
   const widthOverflowPx = Math.max(0, extraction.body.scrollWidth - extraction.body.width - 1);
@@ -989,6 +954,46 @@ module.exports = async function html2pptx(htmlFile, pres, options) {
       }
     }
   }
+  return errors;
+}
+
+module.exports = async function html2pptx(htmlFile, pres, options) {
+  options = options || {};
+  const absHtmlPath = path.isAbsolute(htmlFile) ? htmlFile : path.resolve(process.cwd(), htmlFile);
+  const tmpDir = options.tmpDir || process.env.TMPDIR || '/tmp';
+
+  function finalizeError(rawMessage) {
+    let message = rawMessage;
+    if (!message.startsWith(htmlFile)) {
+      message = `${htmlFile}: ${message}`;
+    }
+    return new Error(message);
+  }
+
+  let browser;
+  let extraction;
+  try {
+    const launchOptions = { env: Object.assign({}, process.env, { TMPDIR: tmpDir }) };
+    if (process.platform === 'darwin') launchOptions.channel = 'chrome';
+    browser = await chromium.launch(launchOptions);
+    const page = await browser.newPage();
+    await page.goto('file://' + absHtmlPath);
+
+    const initialBodySize = await page.evaluate(() => {
+      const cs = getComputedStyle(document.body);
+      return { width: parseFloat(cs.width), height: parseFloat(cs.height) };
+    });
+    await page.setViewportSize({
+      width: Math.max(1, Math.round(initialBodySize.width)),
+      height: Math.max(1, Math.round(initialBodySize.height)),
+    });
+
+    extraction = await page.evaluate(extractPageDataInBrowser);
+  } finally {
+    if (browser) await browser.close();
+  }
+
+  const errors = validatePage(extraction, pres);
 
   if (errors.length > 0) {
     let message;
@@ -1017,3 +1022,6 @@ module.exports = async function html2pptx(htmlFile, pres, options) {
 
   return { slide, placeholders: extraction.placeholders };
 };
+
+// Expostos só para teste (funções puras, sem browser).
+module.exports._internals = { toPt, toIn, stripFileProtocol, previewTextOf, writeElement, validatePage };

package/src/skills-lib/wizz-huashu-design/scripts/mix-voiceover.sh

@@ -80,7 +80,7 @@ if [ -n "$BGM" ] && [ ! -f "$BGM" ]; then
   echo "✗ BGM 文件不存在: $BGM" >&2
   echo "  可用 mood: $(ls "$ASSETS_DIR" 2>/dev/null | grep -E '^bgm-.*\.mp3$' | sed 's/^bgm-//;s/\.mp3$//' | tr '\n' ' ')" >&2
   echo "  离线，或 npx 失败？手动下载：" >&2
-  echo "    npx wizz-method fetch-assets --bundle huashu-audio  (https://wizz-assets.junior-aec.workers.dev/huashu-audio-{1,2}.tar.gz)" >&2
+  echo "    npx wizz-method fetch-assets --bundle huashu-audio  (https://assets.wizzcomms.com/huashu-audio-{1,2}.tar.gz)" >&2
   echo "  解压到：$ASSETS_DIR" >&2
   exit 1
 fi

package/src/skills-lib/wizz-huashu-design/scripts/narrate-pipeline.mjs

@@ -308,8 +308,14 @@ async function main() {
   console.error(`  cue 数:    ${totalCues}`);
 }
 
-main().catch((err) => {
-  console.error(`narrate-pipeline 失败：${err.message}`);
-  console.error(err.stack);
-  process.exit(1);
-});
+// Só executa quando chamado como script; importar o módulo (testes) não dispara o pipeline.
+const isMain = process.argv[1] && fs.realpathSync(process.argv[1]) === fileURLToPath(import.meta.url);
+if (isMain) {
+  main().catch((err) => {
+    console.error(`narrate-pipeline 失败：${err.message}`);
+    console.error(err.stack);
+    process.exit(1);
+  });
+}
+
+export { parseArgs, parseScript, splitByCues };