wizz-method 1.17.0 → 1.18.1

package/src/skills-lib/cerebro/references/comandos-pesquisa-e-memoria.md

@@ -0,0 +1,96 @@
+# Comandos de Pesquisa e Memoria: /prospect, /memoria
+
+Carregue este arquivo ao executar `/prospect` ou `/memoria`. Antes de tudo, releia a REGRA DE OURO e a seção Vault no SKILL.md principal — esses comandos dependem delas.
+
+## /prospect
+
+**Objetivo:** pesquisar e registrar prospect.
+
+**Passos:**
+1. Receber nome/empresa + objetivo (tudo de uma vez)
+2. Pesquisar via web search (setor, presença digital, dores, oportunidades)
+3. Write direto em `_prospects/YYYY-MM-DD-[slug].md`
+4. Resumo executivo para o usuário (não precisa estar no arquivo)
+
+**Template `_prospects/YYYY-MM-DD-[slug].md`:**
+```markdown
+# [Nome / Empresa]
+> Data: [data] | Objetivo: [tipo] | Status: pesquisado
+
+## Perfil
+- Setor / Tamanho / Produto / Público-alvo
+
+## Presença digital
+- Site / Redes / Ads ativos
+
+## Oportunidade e ângulo de abordagem
+[o que oferecer e como entrar]
+
+## Próximo passo
+- [ ] [ação]
+```
+
+## /memoria
+
+**Objetivo:** ler (e alimentar) a auto-memória do projeto a partir de **qualquer**
+plataforma, não só do Claude Code.
+
+A auto-memória guarda as duas linhas que não moram no vault: **armadilha de stack /
+bug não-óbvio** e **preferência de trabalho / correção do usuário**. No Claude Code ela
+carrega sozinha no início da sessão. Em Codex, OpenCode e Gemini não carrega nada, mas
+o dado está lá: é um diretório comum de arquivos `.md` no disco local. Este comando é a
+ponte de leitura. Não existe segunda cópia dos fatos — a fonte continua sendo uma só.
+
+### Passo 1 — resolver o diretório de memória
+
+```bash
+PROJ_DIR="$(pwd)"
+SLUG="$(printf '%s' "$PROJ_DIR" | sed 's/[/.]/-/g')"
+MEM="$HOME/.claude/projects/$SLUG/memory"
+# fallback: o slug histórico nem sempre normaliza espaço e ponto do mesmo jeito
+[ -d "$MEM" ] || MEM="$(ls -d "$HOME"/.claude/projects/*"$(basename "$PROJ_DIR")"/memory 2>/dev/null | head -1)"
+echo "$MEM"
+```
+
+Diretório inexistente = projeto sem auto-memória. Siga sem travar; não é problema a corrigir.
+
+### Passo 2 — carregar só o índice
+
+```bash
+cat "$MEM/MEMORY.md"
+```
+
+O índice tem teto de 8 KB e é 1 linha por memória. **Nunca leia os arquivos individuais
+em bloco.** Abra um arquivo só quando a linha do índice for relevante ao pedido da vez:
+
+```bash
+grep -rln "termo" "$MEM" --include="*.md" | head -5   # depois Read só o que casar
+```
+
+`_archive/` fica fora do índice de propósito. Só entre nele quando o índice não tiver a resposta.
+
+### Passo 3 — gravar (mesma pasta, mesmo formato)
+
+Vale o Dever de Memória e o teto: **40 memórias e 8 KB de índice por projeto**. Antes de
+criar, `grep` no destino; se o fato já existe, atualize o arquivo que existe.
+
+```markdown
+---
+name: <slug-em-kebab-case>
+description: <resumo de uma linha, é o que decide a relevância na recuperação>
+metadata:
+  type: user | feedback | project | reference
+---
+
+<o fato. Para feedback/project, siga com as linhas **Why:** e **How to apply:**.
+Ligue memórias relacionadas com [[nome-da-outra]].>
+```
+
+Depois de escrever o arquivo, acrescente 1 linha ao `MEMORY.md`:
+`- [Título](arquivo.md) — gancho`
+
+### Limites honestos
+
+- É **pull, não push**: fora do Claude Code nada carrega sozinho, o agente precisa rodar o comando.
+- Vale só para agente rodando na **mesma máquina**. Agente remoto não enxerga este disco.
+- O teto e a poda continuam valendo igual, venha a escrita de qual plataforma vier.

package/src/skills-lib/cerebro/references/comandos-rotina-e-captura.md

@@ -36,19 +36,38 @@ Carregue este arquivo ao executar `/dia`, `/dump`, `/decisao` ou `/conteudo`. An
 
 ## /decisao
 
-**Objetivo:** registrar decisão. Zero reads de arquivos existentes.
+**Objetivo:** registrar decisão. 1 grep antes, nenhum Read.
 
 **Passos:**
 1. Receber descrição + alternativas + projeto (perguntar tudo de uma vez se não passado)
