wizz-method 1.1.0 → 1.2.0

package/package.json

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

package/skills-registry.yaml

@@ -58,6 +58,24 @@ areas:
           args: ["-y", "@21st-dev/magic"]
           env:
             API_KEY: "${MAGIC_API_KEY}"
+    clis:
+      - id: hyperframes
+        when: "Renderizar vídeo a partir de HTML/CSS/animação (HTML→MP4, agent-native, 20+ skills). Alternativa HTML-nativa ao Remotion (que é React). Precisa ffmpeg + Node 22 + Chrome headless."
+        check: "npx --yes hyperframes --version"
+        install: "npx skills add heygen-com/hyperframes"
+      - id: claude-video
+        when: "Analisar/entender vídeo EXISTENTE: baixa, extrai frames e transcreve para resumir, achar momentos ou diagnosticar footage. NÃO cria vídeo. Precisa ffmpeg + yt-dlp (+ Groq/OpenAI p/ transcrição sem legenda)."
+        check: "test -d $HOME/.claude/skills/watch"
+        install: "npx skills add bradautomates/claude-video"
+      - id: buttercut
+        when: "EDITAR vídeo por IA: cortes, selects, cenas, roughcut via XML/FFmpeg. Sugerir quando o pedido for editar/cortar vídeo. Clone-and-run no PROJETO (não é skill add), pesado: Ruby + Python + FFmpeg + WhisperX. AVISOS: ~GB de modelos (WhisperX), build demorado, só Apple Silicon."
+        platform: darwin-arm64
+        check: "test -d ./buttercut"
+        install: "git clone https://github.com/barefootford/buttercut.git"
+      - id: voicebox
+        when: "Voz/TTS/clonagem de voz local para narração/VO de vídeo (7 engines TTS + Whisper STT). App desktop que expõe endpoint MCP local em runtime. Clone-and-run no projeto."
+        check: "test -d ./voicebox"
+        install: "git clone https://github.com/jamiepine/voicebox.git"
     references:
       - "references/premium-agency-rules.md (regras $150k-tier, importadas por impeccable/huashu no modo high-end)"
 
@@ -92,6 +110,11 @@ areas:
         when: "Gerar páginas em escala pra atacar muitas keywords."
       - id: site-architecture
         when: "Arquitetura de site / topic clusters / estrutura de URLs."
+    clis:
+      - id: distribb
+        when: "EXECUTAR distribuição de SEO: publicar artigos + construir backlinks pela rede da Distribb, conectar Google Search Console, autopublicar notícias. Complementa (não duplica) as skills de SEO que só geram/auditam. Requer Distribb API + GSC (+ DataForSEO/Ahrefs no plano free)."
+        check: "ls $HOME/.claude/skills 2>/dev/null | grep -qi distribb"
+        install: "npx skills add Bomx/distribb-skill"
 
   growth:
     agent: wizz-growth
@@ -137,6 +160,12 @@ areas:
         when: "Montar A/B test / experimento de conversão."
       - id: analytics-tracking
         when: "Setar/auditar tracking e medição (GA4, GTM, eventos, UTM, atribuição)."
+    mcps:
+      - id: scrapling
+        when: "Scraping/crawl web para pesquisa de mercado, prospecção de leads e inteligência competitiva. Bypass anti-bot (Cloudflare), parsing adaptativo, spider concorrente. Requer: pip install 'scrapling[ai]' && scrapling install."
+        server:
+          command: scrapling
+          args: ["mcp"]
 
   ads:
     agent: wizz-ads
@@ -156,6 +185,11 @@ areas:
           args: ["-y", "mcp-meta-ads"]
           env:
             META_ACCESS_TOKEN: "${META_ACCESS_TOKEN}"
+    clis:
+      - id: arcads
+        when: "GERAR vídeo-ad e imagem por IA (Seedance/Sora/Veo/Kling/OmniHuman + Nano Banana) e publicar como Meta ad. Clone-and-run no projeto: git clone + ./scripts/setup.sh; precisa Python 3.10+ e ARCADS API key em .env (META_ACCESS_TOKEN opcional p/ publicar)."
+        check: "test -d ./arcads-claude-code"
+        install: "git clone https://github.com/krusemediallc/arcads-claude-code.git"
 
   architect:
     agent: wizz-agent-architect

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

