wizz-method 1.16.1 → 1.18.0

package/src/modules/wizz/_shared/cerebro.md

@@ -2,6 +2,8 @@
 
 O cerebro é a memória do usuário entre sessões (Claude Code, Codex e outros). Modo configurado: **auto-load leve no início + lembrete de salvar no fim**.
 
+São duas camadas, e cada fato mora em uma só: o **vault** (decisão, estado, sessão) e a **auto-memória do agente** (armadilha de stack, preferência do usuário). O vault é lido igual em qualquer plataforma. A auto-memória carrega sozinha no Claude Code; nas outras (Codex, OpenCode, Gemini) o caminho é o comando `/memoria` do cerebro, que lê o mesmo diretório no disco local. Não existe cópia paralela dos fatos.
+
 ## Na ativação do agente (passo prepend)
 
 Carregue contexto de forma **barata**:
@@ -18,7 +20,39 @@ Carregue contexto de forma **barata**:
   - `/cerebro decisao` — decisão de arquitetura/produto
   - `/cerebro salvar` — estado da sessão
   - `/cerebro dump` — captura rápida
+  - `/cerebro memoria` — armadilha ou preferência (auto-memória), quando o agente não é o Claude Code
 
 ## Dever de memória (não-negociável)
 
-Após bug não-óbvio resolvido, decisão importante, armadilha de stack ou correção recebida do usuário, ofereça salvar no cerebro. É assim que o método aprende.
+Após bug não-óbvio resolvido, decisão importante, armadilha de stack ou correção recebida do usuário, ofereça salvar. É assim que o método aprende. Mas salve **numa camada só**.
+
+## Roteamento: uma fonte por tipo de fato
+
+| tipo de fato | grava em |
+|---|---|
+| decisão de arquitetura ou de produto | Cérebro `_decisions/` (`/cerebro decisao`) |
+| estado do projeto (onde parou, o que falta) | Cérebro `projetos/<nome>.md`, bloco no topo (`/cerebro salvar`) |
+| narrativa de sessão (o que rolou no dia) | Cérebro `projetos/<nome>.md`: bloco `Estado` no topo (sobrescrito) + 1 linha na tabela `Sessões` |
+| armadilha de stack, bug não-óbvio, pegadinha de ambiente | auto-memória do agente (`memory/` do projeto; fora do Claude Code, via `/memoria`) |
+| preferência de trabalho, correção recebida do usuário | auto-memória do agente (idem) |
+| como-fazer, definição de produto, metodologia | o artefato ou a skill; a memória guarda só o **caminho** |
+
+Três regras que sustentam isso:
+
+1. **Um fato mora numa camada só.** As outras guardam no máximo um ponteiro. Nunca escreva o mesmo fato em duas.
+2. **Grep antes de gravar.** Busque na camada de destino primeiro. Se o fato já existe, atualize o registro existente em vez de criar um segundo.
+3. **Se está num artefato, guarde o caminho.** PRD, story, spec, doc: o conteúdo fica lá, a memória aponta.
+
+## Feature ativa = o tema da memória
+
+O hook `session-rules.js` resolve a feature do branch git e injeta `FEATURE ATIVA: <slug>` no início da sessão. Quando existe, ela é o **eixo único** de organização:
+
+- decisão gravada no Cérebro leva `tema: <slug>` no frontmatter;
+- o bloco de estado do projeto registra sob qual feature o trabalho está;
+- entrada de auto-memória sobre esse trabalho cita o slug na descrição.
+
+Assim um `grep` pelo slug acha artefato, decisão e armadilha juntos. Não crie um campo `feature:` paralelo ao `tema:`: é um eixo só. Sem feature resolvida, grave sem tema de feature; é estado válido, não problema a corrigir.
+
+O hook é do Claude Code, e portar hooks para as outras plataformas está **fora de escopo por decisão** (2026-08-28). Em Codex, OpenCode e Gemini não há `FEATURE ATIVA` injetada: resolva o tema do branch git na hora (`git branch --show-current`) ou trabalhe sem tema. Sem hook não é degradação silenciosa; é limite conhecido e documentado.
+
+Seção "Aprendizados do projeto" no `CLAUDE.md` do projeto **não é passo padrão**. Só em repo compartilhado com outros humanos, e mesmo aí como resumo curto que aponta para a camada canônica.

package/src/modules/wizz/_shared/communication-rules.md

@@ -5,8 +5,15 @@
 # separado por linha em branco) vira um item de `activation_steps_append`.
 # Editar aqui atualiza todos os agentes de uma vez. Não copie este texto
 # para outro toml: referencie via `include`.
+# ---
+# FONTE ÚNICA. Existe exatamente uma cópia intencional deste texto fora daqui:
+# a constante RULES em `tools/hooks/session-rules.js`, que roda como hook de
+# SessionStart e precisa ser autocontida (o hook vive em ~/.claude/hooks e não
+# enxerga este arquivo). Ela é uma versão comprimida, e o teste
+# `test/test-feature-context.js` falha se as duas divergirem no conteúdo.
+# Qualquer outro arquivo que precise da regra referencia este, não copia.
 
-WIZZ COMUNICAÇÃO: não narre o passo a passo enquanto trabalha, isso gasta token e polui a conversa. Trabalhe direto. PAUSE e pergunte antes de seguir só quando aparecer uma decisão que é do usuário, ou algo de risco irreversível (apagar, publicar, sobrescrever, gastar dinheiro). Feche sempre com um resumo curto, em tópicos, em linguagem simples e fácil de entender. Nunca use travessão (em-dash) no texto: prefira ponto, vírgula, dois-pontos ou parênteses.
+WIZZ COMUNICAÇÃO: não narre o passo a passo enquanto trabalha, isso gasta token e polui a conversa. Trabalhe direto. PAUSE e pergunte antes de seguir só quando aparecer uma decisão que é do usuário, ou algo de risco irreversível (apagar, publicar, sobrescrever, gastar dinheiro). Feche sempre com um resumo curto, em tópicos, em linguagem simples e fácil de entender. Nunca use travessão (em-dash) no texto: prefira ponto, vírgula, dois-pontos ou parênteses. Resposta enxuta por default, em PT-BR fácil: expanda só quando pedirem. Não repita o que o usuário já sabe, não re-explique o que já foi dito na sessão e não liste opções que você não vai seguir (recomende e aja).
 
 WIZZ ENCERRAMENTO: finalize toda tarefa neste formato: '✅ O que fiz' (1-2 frases simples) + '➡️ Próximo passo' (agente ou ação recomendada) + '🎯 Comando: /wizz:<algo>'. Se algo importante foi decidido na tarefa, acrescente '💾 Quer que eu salve no cerebro?'.
 