-2. Write direto em `_decisions/YYYY-MM-DD-[slug].md` (template abaixo)
-3. `grep -n "## Decisões recentes" "$VAULT/CEREBRO.md"` → linha
-4. Edit para inserir referência wiki-link logo abaixo dessa linha
-5. Se há projeto: `grep -n "## Decisões" "$VAULT/projetos/$PROJ.md"` → Edit 1 linha
+2. **Grep antes de gravar** (obrigatório, 1 bash call):
+
+```bash
+grep -ril "<2 ou 3 palavras do tema>" "$VAULT/_decisions/" | head -5
+```
+
+- Achou decisão sobre o mesmo tema: **não crie arquivo novo**. Abra o que existe e decida entre dois caminhos:
+  - a decisão nova **substitui** a antiga → marque a antiga com `status: superseded` e `supersedida_por: <slug novo>`, e crie a nova com `supersede: <slug antigo>`
+  - a decisão nova **detalha** a antiga → edite a antiga, não crie a segunda
+- Não achou nada: siga para o passo 3.
+
+3. Write direto em `_decisions/YYYY-MM-DD-[slug].md` (template abaixo)
+4. `grep -n "## Decisões recentes" "$VAULT/CEREBRO.md"` → linha
+5. Edit para inserir referência wiki-link logo abaixo dessa linha
+6. Se há projeto: `grep -n "## Decisões" "$VAULT/projetos/$PROJ.md"` → Edit 1 linha
 
 **Template `_decisions/YYYY-MM-DD-[slug].md`:**
 ```markdown
+---
+data: YYYY-MM-DD
+projeto: [nome]
+tema: [2 a 4 palavras-chave separadas por vírgula, é por elas que o grep acha]
+status: ativa
+supersede: [slug da decisão que esta substitui, ou omitir]
+supersedida_por: [preenchido depois, quando outra decisão substituir esta]
+---
+
 # [Título]
-> Data: [data] | Projeto: [[projetos/nome]] | Status: ativa
 
 ## Decisão
 [1-2 linhas]

package/src/skills-lib/cerebro/references/comandos-sessao.md

@@ -2,11 +2,30 @@
 
 Carregue este arquivo ao executar `/iniciar`, `/ver` ou `/salvar`. Antes de tudo, releia a REGRA DE OURO e a seção Vault no SKILL.md principal — esses comandos dependem delas.
 
+## O bloco Estado
+
+Todo arquivo em `projetos/` começa com um bloco `## Estado` de no **máximo 12 linhas**, logo abaixo do título. Ele é sobrescrito a cada `/salvar` e é a única coisa que o `/ver` precisa ler.
+
+```markdown
+## Estado
+- **Fase:** [em que ponto o projeto está, 1 linha]
+- **Stack:** [1 linha]
+- **Onde parou:** [1 linha]
+- **Próximo passo:** [1 linha, a primeira coisa a fazer ao voltar]
+- **Bloqueio:** [1 linha, ou "nenhum"]
+- **Última sessão:** [YYYY-MM-DD] — [1 linha]
+```
+
+Por que 12 linhas: o `/ver` vira 1 Read de 14 linhas em vez de um tail de 60. E o bloco fica no topo, onde qualquer humano abrindo a nota também lê primeiro.
+
+O que **não** entra no bloco: histórico, decisão, aprendizado, lista longa de pendências. Histórico é a tabela `Sessões`; decisão é `_decisions/`; aprendizado é a auto-memória do agente; a lista completa de pendências é a seção `O que falta`.
+
 ## /iniciar
 
 **Objetivo:** configurar projeto novo. Só cria arquivos — não lê nada além do CEREBRO.md mínimo.
 
 **Passos:**
+
 1. Descobrir vault (ver seção Vault)
 2. `grep -c "$PROJ" "$VAULT/CEREBRO.md"` → verificar se projeto já existe (0 = novo)
 3. Se novo: entrevistar em 1 mensagem (organização, info essencial, estilo, modo)
@@ -15,21 +34,27 @@ Carregue este arquivo ao executar `/iniciar`, `/ver` ou `/salvar`. Antes de tudo
 6. Confirmar
 
 **Template `projetos/[nome].md`:**
+
 ```markdown
 # [Nome] — Estado Atual
 > Atualizado: [data]
 
+## Estado
+- **Fase:** [fase]
+- **Stack:** [stack]
+- **Onde parou:** [1 linha]
+- **Próximo passo:** [1 linha]
+- **Bloqueio:** nenhum
+- **Última sessão:** [data] — [1 linha]
+
 ## Preferências
 - Organização: [resposta]
 - Info essencial: [resposta]
 - Estilo: [resposta]
 - Modo: [registro / sugestivo]
 
-## Stack
-[breve descrição]
-
-## Onde parou
--
+## Contexto
+[o que o bloco Estado não cabe: stack detalhada, restrições, links]
 
 ## O que falta
 - [ ]
@@ -41,6 +66,7 @@ Carregue este arquivo ao executar `/iniciar`, `/ver` ou `/salvar`. Antes de tudo
 ```
 
 **Template bloco em CEREBRO.md:**