@@ -73,6 +73,7 @@ O roteamento tem duas fontes que você lê juntas, e NENHUMA é uma tabela fixa
    - `areas:` — `agent` (deve casar com o do menu) e `skills:` (cada uma com `id` + `when` curto). Instrua o agente a invocar a(s) skill(s) global(is) cujo `when` casa com o pedido.
    - `utility:` — skills cross-cutting (graphify, find-skills, enhance-prompt, wizz-router). Ofereça quando couber.
    - `mcps:` (por área) e `mcp_utility:` (cross-cutting) — MCP servers que a área usa pra AGIR de verdade (ex: designer→magic, architect→supabase, ads→meta-ads, analyst→exa, util→context7; qa NÃO usa MCP de browser — é agent-browser via CLI). Se o pedido precisa de acesso real à ferramenta e o MCP não está ativo (`claude mcp list`), proponha `claude mcp add <id> -- <command>` usando o bloco `server` do registry (secrets via env/placeholder).
+   - `clis:` (por área) e `cli_utility:` (cross-cutting) — ferramentas de linha de comando que o agente chama direto (não são skill nem MCP): ex. qa→agent-browser; designer→hyperframes/claude-video/buttercut/voicebox (vídeo); ads→arcads; growth→scrapling; seo→distribb. Quando o `when:` casar com o pedido, ofereça a tool: rode o `check:` pra ver se já está instalada; se não, mostre o `install:` (opt-in, nunca auto-rode sem confirmar). Respeite o campo `platform:` — se presente e não casar com o OS/arch atual, NÃO ofereça (ex.: `buttercut` é `darwin-arm64`, só Apple Silicon). Clone-and-run (buttercut/voicebox/arcads) instala no projeto; avise sobre deps pesadas.
    - `squads:` — painéis consultivos (rodam via `wizz-party-mode`). Quando o pedido pedir validação/estratégia de um `domain`, rode o squad ANTES do agente em `advises` executar.
 
 Em resumo: **menu escolhe o agente, registry escolhe a(s) skill(s) e os squads.** Os papéis de dev/produto reusam os agentes WIZZ; os de agência são os `wizz-*`. Não memorize nomes de agente aqui — eles vêm do menu e do campo `agent:` do registry.

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

@@ -140,7 +140,12 @@ Se nenhuma skill/MCP instalado mapear o pedido, primeiro **classifique o que fal
 | Qualidade de design, anti-slop, gosto visual, estética, olhar crítico | `taste-skill` (se instalada) | 1 |
 | Regras de frontend, código UI determinístico, 44 regras, audit de frontend | `impeccable` (se instalada) | 2 |
 | Design system HTML-native, filosofia visual, review 5-dim, export MP4 | `huashu-design` (se instalada) | 2 |
-| Animação, motion, vídeo, Remotion, Three.js, 3D, WebGL | `motion-3d-director` + `remotion-best-practices` | 1 |
+| Animação, motion, vídeo programático em código, Remotion, Three.js, 3D, WebGL | `motion-3d-director` + `remotion-best-practices` | 1 |
+| Renderizar vídeo de HTML/CSS (HTML→MP4, agent-native) | CLI `hyperframes` (registry designer; `npx skills add heygen-com/hyperframes`) | 2 |
+| **Editar/cortar vídeo** (cortes, selects, roughcut) | CLI `buttercut` (registry designer; **só Apple Silicon**, clone-and-run no projeto, deps pesadas) | 1 |
+| Gerar vídeo-ad/imagem por IA (Sora/Veo/Kling) + publicar Meta | CLI `arcads` (registry `ads`; git clone + Arcads API key) | 1 |
+| Analisar/entender vídeo existente (frames + transcrição) | CLI `claude-video` (registry designer; `npx skills add bradautomates/claude-video`) | 2 |
+| Narração / voz / TTS / clonagem de voz para vídeo | CLI `voicebox` (registry designer; app local com endpoint MCP) | 2 |
 | Componentes prontos via Magic (21st.dev) | Use diretamente: `mcp__magic__21st_magic_component_inspiration` / `mcp__magic__21st_magic_component_builder` | 1 |
 
 ### Área de Marketing / Growth