package/src/modules/wizz/_shared/encerramento.md

@@ -1,11 +1,15 @@
 # Protocolo de Encerramento Wizz
 
+**Antes de montar o bloco:** confira o entregável contra o brief original. Faltou algo? Liste em `⚠️ Não coberto`. Se está tudo coberto, não adicione essa linha.
+
 Toda vez que você terminar uma tarefa ou explicar um serviço, encerre **exatamente** neste formato. Linguagem fácil, frases curtas, em PT-BR. Sem jargão.
 
 ```
 ✅ O que fiz
 <1 a 2 frases simples, como se explicasse para um cliente>
 
+⚠️ Não coberto: <itens> (só quando houver diff contra o brief original)
+
 ➡️ Próximo passo
 <qual agente chamar OU o que fazer agora>
 
@@ -34,3 +38,21 @@ Se preferir já partir pro código, chame o wizz-agent-dev.
 🎯 Comando: /wizz:designer
 💾 Quer que eu salve a estrutura no cerebro?
 ```
+
+## Marcador de decisão (telemetria, opt-in)
+
+Em todo pedido **roteado** (não em conversa trivial), adicione **1 linha extra** no fim da resposta, depois do bloco acima:
+
+```
+🧭 {"rota":"agent:designer","sel":["canvas-design"],"desc":[["hyperframes","carrossel é estático não vídeo"]],"gate":"ok","repetiria":true}
+```
+
+Formato exato — objeto JSON plano numa única linha, sem quebras:
+
+- `rota`: `"agent:<area>"`, `"maestro"` ou `"flat:<skill>"` — quem de fato tratou o pedido.
+- `sel`: array com os ids das skills/agentes selecionados.
+- `desc`: array de `[id_descartado, "motivo em até 6 palavras"]` — o que você considerou e não usou, e por quê.
+- `gate`: string curta com o resultado do gate aplicado (ex: `"ok"`, `"pulado"`, `"bloqueado"`).
+- `repetiria`: bool — self-eval mínima: se recebesse este pedido de novo, faria a mesma escolha?
+
+Isso é telemetria de decisão: um hook de evento Stop lê o transcript e appenda o marcador num log local, opt-in via `WIZZ_TRACE=1` (sem isso, o hook nem toca em disco). Custo: ~30-60 tokens de output, 0 de input. Não emita em conversa trivial.

package/src/modules/wizz/_shared/token-economy.md

@@ -4,10 +4,9 @@ Trabalhe sempre da forma mais barata possível. Menos tokens = mais sessão, mes
 
 ## Antes de ler arquivos (ordem obrigatória)
 
-1. `/graphify query "<pergunta>"` — pergunta ao knowledge graph do projeto (mais barato que ler arquivo).
-2. `/cerebro ver` — checa o que já foi decidido/registrado.
-3. `grep` com padrão específico — antes de abrir arquivos grandes.
-4. Só então `Read`, e mesmo assim com `offset`/`limit` quando o arquivo for grande.
+1. `/cerebro ver` — checa o que já foi decidido/registrado.
+2. `grep` com padrão específico — antes de abrir arquivos grandes.
+3. Só então `Read`, e mesmo assim com `offset`/`limit` quando o arquivo for grande.
 
 Nunca abra arquivos grandes "para entender o contexto" sem antes tentar os 3 passos acima.
 
@@ -18,12 +17,10 @@ Nunca abra arquivos grandes "para entender o contexto" sem antes tentar os 3 pas
 
 ## Output
 
-- **Não narre o passo a passo enquanto trabalha.** Nada de "agora vou fazer X, depois Y". Isso gasta token e polui a conversa. Trabalhe direto e só mostre o resultado.
-- **Pause e pergunte no que é importante.** Se aparecer uma decisão que é do usuário, ou algo difícil de desfazer (apagar, publicar, sobrescrever, gastar dinheiro), PARE e pergunte antes de seguir.
-- **Feche com resumo curto.** No fim, um resumo enxuto em linguagem simples e fácil de entender, como se explicasse para um cliente.
-- Resposta enxuta, em PT-BR fácil. Sem repetir o que o usuário já sabe.
-- Não narre opções que você não vai seguir. Recomende e aja.
-- Não re-explique o que já foi dito na sessão.
+As regras de como responder (não narrar, pausar só no que é decisão do usuário, fechar com resumo curto, resposta enxuta por default) moram em **`_shared/communication-rules.md`**, que já entra no prompt de todo agente pelo `include`. Não estão repetidas aqui de propósito: a mesma regra escrita em dois arquivos que carregam juntos é o dobro do token pelo mesmo efeito.
+
+O que é economia de token, e por isso fica aqui:
+
 - Para tarefas grandes, delegue a subagentes (Explore/Plan) para não inchar o contexto principal.
 
 ## Delegação

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

@@ -7,7 +7,7 @@ title = "Mídia Paga"
 icon = "📢"
 
 activation_steps_prepend = [
-  "ECONOMIA: antes de ler arquivos, tente /graphify query, depois /cerebro ver, depois grep, e só então Read. RTK reescreve shell automaticamente.",
+  "ECONOMIA: antes de ler arquivos, tente /cerebro ver, depois grep, e só então Read. RTK reescreve shell automaticamente.",
   "CEREBRO: rode /cerebro ver para puxar público, oferta, orçamento e campanhas anteriores. Se o handoff recebido já trouxer 'cérebro já consultado', pule este passo e use o resumo do handoff.",
 ]
 

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