+
 ```markdown
 ### [Nome] [emoji]
 - **Stack:** [stack]
@@ -51,20 +77,14 @@ Carregue este arquivo ao executar `/iniciar`, `/ver` ou `/salvar`. Antes de tudo
 
 ## /ver
 
-**Objetivo:** mostrar estado atual rápido. Máximo: 1 Read.
+**Objetivo:** mostrar estado atual rápido. Máximo: 1 Read de 14 linhas.
 
 **Passos:**
-1. `wc -l "$VAULT/projetos/$PROJ.md"` → total de linhas
-2. Read com `offset=(n-60)`, `limit=60` → pega Onde parou + O que falta + Sessões
-3. Retornar em formato condensado:
 
-```
-## [Projeto] — [data última sessão]
-Stack: [1 linha]
-Onde parou: [bullets]
-O que falta: [checkboxes]
-Última sessão: [1 linha]
-```
+1. Read `projetos/[nome].md` com `limit=14` (o bloco Estado está no topo)
+2. Devolver o bloco quase como está, sem reescrever
+
+**Arquivo antigo, sem bloco Estado no topo:** cai no caminho lento uma única vez — `wc -l` e Read das últimas 60 linhas — e ao devolver, ofereça criar o bloco. Aceito, o próximo `/ver` volta a custar 1 Read curto.
 
 ## /salvar
 
@@ -73,6 +93,7 @@ O que falta: [checkboxes]
 **Passos (executar em ordem, sem desvios):**
 
 **1. Localizar projeto e bloco no CEREBRO.md (1 bash call)**
+
 ```bash
 VAULT=~/Documents/projects/Obsidian\ Vault
 PROJ=construcao   # inferir do diretório atual ou contexto
@@ -80,43 +101,46 @@ grep -n "### \|Última sessão\|Pendente" "$VAULT/CEREBRO.md" | grep -A2 -i "$PR
 wc -l "$VAULT/projetos/$PROJ.md"
 ```
 
-**2. Ler apenas o final do arquivo do projeto (1 Read)**
-- `offset = (total_linhas - 80)`, `limit = 80`
-- Isso captura: Hoje atual, Onde parou, O que falta, tabela Sessões
+**2. Ler o topo e o fim do arquivo do projeto (2 Reads curtos)**
+
+- topo: `limit=14` → bloco Estado
+- fim: `offset = (total_linhas - 40)`, `limit = 40` → O que falta e tabela Sessões
 
 **3. Construir as alterações na memória, depois aplicar (Edits atômicos)**
 
-Em `projetos/[nome].md`, sempre adicionar ACIMA da seção "Onde parou" existente:
+Em `projetos/[nome].md`:
+
+- **Sobrescrever o bloco `## Estado`** inteiro, mantendo os mesmos 6 campos e o teto de 12 linhas. Não empilhar bloco novo: o histórico é a tabela.
+- Atualizar a seção `O que falta` (marcar o que saiu, acrescentar o que entrou).
+- Acrescentar 1 linha ao fim da tabela `Sessões`:
+
 ```markdown
-## Hoje ([data] — [sessão])
-- [item 1]
-- [item 2]
+| [data] | [resumo 1 linha] |
 ```
 
-Substituir "Onde parou" e "O que falta" com o estado novo.
-
-Adicionar linha na tabela Sessões (append na última linha da tabela).
+Arquivo sem bloco `## Estado`: criar agora, logo abaixo do título, com o que a sessão apurou.
 
 **4. Atualizar bloco do projeto em CEREBRO.md (1 Edit)**
+
 - Usar grep do passo 1 para saber as linhas exatas
 - Edit cirúrgico apenas nas linhas "Última sessão" e "Pendente"
 
-**5. Atualizar CONTEXT.md (Edit cirúrgico — só campos alterados)**
-- Nunca reescrever o arquivo inteiro
-- Editar apenas: data no cabeçalho, pendências em "O que falta", commit hash se mudou
+**5. Se houve decisão relevante:** criar arquivo em `_decisions/` (ver `comandos-rotina-e-captura.md` para o frontmatter e a regra de grep-antes-de-gravar).
+Aprendizado técnico (armadilha de stack, bug não óbvio, pegadinha de ambiente) **não vai para o vault**: vai para a auto-memória do agente. No vault ninguém lia. No Claude Code ela carrega sozinha no início da sessão; em Codex, OpenCode e Gemini o caminho de leitura é o `/memoria` (ver `comandos-pesquisa-e-memoria.md`).
 
-**6. Append em `_index/sessions.md` (1 Edit ou Write se não existir)**
-```markdown
-| [data] | [projeto] | [resumo 1 linha] |
-```
-
-**7. Se houve decisão ou aprendizado relevante:** criar arquivo em `_decisions/` ou `_learnings/` (Write direto, sem Read prévio).
+**6. Higiene do índice (compactação)**
 
-**8. Higiene do índice (compactação)**
 ```bash
 wc -l "$VAULT/CEREBRO.md"
 ```
+
 - Se > 150 linhas: mover o conteúdo mais antigo/menos essencial (projeto ✅ concluído ou ❌ descontinuado com histórico longo, ou entradas de "Decisões recentes" além das ~15 mais novas) para `_index/cerebro-archive.md`, deixando no lugar só 1 linha de referência `[[_index/cerebro-archive]]`. Nunca apagar, só mover.
 - Se ≤ 150 linhas: pular este passo.
 
-**9. Confirmar em 2 linhas** o que foi salvo.
+```bash
+grep -c "^| " "$VAULT/projetos/$PROJ.md"
+```
+
+- Tabela Sessões com mais de 15 linhas: mover as mais antigas para `_index/cerebro-archive.md`, sob `## Sessões antigas — [projeto]`, deixando as 15 mais novas no arquivo do projeto. Nunca apagar, só mover.
+
+**7. Confirmar em 2 linhas** o que foi salvo.