package/tools/installer/modules/cli-config.js

@@ -46,17 +46,45 @@ async function defaultExec(command, { timeoutMs = 300_000 } = {}) {
   }
 }
 
+/**
+ * Current "<platform>-<arch>" tag (e.g. "darwin-arm64"). Injectable for tests.
+ * @returns {string}
+ */
+function currentPlatformTag() {
+  return `${process.platform}-${process.arch}`;
+}
+
+/**
+ * A CLI entry may declare `platform:` to gate it to specific OS/arch combos —
+ * e.g. a tool that only builds on Apple Silicon. Accepts a string or array of
+ * tokens matched against the current tag: a full "darwin-arm64", a bare OS
+ * ("darwin"), or a bare arch ("arm64"). No `platform` field => runs everywhere.
+ * @param {{platform?: string|string[]}} cli
+ * @param {string} tag - Current "<platform>-<arch>" tag
+ * @returns {boolean}
+ */
+function matchesPlatform(cli, tag) {
+  const p = cli && cli.platform;
+  if (!p) return true;
+  const wanted = Array.isArray(p) ? p : [p];
+  const [os, arch] = tag.split('-');
+  return wanted.some((w) => w === tag || w === os || w === arch);
+}
+
 /**
  * Resolve the recommended CLI entries for the chosen areas, deduped by id.
  * Empty / undefined / containing 'all' means every area. The cross-cutting
  * `cli_utility:` tools are always included. Entries missing `id` or `install`
- * are dropped — a CLI we cannot install is not actionable.
+ * are dropped — a CLI we cannot install is not actionable. Entries whose
+ * `platform:` gate does not match the current OS/arch are dropped too, so a
+ * Mac-only tool is never even suggested on Linux/Windows.
  *
  * @param {Object} registry - Parsed skills-registry.yaml
  * @param {string[]} [selectedAreas] - Area keys to resolve
- * @returns {Array<{id: string, when: string, check: string, install: string, areas: string[]}>}
+ * @param {string} [platformTag] - Current "<platform>-<arch>" (injectable for tests)
+ * @returns {Array<{id: string, when: string, check: string, install: string, platform: (string|string[]|undefined), areas: string[]}>}
  */
-function resolveClis(registry, selectedAreas) {
+function resolveClis(registry, selectedAreas, platformTag = currentPlatformTag()) {
   const byId = new Map();
   const areas = (registry && registry.areas) || {};
   const wantAll = !selectedAreas || selectedAreas.length === 0 || selectedAreas.includes('all');
@@ -64,6 +92,7 @@ function resolveClis(registry, selectedAreas) {
 
   const add = (cli, areaKey) => {
     if (!cli || !cli.id || !cli.install) return; // not actionable without an install command
+    if (!matchesPlatform(cli, platformTag)) return; // gated to another OS/arch
     const existing = byId.get(cli.id);
     if (existing) {
       if (areaKey && !existing.areas.includes(areaKey)) existing.areas.push(areaKey);
@@ -74,6 +103,7 @@ function resolveClis(registry, selectedAreas) {
       when: cli.when || '',
       check: cli.check || '',
       install: cli.install,
+      platform: cli.platform,
       areas: areaKey ? [areaKey] : [],
     });
   };
@@ -142,4 +172,4 @@ async function installClis({ clis, exec = defaultExec }) {
   return { installed, failed };
 }
 
-module.exports = { resolveClis, renderInstallCommand, detectClis, installClis, defaultExec };
+module.exports = { resolveClis, renderInstallCommand, detectClis, installClis, defaultExec, matchesPlatform, currentPlatformTag };