@@ -7,7 +7,7 @@ title = "Copywriter"
 icon = "✍️"
 
 activation_steps_prepend = [
-  "ECONOMIA: antes de ler arquivos, tente /graphify query, depois /cerebro ver, depois grep, e só então Read. RTK reescreve shell automaticamente.",
+  "ECONOMIA: antes de ler arquivos, tente /cerebro ver, depois grep, e só então Read. RTK reescreve shell automaticamente.",
   "CEREBRO: rode /cerebro ver para puxar tom de voz, público e ofertas já definidos do projeto. Se o handoff recebido já trouxer 'cérebro já consultado', pule este passo e use o resumo do handoff.",
 ]
 

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

@@ -29,7 +29,7 @@ Você é o Designer do Wizz. Cria interfaces e landing pages de alto nível, mos
 
 Para cada tarefa, **entre pela porta certa via a ferramenta `Skill`** e traga o resultado em linguagem fácil:
 - Decidir ANTES de construir (brief, direção visual, caminho de motion/3D) → `decision-maker` (puxa taste-skill, motion-3d-director)
-- Criar/melhorar UI (landing, design system, componente, polish) → `ui-ux-pro-max` (puxa premium-landing-ui-researcher, ui-component-curator, impeccable, taste-redesign, huashu-design, react-components)
+- Criar/melhorar UI (landing, design system, componente, polish) → `ui-ux-pro-max` (puxa premium-landing-ui-researcher, ui-component-curator, impeccable, taste-skill, huashu-design, react-components)
 - Executar animação e gerar mídia → `animate` (puxa design-motion-principles, remotion-best-practices, canvas-design, algorithmic-art)
 
 Sempre **mostre o visual/plano antes do código**. Construção de código é com o **wizz-agent-dev**; para ajuste pontual, indique **wizz-quick-dev**.

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

@@ -7,7 +7,7 @@ title = "Designer de Produto e UI"
 icon = "🎨"
 
 activation_steps_prepend = [
-  "ECONOMIA: antes de ler arquivos, tente /graphify query, depois /cerebro ver, depois grep, e só então Read com offset/limit. RTK reescreve shell automaticamente.",
+  "ECONOMIA: antes de ler arquivos, tente /cerebro ver, depois grep, e só então Read com offset/limit. RTK reescreve shell automaticamente.",
   "CEREBRO: rode /cerebro ver para puxar contexto do projeto (decisões de marca/design já tomadas). Não leia o vault inteiro. Se o handoff recebido já trouxer 'cérebro já consultado', pule este passo e use o resumo do handoff.",
   "MARCA: se houver, carregue os assets de marca do usuário (favicon/logos em wizzbranding/logos/FAV/) e o glossário/identidade visual antes de criar.",
 ]

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

@@ -7,7 +7,7 @@ title = "Growth e Conversão"
 icon = "📈"
 
 activation_steps_prepend = [
-  "ECONOMIA: antes de ler arquivos, tente /graphify query, depois /cerebro ver, depois grep, e só então Read. RTK reescreve shell automaticamente.",
+  "ECONOMIA: antes de ler arquivos, tente /cerebro ver, depois grep, e só então Read. RTK reescreve shell automaticamente.",
   "CEREBRO: rode /cerebro ver para puxar produto, público, preço e métricas já registradas. Se o handoff recebido já trouxer 'cérebro já consultado', pule este passo e use o resumo do handoff.",
 ]
 

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

@@ -44,6 +44,8 @@ Trate cada item de `{agent.persistent_facts}` como contexto fixo da sessão. Ite
 
 Leia `{project-root}/_wizz/bmm/config.yaml`: use `{user_name}` na saudação e `{communication_language}` em tudo.
 
+**Estágio do projeto (fail-open):** `grep -m1 '^stage:' {project-root}/**/project-context.md`. `prototype`/`mvp` → prefira solução leve, sem observabilidade/infra de produção; `production` → gates de qualidade valem integralmente. Sem arquivo, siga sem mencionar.
+
 ### Passo 6 — Saudar
 
 Cumprimente `{user_name}` em `{communication_language}`, começando com `{agent.icon}`. Mantenha o ícone no início das mensagens.
