wizz-method 2.13.0 → 2.15.0

package/THIRD-PARTY-NOTICES.md

@@ -106,12 +106,14 @@ the `<Font>-OFL.txt` file in the same folder.
 - Path: `src/skills-lib/wizz-humanizer/`
 - Origin: [blader/humanizer](https://github.com/blader/humanizer)
 - License: MIT (full text at `src/skills-lib/wizz-humanizer/LICENSE`, copyright (c) 2025 Siqi Chen)
+- Version: 3.1.0, upstream commit `225a6f39` (ported 2026-09-30).
 
 ## wizz-huashu-design
 
 - Path: `src/skills-lib/wizz-huashu-design/`
 - Origin: [alchaincyf/huashu-design](https://github.com/alchaincyf/huashu-design)
 - License: MIT (full text at `src/skills-lib/wizz-huashu-design/LICENSE`, copyright (c) 2026 alchaincyf (花叔))
+- `scripts/html2pptx.js`: clean-room rewrite from upstream commit `0830494e` (2026-09-22). The earlier copy was removed upstream because it derived from proprietary Anthropic code; it was replaced here on 2026-09-30.
 
 ## wizz-react-components (Stitch template)
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "wizz-method",
-  "version": "2.13.0",
+  "version": "2.15.0",
   "description": "Wizz Method: método de agência orientado por IA em PT-BR",
   "keywords": [
     "agile",
@@ -14,6 +14,10 @@
     "wizzcomms"
   ],
   "homepage": "https://method.wizzcomms.com",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/wizzcomms/wizz-method.git"
+  },
   "license": "SEE LICENSE IN LICENSE",
   "author": "Wizz! comms. (wizzcomms)",
   "main": "tools/installer/wizz-cli.js",
@@ -38,7 +42,9 @@
     "removals.txt",
     "THIRD-PARTY-NOTICES.md",
     "SECURITY.md",
-    "tools/fetch-assets.mjs"
+    "tools/fetch-assets.mjs",
+    "!**/__pycache__/**",
+    "!**/*.pyc"
   ],
   "scripts": {
     "docs:build": "node tools/build-docs.mjs",
@@ -60,7 +66,7 @@
     "lint:md": "markdownlint-cli2 \"**/*.md\"",
     "prepare": "command -v husky >/dev/null 2>&1 && husky || exit 0",
     "quality": "npm run format:check && npm run lint && npm run lint:md && npm run docs:build && npm run quality:validate",
-    "quality:validate": "npm test && npm run validate:refs && npm run validate:registry-schema && npm run validate:method-refs && npm run validate:skills && npm run docs:validate-sidebar && npm run validate:generated && npm run eval:routing && npm run eval:output",
+    "quality:validate": "npm test && npm run validate:refs && npm run validate:registry-schema && npm run validate:method-refs && npm run validate:model-ids && npm run validate:skills && npm run docs:validate-sidebar && npm run validate:generated && npm run eval:routing && npm run eval:output",
     "rebundle": "node tools/bundle-web-bundles.js",
     "sync:check": "node tools/sync-check.mjs",
     "sync:global": "node tools/sync-global.mjs",
@@ -115,6 +121,7 @@
     "test:workflow-path-regex": "node test/test-workflow-path-regex.js",
     "validate:generated": "npm run test:dispatch-rule && npm run test:routing-table-refs && npm run test:subagents-parity",
     "validate:method-refs": "node tools/validate-method-refs.js --strict",
+    "validate:model-ids": "node tools/validate-model-ids.mjs",
     "validate:refs": "node tools/validate-file-refs.js --strict",
     "validate:registry-schema": "node tools/validate-registry-schema.js --strict",
     "validate:skills": "node tools/validate-skills.js --strict",

package/skills-registry.yaml

@@ -127,14 +127,14 @@ areas:
       # dentro do `when:` deixa a entrada gulosa e mexe no roteamento).
       - id: wizz-premium-landing-ui-researcher
         door: construcao
-        when: "Projeto NOVO (greenfield): cria landing premium do zero, hero, 3D high-end. Estratégia source-first."
+        when: "Projeto NOVO (greenfield) ou tela inteira refeita: landing premium, hero, 3D high-end, dashboard SaaS ou painel operacional. Estratégia source-first."
         rel:
           after: [wizz-design-needs]
           pairs_with: [wizz-ui-ux-pro-max]
       # Idem: a relação com o mapa vive na aresta `after`, não no `when:`.
       - id: wizz-ui-component-curator
         door: construcao
-        when: "Projeto EXISTENTE: qual componente/efeito adicionar que combina com o estilo atual."
+        when: "Projeto EXISTENTE (site ou painel): qual componente, efeito, hover ou animação de carregamento adicionar que combina com o estilo atual."
         rel:
           after: [wizz-design-needs]
           pairs_with: [wizz-ui-ux-pro-max]
@@ -229,15 +229,15 @@ areas:
         platform: [darwin, linux]
         # O check confere o SHA fixado, não só a existência da pasta: o bundle é
         # copiado (não clonado), então o pin é gravado num marcador no install.
-        check: 'grep -qx 83da59fa78c3eee9e20f515fe75c438bb5166efd "$HOME/.claude/skills/watch/.wizz-pin" 2>/dev/null'
+        check: 'grep -qx 03ceb42f7fa2c4439aca01752118044baabffb8f "$HOME/.claude/skills/watch/.wizz-pin" 2>/dev/null'
         # Pin de supply chain (2026-08-23): clone temporário + checkout do SHA
         # + `skills add` local. Atualizar conscientemente.
-        install: 'd="$(mktemp -d)" && git clone https://github.com/bradautomates/claude-video.git "$d" && git -C "$d" checkout 83da59fa78c3eee9e20f515fe75c438bb5166efd && npx skills add "$d" -g -y --copy && printf "%s\\n" 83da59fa78c3eee9e20f515fe75c438bb5166efd > "$HOME/.claude/skills/watch/.wizz-pin" && rm -rf "$d"'
+        install: 'd="$(mktemp -d)" && git clone https://github.com/bradautomates/claude-video.git "$d" && git -C "$d" checkout 03ceb42f7fa2c4439aca01752118044baabffb8f && npx skills add "$d" -g -y --copy && printf "%s\\n" 03ceb42f7fa2c4439aca01752118044baabffb8f > "$HOME/.claude/skills/watch/.wizz-pin" && rm -rf "$d"'
       - id: get-brolls
-        # Versão que o SKILL.md do upstream declara no SHA pinado abaixo. A
-        # última tag publicada lá é a v2.3.7; o 2.3.8 só existe como HEAD.
+        # Versão que o SKILL.md do upstream declara no SHA pinado abaixo
+        # (tag v2.5.0, 2026-09-19).
         metadata:
-          version: "2.3.8"
+          version: "2.5.0"
         when: "CAPTAR B-roll/insert — em português: 'imagens de apoio', 'cenas de apoio', 'imagem de corte' para Reel, TikTok ou vídeo: acha a fonte LITERAL do que a narração cita (o fato, a pessoa, o produto, a notícia, a tela) em YouTube (yt-dlp, sem API key), Instagram/TikTok (navegador/Playwright, sessão do usuário), Pexels/Pixabay/Wikimedia Commons/NASA ou arquivo local; gera prévia (poster, contact sheet numerado, GIF), monta um Storyboard HTML para REVISÃO HUMANA e entrega o corte com origem/autor/condições de uso registrados. Etapa de CAPTAÇÃO do pipeline de vídeo: enche a timeline de material real antes do corte fino e da montagem. Stock só quando o usuário pedir stock explicitamente — nunca como preenchimento de um beat sem fonte literal."
         not_when:
           - "Analisar/resumir um vídeo que já se tem em mãos: é claude-video."
@@ -255,18 +255,18 @@ areas:
         platform: [darwin]
         # O check confere o SHA fixado, não só a existência da pasta: o bundle é
         # copiado (não clonado), então o pin é gravado num marcador no install.
-        check: 'grep -qx 3d2313b0b856594617371697875ccfd59861c693 "$HOME/.claude/skills/get-brolls/.wizz-pin" 2>/dev/null'
+        check: 'grep -qx d9364053d336ae2c1d71a3c4de796590dece8c53 "$HOME/.claude/skills/get-brolls/.wizz-pin" 2>/dev/null'
         # Pin de supply chain (2026-09-17): clone temporário + checkout do SHA
         # + `skills add` global + o `install.sh` do próprio upstream (cria .venv
-        # e .tools DENTRO da skill: yt-dlp fixado, EJS e Playwright CLI). O
-        # upstream documenta 2.3.8 mas a última tag publicada é v2.3.7, então o
-        # pin é o SHA do HEAD de 2026-09-17 (mesmo caso do apple-design).
+        # e .tools DENTRO da skill: yt-dlp fixado, EJS e Playwright CLI). Desde
+        # 2026-09-30 o pin é o commit da tag oficial v2.5.0 (antes, HEAD de
+        # 2026-09-17, quando ainda não havia tag). install.sh sem mudança.
         # Atualizar conscientemente. O install.sh aborta sozinho se faltar
         # python3/ffmpeg/node 22+; sem pin gravado, o installer volta a oferecer.
         # Escopo GLOBAL (-g) de propósito: a skill guarda .venv/.tools/.env na
         # própria raiz e recebe o projeto por `--project`, então é instalar uma
         # vez e usar em todos — igual hyperframes e claude-video.
-        install: 'd="$(mktemp -d)" && git clone https://github.com/engenheirodevideo/get-brolls.git "$d" && git -C "$d" checkout 3d2313b0b856594617371697875ccfd59861c693 && npx skills add "$d" -g -y --copy && bash "$HOME/.claude/skills/get-brolls/scripts/install.sh" && printf "%s\\n" 3d2313b0b856594617371697875ccfd59861c693 > "$HOME/.claude/skills/get-brolls/.wizz-pin" && rm -rf "$d"'
+        install: 'd="$(mktemp -d)" && git clone https://github.com/engenheirodevideo/get-brolls.git "$d" && git -C "$d" checkout d9364053d336ae2c1d71a3c4de796590dece8c53 && npx skills add "$d" -g -y --copy && bash "$HOME/.claude/skills/get-brolls/scripts/install.sh" && printf "%s\\n" d9364053d336ae2c1d71a3c4de796590dece8c53 > "$HOME/.claude/skills/get-brolls/.wizz-pin" && rm -rf "$d"'
         # Sem drawtext (libfreetype) o contact sheet sai sem número e timecode e
         # o Storyboard degrada EM SILÊNCIO — por isso o probe olha o filtro, não
         # só o binário do ffmpeg. A venv prova que o install.sh chegou ao fim.
@@ -279,9 +279,9 @@ areas:
         platform: darwin-arm64
         # Clone-and-run: o próprio repo responde o SHA, então o check compara com o
         # pin. O install repara um clone existente em vez de falhar no git clone.
-        check: 'test "$(git -C ./buttercut rev-parse HEAD 2>/dev/null)" = f71d9537e2c22c3c4c1c659c4bdfb11e90ccd961'
+        check: 'test "$(git -C ./buttercut rev-parse HEAD 2>/dev/null)" = 3d4cf6b6b6881c6bc2f964e2d311f7688186f79b'
         # Pin de supply chain (2026-08-23): checkout de SHA fixo; atualizar conscientemente.
-        install: "{ [ -d buttercut/.git ] || git clone https://github.com/barefootford/buttercut.git buttercut; } && git -C buttercut fetch --tags origin && git -C buttercut checkout f71d9537e2c22c3c4c1c659c4bdfb11e90ccd961"
+        install: "{ [ -d buttercut/.git ] || git clone https://github.com/barefootford/buttercut.git buttercut; } && git -C buttercut fetch --tags origin && git -C buttercut checkout 3d4cf6b6b6881c6bc2f964e2d311f7688186f79b"
         verify: "command -v ffmpeg >/dev/null 2>&1 && command -v ruby >/dev/null 2>&1 && command -v python3 >/dev/null 2>&1"
       - 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."
@@ -299,8 +299,10 @@ areas:
           after: [voicebox]
           before: [wizz-remotion-best-practices, wizz-video-effects]
         platform: [darwin, linux]
-        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"'
+        # O pip grava o commit instalado no direct_url.json: o check compara com o pin.
+        check: "test -x ./tools/ctc-align/.venv/bin/ctc-forced-aligner && grep -qs 64293cc6d711e57666c4a8b098e9fd93b381fd88 ./tools/ctc-align/.venv/lib/python*/site-packages/ctc_forced_aligner-*.dist-info/direct_url.json"
+        # Pin de supply chain (2026-09-30): commit fixo; atualizar conscientemente.
+        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@64293cc6d711e57666c4a8b098e9fd93b381fd88"'
         verify: "command -v ffmpeg >/dev/null 2>&1 && command -v uv >/dev/null 2>&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')."
@@ -709,7 +711,7 @@ areas:
           pairs_with: [wizz-infrastructure]
         check: "sentry-cli --version"
         # Pin de supply chain (2026-08-25): versão fixa; atualizar conscientemente.
-        install: "npm install -g @sentry/cli@3.6.2"
+        install: "npm install -g @sentry/cli@3.8.0"
       - id: archify
         when: "DESENHAR um diagrama VALIDADO de arquitetura/workflow/sequência/dataflow/estado como HTML+SVG navegável (aceita Mermaid) — no passo 'Renderings & polish' do wizz-architecture, ou quando o usuário pedir um diagrama assim. Protocolo obrigatório validate → deliver → visual-check: nunca declarar sucesso sem ler o JSON do comando. Ele DESENHA o que já foi decidido; a decisão e o porquê continuam no wizz-architecture (memlog, AD-n)."
         not_when:
@@ -766,7 +768,7 @@ areas:
           pairs_with: [wizz-agent-browser]
         check: "agent-browser --version"
         # Pin de supply chain (2026-08-23): versão fixa; atualizar conscientemente.
-        install: "npm install -g agent-browser@0.34.0"
+        install: "npm install -g agent-browser@0.38.1"
       - id: strix
         when: "CONDICIONAL, nunca default — executor de pentest AUTÔNOMO e OFENSIVO (agentes de IA que rodam o app, exploram e VALIDAM vulnerabilidades com PoC real). Complementa security-audit-pentest: aquela skill é a metodologia/checklist humana; o Strix é o executor automatizado. Ferramenta dual-use: SÓ contra alvo próprio ou com AUTORIZAÇÃO ESCRITA do dono do sistema e ESCOPO definido — nunca contra alvo de terceiros sem permissão. Roda SEMPRE dentro do sandbox Docker isolado que a própria ferramenta provê (jamais direto no host). Gate condicional: ofereça apenas mediante confirmação explícita do usuário, com escopo e autorização declarados; jamais acione por padrão silencioso. RETORNO DEFENSIVO OBRIGATÓRIO: o executor (subagente) SEMPRE devolve o achado em formato defensivo — falha, severidade, evidência mínima e correção — nunca payload/exploit cru ou arma pronta; assim o revisor recebe conteúdo defensivo pra corrigir, não instrução de ataque. Precisa de Docker rodando e de uma LLM API key configurada."
         not_when: "Sem alvo próprio ou sem autorização escrita e escopo definido do dono do sistema; nunca acionar por padrão silencioso."
@@ -777,7 +779,7 @@ areas:
         # Pin de supply chain (2026-08-25): versão fixa do pacote pip; o sandbox
         # é a imagem pinada ghcr.io/usestrix/strix-sandbox:1.3.0, puxada no 1º run
         # dentro do Docker isolado. Atualizar conscientemente.
-        install: "pipx install strix-agent==1.5.3"
+        install: "pipx install strix-agent==1.6.2"
         verify: "command -v docker >/dev/null 2>&1 && docker info >/dev/null 2>&1"
 
   analyst:
@@ -931,7 +933,7 @@ mcp_utility:
     server:
       command: npx
       # Pin de supply chain (2026-08-23): versão fixa; atualizar conscientemente.
-      args: ["-y", "@upstash/context7-mcp@4.0.3"]
+      args: ["-y", "@upstash/context7-mcp@4.1.1"]
 
 # ─────────────────────────────────────────────────────────────────────────────
 # CLIs — ferramentas de linha de comando que os agentes chamam direto (não são
@@ -969,17 +971,20 @@ cli_utility:
     # --version` só testava que rodava). Agora `check` volta a ser só
     # presença/versão (roda e imprime o número); a COMPARAÇÃO semver contra
     # min_version é feita pelo installer (detectClis), não em shell.
-    min_version: 0.45.0
+    min_version: 0.50.0
     check: "rtk --version"
-    # Pin de supply chain (2026-08-23): tag v0.45.0 (antes: v0.43.0)
-    # Checksum do install.sh nesta tag (2026-08-23): sha256
+    # Pin de supply chain (2026-09-30): tag v0.50.0 (antes: v0.45.0)
+    # Checksum do install.sh nesta tag (2026-09-30): sha256
     # d6eb73a772903e13ff34ee1be8a8b24e896ba9a978f20d2279a08b4083ea6f77
-    # (install.sh idêntico ao v0.43.0 — mesmo checksum.)
+    # (install.sh idêntico ao v0.43.0 e ao v0.45.0 — mesmo checksum.)
+    # O install.sh baixa a release MAIS NOVA, não a da tag, a menos que
+    # RTK_VERSION esteja setada (achado de 2026-09-30): sem ela o pin da tag
+    # só travava o script, não o binário.
     # (RT1: tag git pode ser movida à força; o checksum trava o conteúdo real
     # que será executado, não só o nome da tag. Verificado com `shasum -c`
     # antes do `sh`; se a tag mudar de conteúdo, o install aborta em vez de
     # rodar script desconhecido.)
-    install: "curl -fsSL https://raw.githubusercontent.com/rtk-ai/rtk/refs/tags/v0.45.0/install.sh -o /tmp/rtk-install-v0.45.0.sh && echo 'd6eb73a772903e13ff34ee1be8a8b24e896ba9a978f20d2279a08b4083ea6f77  /tmp/rtk-install-v0.45.0.sh' | shasum -a 256 -c - && sh /tmp/rtk-install-v0.45.0.sh"
+    install: "curl -fsSL https://raw.githubusercontent.com/rtk-ai/rtk/refs/tags/v0.50.0/install.sh -o /tmp/rtk-install-v0.50.0.sh && echo 'd6eb73a772903e13ff34ee1be8a8b24e896ba9a978f20d2279a08b4083ea6f77  /tmp/rtk-install-v0.50.0.sh' | shasum -a 256 -c - && RTK_VERSION=v0.50.0 sh /tmp/rtk-install-v0.50.0.sh"
 
 # ─────────────────────────────────────────────────────────────────────────────
 # SQUADS — painéis consultivos de personas (rodam via wizz-party-mode).

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

@@ -30,9 +30,10 @@ activation_steps_append = []
 #   - a file reference prefixed with `file:`, e.g. "file:{project-root}/docs/standards.md"
 #     (glob patterns are supported; the file's contents are loaded and treated as facts).
 
-persistent_facts = [
-  "file:{project-root}/**/project-context.md",
-]
+# Empty of project-context by default: repo-wide context belongs in CLAUDE.md/AGENTS.md
+# (the Wizz block imports project-context.md there once per session). Add
+# `file:{project-root}/**/project-context.md` here only to load it on every activation.
+persistent_facts = []
 
 # Scalar: executed when the workflow reaches its terminal stage (Step 6: Research Synthesis),
 # after the domain research document has been saved and the user selects [C] Complete.

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

@@ -30,9 +30,10 @@ activation_steps_append = []
 #   - a file reference prefixed with `file:`, e.g. "file:{project-root}/docs/standards.md"
 #     (glob patterns are supported; the file's contents are loaded and treated as facts).
 
-persistent_facts = [
-  "file:{project-root}/**/project-context.md",
-]
+# Empty of project-context by default: repo-wide context belongs in CLAUDE.md/AGENTS.md
+# (the Wizz block imports project-context.md there once per session). Add
+# `file:{project-root}/**/project-context.md` here only to load it on every activation.
+persistent_facts = []
 
 # Scalar: executed when the workflow reaches its terminal stage (Step 6: Research Completion),
 # after the market research document has been saved and the user selects [C] Complete.

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

@@ -30,8 +30,10 @@ activation_steps_append = []
 #   - a file reference prefixed with `file:`, e.g. "file:{project-root}/docs/standards.md"
 #     (glob patterns are supported; the file's contents are loaded and treated as facts).
 
+# Empty of project-context by default: repo-wide context belongs in CLAUDE.md/AGENTS.md
+# (the Wizz block imports project-context.md there once per session). Add
+# `file:{project-root}/**/project-context.md` here only to load it on every activation.
 persistent_facts = [
-  "file:{project-root}/**/project-context.md",
   "When researching a specific library, framework, or SDK, consult Context7 for current docs and version-specific facts as a preferred source alongside web search: call resolve-library-id with the library name, then query-docs with the returned /org/project id and a specific question. If Context7 is unavailable, note the gap and proceed with web research.",
 ]
 

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

@@ -35,8 +35,10 @@ activation_steps_append = []
 #   - a file reference prefixed with `file:`, e.g. "file:{project-root}/docs/standards.md"
 #     (glob patterns are supported; the file's contents are loaded and treated as facts).
 
+# Empty of project-context by default: repo-wide context belongs in CLAUDE.md/AGENTS.md
+# (the Wizz block imports project-context.md there once per session). Add
+# `file:{project-root}/**/project-context.md` here only to load it on every activation.
 persistent_facts = [
-  "file:{project-root}/**/project-context.md",
   "FEATURE: the SessionStart hook already resolves the active feature from the git branch and injects 'FEATURE ATIVA: <slug>'. If it exists, save EVERY planning and implementation artifact in the subfolder with that name ({planning_artifacts}/{active_feature}/, {implementation_artifacts}/{active_feature}/) and write the slug to active_feature in {project-root}/_wizz/bmm/config.yaml on first write, announcing it in ONE line. Memory saved in this session carries the same slug as its theme. With no feature resolved, write to the root folders. NEVER ask the user for the feature: invoke wizz-set-feature only if they ask to switch, or if there are two open features and the request does not decide between them.",
 ]
 

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

@@ -36,9 +36,10 @@ activation_steps_append = []
 #   - a file reference prefixed with `file:`, e.g. "file:{project-root}/docs/standards.md"
 #     (glob patterns are supported; the file's contents are loaded and treated as facts).
 
-persistent_facts = [
-  "file:{project-root}/**/project-context.md",
-]
+# Empty of project-context by default: repo-wide context belongs in CLAUDE.md/AGENTS.md
+# (the Wizz block imports project-context.md there once per session). Add
+# `file:{project-root}/**/project-context.md` here only to load it on every activation.
+persistent_facts = []
 
 role = "Capture and curate project knowledge so humans and future LLM agents stay in sync during the Wizz Method analysis phase."
 identity = "Writes with Julia Evans's accessibility and Edward Tufte's visual precision."

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

@@ -30,9 +30,10 @@ activation_steps_append = []
 #   - a file reference prefixed with `file:`, e.g. "file:{project-root}/docs/standards.md"
 #     (glob patterns are supported; the file's contents are loaded and treated as facts).
 
-persistent_facts = [
-  "file:{project-root}/**/project-context.md",
-]
+# Empty of project-context by default: repo-wide context belongs in CLAUDE.md/AGENTS.md
+# (the Wizz block imports project-context.md there once per session). Add
+# `file:{project-root}/**/project-context.md` here only to load it on every activation.
+persistent_facts = []
 
 # Scalar: executed when the workflow reaches its terminal stage, after
 # the main output has been delivered. Override wins. Leave empty for

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

@@ -30,9 +30,10 @@ activation_steps_append = []
 #   - a file reference prefixed with `file:`, e.g. "file:{project-root}/docs/standards.md"
 #     (glob patterns are supported; the file's contents are loaded and treated as facts).
 
-persistent_facts = [
-  "file:{project-root}/**/project-context.md",
-]
+# Empty of project-context by default: repo-wide context belongs in CLAUDE.md/AGENTS.md
+# (the Wizz block imports project-context.md there once per session). Add
+# `file:{project-root}/**/project-context.md` here only to load it on every activation.
+persistent_facts = []
 
 # Scalar: executed when the workflow reaches its terminal stage (Stage 5: The Verdict),
 # after the PRFAQ and distillate have been delivered. Override wins. Leave empty for

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

@@ -24,14 +24,13 @@ activation_steps_append = []
 # Each entry is either a literal sentence, a skill prefixed with `skill:`, or a `file:`-prefixed path/glob
 # whose contents are loaded as facts.
 #
-# Default loads project-context.md if wizz-generate-project-context has produced one — this gives
-# the facilitator persistent awareness of the project's tech, domain, and constraints without
-# re-asking. Common opt-ins (set in team/user override TOML):
+# Common opt-ins (set in team/user override TOML):
 #   "skill:acme-co:terms-and-conditions"                                      # a skill that contains some relevant info
 #   "Elvis has left the building"                                             # generic agent instruction
-persistent_facts = [
-  "file:{project-root}/**/project-context.md",
-]
+# Empty of project-context by default: repo-wide context belongs in CLAUDE.md/AGENTS.md
+# (the Wizz block imports project-context.md there once per session). Add
+# `file:{project-root}/**/project-context.md` here only to load it on every activation.
+persistent_facts = []
 
 # Executed when the workflow completes (after the user has been told the
 # brief is ready). Accepts either a string scalar (single instruction)

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

@@ -35,8 +35,10 @@ activation_steps_append = []
 #   - a file reference prefixed with `file:`, e.g. "file:{project-root}/docs/standards.md"
 #     (glob patterns are supported; the file's contents are loaded and treated as facts).
 
+# Empty of project-context by default: repo-wide context belongs in CLAUDE.md/AGENTS.md
+# (the Wizz block imports project-context.md there once per session). Add
+# `file:{project-root}/**/project-context.md` here only to load it on every activation.
 persistent_facts = [
-  "file:{project-root}/**/project-context.md",
   "FEATURE: the SessionStart hook already resolves the active feature from the git branch and injects 'FEATURE ATIVA: <slug>'. If it exists, save EVERY planning and implementation artifact in the subfolder with that name ({planning_artifacts}/{active_feature}/, {implementation_artifacts}/{active_feature}/) and write the slug to active_feature in {project-root}/_wizz/bmm/config.yaml on first write, announcing it in ONE line. Memory saved in this session carries the same slug as its theme. With no feature resolved, write to the root folders. NEVER ask the user for the feature: invoke wizz-set-feature only if they ask to switch, or if there are two open features and the request does not decide between them.",
 ]
 

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

@@ -35,8 +35,10 @@ activation_steps_append = []
 #   - a file reference prefixed with `file:`, e.g. "file:{project-root}/docs/standards.md"
 #     (glob patterns are supported; the file's contents are loaded and treated as facts).
 
+# Empty of project-context by default: repo-wide context belongs in CLAUDE.md/AGENTS.md
+# (the Wizz block imports project-context.md there once per session). Add
+# `file:{project-root}/**/project-context.md` here only to load it on every activation.
 persistent_facts = [
-  "file:{project-root}/**/project-context.md",
   "FEATURE: the SessionStart hook already resolves the active feature from the git branch and injects 'FEATURE ATIVA: <slug>'. If it exists, save EVERY planning and implementation artifact in the subfolder with that name ({planning_artifacts}/{active_feature}/, {implementation_artifacts}/{active_feature}/) and write the slug to active_feature in {project-root}/_wizz/bmm/config.yaml on first write, announcing it in ONE line. Memory saved in this session carries the same slug as its theme. With no feature resolved, write to the root folders. NEVER ask the user for the feature: invoke wizz-set-feature only if they ask to switch, or if there are two open features and the request does not decide between them.",
 ]
 

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

@@ -30,9 +30,10 @@ activation_steps_append = []
 #   - a file reference prefixed with `file:`, e.g. "file:{project-root}/docs/standards.md"
 #     (glob patterns are supported; the file's contents are loaded and treated as facts).
 
-persistent_facts = [
-  "file:{project-root}/**/project-context.md",
-]
+# Empty of project-context by default: repo-wide context belongs in CLAUDE.md/AGENTS.md
+# (the Wizz block imports project-context.md there once per session). Add
+# `file:{project-root}/**/project-context.md` here only to load it on every activation.
+persistent_facts = []
 
 # Scalar: executed when the workflow reaches Step 12 (Workflow Completion),
 # after the PRD is finalized and workflow status is updated. Override wins.

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

@@ -30,9 +30,10 @@ activation_steps_append = []
 #   - a file reference prefixed with `file:`, e.g. "file:{project-root}/docs/standards.md"
 #     (glob patterns are supported; the file's contents are loaded and treated as facts).
 
-persistent_facts = [
-  "file:{project-root}/**/project-context.md",
-]
+# Empty of project-context by default: repo-wide context belongs in CLAUDE.md/AGENTS.md
+# (the Wizz block imports project-context.md there once per session). Add
+# `file:{project-root}/**/project-context.md` here only to load it on every activation.
+persistent_facts = []
 
 # Scalar: executed when the workflow reaches Step E-4 (Complete & Validate) and the
 # user exits via [S] Summary or [X] Exit — not on [V] Validate (which chains to

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

@@ -24,14 +24,13 @@ activation_steps_append = []
 # Each entry is either a literal sentence, a skill prefixed with `skill:`, or a `file:`-prefixed path/glob
 # whose contents are loaded as facts.
 #
-# Default loads project-context.md if wizz-generate-project-context has produced one — this gives
-# the facilitator persistent awareness of the project's tech, domain, and constraints without
-# re-asking. Common opt-ins (set in team/user override TOML):
+# Common opt-ins (set in team/user override TOML):
 #   "skill:acme-co:terms-and-conditions"                                      # a skill that contains some relevant info
 #   "Investor PRDs must include a market sizing section."                    # generic agent instruction
-persistent_facts = [
-  "file:{project-root}/**/project-context.md",
-]
+# Empty of project-context by default: repo-wide context belongs in CLAUDE.md/AGENTS.md
+# (the Wizz block imports project-context.md there once per session). Add
+# `file:{project-root}/**/project-context.md` here only to load it on every activation.
+persistent_facts = []
 
 # Executed when the workflow completes (after the user has been told the
 # PRD is ready). Accepts either a string scalar (single instruction)

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

@@ -14,9 +14,10 @@ activation_steps_append = []
 
 # Persistent facts loaded at activation and kept in mind for the run.
 # Entries: literal sentence, `skill:NAME`, or `file:PATH` (glob ok).
-persistent_facts = [
-  "file:{project-root}/**/project-context.md",
-]
+# Empty of project-context by default: repo-wide context belongs in CLAUDE.md/AGENTS.md
+# (the Wizz block imports project-context.md there once per session). Add
+# `file:{project-root}/**/project-context.md` here only to load it on every activation.
+persistent_facts = []
 
 # Runs at workflow completion. String or array of instructions.
 on_complete = ""

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

@@ -30,9 +30,10 @@ activation_steps_append = []
 #   - a file reference prefixed with `file:`, e.g. "file:{project-root}/docs/standards.md"
 #     (glob patterns are supported; the file's contents are loaded and treated as facts).
 
-persistent_facts = [
-  "file:{project-root}/**/project-context.md",
-]
+# Empty of project-context by default: repo-wide context belongs in CLAUDE.md/AGENTS.md
+# (the Wizz block imports project-context.md there once per session). Add
+# `file:{project-root}/**/project-context.md` here only to load it on every activation.
+persistent_facts = []
 
 # Scalar: executed when the workflow reaches Step 13 (Validation Report Complete) and
 # the user exits via [X] Exit — not on [E] Use Edit Workflow (which chains to

package/src/bmm-skills/3-solutioning/wizz-agent-architect/customize.toml

@@ -35,8 +35,10 @@ activation_steps_append = []
 #   - a file reference prefixed with `file:`, e.g. "file:{project-root}/docs/standards.md"
 #     (glob patterns are supported; the file's contents are loaded and treated as facts).
 
+# Empty of project-context by default: repo-wide context belongs in CLAUDE.md/AGENTS.md
+# (the Wizz block imports project-context.md there once per session). Add
+# `file:{project-root}/**/project-context.md` here only to load it on every activation.
 persistent_facts = [
-  "file:{project-root}/**/project-context.md",
   "FEATURE: the SessionStart hook already resolves the active feature from the git branch and injects 'FEATURE ATIVA: <slug>'. If it exists, save EVERY planning and implementation artifact in the subfolder with that name ({planning_artifacts}/{active_feature}/, {implementation_artifacts}/{active_feature}/) and write the slug to active_feature in {project-root}/_wizz/bmm/config.yaml on first write, announcing it in ONE line. Memory saved in this session carries the same slug as its theme. With no feature resolved, write to the root folders. NEVER ask the user for the feature: invoke wizz-set-feature only if they ask to switch, or if there are two open features and the request does not decide between them.",
 ]
 

package/src/bmm-skills/3-solutioning/wizz-architecture/customize.toml

@@ -24,14 +24,13 @@ activation_steps_append = []
 # Each entry is either a literal sentence, a skill prefixed with `skill:`, or a `file:`-prefixed
 # path/glob whose contents are loaded as facts.
 #
-# Default loads project-context.md if wizz-generate-project-context produced one — giving the
-# architect persistent awareness of the project's tech, domain, and conventions (load-bearing
-# for brownfield). Common opt-ins (set in team/user override TOML):
+# Common opt-ins (set in team/user override TOML):
 #   "Our org is AWS-only -- do not propose GCP or Azure."
 #   "file:{project-root}/docs/engineering-standards.md"
-persistent_facts = [
-  "file:{project-root}/**/project-context.md",
-]
+# Empty of project-context by default: repo-wide context belongs in CLAUDE.md/AGENTS.md
+# (the Wizz block imports project-context.md there once per session). Add
+# `file:{project-root}/**/project-context.md` here only to load it on every activation.
+persistent_facts = []
 
 # Executed when the workflow completes (after the spine is final and the user has been told).
 # String scalar (single instruction) or array of instructions executed in order. Empty for none.

package/src/bmm-skills/3-solutioning/wizz-check-implementation-readiness/customize.toml

@@ -30,9 +30,10 @@ activation_steps_append = []
 #   - a file reference prefixed with `file:`, e.g. "file:{project-root}/docs/standards.md"
 #     (glob patterns are supported; the file's contents are loaded and treated as facts).
 
-persistent_facts = [
-  "file:{project-root}/**/project-context.md",
-]
+# Empty of project-context by default: repo-wide context belongs in CLAUDE.md/AGENTS.md
+# (the Wizz block imports project-context.md there once per session). Add
+# `file:{project-root}/**/project-context.md` here only to load it on every activation.
+persistent_facts = []
 
 # Scalar: executed when the workflow reaches Step 6 (Final Assessment),
 # after the readiness report has been saved and presented. Override wins.

package/src/bmm-skills/3-solutioning/wizz-create-architecture/customize.toml

@@ -30,9 +30,10 @@ activation_steps_append = []
 #   - a file reference prefixed with `file:`, e.g. "file:{project-root}/docs/standards.md"
 #     (glob patterns are supported; the file's contents are loaded and treated as facts).
 
-persistent_facts = [
-  "file:{project-root}/**/project-context.md",
-]
+# Empty of project-context by default: repo-wide context belongs in CLAUDE.md/AGENTS.md
+# (the Wizz block imports project-context.md there once per session). Add
+# `file:{project-root}/**/project-context.md` here only to load it on every activation.
+persistent_facts = []
 
 # Scalar: executed when the workflow reaches Step 8 (Architecture Completion & Handoff),
 # after the architecture document frontmatter is updated and next-steps guidance is given.

package/src/bmm-skills/3-solutioning/wizz-create-epics-and-stories/customize.toml

@@ -30,9 +30,10 @@ activation_steps_append = []
 #   - a file reference prefixed with `file:`, e.g. "file:{project-root}/docs/standards.md"
 #     (glob patterns are supported; the file's contents are loaded and treated as facts).
 
-persistent_facts = [
-  "file:{project-root}/**/project-context.md",
-]
+# Empty of project-context by default: repo-wide context belongs in CLAUDE.md/AGENTS.md
+# (the Wizz block imports project-context.md there once per session). Add
+# `file:{project-root}/**/project-context.md` here only to load it on every activation.
+persistent_facts = []
 
 # Scalar: executed when the workflow reaches Step 4 (Final Validation) and the
 # user confirms [C] Complete — after the epics.md is saved and wizz-help is invoked.

package/src/bmm-skills/3-solutioning/wizz-generate-project-context/steps/step-03-complete.md

@@ -207,6 +207,13 @@ stage: '{{project_stage}}' # prototype|mvp|production|maintenance
 **Add Usage Section:**
 Append the usage guidelines from step 3 to complete the document.
 
+**Wire it into the Wizz block:** agents no longer load this file on every skill activation; the Wizz block in `CLAUDE.md` / `AGENTS.md` loads it once per session. For each of those files at `{project-root}` that has the `<!-- wizz:begin -->` block and does not yet mention this file, add a line right before `<!-- wizz:end -->`, using the path relative to `{project-root}`:
+
+- `CLAUDE.md`: `@<relative path>` on its own line (Claude Code imports it).
+- `AGENTS.md`: ``- Contexto do projeto: leia `<relative path>` antes de implementar (regras de stack e padrões).``
+
+The next `wizz install` rewrites the block with the same line, so the edit is stable. If neither file has the block, tell the user to run `npx wizz-method install` to add it.
+
 ### 6. Completion Validation
 
 Final checks before completion:

package/src/bmm-skills/4-implementation/wizz-agent-dev/customize.toml

@@ -35,8 +35,10 @@ activation_steps_append = []
 #   - a file reference prefixed with `file:`, e.g. "file:{project-root}/docs/standards.md"
 #     (glob patterns are supported; the file's contents are loaded and treated as facts).
 
+# Empty of project-context by default: repo-wide context belongs in CLAUDE.md/AGENTS.md
+# (the Wizz block imports project-context.md there once per session). Add
+# `file:{project-root}/**/project-context.md` here only to load it on every activation.
 persistent_facts = [
-  "file:{project-root}/**/project-context.md",
   "FEATURE: the SessionStart hook already resolves the active feature from the git branch and injects 'FEATURE ATIVA: <slug>'. If it exists, save EVERY planning and implementation artifact in the subfolder with that name ({planning_artifacts}/{active_feature}/, {implementation_artifacts}/{active_feature}/) and write the slug to active_feature in {project-root}/_wizz/bmm/config.yaml on first write, announcing it in ONE line. Memory saved in this session carries the same slug as its theme. With no feature resolved, write to the root folders. NEVER ask the user for the feature: invoke wizz-set-feature only if they ask to switch, or if there are two open features and the request does not decide between them.",
   "When implementing against a library or framework, consult Context7 for current docs, APIs, and version-specific syntax before relying on training data or web search: call resolve-library-id with the library name, then query-docs with the returned /org/project id and a specific question. If Context7 is unavailable, tell the user once that they can enable it with `npx ctx7 setup`, then fall back to web research.",
 ]

package/src/bmm-skills/4-implementation/wizz-checkpoint-preview/customize.toml

@@ -30,9 +30,10 @@ activation_steps_append = []
 #   - a file reference prefixed with `file:`, e.g. "file:{project-root}/docs/standards.md"
 #     (glob patterns are supported; the file's contents are loaded and treated as facts).
 
-persistent_facts = [
-  "file:{project-root}/**/project-context.md",
-]
+# Empty of project-context by default: repo-wide context belongs in CLAUDE.md/AGENTS.md
+# (the Wizz block imports project-context.md there once per session). Add
+# `file:{project-root}/**/project-context.md` here only to load it on every activation.
+persistent_facts = []
 
 # Scalar: executed when the workflow reaches its final step,
 # after the review decision (approve/rework/discuss) is made. Override wins.

package/src/bmm-skills/4-implementation/wizz-code-review/customize.toml

@@ -30,9 +30,10 @@ activation_steps_append = []
 #   - a file reference prefixed with `file:`, e.g. "file:{project-root}/docs/standards.md"
 #     (glob patterns are supported; the file's contents are loaded and treated as facts).
 
-persistent_facts = [
-  "file:{project-root}/**/project-context.md",
-]
+# Empty of project-context by default: repo-wide context belongs in CLAUDE.md/AGENTS.md
+# (the Wizz block imports project-context.md there once per session). Add
+# `file:{project-root}/**/project-context.md` here only to load it on every activation.
+persistent_facts = []
 
 # Scalar: executed when the workflow reaches its final step,
 # after review findings are presented and sprint status is synced. Override wins.