package/src/skills-lib/find-skills/SKILL.md

@@ -164,7 +164,6 @@ claude mcp add <id> [-e VAR=valor ...] -- <command> [args...]
 # necessário):
 claude mcp add context7 -- npx -y @upstash/context7-mcp@3.2.2
 claude mcp add exa -e EXA_API_KEY=$EXA_API_KEY -- npx -y exa-mcp-server@3.2.1
-claude mcp add magic -e API_KEY=$MAGIC_API_KEY -- npx -y @21st-dev/magic@0.1.0
 claude mcp add supabase -e SUPABASE_ACCESS_TOKEN=$SUPABASE_ACCESS_TOKEN -- npx -y @supabase/mcp-server-supabase@0.8.2 --read-only
 ```
 Versões acima são as pinadas hoje em `skills-registry.yaml` — confira lá antes de copiar, pode ter mudado. Não sugira o MCP do Playwright: browser é sempre via CLI `agent-browser` neste framework, nunca Playwright.

package/src/skills-lib/impeccable/SKILL.md

@@ -1,30 +1,28 @@
 ---
 name: impeccable
-description: "Use when the user wants to design, redesign, shape, critique, audit, polish, clarify, distill, harden, optimize, adapt, animate, colorize, extract, or otherwise improve a frontend interface. Covers websites, landing pages, dashboards, product UI, app shells, components, forms, settings, onboarding, and empty states. Handles UX review, visual hierarchy, information architecture, cognitive load, accessibility, performance, responsive behavior, theming, anti-patterns, typography, fonts, spacing, layout, alignment, color, motion, micro-interactions, UX copy, error states, edge cases, i18n, and reusable design systems or tokens. Also use for bland designs that need to become bolder or more delightful, loud designs that should become quieter, live browser iteration on UI elements, or ambitious visual effects that should feel technically extraordinary. Not for backend-only or non-UI tasks."
-argument-hint: "[{{command_hint}}] [target]"
+description: "Use when the user wants to review, audit, polish, redesign or improve a frontend interface. Covers hierarchy, accessibility, responsive layout, typography, color, motion, UX copy and component consistency. Wizz's self-contained adaptation runs on project evidence and bundled references."
+argument-hint: "[audit|critique|polish|shape|document|adapt|harden] [target]"
 user-invocable: true
-allowed-tools:
-  - Bash(npx impeccable *)
 license: Apache 2.0
 ---
 
-Designs and iterates production-grade frontend interfaces. Real working code, committed design choices, exceptional craft.
+# Impeccable — Wizz adaptation
 
-## Setup (first step, always run before anything else)
+Design and review working interfaces using project evidence. This bundle contains instructions and design rules; it does not ship the upstream CLI, detector, context scripts or native engine. Do not invent commands or claim those checks ran.
 
-You MUST do these steps before proceeding:
+## Setup
 
-1. Run `node {{scripts_path}}/context.mjs` once per session. If you've already seen its output in this conversation, do not re-run it. The script either prints the project's PRODUCT.md (and DESIGN.md when present) as a markdown block, or tells you it's missing. Follow whatever it prints. **If it reports `NO_PRODUCT_MD`, stop and follow `reference/init.md` before doing anything else.** If the output ends with an `UPDATE_AVAILABLE` directive, follow it (ask the user once about updating, then continue). It never blocks the current task.
-2. If the user invoked a sub-command (`craft`, `shape`, `audit`, `polish`, ...), you MUST read `reference/<command>.md` next. Non-optional. The reference defines the command's flow; without it you will skip steps the user expects.
-3. Familiarize yourself with any existing design system, conventions, and components in the code. Read at least one project file (CSS / tokens / theme / a representative component or page). **Required even when you've loaded a sub-command reference in step 2.** Don't reinvent the wheel; use what's there when it works, branch out when the UX wins.
-4. Read the matching register reference. **This is non-optional; skipping it produces generic output.** If the project is marketing, a landing page, a campaign, long-form content, or a portfolio (design IS the product), read `reference/brand.md`. If it is app UI, admin, a dashboard, or a tool (design SERVES the product), read `reference/product.md`. Pick by first match: (1) task cue ("landing page" vs "dashboard"); (2) surface in focus (the page, file, or route being worked on); (3) `register` field in PRODUCT.md.
-5. **If the project is brand-new (no existing CSS tokens / theme / committed brand colors found in step 3)**, run `node {{scripts_path}}/palette.mjs` to receive a brand seed color and composition guidance. This is the anchor for your primary brand color. Compose the rest of the palette (bg, surface, ink, accent, muted) around it per the script's instructions. Use OKLCH throughout. **Skip this step only if step 3 found committed brand colors in existing tokens; in that case identity-preservation wins.**
+1. Read the user's brief, existing PRODUCT.md/DESIGN.md when present, and at least one relevant UI source file (tokens, theme, component or page). Missing documents alone do not make an existing project greenfield.
+2. Preserve the established identity during refinement. For a requested redesign, choose a new direction while preserving product facts, functionality and user constraints. Explicit user choices take precedence over generic anti-pattern warnings.
+3. Choose the surface mode: **Persuade** (landing/marketing), **Operate** (app/dashboard), **Read** (docs/articles) or **Experience** (portfolio/gallery). A product can have surfaces in different modes.
+4. Map the requested action using [routing-rules](references/routing-rules.md). Read [command-workflows](references/command-workflows.md) for the relevant workflow and [design-rules](references/design-rules.md) before reviewing or changing UI.
+5. For new nontrivial components, invoke `skill:premium-landing-ui-researcher` or `skill:ui-component-curator` to obtain inspected sources. Do not replace source research with generic taste recommendations.
 
-## Design guidance
+## Verification
 
-Produce ready-to-ship, production-grade code, not prototypes or starting points. Take no shortcuts unless the user asks for them (when in doubt, ask). Don't stop until arriving at a complete implementation (beautiful, responsive, fast, precise, bug-free, on brand). You take attention to detail seriously: every page, section or component crafted is battle tested using the tools available to you (browser screenshotting, computer use, etc). {{model}} is capable of extraordinary work. Don't hold back.
+Build the authorized change, inspect the affected desktop/mobile states in one batch, fix the observed issues together and confirm once more. Additional passes need a specific unresolved defect. Verify keyboard/focus, responsive overflow, reduced-motion and relevant project checks. If the app cannot run, use current screenshot fixtures and code, and state the limitation.
 
-**Before writing or reviewing any UI code, load `references/design-rules.md`** — the ruleset every craft/polish/audit/critique pass is checked against. Skipping it is the most common way this skill produces generic or AI-tell-heavy output.
+Report findings with file/route, observed evidence, impact and proposed correction. Distinguish observed defects from taste preferences. Never claim an automatic detector, browser test or performance measurement without running it.
 
 ## Commands
 
@@ -54,17 +52,14 @@ Produce ready-to-ship, production-grade code, not prototypes or starting points.
 | `optimize [target]` | Fix | Diagnose and fix UI performance |
 | `live` | Iterate | Visual variant mode: pick elements in the browser, generate alternatives |
 
-Each command's flow lives at `reference/<command>.md` (e.g. `reference/craft.md`, `reference/live.md` — vendored, per Setup step 2). Plus three management commands: `pin <command>`, `unpin <command>`, and `hooks <on|off|status|...>` — see `references/pin-unpin-and-hooks.md`.
 
-**If the first word matches a command** (table above OR `pin` / `unpin` / `hooks`): load its reference file and follow its instructions. Everything after the command name is the target. **If no argument was given, or the intent doesn't obviously name a command**, load `references/routing-rules.md` for the full routing logic (context-aware menu, signal-based recommendations, intent mapping, fallback general invocation).
+Command names above select the bundled [command-workflows](references/command-workflows.md); they are not shell commands. Management requests (`pin`, `unpin`, `hooks`) use [pin-unpin-and-hooks](references/pin-unpin-and-hooks.md). `teach` aliases `init`.
 
-`teach` is a deprecated alias for `init`: if the user types it, load [reference/init.md](reference/init.md) and proceed as if they ran `init`.
+## References
 
-## Reference map — load each file when needed
+- [Design rules](references/design-rules.md): visual, interaction and anti-pattern checks.
+- [Routing rules](references/routing-rules.md): map intent to the appropriate workflow.
+- [Command workflows](references/command-workflows.md): executable steps using available project tools.
+- [Management capabilities](references/pin-unpin-and-hooks.md): limits of this instruction-only bundle.
 
-- `references/design-rules.md` — general + new-project rules, absolute bans, AI slop test. **Load before producing/reviewing UI code.**
-- `references/routing-rules.md` — full routing algorithm for no-argument or ambiguous invocations. **Load when you can't map the request to a table row.**
-- `references/pin-unpin-and-hooks.md` — the `pin`/`unpin`/`hooks` management flows. **Load when the user invokes one of those.**
-- `reference/<command>.md` (singular — e.g. `reference/craft.md`, `reference/brand.md`) — vendored per-command/per-register flows from the `impeccable` npm package, resolved by Setup steps 2 and 4. Not part of this repo.
-
-Zero content was cut — every rule, example, and routing detail lives verbatim in its `references/` file.
+Upstream: [pbakaus/impeccable](https://github.com/pbakaus/impeccable). The current upstream skill 4.2.1 uses a native engine; this Wizz adaptation does not imply that engine is installed.

package/src/skills-lib/impeccable/references/command-workflows.md

@@ -0,0 +1,35 @@
+# Command workflows
+
+Apply only the workflow matching the user's request. Use the existing project tools and evidence; these procedures do not require a separate CLI.
+
+## Shape and build
+
+For `shape` or `craft`: inspect the brief and current UI; determine visitor task and surface mode; draft section/component structure and states; resolve missing material decisions; research nontrivial components through the appropriate Wizz research skill. Build when authorized, then run the verification pass described in SKILL.md.
+
+## Audit and critique
+
+For `audit`: inspect keyboard/focus, labels, contrast, errors/loading/empty states, responsive overflow, motion preferences and relevant performance evidence. For `critique`: inspect hierarchy, comprehension, navigation, density, typography, brand fit and task completion. Report prioritized findings with exact file/route and evidence. Do not equate a preference with a defect, invent scores or apply fixes during a review-only request.
+
+## Refine and adjust
+
+For `polish`, address the observed issues with the highest user impact. Other commands narrow the scope:
+
+| Commands | Inspect and change |
+|---|---|
+| typeset, layout | Type hierarchy, readable line lengths, wrapping, spacing, alignment, responsive behavior |
+| colorize, bolder, quieter | Color roles, contrast and intended emphasis within the approved direction |
+| distill, clarify | Unnecessary UI/copy complexity, labels and next-action clarity; preserve factual claims |
+| adapt, harden, onboard | Device states, errors/loading/empty states, localization, first-use guidance |
+| animate, delight, overdrive | Purposeful interaction feedback, timing, reduced-motion, rendering cost |
+| optimize | Measured or directly evidenced performance problems; verify the affected path |
+| extract | Repeated tokens/patterns that merit shared primitives without changing behavior |
+
+Inspect the target first, make the authorized edits, then verify those states. Large motion effects still require inspected sources and a fit decision.
+
+## Init and document
+
+For `init`, gather known product, audience, purpose and constraints from project/user evidence; ask only for missing material facts. For `document`, extract the actual design system from code and current screenshots. Merge into existing PRODUCT.md/DESIGN.md without discarding unrelated decisions; mark assumptions.
+
+## Live
+
+Inspect the affected interface using the available browser and current dev server. Implement scoped visual variants if requested, compare the relevant viewport/states, and keep the chosen variant. If a running app or browser is unavailable, provide a code/static assessment and state what remains unverified. Do not simulate an interactive overlay or claim a visual check occurred.

package/src/skills-lib/impeccable/references/design-rules.md

@@ -92,4 +92,4 @@ If someone could look at this interface and say "AI made that" without doubt, it
 **Category-reflex check.** Run at two altitudes; the second one catches what the first one misses.
 
 - **First-order:** if someone could guess the theme + palette from the category alone, it's the first training-data reflex. Rework the scene sentence and color strategy until the answer isn't obvious from the domain. <!-- rule:skill-slop-first-order-check -->
-- **Second-order:** if someone could guess the aesthetic family from category-plus-anti-references ("AI workflow tool that's not SaaS-cream → editorial-typographic", "fintech that's not navy-and-gold → terminal-native dark mode"), it's the trap one tier deeper. The first reflex was avoided; the second wasn't. Rework until both answers are not obvious. The brand register's [reflex-reject aesthetic lanes](reference/brand.md) list catches the currently-saturated families. <!-- rule:skill-slop-second-order-check -->
+- **Second-order:** if someone could guess the aesthetic family from category-plus-anti-references ("AI workflow tool that's not SaaS-cream → editorial-typographic", "fintech that's not navy-and-gold → terminal-native dark mode"), it's the trap one tier deeper. The first reflex was avoided; the second wasn't. Rework until both answers are not obvious. Ground the direction in the user's brief and inspected references instead of swapping one generic aesthetic for another. <!-- rule:skill-slop-second-order-check -->

package/src/skills-lib/impeccable/references/pin-unpin-and-hooks.md

@@ -1,17 +1,7 @@
-# Pin/unpin and hooks management commands
+# Pin, unpin and hooks
 
-Load this file when the user invokes `pin`, `unpin`, or `hooks` (with any argument). Covers: creating/removing standalone command shortcuts, and managing the design detector hook that auto-runs after direct UI file edits.
+The Wizz instruction-only adaptation does not ship the upstream management runtime. `pin`, `unpin` and `hooks` are therefore not executable through this bundle.
 
-## Pin / Unpin
+If asked to manage them, first inspect whether the project separately installed the official Impeccable runtime. If present, consult its installed help and current official documentation and use only commands it actually supports. If absent, explain the missing capability and prepare an installation plan if requested. Do not install another runtime automatically during UI work.
 
-**Pin** creates a standalone shortcut so `{{command_prefix}}<command>` invokes `{{command_prefix}}impeccable <command>` directly. **Unpin** removes it. The script writes to every harness directory present in the project.
-
-```bash
-node {{scripts_path}}/pin.mjs <pin|unpin> <command>
-```
-
-Valid `<command>` is any command from the table above. Report the script's result concisely. Confirm the new shortcut on success, relay stderr verbatim on error.
-
-## Hooks
-
-`{{command_prefix}}impeccable hooks <on|off|status|ignore-rule|ignore-file|ignore-value|reset>` manages the design detector hook for this project. The hook auto-runs the detector after direct UI file edits and surfaces findings as system reminders. Full flow is in [reference/hooks.md](reference/hooks.md); load it when the user invokes `{{command_prefix}}impeccable hooks` with any argument.
+UI audit and polish remain available through the bundled [command-workflows](command-workflows.md). Never report a hook or detector as active based solely on these instructions.

package/src/skills-lib/impeccable/references/routing-rules.md

@@ -1,28 +1,11 @@
-# Routing rules — how to pick a command
+# Routing rules
 
-Load this file whenever the skill is invoked without an explicit sub-command, or when the user's intent doesn't obviously name one of the commands in the table. Covers: the no-argument menu logic (reading context-signals.mjs and detect.mjs, picking the 2-3 highest-value next commands), first-word command matching, intent-to-command mapping, and the fallback general design invocation path.
+Use the user's requested action and target. A clearly implied action is enough to start; do not ask them to choose a command they already described.
 
-### Routing rules
+- Review or diagnose: `audit` for technical defects; `critique` for visual/UX reasoning. Report findings without editing unless authorized.
+- Fix or refine existing UI: `polish`, or the specific adjustment command. Preserve existing identity and behavior outside scope.
+- New page or redesign: `shape`, then the authorized build; use the source-research skills before nontrivial UI code.
+- Capture existing context: `document` for design evidence, `init` for product context. Missing PRODUCT.md does not block a narrow fix.
+- No task or target: inspect available project context and recommend up to three useful actions with evidence; ask for the missing objective.
 
-1. **No argument**: the user is asking "what should I do?" Make the menu context-aware instead of static. Setup has already run `context.mjs`; if that reported `NO_PRODUCT_MD` you are already in init (setup), so finish that and skip this. Otherwise run `node {{scripts_path}}/context-signals.mjs` once and read its JSON, then lead with the **2-3 highest-value next commands**, each with a one-line reason pulled from the signals, followed by the full menu (the table above, grouped by category). **Never auto-run a command; the recommendation is a suggestion the user confirms.**
-
-   Reason over the signals; there is no score to obey:
-   - `setup.hasDesign` false while `setup.hasCode` true → `document` (capture the visual system).
-   - `critique.latest` is `null` → the project has never been critiqued; for a set-up project with a real surface, offering `/impeccable critique <surface>` is a strong default.
-   - `critique.latest` with a low `score` or non-zero `p0` / `p1` → `polish` (it reads that snapshot as its backlog), or re-run `critique` if the snapshot looks stale.
-   - `git.changedFiles` pointing at one surface → scope `audit` or `polish` to those files specifically, naming them.
-   - `devServer.running` true → `live` is available for in-browser iteration; if false, don't lead with `live`.
-   - Otherwise group by intent exactly as init's "Recommend starting points" step does (build new / improve what's there / iterate visually), tailored to `setup.register`.
-
-   **If `scan.targets` is non-empty, run `node {{scripts_path}}/detect.mjs --json <scan.targets joined by spaces>` once** (the bundled detector over local files: no network, no npx). `scan.via` tells you what they are: `git-changes` (the markup/style files in your dirty tree, the most relevant set), `source-dir` (e.g. `src`, `app`), `html`, or `root`. Fold the hits into your picks: many quality / contrast hits → `audit` or `polish`; a specific slop family → the matching command (gradient text or eyebrows → `quieter` / `typeset`, flat or gray palette → `colorize`, and so on). It's a real, current signal that beats guessing. If detect errors or the tree is large and slow, skip it and recommend the user run `audit` themselves; never block the suggestion on it.
-
-   Keep it to 2-3 pointed picks with the exact command to type. The menu stays the fallback; the recommendation is the lede.
-2. **First word matches a command** (table above OR `pin` / `unpin` / `hooks`): load its reference file and follow its instructions. Everything after the command name is the target.
-3. **First word doesn't match, but the intent clearly maps to one command** (e.g. "fix the spacing" → `layout`, "rewrite this error message" → `clarify`, "the colors feel flat" → `colorize`): load that command's reference and proceed as if invoked. If two commands could fit, ask once which.
-4. **No clear command match**: general design invocation. Apply the setup steps, the General rules, and the loaded register reference, using the full argument as context.
-
-Setup (context gathering, register) is already loaded by then; sub-commands don't re-invoke `{{command_prefix}}impeccable`.
-
-If the first word is `craft`, setup still runs first, but [reference/craft.md](reference/craft.md) owns the rest of the flow. If setup invokes `init` as a blocker, finish init, refresh context, then resume the original command and target.
-
-`teach` is a deprecated alias for `init`: if the user types it, load [reference/init.md](reference/init.md) and proceed as if they ran `init`.
+Read [command-workflows](command-workflows.md) for the selected action. Reuse context from the current handoff; do not re-invoke router or maestro. Do not invoke absent detector/context scripts.

package/src/skills-lib/premium-landing-ui-researcher/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: premium-landing-ui-researcher
-description: Pesquisar animações, componentes, referências visuais e padrões de conversão para criar landing pages premium em React, Next.js, Tailwind, shadcn/ui, Framer Motion, Three.js e React Three Fiber. Use quando o pedido envolver analisar projeto existente; classificar nível de complexidade do site (básico a 3D high-end/Signature); escolher componentes/animações; melhorar UI genérica; criar landing page completa, transformar oferta em página estratégica, dashboard SaaS, site de autoridade/portfolio (agência, estúdio, consultoria, marca pessoal, lead passivo), case studies/selected work editoriais, ou experiência 3D cinematográfica para marcas premium; buscar referências em fontes premium (React Bits, Cult UI, Watermelon UI, Skiper UI, 21st.dev via Magic MCP/CLI, outras em references/component-sources.md); ou escolher motion engine (GSAP, anime.js, Framer Motion, Three.js/R3F) para scroll storytelling.
+description: Pesquisar animações, componentes, referências visuais e padrões de conversão para criar landing pages premium em React, Next.js, Tailwind, shadcn/ui, Framer Motion, Three.js e React Three Fiber. Use quando o pedido envolver analisar projeto existente; classificar nível de complexidade do site (básico a 3D high-end/Signature); escolher componentes/animações; melhorar UI genérica; criar landing page completa, transformar oferta em página estratégica, dashboard SaaS, site de autoridade/portfolio (agência, estúdio, consultoria, marca pessoal, lead passivo), case studies/selected work editoriais, ou experiência 3D cinematográfica para marcas premium; buscar referências em fontes premium (React Bits, Cult UI, Watermelon UI, Skiper UI, Componentry, outras em references/component-sources.md); ou escolher motion engine (GSAP, anime.js, Framer Motion, Three.js/R3F) para scroll storytelling.
 ---
 
 # Premium Landing UI Researcher
@@ -9,9 +9,9 @@ Estrategista autônomo de landing pages premium, UI SaaS e experiências visuais
 
 ## Gate 1: Source-First (sempre, antes de qualquer código de UI)
 
-Esta skill existe porque escrever shaders, animações, hovers e componentes do zero NÃO é o caminho. O caminho é curar componentes, animações e shaders maduros de fontes profissionais (`modelos lp/` do usuário, React Bits, Cult UI, Ali Imam, Watermelon, StyleUI, Skiper UI e, como fonte PAGA complementar, 21st.dev via Magic MCP e 21st CLI) e adaptar à marca.
+Esta skill existe porque escrever shaders, animações, hovers e componentes do zero NÃO é o caminho. O caminho é curar componentes, animações e shaders maduros de fontes profissionais (`modelos lp/` do usuário, React Bits, Cult UI, Ali Imam, Watermelon, StyleUI, Skiper UI, Componentry e registries públicos) e adaptar à marca.
 
-Regra absoluta: inspecione fontes reais, ofereça opções ao usuário, adapte à marca. Nunca recrie o que já existe maduro. Se uma fonte estiver indisponível (MCP offline, sem rede, sem permissão pra clone), declare isso explicitamente ao usuário antes de cair pro fallback de criar do zero. Nunca cair pro fallback silenciosamente. O mandato completo (anti-patterns e required pattern) está no topo de [source-first-protocol](references/source-first-protocol.md).
+Regra absoluta: inspecione fontes reais, registre evidências e recomende opções, adapte à marca. Nunca recrie o que já existe maduro. Se uma fonte estiver indisponível, registre a limitação e pesquise outra fonte pública ou local antes de justificar uma implementação própria. Nunca cair pro fallback silenciosamente. O mandato completo (anti-patterns e required pattern) está no topo de [source-first-protocol](references/source-first-protocol.md).
 
 ## Gate 2: classificar o nível do site (sempre, antes de recomendar componentes)
 
@@ -31,7 +31,7 @@ Classificar o projeto em um dos 5 níveis (regras, motion permitido/proibido e b
 2. Classificar o nível do site (Gate 2).
 3. Definir direção visual e stack.
 4. Decidir modos extras: dashboard SaaS e/ou Portfolio / Authority Mode.
-5. Checkpoints de fontes: inventário interno, Source-First Protocol completo e confirmação do usuário sobre as fontes escolhidas (Gate 1). Nunca pular silenciosamente.
+5. Checkpoints de fontes: inventário interno, Source-First Protocol completo e escolha das fontes dentro do escopo autorizado (Gate 1). Nunca pular silenciosamente.
 6. Se nível 4 ou 5: handoff pro `motion-3d-director` antes de implementar.
 7. Escrever copy completa e estrutura da página.
 8. Plano de implementação (handoff pro `implementation-planner` quando aplicável).
@@ -47,9 +47,9 @@ Classificar o projeto em um dos 5 níveis (regras, motion permitido/proibido e b
 | Handoffs pro motion-3d-director e implementation-planner, regra final do ladder | [handoffs](references/handoffs.md) |
 | SaaS Dashboard Mode e Portfolio / Authority Site Mode | [dashboard-and-portfolio-modes](references/dashboard-and-portfolio-modes.md) |
 | Processo obrigatório de 12 passos e checkpoint de honestidade | [mandatory-process](references/mandatory-process.md) |
-| Source-First Mandate completo + protocolo em 5 fases (inventário, repos em cache, Magic MCP, 21st CLI, confirmação; 21st = fonte paga complementar) | [source-first-protocol](references/source-first-protocol.md) |
+| Protocolo em 5 fases (inventário, busca pública, cache, evidências, adaptação) | [source-first-protocol](references/source-first-protocol.md) |
 | Audit Protocol: Pass 1 Taste, Pass 2 Impeccable, Pass 3 Cross-check, Pass 4 A11y/Perf | [audit-protocol](references/audit-protocol.md) |
-| Fontes de componentes (React Bits, Cult UI, Ali Imam, Watermelon, StyleUI, Skiper UI, Bklit UI, 21st.dev + 21st CLI), animation engines (GSAP, anime.js), fontes de referência e inspiração visual, Clone Policy, Paid Source Policy | [component-sources](references/component-sources.md) |
+| Fontes de componentes (React Bits, Cult UI, Ali Imam, Watermelon, StyleUI, Skiper UI, Bklit UI, Componentry), animation engines (GSAP, anime.js), fontes de referência e inspiração visual, Clone Policy, Paid Source Policy | [component-sources](references/component-sources.md) |
 | Stack default, direção visual, paletas, tipografia e regras de seleção de animação | [stack-and-visual-direction](references/stack-and-visual-direction.md) |
 | Estrutura obrigatória da landing, case studies/portfolio, copywriting, conversão e CTA externo/WhatsApp | [landing-page-strategy](references/landing-page-strategy.md) |
 | Prompts base (landing completa e hero 3D com scroll) | [prompt-templates](references/prompt-templates.md) |