wizz-method 2.12.0 → 2.13.0

package/README.md

@@ -72,7 +72,7 @@ The Wizz layer applies to everyone: standard closing (✅/➡️/🎯), token ec
 npx wizz-method install
 ```
 
-Follow the prompts, then open your AI IDE (Claude Code, Cursor, Codex and others) in the project folder.
+The guided install takes four steps (folder, what you'll use it for, your AI tool, your name) and shows what will be installed before it starts. Choose Português on the first screen or pass `--lang pt`; `--advanced` asks the complete question list. Then open your AI tool (Claude Code, Cursor, Codex and others) in the project folder.
 
 ### 2. Customize the Wizz layer
 
@@ -106,6 +106,7 @@ Without a TTY, the default language is "Português (BR)". Use `--lang` or the `W
 | Command | Does |
 |---|---|
 | `npx wizz-method install` | Installs modules, hooks, skills and MCPs into the project |
+| `npx wizz-method catalog [--area <area>]` | Lists every area, skill and tool, marking what's installed |
 | `npx wizz-method status` | Shows what's installed and each module's version |
 | `npx wizz-method doctor` | Diagnostics: hooks, rtk, jq, optional Python and `_wizz/` drift |
 | `npx wizz-method resolve [--skill <name>]` | Regenerates the customization snapshots in `_wizz/_resolved/` |

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "wizz-method",
-  "version": "2.12.0",
+  "version": "2.13.0",
   "description": "Wizz Method: método de agência orientado por IA em PT-BR",
   "keywords": [
     "agile",

package/skills-registry.yaml

@@ -242,7 +242,7 @@ areas:
         not_when:
           - "Analisar/resumir um vídeo que já se tem em mãos: é claude-video."
           - "Cortar/montar footage já captado: é buttercut (corte fino) ou wizz-remotion-best-practices (montagem final)."
-          - "Gerar imagem/vídeo por IA: é fal-video. O get-brolls busca material REAL, não sintético."
+          - "Gerar imagem/vídeo por IA: é wizz-ad-creative, que escreve o prompt para o usuário colar no Flow ou em outra IA. O get-brolls busca material REAL, não sintético."
           - "Desenhar uma tela/cena em HTML: é hyperframes."
           - "Minerar/estudar criativo ou oferta de concorrente (Biblioteca de Anúncios, 'baixa esse anúncio pra eu ver'): é wizz-lowticket-minerador na área ads. O get-brolls capta insert para a SUA edição, com procedência registrada — não é ferramenta de inteligência competitiva, e o fato de saber baixar um Reel não o torna uma."
         rel:
@@ -302,14 +302,6 @@ areas:
         check: "test -x ./tools/ctc-align/.venv/bin/ctc-forced-aligner"
         install: 'mkdir -p tools/ctc-align && uv venv --python 3.12 tools/ctc-align/.venv && uv pip install --python tools/ctc-align/.venv/bin/python "git+https://github.com/MahmoudAshraf97/ctc-forced-aligner.git"'
         verify: "command -v ffmpeg >/dev/null 2>&1 && command -v uv >/dev/null 2>&1"
-      - id: fal-video
-        when: "GERAR vídeo/imagem por IA (Veo/Kling/Wan e outros modelos via API da fal.ai), estilo UGC/ad-ready. Substitui o arcads: mesmo caso de uso (vídeo gerado por IA), custo 50-95% menor por vídeo, sem clone-and-run pesado. Precisa FAL_KEY em .env. Sem CLI binária oficial: usa o client Node oficial @fal-ai/client como dependência do projeto."
-        rel:
-          pairs_with: [wizz-ad-creative]
-        platform: [darwin, linux]
-        check: "test -f node_modules/@fal-ai/client/package.json"
-        # Pin de supply chain (2026-08-25): versão fixa (client oficial fal.ai); atualizar conscientemente.
-        install: "npm install @fal-ai/client@1.10.1"
       - id: apple-design
         when: "Revisar/auditar UI NATIVA (iOS/macOS: SwiftUI, Flutter, React Native, Tauri, Electron) contra o Apple HIG e o Liquid Glass — compliance com o HIG, acessibilidade, dark mode, navegação. Cobre o gap que o wizz-taste-skill declara fora de escopo ('native mobile: use Apple HIG directly')."
         not_when: "UI web: aí é wizz-ui-ux-pro-max / wizz-impeccable."
@@ -573,9 +565,10 @@ areas:
     # para as CLIs de vídeo quando o roteiro vira vídeo", prometendo um handoff
     # que a área não pode fazer: as CLIs de vídeo (get-brolls, hyperframes,
     # buttercut, claude-video) moram em `designer`, e o único cli daqui é o
-    # postiz. Medido: essa frase puxava pedido de ASSET ("imagens de apoio pro
-    # meu Reel", "carrossel pro Instagram") para social, que não tem a
-    # ferramenta. A fronteira ficou no summary; a nota ficou aqui.
+    # buffer (era o postiz até 2026-09-25). Medido: essa frase puxava pedido
+    # de ASSET ("imagens de apoio pro meu Reel", "carrossel pro Instagram")
+    # para social, que não tem a ferramenta. A fronteira ficou no summary;
+    # a nota ficou aqui.
     summary: "Social e roteiros virais: o TEXTO e o ROTEIRO de Reels/Shorts, hooks, legenda, thread, calendário de conteúdo. Persona Rafa, aplica o Blueprint de Roteiro Viral. Captar, desenhar ou montar o asset em si (b-roll, vídeo, carrossel, imagem) não é desta área."
     skills:
       - id: wizz-social-content
@@ -584,7 +577,7 @@ areas:
           - "Editar/revisar texto de social já escrito: aí é wizz-copy-editing."
           - "Pedir SÓ o asset de um Reel/vídeo — b-roll, 'imagens de apoio', 'cenas de apoio', imagem de corte, footage — sem que o texto ou o roteiro façam parte do pedido: a captação é get-brolls, na área designer. Esta entrada entra quando o TEXTO ou o ROTEIRO é parte do que se pede; se o pedido junta roteiro E captação, são 2 áreas."
         rel:
-          before: [get-brolls, postiz]
+          before: [buffer, get-brolls]
           pairs_with: [wizz-canvas-design, wizz-content-strategy, wizz-copy-editing, wizz-launch-strategy]
       - id: wizz-content-strategy
         when: "Decidir O QUE produzir de conteúdo (topic clusters, calendário, pilares)."
@@ -596,20 +589,22 @@ areas:
           after: [wizz-copywriting]
           pairs_with: [wizz-social-content]
     clis:
-      - id: postiz
-        when: "PUBLICAR/agendar de verdade em redes sociais (30+ integrações) a partir do conteúdo que o wizz-social já gerou. Separa 'gerar' (Wizz) de 'publicar' (Postiz). Precisa autenticar antes (`postiz auth:login` ou env `POSTIZ_API_KEY`); para imagem/vídeo a própria CLI faz o upload."
+      - id: buffer
+        when: "PUBLICAR/agendar de verdade em redes sociais (Instagram, TikTok, YouTube, LinkedIn, Facebook, Threads, X, Pinterest, Bluesky, Mastodon, Google Business) a partir do conteúdo que o wizz-social já gerou. Separa 'gerar' (Wizz) de 'publicar' (Buffer). Precisa de API key (`buffer init` ou env `BUFFER_API_KEY`). Imagem/vídeo NÃO sobe do disco: a mídia precisa estar numa URL pública HTTPS e direta (Cloudinary, Cloudflare R2), estável até o post publicar."
         not_when: "Escrever o roteiro ou a legenda: isso é skill da área (wizz-social-content, wizz-copy-editing)."
         rel:
           after: [wizz-social-content]
-        # Item 30 da auditoria (2026-09-11, Parte 3.7). Pin de supply chain
-        # (2026-09-12): versão publicada fixa no npm, atualizar conscientemente.
+        # Substituiu o postiz em 2026-09-25: a nuvem da Postiz não tem plano
+        # grátis (a partir de US$ 29/mês) e o self-host exige servidor próprio
+        # mais um app de desenvolvedor por rede. O plano grátis do Buffer tem
+        # 3 canais, 10 posts na fila por canal e API/CLI/MCP inclusos.
         # CLI, não MCP: o schema de `mcps:` deste registry só aceita stdio
-        # ({command,args,env}) e o MCP hospedado da Postiz é HTTP+OAuth
-        # (https://mcp.postiz.com/mcp-oauth-dynamic) — não encaixa. Existe uma
-        # skill wrapper (`gitroomhq/postiz-agent`) que só dirige esta mesma CLI;
-        # opcional, não registrada aqui.
-        check: "command -v postiz >/dev/null 2>&1"
-        install: "npm install -g postiz@2.0.16"
+        # ({command,args,env}) e o MCP do Buffer é HTTP com bearer
+        # (https://mcp.buffer.com/mcp) — não encaixa.
+        # Pin de supply chain (2026-09-25): versão publicada fixa no npm,
+        # atualizar conscientemente.
+        check: "command -v buffer >/dev/null 2>&1"
+        install: "npm install -g @bufferapp/cli@1.2.0"
 
   ads:
     agent: wizz-ads
@@ -620,9 +615,9 @@ areas:
         rel:
           pairs_with: [wizz-ad-creative, wizz-tracking-audit]
       - id: wizz-ad-creative
-        when: "Gerar/iterar criativos e headlines de anúncio em escala (RSA, variações)."
+        when: "Gerar/iterar criativos e headlines de anúncio em escala (RSA, variações). Inclui escrever o PROMPT de imagem/vídeo por IA (Veo, Kling, Flow e similares) para o usuário gerar fora do método: nenhuma API de geração está integrada."
         rel:
-          pairs_with: [fal-video, wizz-copywriting, wizz-paid-ads, wizz-video-effects]
+          pairs_with: [wizz-copywriting, wizz-paid-ads, wizz-video-effects]
       - id: wizz-analytics-tracking
         when: "Tracking de conversão pros anúncios (compartilhada com growth)."
         rel:

package/src/bmm-skills/module.yaml

@@ -1,5 +1,5 @@
 code: bmm
-name: "Wizz Method"
+name: "Wizz Product & Code"
 description: "Full-lifecycle AI agile development: analysis, planning, architecture, implementation"
 default_selected: true # This module will be selected by default for new installations
 

package/src/modules/wizz/_shared/video-pipeline.md

@@ -27,7 +27,7 @@
 | **Source B-roll / inserts: find real footage of what the script names** | `get-brolls` (darwin) |
 | Edit/cut recorded footage (cuts, selects, roughcut) | `buttercut` (darwin-arm64 only) |
 | Analyze an existing reference video (frames + transcription) | `claude-video` |
-| AI-generated video/image (Veo/Kling/Wan), UGC / ad-ready style | `fal-video` (designer area; needs `FAL_KEY`) |
+| AI-generated video/image (Veo/Kling/Wan), UGC / ad-ready style | `wizz-ad-creative` (ads area) writes the prompt; the user generates it in Flow or another AI tool, outside the method |
 
 ## Full chain (script → publishing)
 

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

@@ -76,7 +76,7 @@ The Diretor (`wizz-router`) has already done the triage and handed it to you bec
    - `areas:` — `agent` (must match the menu's) and `skills:` (each with an `id` + short `when`). Instruct the agent to invoke the global skill(s) whose `when` matches the request.
    - `utility:` — cross-cutting skills (find-skills, enhance-prompt, wizz-router). Offer when it fits.
    - `mcps:` (per area) and `mcp_utility:` (cross-cutting) — MCP servers the area uses to actually ACT (e.g. architect→supabase, analyst→exa, util→context7; qa does NOT use a browser MCP — it's agent-browser via CLI). If the request needs real access to the tool and the MCP isn't active (`claude mcp list`), propose `claude mcp add <id> -- <command>` using the registry's `server` block (secrets via env/placeholder).
-   - `clis:` (per area) and `cli_utility:` (cross-cutting) — command-line tools the agent calls directly (neither a skill nor an MCP): e.g. qa→agent-browser; designer→hyperframes/get-brolls/claude-video/buttercut/voicebox/fal-video (video); growth→scrapling; seo→distribb; social→postiz. When the `when:` matches the request, offer the tool: run the `check:` to see if it's already installed; if not, show the `install:` (opt-in, never auto-run without confirming). Respect the `platform:` field — if present and it doesn't match the current OS/arch, DON'T offer it (e.g., `buttercut` is `darwin-arm64`, Apple Silicon only). Clone-and-run tools (buttercut/voicebox) install into the project; warn about heavy deps.
+   - `clis:` (per area) and `cli_utility:` (cross-cutting) — command-line tools the agent calls directly (neither a skill nor an MCP): e.g. qa→agent-browser; designer→hyperframes/get-brolls/claude-video/buttercut/voicebox (video); growth→scrapling; seo→distribb; social→buffer. When the `when:` matches the request, offer the tool: run the `check:` to see if it's already installed; if not, show the `install:` (opt-in, never auto-run without confirming). Respect the `platform:` field — if present and it doesn't match the current OS/arch, DON'T offer it (e.g., `buttercut` is `darwin-arm64`, Apple Silicon only). Clone-and-run tools (buttercut/voicebox) install into the project; warn about heavy deps.
    - `rel:` (on any entry) — **this is where the method knows that a request about A also needs C.** `pairs_with` (they go together), `before`/`after` (mandatory order) and `instead_of` (one or the other, not both). Every edge is reciprocal by construction: the schema validator rejects one-way edges, so the relation shows up whichever side the user enters from. As the multi-area orchestrator you are the biggest beneficiary of this — roughly a third of the edges cross areas (count them in the registry when you need the number; don't quote one from memory). When building the dispatch, follow the same order the area agents follow ([rel protocol](../../_shared/rel-protocol.md)): LIST every id the chosen entry's `rel` names — including the ones you don't recognise, which are exactly the point — resolve each id → area via the `ids:` map in `{project-root}/_wizz/_config/registry/index.yaml`, read that area's slice for its `when:`, and then either bring it in or discard it with a stated reason. A target in another area becomes a dispatch to THAT area's agent, and a `before` target sets the ORDER of the plan, not a parallel item. Never deliver only the half the user named when `rel` says the other half is missing: a related capability you never named is one the method lost.
    - `squads:` — advisory panels (run via `wizz-party-mode`). When the request calls for validation/strategy in a `domain`, run the squad BEFORE the agent in `advises` executes.
 

package/src/skills-lib/wizz-router/references/routing-table-flat.md

@@ -58,7 +58,7 @@ Use this table to map skills/CLIs/MCPs directly **outside a Wizz project** (no `
 | Effects and sound of a short vertical video (ad or Reels): which effect goes where and when not, which SFX for each event and at what level, ducking, master loudness, safe-zone/density/excess/rhythm gates | `wizz-video-effects` (designer registry; decides the effects, Remotion assembles them) | 2 |
 | **Find B-roll / inserts / cutaways / supporting footage** for a video or Reel (real footage of the fact, person, product, news item or screen the script names; YouTube/Instagram/TikTok/Pexels/Pixabay/Commons/NASA) | CLI `get-brolls` (designer registry; **macOS**, global `skills add` + its own `install.sh`; needs ffmpeg with drawtext, Node 22+, Python 3.11+). Ends in a Storyboard the HUMAN approves — the agent never self-approves. Stock only when the user explicitly asks for stock | 1 |
 | **Edit/cut video** (cuts, selects, roughcut) | CLI `buttercut` (designer registry; **Apple Silicon only**, clone-and-run in the project, heavy deps) | 1 |
-| Generate an AI video/image (Veo/Kling/Wan), UGC / ad-ready style | CLI `fal-video` (designer registry; official `@fal-ai/client`, needs `FAL_KEY` in `.env`). Replaced the old arcads entry: same use case, 50-95% cheaper per video, no heavy clone-and-run | 1 |
+| Generate an AI video/image (Veo/Kling/Wan), UGC / ad-ready style | `wizz-ad-creative` writes the prompt for the user to paste into Flow or another AI tool. No generation API is integrated in the method | 1 |
 | Analyze/understand an existing video (frames + transcription) | CLI `claude-video` (designer registry; `npx skills add bradautomates/claude-video`) | 2 |
 | Narration / voice / TTS / voice cloning for video | CLI `voicebox` (designer registry; local app with MCP endpoint) | 2 |
 | Research components compatible with the project | `wizz-ui-component-curator` (demos, code, and public registries with evidence) | 1 |
@@ -83,7 +83,7 @@ Use this table to map skills/CLIs/MCPs directly **outside a Wizz project** (no `
 | EXECUTE the SEO distribution: publish articles, build backlinks through the Distribb network, connect Search Console, autopublish news | CLI `distribb` (seo registry) — the doing half; the strategy half is the SEO row above | 2 |
 | Competitor comparison, alternatives page, war room | `wizz-competitor-alternatives` | 2 |
 | Content, social media, newsletter, threads | `wizz-content-strategy` + `wizz-social-content` + `wizz-copy-editing` | 2 |
-| Actually PUBLISH/schedule to social networks (30+ integrations), not write it | CLI `postiz` (social registry; needs auth). Separates "generate" (Wizz skills above) from "publish" | 2 |
+| Actually PUBLISH/schedule to social networks (Instagram, TikTok, YouTube, LinkedIn and more), not write it | CLI `buffer` (social registry; needs `BUFFER_API_KEY`; media must be a public HTTPS URL). Separates "generate" (Wizz skills above) from "publish" | 2 |
 | Cold email, B2B outbound, prospecting | `wizz-cold-email` | 2 |
 | Referral, referrals, affiliate program | `wizz-referral-program` | 2 |
 | Sales material, pitch, deck, proposal | `wizz-sales-enablement` | 2 |

package/tools/installer/banner.js

@@ -1,40 +1,91 @@
 const prompts = require('./prompts');
+const { t } = require('./guided/messages');
+
+// Wizz brand palette (brand book): Wizz Orange and its deep shade.
+const BRAND_ORANGE = [255, 69, 0];
+const BRAND_DEEP = [204, 55, 0];
+// Built from the char code on purpose: a literal escape byte in source turns
+// the file binary for git (see the review-prep.mjs incident).
+const ESC = String.fromCodePoint(27);
+
+/**
+ * Paint text with a 24-bit brand color, or leave it plain when the terminal
+ * has no color support (NO_COLOR, pipes, CI logs).
+ * @param {number[]} rgb - [r, g, b]
+ * @param {string} text - Text to paint
+ * @param {boolean} enabled - Whether color is supported
+ * @returns {string}
+ */
+function paint(rgb, text, enabled) {
+  if (!enabled) return text;
+  return `${ESC}[38;2;${rgb[0]};${rgb[1]};${rgb[2]}m${text}${ESC}[39m`;
+}
+
+const LOGO_WIDE = [
+  '██╗    ██╗ ██╗ ███████╗ ███████╗    ███╗   ███╗ ███████╗ ████████╗ ██╗  ██╗  ██████╗  ██████╗  ™',
+  '██║    ██║ ██║ ╚══███╔╝ ╚══███╔╝    ████╗ ████║ ██╔════╝ ╚══██╔══╝ ██║  ██║ ██╔═══██╗ ██╔══██╗',
+  '██║ █╗ ██║ ██║   ███╔╝    ███╔╝     ██╔████╔██║ █████╗      ██║    ███████║ ██║   ██║ ██║  ██║',
+  '██║███╗██║ ██║  ███╔╝    ███╔╝      ██║╚██╔╝██║ ██╔══╝      ██║    ██╔══██║ ██║   ██║ ██║  ██║',
+  '╚███╔███╔╝ ██║ ███████╗ ███████╗    ██║ ╚═╝ ██║ ███████╗    ██║    ██║  ██║ ╚██████╔╝ ██████╔╝',
+  ' ╚══╝╚══╝  ╚═╝ ╚══════╝ ╚══════╝    ╚═╝     ╚═╝ ╚══════╝    ╚═╝    ╚═╝  ╚═╝  ╚═════╝  ╚═════╝ ',
+];
+
+const LOGO_NARROW = [
+  '██╗    ██╗ ██╗ ███████╗ ███████╗ ™',
+  '██║    ██║ ██║ ╚══███╔╝ ╚══███╔╝',
+  '██║ █╗ ██║ ██║   ███╔╝    ███╔╝ ',
+  '██║███╗██║ ██║  ███╔╝    ███╔╝  ',
+  '╚███╔███╔╝ ██║ ███████╗ ███████╗',
+  ' ╚══╝╚══╝  ╚═╝ ╚══════╝ ╚══════╝',
+];
 
 const CLIUtils = {
   /**
-   * Display Wizz Method logo and version using @clack intro + box
+   * Display the Wizz Method opening screen. With `steps`, it also lists the
+   * guided path's four steps so the user knows what comes next.
+   * @param {Object} [opts]
+   * @param {boolean} [opts.steps=false] - Show the "what happens next" list
+   * @param {'en'|'pt'} [opts.lang='en'] - Display language
+   * @param {string} [opts.version] - Version shown under the logo
    */
-  async displayLogo() {
+  async displayLogo(opts = {}) {
+    const { steps = false, lang = 'en', version } = opts;
     const color = await prompts.getColor();
+    const colorOn = color.isColorSupported !== false;
     const termWidth = process.stdout.columns || 80;
 
-    // Full "WIZZ METHOD" logo for wide terminals, "WIZZ" only for narrow
-    const logoWide = [
-      '██╗    ██╗ ██╗ ███████╗ ███████╗    ███╗   ███╗ ███████╗ ████████╗ ██╗  ██╗  ██████╗  ██████╗  ™',
-      '██║    ██║ ██║ ╚══███╔╝ ╚══███╔╝    ████╗ ████║ ██╔════╝ ╚══██╔══╝ ██║  ██║ ██╔═══██╗ ██╔══██╗',
-      '██║ █╗ ██║ ██║   ███╔╝    ███╔╝     ██╔████╔██║ █████╗      ██║    ███████║ ██║   ██║ ██║  ██║',
-      '██║███╗██║ ██║  ███╔╝    ███╔╝      ██║╚██╔╝██║ ██╔══╝      ██║    ██╔══██║ ██║   ██║ ██║  ██║',
-      '╚███╔███╔╝ ██║ ███████╗ ███████╗    ██║ ╚═╝ ██║ ███████╗    ██║    ██║  ██║ ╚██████╔╝ ██████╔╝',
-      ' ╚══╝╚══╝  ╚═╝ ╚══════╝ ╚══════╝    ╚═╝     ╚═╝ ╚══════╝    ╚═╝    ╚═╝  ╚═╝  ╚═════╝  ╚═════╝ ',
-    ];
-
-    const logoNarrow = [
-      '    ██╗    ██╗ ██╗ ███████╗ ███████╗ ™',
-      '    ██║    ██║ ██║ ╚══███╔╝ ╚══███╔╝',
-      '    ██║ █╗ ██║ ██║   ███╔╝    ███╔╝ ',
-      '    ██║███╗██║ ██║  ███╔╝    ███╔╝  ',
-      '    ╚███╔███╔╝ ██║ ███████╗ ███████╗',
-      '     ╚══╝╚══╝  ╚═╝ ╚══════╝ ╚══════╝',
-    ];
-
-    const logoLines = termWidth >= 95 ? logoWide : logoNarrow;
-    const logo = logoLines.map((line) => color.blue(line)).join('\n');
-    const tagline = color.white('    Método de agência orientado por IA\n    © Wizz! comms.  ·  method.wizzcomms.com');
-
-    await prompts.box(`${logo}\n${tagline}`, '', {
-      contentAlign: 'center',
+    const wide = termWidth >= 100;
+    const logoLines = wide ? LOGO_WIDE : LOGO_NARROW;
+    // Top half in Wizz Orange, bottom half in the deep shade: reads as a
+    // light-to-shadow gradient without a per-character color ramp.
+    const half = Math.ceil(logoLines.length / 2);
+    const logo = logoLines.map((line, i) => paint(i < half ? BRAND_ORANGE : BRAND_DEEP, line, colorOn));
+    if (!wide) logo.push(paint(BRAND_ORANGE, 'M E T H O D', colorOn));
+
+    const lines = [...logo, ''];
+    const versionTag = version ? color.dim(`v${version}`) : '';
+    lines.push(`${color.white(t(lang, 'tagline'))}  ${versionTag}`.trimEnd());
+
+    if (steps) {
+      lines.push('', `${color.bold(t(lang, 'whatHappens'))}  ${color.dim(`(${t(lang, 'duration')})`)}`);
+      for (const [i, name] of t(lang, 'stepNames').entries()) {
+        lines.push(`${paint(BRAND_ORANGE, String(i + 1), colorOn)} ▸ ${name}`);
+      }
+    }
+
+    lines.push('', color.dim('© Wizz! comms.  ·  method.wizzcomms.com'));
+
+    // A terminal that reports 0 columns (some ptys, expect, CI with a TTY)
+    // makes clack's box compute a negative width and throw. Print the same
+    // lines without the frame instead of failing the install.
+    if (!process.stdout.columns || process.stdout.columns < 40) {
+      process.stdout.write(`${lines.join('\n')}\n\n`);
+      return;
+    }
+    await prompts.box(lines.join('\n'), '', {
+      contentAlign: steps ? 'left' : 'center',
       rounded: true,
-      formatBorder: color.blue,
+      formatBorder: (text) => paint(BRAND_DEEP, text, colorOn),
     });
   },
 
@@ -50,4 +101,4 @@ const CLIUtils = {
   },
 };
 
-module.exports = { CLIUtils };
+module.exports = { CLIUtils, paint, BRAND_ORANGE, BRAND_DEEP };

package/tools/installer/commands/catalog.js

@@ -0,0 +1,87 @@
+const path = require('node:path');
+const os = require('node:os');
+const fs = require('node:fs');
+const { getProjectRoot } = require('../project-root');
+const { loadYamlCached } = require('../core/yaml-cache');
+const { AREA_LABELS, cliBadges, cliDescription } = require('../guided/labels');
+const { normalizeLang, t } = require('../guided/messages');
+const { paint, BRAND_ORANGE } = require('../banner');
+
+const SKILL_DIRS = ['.claude/skills', '.agents/skills'];
+
+/**
+ * Whether a skill folder exists in the project or in the global Claude
+ * skills folder. Only a hint for the ✓ mark; nothing depends on it.
+ */
+function isSkillInstalled(id, projectDir, home) {
+  const places = [...SKILL_DIRS.map((dir) => path.join(projectDir, dir, id)), path.join(home, '.claude', 'skills', id)];
+  return places.some((place) => fs.existsSync(place));
+}
+
+/** First sentence of a registry `when:`, cut to fit one terminal line. */
+function shortWhen(when, max = 90) {
+  const first = String(when || '').split(/(?<=[.!?])\s/)[0];
+  return first.length > max ? `${first.slice(0, max - 1)}…` : first;
+}
+
+/**
+ * Render the catalog as plain text lines.
+ * @param {Object} registry - Parsed skills-registry.yaml
+ * @param {Object} opts
+ * @param {'en'|'pt'} opts.lang - Display language
+ * @param {string|null} opts.area - Only this area, or null for all
+ * @param {(id: string) => boolean} opts.installed - Installed check
+ * @param {boolean} opts.color - Whether to paint
+ * @returns {string[]}
+ */
+function renderCatalog(registry, opts) {
+  const { lang, area, installed, color } = opts;
+  const areas = Object.entries(registry.areas || {}).filter(([key]) => !area || key === area);
+  const lines = [];
+  for (const [key, entry] of areas) {
+    const label = AREA_LABELS[key] ? AREA_LABELS[key][lang] : { name: key, help: entry.summary || '' };
+    lines.push('', `${paint(BRAND_ORANGE, `■ ${label.name}`, color)}  (${key}) · ${label.help}`);
+    for (const skill of entry.skills || []) {
+      const mark = installed(skill.id) ? '✓' : ' ';
+      lines.push(`  ${mark} ${skill.id.padEnd(40)} ${shortWhen(skill.when)}`);
+    }
+    for (const cli of entry.clis || []) {
+      const badges = cliBadges(cli, lang);
+      const needs = badges.length > 0 ? ` [${badges.join(', ')}]` : ` [${t(lang, 'free')}]`;
+      lines.push(`  ⌘ ${cli.id.padEnd(40)} ${cliDescription(cli.id, lang)}${needs}`);
+    }
+    for (const mcp of entry.mcps || []) {
+      lines.push(`  ◇ ${mcp.id.padEnd(40)} ${shortWhen(mcp.when)}`);
+    }
+  }
+  return lines;
+}
+
+module.exports = {
+  command: 'catalog',
+  description: 'List every area, skill and tool Wizz Method can install (✓ = installed)',
+  options: [
+    ['--area <area>', 'Only one area, e.g. social or dev'],
+    ['--lang <lang>', 'Language for area names and tool descriptions: en (default) or pt'],
+  ],
+  action: async (options) => {
+    const registry = await loadYamlCached(path.join(getProjectRoot(), 'skills-registry.yaml'));
+    if (options.area && !(registry.areas || {})[options.area]) {
+      process.stderr.write(`Unknown area "${options.area}". Areas: ${Object.keys(registry.areas).join(', ')}\n`);
+      process.exitCode = 1;
+      return;
+    }
+    const projectDir = process.cwd();
+    const home = os.homedir();
+    const lang = normalizeLang(options.lang) || 'en';
+    const lines = renderCatalog(registry, {
+      lang,
+      area: options.area || null,
+      installed: (id) => isSkillInstalled(id, projectDir, home),
+      color: !!process.stdout.isTTY && !process.env.NO_COLOR,
+    });
+    lines.push('', t(lang, 'catalogLegend'), '');
+    process.stdout.write(lines.join('\n'));
+  },
+  renderCatalog,
+};

package/tools/installer/commands/install.js

@@ -47,6 +47,11 @@ module.exports = {
     ['--output-folder <path>', 'Output folder path relative to project root (default: _wizz-output)'],
     ['--custom-source <sources>', 'Comma-separated Git URLs or local paths to install custom modules from'],
     ['-y, --yes', 'Accept all defaults and skip prompts where possible'],
+    ['--lang <lang>', 'Installer language for the guided install: en (default) or pt'],
+    [
+      '--advanced',
+      'Skip the guided install and ask every question: module list, community modules, release channels, artifact folders and the routing meter',
+    ],
     [
       '--channel <channel>',
       'Apply channel (stable|next) to all external modules being installed. --all-stable and --all-next are aliases.',
@@ -171,6 +176,10 @@ module.exports = {
           process.exit(1);
         }
         if (result.success) {
+          if (config.guided) {
+            const { showGuidedOutro } = require('../guided/outro');
+            await showGuidedOutro(config);
+          }
           process.exit(0);
         }
       }

package/tools/installer/guided/detect-tools.js

@@ -0,0 +1,53 @@
+const os = require('node:os');
+const path = require('node:path');
+const fs = require('node:fs');
+
+/**
+ * Signs that an AI tool is present on this machine: a binary on PATH, a
+ * config folder in the home directory or an installed app. Any one is
+ * enough; this only decides which option comes pre-checked, never what
+ * gets installed.
+ */
+const SIGNS = {
+  'claude-code': { bins: ['claude'], homeDirs: ['.claude'], apps: [] },
+  codex: { bins: ['codex'], homeDirs: ['.codex'], apps: [] },
+  cursor: { bins: ['cursor'], homeDirs: ['.cursor'], apps: ['Cursor.app'] },
+  'github-copilot': { bins: [], homeDirs: [], apps: [], vscodeExtension: 'github.copilot' },
+};
+
+function onPath(bin) {
+  const dirs = (process.env.PATH || '').split(path.delimiter).filter(Boolean);
+  const exts = process.platform === 'win32' ? ['.exe', '.cmd', ''] : [''];
+  return dirs.some((dir) => exts.some((ext) => fs.existsSync(path.join(dir, bin + ext))));
+}
+
+function hasVscodeExtension(prefix, home) {
+  const extDir = path.join(home, '.vscode', 'extensions');
+  try {
+    return fs.readdirSync(extDir).some((name) => name.toLowerCase().startsWith(prefix));
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * Which of the preferred AI tools look installed.
+ * @param {Object} [deps] - Injection seam for tests
+ * @param {string} [deps.home] - Home directory
+ * @returns {string[]} Tool ids, e.g. ['claude-code', 'cursor']
+ */
+function detectAiTools(deps = {}) {
+  const home = deps.home || os.homedir();
+  const found = [];
+  for (const [id, sign] of Object.entries(SIGNS)) {
+    const present =
+      sign.bins.some((bin) => onPath(bin)) ||
+      sign.homeDirs.some((dir) => fs.existsSync(path.join(home, dir))) ||
+      sign.apps.some((app) => fs.existsSync(path.join('/Applications', app))) ||
+      (sign.vscodeExtension ? hasVscodeExtension(sign.vscodeExtension, home) : false);
+    if (present) found.push(id);
+  }
+  return found;
+}
+
+module.exports = { detectAiTools };