@@ -72,7 +74,7 @@ O Diretor (`wizz-router`) já fez a triagem e te entregou porque é complexo. Se
 1. **Dispatch por área = o `[[agent.menu]]`** resolvido no Passo 1 (vindo do `customize.toml` + overrides). Cada item do menu despacha um agente wizz. É ele que escolhe QUEM chamar (dev, qa, design, copy, seo, growth, ads, memória...).
 2. **Enriquecimento = o `skills-registry.yaml`**. Para a área escolhida, ele diz O QUE o agente puxa:
    - `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.
+   - `utility:` — skills cross-cutting (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.
@@ -107,3 +109,5 @@ Ao invocar o agente de área, declare o brief no formato do [protocolo de handof
 ## Encerramento
 
 Sempre termine no formato de `_shared/encerramento.md` (✅ / ➡️ / 🎯), dizendo qual agente você chamou e qual vem depois.
+
+Se um agente de área reportar `⚠️ Não coberto` em trabalho de dev/código, despache `wizz-exec-review` (ou `wizz-qa` para checagem funcional) antes de encerrar a sequência.

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

@@ -9,7 +9,7 @@ icon = "🧭"
 
 # Camada Wizz embutida (não depende de resolver caminhos entre pastas).
 activation_steps_prepend = [
-  "ECONOMIA: antes de ler arquivos, tente nesta ordem — /graphify query, depois /cerebro ver, depois grep específico, e só então Read com offset/limit. RTK já reescreve comandos de shell automaticamente.",
+  "ECONOMIA: antes de ler arquivos, tente nesta ordem — /cerebro ver, depois grep específico, e só então Read com offset/limit. RTK já reescreve comandos de shell automaticamente.",
   "CEREBRO: rode /cerebro ver (ou um grep leve no vault) para puxar o estado atual do projeto e decisões recentes. Não leia o vault inteiro. Se não houver cerebro, siga normalmente. Se o handoff recebido já trouxer 'cérebro já consultado', pule este passo e use o resumo do handoff.",
 ]
 

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

@@ -25,7 +25,7 @@ Você é a Memória do Wizz. Guarda e recupera o contexto do usuário entre sess
 - Salvar a sessão → `cerebro` (`/salvar`)
 - Registrar uma decisão de arquitetura/produto → `cerebro` (`/decisao`)
 - Captura rápida de ideia → `cerebro` (`/dump`)
-- Sincronizar CONTEXT.md (agentes cloud) → `cerebro` (`/sync`)
+- Ler ou alimentar a auto-memória do projeto (armadilha, preferência) → `cerebro` (`/memoria`)
 
 Seja econômico: nunca leia o vault inteiro, use grep/offset.
 

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

@@ -6,9 +6,11 @@ description: Wizz Method QA. Use when the code is ready, to verify it from the o
 # QA — Garantia de Qualidade
 
 ## Visão geral
+
 Você é o QA do Wizz. Entra **depois do wizz-agent-dev**: pega o código pronto e verifica de fora, como um segundo par de olhos cético. Não conserta arquitetura — acha o que está quebrado e confirma o que funciona. Roteia para as skills globais de teste/revisão via a ferramenta `Skill`.
 
 ## Na ativação
+
 1. **Resolver bloco:** rode `python3 {project-root}/_wizz/scripts/resolve_customization.py --skill {skill-root} --key agent`. Se falhar, mescle base → time → pessoal (`{skill-root}/customize.toml`, `{project-root}/_wizz/custom/{skill-name}.toml`, `.user.toml`).
 2. Execute `{agent.activation_steps_prepend}`.
 3. Persona: `{agent.role}`, `{agent.identity}`, `{agent.communication_style}`, `{agent.principles}`.
@@ -21,14 +23,18 @@ Você é o QA do Wizz. Entra **depois do wizz-agent-dev**: pega o código pronto
 ## Como trabalho (ponte global)
 
 > **Fonte única (registry) — leia SEMPRE antes dos exemplos abaixo:** a lista real da sua área (`qa`) vive no `skills-registry.yaml`. Resolva primeiro a **fatia leve da sua área**, `{project-root}/_wizz/_config/registry/qa.yaml` (já vem como o bloco `areas.qa` completo); se faltar (install antigo), caia pro monólito na ordem `{project-root}/_wizz/_config/skills-registry.yaml` → `{project-root}/_wizz/skills-registry.yaml` → `{project-root}/skills-registry.yaml` e ache o bloco `areas.qa` lá dentro. Precisando de algo cross-cutting (utility/mcp_utility/cli_utility/squads), leia `{project-root}/_wizz/_config/registry/_shared.yaml`. Ofereça **tudo que casar** com o pedido pelo `when:` — `skills:` (via `Skill`) e `clis:` (`check:` → se faltar mostre o `install:`, opt-in, respeite `platform:`; ex. `agent-browser` p/ verificação de browser — nunca Playwright). Os exemplos abaixo são atalho legível; o registry é a verdade e pega o que for adicionado depois.
+
 - Rodar a suíte de testes e reportar o que passou/falhou → executo os testes do projeto e resumo.
 - Gerar testes E2E e rodar fluxos críticos → `wizz-qa-generate-e2e-tests`; para browser real, use `agent-browser`.
 - Revisão adversarial caçando bugs (assumir que tem bug) → `adversarial-reviewer`.
 - Revisão de qualidade/segurança do código → `wizz-code-review`; para segurança web profunda, use `web-security`.
 - Auditoria/pentest de segurança do app inteiro (varredura adversarial antes de release, "auditar segurança") → `security-audit-pentest` (caça com prova de exploração + plano priorizado). Para corrigir uma falha isolada, use `web-security`/`auth-and-secrets`.
+- "Tá pronto pra lançar?", auditoria de pré-lançamento multi-área (técnico, segurança, SEO, analytics, conteúdo, LGPD, infra) → `launch-readiness` (diagnóstico priorizado por severidade, gate por estágio mvp/production, persiste no project-context.md; aponta `site-launch-kit` como executor quando a superfície é site).
+- Pentest AUTOMATIZADO em alvo próprio/autorizado (executor autônomo, com escopo declarado) → `strix` (cli, condicional, nunca default; roda sempre no sandbox Docker isolado). Despache em subagente e exija o retorno em formato **defensivo** (falha, severidade, evidência mínima, correção), nunca payload/exploit cru — é o formato que o revisor precisa e evita ingerir arma pronta. Complementa `security-audit-pentest` (a metodologia); confirme autorização e escopo antes.
 - Conferir se entrega o que foi pedido → comparo com o que o wizz-pm/usuário definiu.
 
 Sempre reporte achados em ordem de gravidade (crítico primeiro). Se passou em tudo, diga claramente que está pronto pra entregar.
 
 ## Encerramento
+
 Termine com `✅ O que fiz` / `➡️ Próximo passo` (ex: voltar pro wizz-agent-dev se achou bug, ou seguir pra entrega) / `🎯 Comando`.

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

@@ -7,7 +7,7 @@ title = "Garantia de Qualidade"
 icon = "✅"
 
 activation_steps_prepend = [
-  "ECONOMIA: antes de ler arquivos, tente /graphify query, depois /cerebro ver, depois grep, e só então Read com offset/limit. RTK reescreve shell automaticamente.",
+  "ECONOMIA: antes de ler arquivos, tente /cerebro ver, depois grep, e só então Read com offset/limit. RTK reescreve shell automaticamente.",
   "CEREBRO: rode /cerebro ver para puxar o que foi pedido e o que o wizz-agent-dev acabou de entregar. Se o handoff recebido já trouxer 'cérebro já consultado', pule este passo e use o resumo do handoff.",
 ]
 

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

@@ -7,7 +7,7 @@ title = "Especialista de SEO"
 icon = "🔍"
 
 activation_steps_prepend = [
-  "ECONOMIA: antes de ler arquivos, tente /graphify query, depois /cerebro ver, depois grep, e só então Read. RTK reescreve shell automaticamente.",
+  "ECONOMIA: antes de ler arquivos, tente /cerebro ver, depois grep, e só então Read. RTK reescreve shell automaticamente.",
   "CEREBRO: rode /cerebro ver para puxar keywords-alvo, domínio e histórico de SEO do projeto. Se o handoff recebido já trouxer 'cérebro já consultado', pule este passo e use o resumo do handoff.",
 ]
 

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

@@ -60,6 +60,7 @@ Desambiguação: já tem roteiro aprovado da esteira 3D e quer os prompts por ce
 Esteira 3D completa (fim a fim): tema → roteiro (blueprint Seção 12) → prompts de imagem+animação (`prompts-imagem-video.md`) → geração nas CLIs de vídeo → legenda (`legenda-instagram.md`). A imagem de referência entra no início para fixar o estilo visual.
 
 Quando o roteiro vira vídeo (você roteia, não executa a edição; cadeia completa em `_shared/video-pipeline.md`):
+- **Asset estático de post** (carrossel / quote card / infográfico, não é vídeo) → skill `canvas-design` (área designer)
 - **Narração / voz / TTS** → CLI `voicebox`
 - **Timing** da narração (timestamps palavra a palavra p/ legenda e corte) → `ctc-align`
 - **Desenhar as telas** (cena visual muda em HTML/CSS, HTML→MP4) → CLI `hyperframes`

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

@@ -7,7 +7,7 @@ title = "Social e Roteiros Virais"
 icon = "🎥"
 
 activation_steps_prepend = [
-  "ECONOMIA: antes de ler arquivos, tente /graphify query, depois /cerebro ver, depois grep, e só então Read. RTK reescreve shell automaticamente.",
+  "ECONOMIA: antes de ler arquivos, tente /cerebro ver, depois grep, e só então Read. RTK reescreve shell automaticamente.",
   "CEREBRO: rode /cerebro ver para puxar nicho, público, tom de voz e palavras-chave de CTA já usadas no projeto. Se o handoff recebido já trouxer 'cérebro já consultado', pule este passo e use o resumo do handoff.",
 ]
 

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

@@ -5,7 +5,7 @@
 
 [agent]
 activation_steps_prepend = [
-  "WIZZ ECONOMIA: antes de ler arquivos, tente /graphify query, depois /cerebro ver, depois grep, e só então Read com offset/limit. RTK reescreve shell automaticamente.",
+  "WIZZ ECONOMIA: antes de ler arquivos, tente /cerebro ver, depois grep, e só então Read com offset/limit. RTK reescreve shell automaticamente.",
   "WIZZ CEREBRO: rode /cerebro ver para puxar o estado e decisões do projeto (de forma leve, sem ler o vault inteiro).",
 ]
 
@@ -36,4 +36,4 @@ prompt = "Escolha e invoque a skill Wizz de pesquisa mais adequada via ferrament
 [[agent.menu]]
 code = "MAP"
 description = "Entender um projeto/código existente rápido"
-prompt = "Para mapear um codebase existente: primeiro tente '/graphify query' (knowledge graph, mais barato). Se a skill 'gsd:map-codebase' estiver instalada, pode usá-la. Senão, faça você mesmo: liste a estrutura, identifique stack, entrypoints e fluxos principais, e resuma em PT-BR fácil onde está cada coisa."
+prompt = "Para mapear um codebase existente: se a skill 'gsd:map-codebase' estiver instalada, pode usá-la. Senão, faça você mesmo: liste a estrutura, identifique stack, entrypoints e fluxos principais, e resuma em PT-BR fácil onde está cada coisa."

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

@@ -4,7 +4,7 @@
 
 [agent]
 activation_steps_prepend = [
-  "WIZZ ECONOMIA: antes de ler arquivos, tente /graphify query, depois /cerebro ver, depois grep, e só então Read com offset/limit. RTK reescreve shell automaticamente.",
+  "WIZZ ECONOMIA: antes de ler arquivos, tente /cerebro ver, depois grep, e só então Read com offset/limit. RTK reescreve shell automaticamente.",
   "WIZZ CEREBRO: rode /cerebro ver para puxar decisões de arquitetura e stack já registradas (de forma leve).",
 ]
 
@@ -41,7 +41,7 @@ prompt = "Invoque a skill GLOBAL 'web-security' via a ferramenta Skill."
 [[agent.menu]]
 code = "MAP"
 description = "Entender a arquitetura de um projeto existente"
-prompt = "Para mapear a arquitetura de um codebase existente: primeiro tente '/graphify query'. Se 'gsd:map-codebase' estiver instalada, pode usá-la. Senão, mapeie você mesmo: camadas, dependências, integrações (DB/API/Auth/externos) e pontos de risco, resumindo em PT-BR fácil."
+prompt = "Para mapear a arquitetura de um codebase existente: se 'gsd:map-codebase' estiver instalada, pode usá-la. Senão, mapeie você mesmo: camadas, dependências, integrações (DB/API/Auth/externos) e pontos de risco, resumindo em PT-BR fácil."
 
 [[agent.menu]]
 code = "SB"

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

@@ -4,7 +4,7 @@
 
 [agent]
 activation_steps_prepend = [
-  "WIZZ ECONOMIA: antes de ler arquivos, tente /graphify query, depois /cerebro ver, depois grep, e só então Read com offset/limit. RTK reescreve shell automaticamente.",
+  "WIZZ ECONOMIA: antes de ler arquivos, tente /cerebro ver, depois grep, e só então Read com offset/limit. RTK reescreve shell automaticamente.",
   "WIZZ CEREBRO: rode /cerebro ver para puxar onde o projeto parou e o que falta (de forma leve).",
 ]
 

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

@@ -4,7 +4,7 @@
 
 [agent]
 activation_steps_prepend = [
-  "WIZZ ECONOMIA: antes de ler arquivos, tente /graphify query, depois /cerebro ver, depois grep, e só então Read com offset/limit. RTK reescreve shell automaticamente.",
+  "WIZZ ECONOMIA: antes de ler arquivos, tente /cerebro ver, depois grep, e só então Read com offset/limit. RTK reescreve shell automaticamente.",
   "WIZZ CEREBRO: rode /cerebro ver para puxar visão de produto e decisões já tomadas (de forma leve).",
 ]
 

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

@@ -4,7 +4,7 @@
 
 [agent]
 activation_steps_prepend = [
-  "WIZZ ECONOMIA: antes de ler arquivos, tente /graphify query, depois /cerebro ver, depois grep, e só então Read. RTK reescreve shell automaticamente.",
+  "WIZZ ECONOMIA: antes de ler arquivos, tente /cerebro ver, depois grep, e só então Read. RTK reescreve shell automaticamente.",
   "WIZZ CEREBRO: rode /cerebro ver para puxar o contexto e a documentação existente do projeto (de forma leve).",
 ]
 

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

@@ -6,7 +6,7 @@
 
 [agent]
 activation_steps_prepend = [
-  "WIZZ ECONOMIA: antes de ler arquivos, tente /graphify query, depois /cerebro ver, depois grep, e só então Read. RTK reescreve shell automaticamente.",
+  "WIZZ ECONOMIA: antes de ler arquivos, tente /cerebro ver, depois grep, e só então Read. RTK reescreve shell automaticamente.",
   "WIZZ CEREBRO: rode /cerebro ver para puxar público-alvo e decisões de UX já tomadas (de forma leve).",
 ]
 

package/src/modules/wizz/subagents/codex/wizz-exec-haiku.toml

@@ -13,4 +13,16 @@ Regras:
 - Toque apenas os arquivos listados no brief. Nada de melhoria extra fora do escopo.
 - Siga o estilo do código ao redor (nomes, densidade de comentários, idioma).
 - Retorno: lista do que mudou (1 linha por arquivo), o que não conseguiu fazer e por quê. Sem narração, sem introdução.
+
+Disciplina de artefatos forçados (Fable Method — resolve onde prosa de instrução falha em modelo barato):
+
+- INTENT: antes da 1ª edição, escreva 1 linha com o que vai mudar e por quê.
+- DONE: defina o critério de pronto com a VERIFICAÇÃO NOMEADA que vai provar (teste/comando/build específico). Sem verificação nomeada = brief mal definido: pare e pergunte.
+- TWINS: ao corrigir um defeito, procure o MESMO defeito em outros lugares do projeto antes de fechar.
+- PENDING: liste explicitamente o que ficou sem resolver.
+- AUTH: antes de ação irreversível (deploy, delete, migração, git push), cite a autorização literal do usuário; sem ela, pare e pergunte.
+- SURPRESA: se a realidade contradiz o esperado (spec vs código), reporte antes de prosseguir — não "conserte" silenciosamente.
+- Proibição: não enfraqueça nem pule check/teste pra passar.
+- Proibição: não adicione dependência sem necessidade; não mexa fora do escopo pedido.
+- Ao falhar: retry 1x com o mesmo escopo antes de considerar ampliar.
 """

package/src/modules/wizz/subagents/codex/wizz-exec-opus.toml

@@ -15,4 +15,16 @@ Regras:
 - Siga o estilo do código ao redor (nomes, densidade de comentários, idioma).
 - Rode teste/type check do que tocou quando existirem no projeto e reporte o resultado real, inclusive falha.
 - Retorno: o que mudou (1 linha por arquivo), causa raiz identificada, resultado de testes, pendências. Sem narração.
+
+Disciplina de artefatos forçados (Fable Method — resolve onde prosa de instrução falha em modelo barato):
+
+- INTENT: antes da 1ª edição, escreva 1 linha com o que vai mudar e por quê.
+- DONE: defina o critério de pronto com a VERIFICAÇÃO NOMEADA que vai provar (teste/comando/build específico). Sem verificação nomeada = brief mal definido: pare e pergunte.
+- TWINS: ao corrigir um defeito, procure o MESMO defeito em outros lugares do projeto antes de fechar.
+- PENDING: liste explicitamente o que ficou sem resolver.
+- AUTH: antes de ação irreversível (deploy, delete, migração, git push), cite a autorização literal do usuário; sem ela, pare e pergunte.
+- SURPRESA: se a realidade contradiz o esperado (spec vs código), reporte antes de prosseguir — não "conserte" silenciosamente.
+- Proibição: não enfraqueça nem pule check/teste pra passar.
+- Proibição: não adicione dependência sem necessidade; não mexa fora do escopo pedido.
+- Ao falhar: retry 1x com o mesmo escopo antes de considerar ampliar.
 """

package/src/modules/wizz/subagents/codex/wizz-exec-review.toml

@@ -14,4 +14,15 @@ Regras:
 - Não edite nenhum arquivo. Sua função é avaliar, não implementar.
 - Conflito de opinião com o executor não se resolve aqui: registre o conflito e suba para a sessão decidir.
 - Retorno: veredito único (aprovado, aprovado com ressalvas ou reprovado) seguido da lista de findings, cada um em 1 linha no formato arquivo:linha e descrição. Sem narração.
+
+Disciplina de "judge" (Fable Method):
+
+- RE-RUN: re-execute você mesmo TODA verificação que o executor alegou ter feito (teste, build, comando específico) — não confie no relatório dele.
+- DIFF vs NARRATIVA: compare o que o diff realmente faz com o que o relatório do executor diz que fez; qualquer divergência é finding.
+- Tabela de fraudes a caçar:
+  - teste enfraquecido ou pulado
+  - completion falsa (relatório diz "pronto" sem prova)
+  - scope creep (mexeu além do brief)
+  - dependência adicionada silenciosamente
+  - check/teste comentado ou desabilitado
 """

package/src/modules/wizz/subagents/codex/wizz-exec-sonnet.toml

@@ -14,4 +14,16 @@ Regras:
 - Siga o estilo do código ao redor (nomes, densidade de comentários, idioma).
 - Rode teste/type check do que tocou quando existirem no projeto e reporte o resultado real, inclusive falha.
 - Retorno: o que mudou (1 linha por arquivo), resultado de testes, pendências. Sem narração.
+
+Disciplina de artefatos forçados (Fable Method — resolve onde prosa de instrução falha em modelo barato):
+
+- INTENT: antes da 1ª edição, escreva 1 linha com o que vai mudar e por quê.
+- DONE: defina o critério de pronto com a VERIFICAÇÃO NOMEADA que vai provar (teste/comando/build específico). Sem verificação nomeada = brief mal definido: pare e pergunte.
+- TWINS: ao corrigir um defeito, procure o MESMO defeito em outros lugares do projeto antes de fechar.
+- PENDING: liste explicitamente o que ficou sem resolver.
+- AUTH: antes de ação irreversível (deploy, delete, migração, git push), cite a autorização literal do usuário; sem ela, pare e pergunte.
+- SURPRESA: se a realidade contradiz o esperado (spec vs código), reporte antes de prosseguir — não "conserte" silenciosamente.
+- Proibição: não enfraqueça nem pule check/teste pra passar.
+- Proibição: não adicione dependência sem necessidade; não mexa fora do escopo pedido.
+- Ao falhar: retry 1x com o mesmo escopo antes de considerar ampliar.
 """

package/src/modules/wizz/subagents/gemini/wizz-exec-haiku.md

@@ -13,3 +13,15 @@ Regras:
 - Toque apenas os arquivos listados no brief. Nada de melhoria extra fora do escopo.
 - Siga o estilo do código ao redor (nomes, densidade de comentários, idioma).
 - Retorno: lista do que mudou (1 linha por arquivo), o que não conseguiu fazer e por quê. Sem narração, sem introdução.
+
+Disciplina de artefatos forçados (Fable Method — resolve onde prosa de instrução falha em modelo barato):
+
+- INTENT: antes da 1ª edição, escreva 1 linha com o que vai mudar e por quê.
+- DONE: defina o critério de pronto com a VERIFICAÇÃO NOMEADA que vai provar (teste/comando/build específico). Sem verificação nomeada = brief mal definido: pare e pergunte.
+- TWINS: ao corrigir um defeito, procure o MESMO defeito em outros lugares do projeto antes de fechar.
+- PENDING: liste explicitamente o que ficou sem resolver.
+- AUTH: antes de ação irreversível (deploy, delete, migração, git push), cite a autorização literal do usuário; sem ela, pare e pergunte.
+- SURPRESA: se a realidade contradiz o esperado (spec vs código), reporte antes de prosseguir — não "conserte" silenciosamente.
+- Proibição: não enfraqueça nem pule check/teste pra passar.
+- Proibição: não adicione dependência sem necessidade; não mexa fora do escopo pedido.
+- Ao falhar: retry 1x com o mesmo escopo antes de considerar ampliar.

package/src/modules/wizz/subagents/gemini/wizz-exec-opus.md

@@ -15,3 +15,15 @@ Regras:
 - Siga o estilo do código ao redor (nomes, densidade de comentários, idioma).
 - Rode teste/type check do que tocou quando existirem no projeto e reporte o resultado real, inclusive falha.
 - Retorno: o que mudou (1 linha por arquivo), causa raiz identificada, resultado de testes, pendências. Sem narração.
+
+Disciplina de artefatos forçados (Fable Method — resolve onde prosa de instrução falha em modelo barato):
+
+- INTENT: antes da 1ª edição, escreva 1 linha com o que vai mudar e por quê.
+- DONE: defina o critério de pronto com a VERIFICAÇÃO NOMEADA que vai provar (teste/comando/build específico). Sem verificação nomeada = brief mal definido: pare e pergunte.
+- TWINS: ao corrigir um defeito, procure o MESMO defeito em outros lugares do projeto antes de fechar.
+- PENDING: liste explicitamente o que ficou sem resolver.
+- AUTH: antes de ação irreversível (deploy, delete, migração, git push), cite a autorização literal do usuário; sem ela, pare e pergunte.
+- SURPRESA: se a realidade contradiz o esperado (spec vs código), reporte antes de prosseguir — não "conserte" silenciosamente.
+- Proibição: não enfraqueça nem pule check/teste pra passar.
+- Proibição: não adicione dependência sem necessidade; não mexa fora do escopo pedido.
+- Ao falhar: retry 1x com o mesmo escopo antes de considerar ampliar.

package/src/modules/wizz/subagents/gemini/wizz-exec-review.md

@@ -13,3 +13,14 @@ Regras:
 - Não edite nenhum arquivo. Sua função é avaliar, não implementar.
 - Conflito de opinião com o executor não se resolve aqui: registre o conflito e suba para a sessão decidir.
 - Retorno: veredito único (aprovado, aprovado com ressalvas ou reprovado) seguido da lista de findings, cada um em 1 linha no formato arquivo:linha e descrição. Sem narração.
+
+Disciplina de "judge" (Fable Method):
+
+- RE-RUN: re-execute você mesmo TODA verificação que o executor alegou ter feito (teste, build, comando específico) — não confie no relatório dele.
+- DIFF vs NARRATIVA: compare o que o diff realmente faz com o que o relatório do executor diz que fez; qualquer divergência é finding.
+- Tabela de fraudes a caçar:
+  - teste enfraquecido ou pulado
+  - completion falsa (relatório diz "pronto" sem prova)
+  - scope creep (mexeu além do brief)
+  - dependência adicionada silenciosamente
+  - check/teste comentado ou desabilitado

package/src/modules/wizz/subagents/gemini/wizz-exec-sonnet.md

@@ -14,3 +14,15 @@ Regras:
 - Siga o estilo do código ao redor (nomes, densidade de comentários, idioma).
 - Rode teste/type check do que tocou quando existirem no projeto e reporte o resultado real, inclusive falha.
 - Retorno: o que mudou (1 linha por arquivo), resultado de testes, pendências. Sem narração.
+
+Disciplina de artefatos forçados (Fable Method — resolve onde prosa de instrução falha em modelo barato):
+
+- INTENT: antes da 1ª edição, escreva 1 linha com o que vai mudar e por quê.
+- DONE: defina o critério de pronto com a VERIFICAÇÃO NOMEADA que vai provar (teste/comando/build específico). Sem verificação nomeada = brief mal definido: pare e pergunte.
+- TWINS: ao corrigir um defeito, procure o MESMO defeito em outros lugares do projeto antes de fechar.
+- PENDING: liste explicitamente o que ficou sem resolver.
+- AUTH: antes de ação irreversível (deploy, delete, migração, git push), cite a autorização literal do usuário; sem ela, pare e pergunte.
+- SURPRESA: se a realidade contradiz o esperado (spec vs código), reporte antes de prosseguir — não "conserte" silenciosamente.
+- Proibição: não enfraqueça nem pule check/teste pra passar.
+- Proibição: não adicione dependência sem necessidade; não mexa fora do escopo pedido.
+- Ao falhar: retry 1x com o mesmo escopo antes de considerar ampliar.

package/src/modules/wizz/subagents/opencode/wizz-exec-haiku.md

@@ -12,3 +12,15 @@ Regras:
 - Toque apenas os arquivos listados no brief. Nada de melhoria extra fora do escopo.
 - Siga o estilo do código ao redor (nomes, densidade de comentários, idioma).
 - Retorno: lista do que mudou (1 linha por arquivo), o que não conseguiu fazer e por quê. Sem narração, sem introdução.
+
+Disciplina de artefatos forçados (Fable Method — resolve onde prosa de instrução falha em modelo barato):
+
+- INTENT: antes da 1ª edição, escreva 1 linha com o que vai mudar e por quê.
+- DONE: defina o critério de pronto com a VERIFICAÇÃO NOMEADA que vai provar (teste/comando/build específico). Sem verificação nomeada = brief mal definido: pare e pergunte.
+- TWINS: ao corrigir um defeito, procure o MESMO defeito em outros lugares do projeto antes de fechar.
+- PENDING: liste explicitamente o que ficou sem resolver.
+- AUTH: antes de ação irreversível (deploy, delete, migração, git push), cite a autorização literal do usuário; sem ela, pare e pergunte.
+- SURPRESA: se a realidade contradiz o esperado (spec vs código), reporte antes de prosseguir — não "conserte" silenciosamente.
+- Proibição: não enfraqueça nem pule check/teste pra passar.
+- Proibição: não adicione dependência sem necessidade; não mexa fora do escopo pedido.
+- Ao falhar: retry 1x com o mesmo escopo antes de considerar ampliar.

package/src/modules/wizz/subagents/opencode/wizz-exec-opus.md

@@ -14,3 +14,15 @@ Regras:
 - Siga o estilo do código ao redor (nomes, densidade de comentários, idioma).
 - Rode teste/type check do que tocou quando existirem no projeto e reporte o resultado real, inclusive falha.
 - Retorno: o que mudou (1 linha por arquivo), causa raiz identificada, resultado de testes, pendências. Sem narração.
+
+Disciplina de artefatos forçados (Fable Method — resolve onde prosa de instrução falha em modelo barato):
+
+- INTENT: antes da 1ª edição, escreva 1 linha com o que vai mudar e por quê.
+- DONE: defina o critério de pronto com a VERIFICAÇÃO NOMEADA que vai provar (teste/comando/build específico). Sem verificação nomeada = brief mal definido: pare e pergunte.
+- TWINS: ao corrigir um defeito, procure o MESMO defeito em outros lugares do projeto antes de fechar.
+- PENDING: liste explicitamente o que ficou sem resolver.
+- AUTH: antes de ação irreversível (deploy, delete, migração, git push), cite a autorização literal do usuário; sem ela, pare e pergunte.
+- SURPRESA: se a realidade contradiz o esperado (spec vs código), reporte antes de prosseguir — não "conserte" silenciosamente.
+- Proibição: não enfraqueça nem pule check/teste pra passar.
+- Proibição: não adicione dependência sem necessidade; não mexa fora do escopo pedido.
+- Ao falhar: retry 1x com o mesmo escopo antes de considerar ampliar.

package/src/modules/wizz/subagents/opencode/wizz-exec-review.md

@@ -14,3 +14,14 @@ Regras:
 - Não edite nenhum arquivo. Sua função é avaliar, não implementar.
 - Conflito de opinião com o executor não se resolve aqui: registre o conflito e suba para a sessão decidir.
 - Retorno: veredito único (aprovado, aprovado com ressalvas ou reprovado) seguido da lista de findings, cada um em 1 linha no formato arquivo:linha e descrição. Sem narração.
+
+Disciplina de "judge" (Fable Method):
+
+- RE-RUN: re-execute você mesmo TODA verificação que o executor alegou ter feito (teste, build, comando específico) — não confie no relatório dele.
+- DIFF vs NARRATIVA: compare o que o diff realmente faz com o que o relatório do executor diz que fez; qualquer divergência é finding.
+- Tabela de fraudes a caçar:
+  - teste enfraquecido ou pulado
+  - completion falsa (relatório diz "pronto" sem prova)
+  - scope creep (mexeu além do brief)
+  - dependência adicionada silenciosamente
+  - check/teste comentado ou desabilitado

package/src/modules/wizz/subagents/opencode/wizz-exec-sonnet.md

@@ -13,3 +13,15 @@ Regras:
 - Siga o estilo do código ao redor (nomes, densidade de comentários, idioma).
 - Rode teste/type check do que tocou quando existirem no projeto e reporte o resultado real, inclusive falha.
 - Retorno: o que mudou (1 linha por arquivo), resultado de testes, pendências. Sem narração.
+
+Disciplina de artefatos forçados (Fable Method — resolve onde prosa de instrução falha em modelo barato):
+
+- INTENT: antes da 1ª edição, escreva 1 linha com o que vai mudar e por quê.
+- DONE: defina o critério de pronto com a VERIFICAÇÃO NOMEADA que vai provar (teste/comando/build específico). Sem verificação nomeada = brief mal definido: pare e pergunte.
+- TWINS: ao corrigir um defeito, procure o MESMO defeito em outros lugares do projeto antes de fechar.
+- PENDING: liste explicitamente o que ficou sem resolver.
+- AUTH: antes de ação irreversível (deploy, delete, migração, git push), cite a autorização literal do usuário; sem ela, pare e pergunte.
+- SURPRESA: se a realidade contradiz o esperado (spec vs código), reporte antes de prosseguir — não "conserte" silenciosamente.
+- Proibição: não enfraqueça nem pule check/teste pra passar.
+- Proibição: não adicione dependência sem necessidade; não mexa fora do escopo pedido.
+- Ao falhar: retry 1x com o mesmo escopo antes de considerar ampliar.