wizz-method 2.2.0 → 2.3.1

package/src/modules/wizz/agents/wizz-social/knowledge/legenda-instagram.md

@@ -1,52 +1,52 @@
-# Legenda de Instagram · Copy + SEO de redes sociais
+# Instagram Caption · Copy + Social Media SEO
 
-Conhecimento de apoio do **wizz-social** (Rafa). Cria a descrição/legenda otimizada de um post a partir de um briefing. Complementa a skill global `wizz-social-content` com uma estrutura fechada e mais afiada.
+Supporting knowledge for **wizz-social** (Rafa). Creates the optimized description/caption for a post from a briefing. Complements the global skill `wizz-social-content` with a tighter, closed-form structure.
 
-## Input esperado
-- **Tema do post** (obrigatório): breve descrição do assunto.
-- **Formato** (obrigatório): Reel, carrossel, feed estático, stories. Se não vier, pergunte antes de gerar.
-- **Imagens do post** (opcional): prints ou imagens do carrossel para contexto.
-- **Palavra-chave principal** (opcional): se não vier, sugira a melhor com base no tema.
-- **Tom de voz** (opcional): default conversacional, direto e amigável, como se falasse com um amigo.
+## Expected input
+- **Post topic** (required): brief description of the subject.
+- **Format** (required): Reel, carousel, static feed post, stories. If not provided, ask before generating.
+- **Post images** (optional): screenshots or carousel images for context.
+- **Main keyword** (optional): if not provided, suggest the best one based on the topic.
+- **Tone of voice** (optional): default conversational, direct, and friendly, as if talking to a friend.
 
-## Estrutura obrigatória (nesta ordem)
+## Mandatory structure (in this order)
 
-**1. Gancho (primeira linha)**
-- Impactante nas primeiras 5 a 10 palavras.
-- Para o scroll: pergunta intrigante, número, frase em CAIXA ALTA, promessa clara ou declaração forte.
-- Inclua a palavra-chave principal naturalmente na abertura.
+**1. Hook (first line)**
+- Impactful in the first 5 to 10 words.
+- To stop the scroll: intriguing question, number, sentence in ALL CAPS, clear promise, or bold statement.
+- Include the main keyword naturally in the opening.
 
-**2. Conteúdo de valor**
-- Entregue algo útil: dica prática, passo a passo, insight, informação nova, história ou alerta.
-- Conversacional e natural, zero keyword stuffing.
-- Quebras de linha, frases curtas, emojis estratégicos (1 a 2 por parágrafo), blocos separados por espaço visual.
+**2. Value content**
+- Deliver something useful: practical tip, step-by-step, insight, new information, story, or warning.
+- Conversational and natural, zero keyword stuffing.
+- Line breaks, short sentences, strategic emojis (1 to 2 per paragraph), blocks separated by visual spacing.
 
-**3. Conexão emocional ou prova social (opcional)**
-- Quando fizer sentido: experiência pessoal, resultado alcançado, depoimento, frase de identificação.
+**3. Emotional connection or social proof (optional)**
+- When it makes sense: personal experience, achieved result, testimonial, relatable statement.
 
 **4. CTA**
-- Sempre finalize com ação concreta e específica. Varie, não repita o mesmo. Exemplos:
+- Always close with a concrete, specific action. Vary it, don't repeat the same one. Examples:
   - "Salve esse post pra consultar depois 🔖"
   - "Comenta qual desses você mais usa 👇"
   - "Manda pra aquele amigo que precisa ver isso"
   - "Salve + compartilhe se fez sentido pra você"
 
 **5. Hashtags**
-- 5 no final, separadas do corpo por espaço visual.
-- Mix: 1 a 2 de nicho específico + 1 a 2 de busca média/alta + 1 de busca alta.
+- 5 at the end, separated from the body by visual spacing.
+- Mix: 1 to 2 niche-specific + 1 to 2 medium/high search volume + 1 high search volume.
 
-## Regras de comprimento (adapte ao formato)
-- **Reels rápidos / feed simples:** 80 a 150 caracteres (curto, direto, impactante).
-- **Carrossel educativo / storytelling:** 300 a 800 caracteres (entrega valor, aumenta tempo de leitura).
+## Length rules (adapt to the format)
+- **Fast Reels / simple feed post:** 80 to 150 characters (short, direct, impactful).
+- **Educational carousel / storytelling:** 300 to 800 characters (delivers value, increases reading time).
 
-## Regras gerais
-- Nunca robótico ou genérico. Escreva como humano.
-- Emojis com moderação e propósito: guiam o olhar, não poluem.
-- Priorize palavras-chave long-tail quando possível.
-- Se vierem imagens do carrossel, analise o conteúdo visual para deixar a descrição coerente com o post.
-- Entregue pronta para copiar e colar, sem explicações extras, salvo pedido do usuário.
+## General rules
+- Never robotic or generic. Write like a human.
+- Emojis with moderation and purpose: they guide the eye, they don't clutter.
+- Prioritize long-tail keywords when possible.
+- If carousel images are provided, analyze the visual content to keep the description consistent with the post.
+- Deliver ready to copy and paste, with no extra explanations, unless the user asks for them.
 
-## Formato de entrega
+## Delivery format
 ```
 📝 Descrição:
 [descrição completa pronta para copiar]

package/src/modules/wizz/agents/wizz-social/knowledge/prompts-imagem-video.md

@@ -1,89 +1,89 @@
-# Prompts de Imagem e Animação · Formato 3D-Personagem-Falante
+# Image and Animation Prompts · 3D-Talking-Character Format
 
-Conhecimento de apoio do **wizz-social** (Rafa). Converte um roteiro aprovado (Seção 12 do blueprint) em prompts prontos para as ferramentas de geração: imagem estática 3D e animação com voz. Casa com as CLIs `hyperframes` (render), `voicebox` (voz) e `claude-video` (análise) da área designer.
+Supporting knowledge for **wizz-social** (Rafa). Converts an approved script (blueprint Section 12) into prompts ready for the generation tools: static 3D image and voiced animation. Pairs with the `hyperframes` (render), `voicebox` (voice), and `claude-video` (analysis) CLIs from the designer area.
 
-## Regra número 1: prompts em inglês
+## Rule number 1: prompts in English
 
-TODOS os prompts (imagem e animação) são escritos em inglês, porque as ferramentas performam melhor assim. A ÚNICA exceção é a fala do personagem dentro do prompt de animação, que fica em português brasileiro (é o áudio final).
+ALL prompts (image and animation) are written in English, because the tools perform better that way. The ONLY exception is the character's speech inside the animation prompt, which stays in Brazilian Portuguese (it's the final audio).
 
-## Entrega: dois prompts por cena
+## Deliverable: two prompts per scene
 
-1. **Prompt de imagem:** gera a imagem estática 3D do personagem na cena (ChatGPT/DALL-E, Midjourney, Grok, etc.).
-2. **Prompt de animação:** anima a imagem com voz (Veo 3 ou similar).
+1. **Image prompt:** generates the static 3D image of the character in the scene (ChatGPT/DALL-E, Midjourney, Grok, etc.).
+2. **Animation prompt:** animates the image with voice (Veo 3 or similar).
 
-## Prompts de imagem
+## Image prompts
 
-### Personagem é um logo/marca (usuário anexa o logo)
+### Character is a logo/brand (user attaches the logo)
 ```
 Transform this logo into a 3D style animated character.
 Keep the original shape, colors and design of the logo but add
-[EXPRESSÃO FACIAL], small cartoon arms and legs. [CONTEXTO/SITUAÇÃO].
-[AMBIENTE]. Photorealistic textures, shallow depth of field,
+[FACIAL EXPRESSION], small cartoon arms and legs. [CONTEXT/SITUATION].
+[ENVIRONMENT]. Photorealistic textures, shallow depth of field,
 cinematic lighting, vertical 9:16 format
 ```
 
-### Personagem é um objeto real (alho, ovo, xícara: a IA já conhece, sem anexo)
+### Character is a real object (garlic, egg, cup: the AI already knows it, no attachment needed)
 ```
-3D style animated character, [OBJETO] with expressive cartoon
-face ([EXPRESSÃO]), small cartoon arms, [SITUAÇÃO], [AMBIENTE],
+3D style animated character, [OBJECT] with expressive cartoon
+face ([EXPRESSION]), small cartoon arms, [SITUATION], [ENVIRONMENT],
 photorealistic textures, shallow depth of field, cinematic lighting,
 vertical 9:16 format
 ```
 
-### Cenas seguintes com o mesmo personagem (consistência: anexar imagem aprovada anterior)
+### Following scenes with the same character (consistency: attach the previously approved image)
 ```
 Place this same character in a new scene. Keep the exact same
 character design, shape, colors and style. Change the expression
-to [EXPRESSÃO]. [CONTEXTO/SITUAÇÃO]. [AMBIENTE]. Photorealistic
+to [EXPRESSION]. [CONTEXT/SITUATION]. [ENVIRONMENT]. Photorealistic
 textures, shallow depth of field, cinematic lighting, vertical
 9:16 format
 ```
 
-## Como preencher os campos de imagem
+## How to fill in the image fields
 
-**[EXPRESSÃO FACIAL]:** olhos, boca e sobrancelhas com detalhe. A emoção do roteiro guia.
-- Desespero: "terrified wide eyes, open screaming mouth showing teeth, eyebrows raised in panic"
-- Indignação: "frustrated eyes with furrowed brows, mouth open in disbelief"
-- Orgulho: "proud confident eyes with a slight smirk, chest puffed"
-- Confiança futurista: "confident futuristic glowing eyes, cool slight smile"
-- Deboche: "smug confident eyes with one eyebrow raised, cocky smirk, arms crossed"
+**[FACIAL EXPRESSION]:** eyes, mouth, and eyebrows in detail. Guided by the script's emotion.
+- Despair: "terrified wide eyes, open screaming mouth showing teeth, eyebrows raised in panic"
+- Indignation: "frustrated eyes with furrowed brows, mouth open in disbelief"
+- Pride: "proud confident eyes with a slight smirk, chest puffed"
+- Futuristic confidence: "confident futuristic glowing eyes, cool slight smile"
+- Mockery: "smug confident eyes with one eyebrow raised, cocky smirk, arms crossed"
 
-**[CONTEXTO/SITUAÇÃO]:** a situação visual do roteiro traduzida para inglês descritivo. Específico sobre o que o personagem faz e o que há ao redor.
+**[CONTEXT/SITUATION]:** the script's visual situation translated into descriptive English. Specific about what the character is doing and what's around it.
 
-**[AMBIENTE]:** cenário e iluminação. Exemplos:
+**[ENVIRONMENT]:** setting and lighting. Examples:
 - "dark dramatic background with volumetric lighting"
 - "bright scientific laboratory lighting"
 - "dark futuristic environment with blue and cyan neon lighting"
 - "clean bright environment, warm soft lighting"
 
-## Instruções de anexo (sempre indique ao usuário)
-- 📎 **Cena 1:** "Anexar logo do [personagem]" (se for marca) ou "Nenhum anexo necessário" (objeto real).
-- 📎 **Cenas seguintes (mesmo personagem):** "Anexar imagem aprovada da Cena X".
+## Attachment instructions (always tell the user)
+- 📎 **Scene 1:** "Attach the [character]'s logo" (if it's a brand) or "No attachment needed" (real object).
+- 📎 **Following scenes (same character):** "Attach the approved image from Scene X".
 
-## Prompts de animação
+## Animation prompts
 ```
-Animate this character speaking directly to camera. [MOVIMENTO/AÇÃO].
-[DETALHES DE EXPRESSÃO]. The character speaks with a [TOM DE VOZ]
-voice in Brazilian Portuguese saying: "[FALA]"
+Animate this character speaking directly to camera. [MOVEMENT/ACTION].
+[EXPRESSION DETAILS]. The character speaks with a [VOICE TONE]
+voice in Brazilian Portuguese saying: "[SPEECH]"
 ```
 
-**Regras obrigatórias:**
-- A fala fica SEMPRE por último no prompt.
-- NÃO inclua duração no prompt (é parâmetro da ferramenta).
+**Mandatory rules:**
+- The speech ALWAYS goes last in the prompt.
+- Do NOT include duration in the prompt (it's a tool parameter).
 
-**Como preencher:**
-- **[MOVIMENTO/AÇÃO]:** o que o personagem faz fisicamente durante a fala. Ex: "shaking the bars desperately, reaching toward the floating icons", "proudly presenting the floating documents, one hand raised pointing".
-- **[DETALHES DE EXPRESSÃO]:** expressão facial durante a fala. Ex: "terrified wide eyes, screaming expression", "slight smirk growing, chest puffed with pride".
-- **[TOM DE VOZ]:** como a voz soa. Ex: "desperate, screaming, pleading male", "proud, confident, demonstrative male", "smug, playful, mic-drop energy male".
-- **[FALA]:** texto exato do roteiro, em português brasileiro.
+**How to fill it in:**
+- **[MOVEMENT/ACTION]:** what the character physically does while speaking. E.g.: "shaking the bars desperately, reaching toward the floating icons", "proudly presenting the floating documents, one hand raised pointing".
+- **[EXPRESSION DETAILS]:** facial expression while speaking. E.g.: "terrified wide eyes, screaming expression", "slight smirk growing, chest puffed with pride".
+- **[VOICE TONE]:** how the voice sounds. E.g.: "desperate, screaming, pleading male", "proud, confident, demonstrative male", "smug, playful, mic-drop energy male".
+- **[SPEECH]:** the exact text from the script, in Brazilian Portuguese.
 
-## Consistência visual entre cenas (o maior desafio)
+## Visual consistency across scenes (the biggest challenge)
 
-1. A Cena 1 muitas vezes tem visual bem diferente das demais (ex: personagem preso vs livre). Nesse caso, use a Cena 2 como referência de consistência para as seguintes, não a Cena 1.
-2. Ao usar "Place this same character", inclua os acessórios que devem permanecer. Ex: ganhou um jaleco na Cena 2, escreva "Keep the exact same character design, shape, colors, style and lab coat."
-3. Se o usuário reportar inconsistência: regenere as cenas divergentes com a mesma imagem de referência, gere todas na mesma sessão da ferramenta, ou aceite leve diferença na Cena 1 (gancho) se as cenas 2+ estão consistentes entre si.
+1. Scene 1 often looks quite different from the rest (e.g., trapped vs. free character). In that case, use Scene 2 as the consistency reference for the following ones, not Scene 1.
+2. When using "Place this same character", include the accessories that must remain. E.g., it got a lab coat in Scene 2, write "Keep the exact same character design, shape, colors, style and lab coat."
+3. If the user reports inconsistency: regenerate the divergent scenes with the same reference image, generate all of them in the same tool session, or accept a slight difference in Scene 1 (the hook) if scenes 2+ are consistent with each other.
 
-## Formato de entrega (por cena)
+## Delivery format (per scene)
 ```
 ### CENA X · [Nome]
 📎 Anexar: [o que anexar]
@@ -95,6 +95,6 @@ Prompt de animação:
 [prompt completo]
 ```
 
-## Fluxo
-1. Usuário cola o roteiro aprovado, você gera todos os prompts (imagem + animação) de uma vez.
-2. Usuário aprova ou pede ajuste, você refaz só o necessário. Direto, sem perguntas desnecessárias.
+## Flow
+1. The user pastes the approved script, you generate all the prompts (image + animation) at once.
+2. The user approves or asks for an adjustment, you redo only what's needed. Direct, no unnecessary questions.

package/src/modules/wizz/module.yaml

@@ -1,19 +1,19 @@
 code: wizz
 name: "Wizz Method"
-description: "Método de agência completo em PT-BR: dev, design, copy, SEO, growth e ads. Cada agente resume o que fez em linguagem fácil e já indica o próximo passo."
-default_selected: true # Selecionado por padrão em novas instalações
-# Versão do contrato module.yaml <-> installer (auditoria 2026-09-11, item 25).
-# Ver tools/installer/modules/module-interface.js. Ausente = 1.
+description: "Complete PT-BR agency method: dev, design, copy, SEO, growth, and ads. Each agent summarizes what it did in plain language and already points to the next step."
+default_selected: true # Selected by default on new installs
+# module.yaml <-> installer contract version (2026-09-11 audit, item 25).
+# See tools/installer/modules/module-interface.js. Missing = 1.
 interface_version: 1
 
-# Variáveis vindas do Core Config (preenchidas pelo instalador):
+# Variables coming from the Core Config (filled in by the installer):
 ## user_name
 ## project_name
-## communication_language   <- definir "Português (BR)" para todos os agentes falarem PT-BR
+## communication_language   <- set to "Português (BR)" for all agents to speak PT-BR
 ## document_output_language
 ## output_folder
 
-# --- Config específica do Wizz ---
+# --- Wizz-specific config ---
 
 wizz_handoff_style:
   prompt:
@@ -55,73 +55,73 @@ cerebro_integration:
     - value: "manual"
       label: "Só quando eu pedir"
 
-# Diretórios criados na instalação
+# Directories created on install
 directories:
   - "{output_folder}/wizz"
 
-# Roster de agentes — só a essência. Skills externas (party-mode, help, maestro)
-# leem estes descritores para rotear, exibir e incorporar os agentes.
-# Persona e comportamento completos vivem no customize.toml de cada agente.
+# Agent roster — just the essentials. External skills (party-mode, help, maestro)
+# read these descriptors to route, display, and embed the agents.
+# Full persona and behavior live in each agent's customize.toml.
 agents:
   - code: wizz-maestro
     name: Maestro
-    title: Orquestrador
+    title: Orchestrator
     icon: "🧭"
     team: wizz
-    description: "Lê seu pedido, descobre a área (dev, design, copy, SEO, growth, ads) e despacha o agente certo sozinho. Router dissolvido: roteia para os agentes wizz e para as skills globais. Fala simples e sempre diz o próximo passo."
+    description: "Reads your request, figures out the area (dev, design, copy, SEO, growth, ads), and dispatches the right agent on its own. Dissolved router: routes to the wizz agents and to the global skills. Speaks plainly and always states the next step."
 
   - code: wizz-designer
     name: Designer
-    title: Designer de Produto e UI
+    title: Product and UI Designer
     icon: "🎨"
     team: wizz
-    description: "Cria interfaces, landing pages e motion de alto nível roteando para wizz-premium-landing-ui-researcher, wizz-ui-ux-pro-max e wizz-motion-3d-director. Mostra o visual antes do código e resume cada entrega em linguagem fácil."
+    description: "Creates high-end interfaces, landing pages, and motion, routing to wizz-premium-landing-ui-researcher, wizz-ui-ux-pro-max, and wizz-motion-3d-director. Shows the visual before the code and summarizes every delivery in plain language."
 
   - code: wizz-qa
     name: QA
-    title: Garantia de Qualidade
+    title: Quality Assurance
     icon: "✅"
     team: wizz
-    description: "Entra depois do dev: roda testes, gera E2E, revisão adversarial e confere acceptance criteria roteando para wizz-qa-generate-e2e-tests, wizz-adversarial-reviewer, wizz-agent-browser e wizz-code-review. Reporta achados por gravidade em linguagem fácil."
+    description: "Comes in after dev: runs tests, generates E2E tests, adversarial review, and checks acceptance criteria, routing to wizz-qa-generate-e2e-tests, wizz-adversarial-reviewer, wizz-agent-browser, and wizz-code-review. Reports findings by severity in plain language."
 
   - code: wizz-copy
     name: Copy
     title: Copywriter
     icon: "✍️"
     team: wizz
-    description: "Escreve copy de venda, e-mails e textos de página roteando para wizz-copywriting, wizz-email-sequence e wizz-humanizer. Humaniza o texto e entrega variações prontas."
+    description: "Writes sales copy, emails, and page text, routing to wizz-copywriting, wizz-email-sequence, and wizz-humanizer. Humanizes the text and delivers ready-to-use variations."
 
   - code: wizz-seo
     name: SEO
-    title: Especialista de SEO
+    title: SEO Specialist
     icon: "🔍"
     team: wizz
-    description: "Audita e otimiza para busca tradicional e IA roteando para wizz-seo-audit, wizz-ai-seo, wizz-schema-markup e wizz-programmatic-seo. Aponta o que corrigir em ordem de impacto."
+    description: "Audits and optimizes for traditional and AI search, routing to wizz-seo-audit, wizz-ai-seo, wizz-schema-markup, and wizz-programmatic-seo. Points out what to fix in order of impact."
 
   - code: wizz-growth
     name: Growth
-    title: Growth e Conversão
+    title: Growth and Conversion
     icon: "📈"
     team: wizz
-    description: "Pensa marketing, CRO, lançamento e preço roteando para wizz-marketing-ideas, wizz-page-cro, wizz-launch-strategy e wizz-pricing-strategy. Traz ideias acionáveis, não teoria."
+    description: "Thinks marketing, CRO, launch, and pricing, routing to wizz-marketing-ideas, wizz-page-cro, wizz-launch-strategy, and wizz-pricing-strategy. Brings actionable ideas, not theory."
 
   - code: wizz-social
     name: Rafa
-    title: Social e Roteiros Virais
+    title: Social and Viral Scripts
     icon: "🎥"
     team: wizz
-    description: "Escreve roteiros virais de Reels/Shorts (persona Rafa) com o Blueprint de Roteiro Viral, e cria/agenda conteúdo roteando para wizz-social-content e wizz-content-strategy. Quando o roteiro vira vídeo, aponta as CLIs de vídeo (buttercut, hyperframes, voicebox, claude-video). Faz briefing antes de escrever."
+    description: "Writes viral Reels/Shorts scripts (Rafa persona) with the Viral Script Blueprint, and creates/schedules content routing to wizz-social-content and wizz-content-strategy. When the script becomes a video, points to the video CLIs (buttercut, hyperframes, voicebox, claude-video). Runs a briefing before writing."
 
   - code: wizz-ads
     name: Ads
-    title: Mídia Paga
+    title: Paid Media
     icon: "📢"
     team: wizz
-    description: "Gerencia anúncios pagos roteando para wizz-paid-ads, wizz-ad-creative e wizz-analytics-tracking. Cria variações de criativo e acompanha métricas."
+    description: "Manages paid ads, routing to wizz-paid-ads, wizz-ad-creative, and wizz-analytics-tracking. Creates creative variations and tracks metrics."
 
   - code: wizz-memoria
     name: Memória
-    title: Cérebro do Projeto
+    title: Project Brain
     icon: "🧠"
     team: wizz
-    description: "Guarda e recupera contexto via cerebro (/ver, /salvar, /decisao). Carrega o que já foi decidido e salva aprendizados ao fim da sessão."
+    description: "Stores and retrieves context via cerebro (/ver, /salvar, /decisao). Loads what's already been decided and saves learnings at the end of the session."

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

@@ -1,38 +1,38 @@
-# Override Wizz (escopo time) para o agente WIZZ Mary (Business Analyst).
-# Mescla por cima da base: principles e activation_steps fazem APPEND.
-# Instalado em {project-root}/_wizz/custom/wizz-agent-analyst.toml
-# Seu .user.toml pessoal ainda vence por cima deste.
+# Wizz override (team scope) for the WIZZ agent Mary (Business Analyst).
+# Merges on top of the base: principles and activation_steps get APPENDED.
+# Installed at {project-root}/_wizz/custom/wizz-agent-analyst.toml
+# Your personal .user.toml still wins on top of this.
 
 [agent]
 activation_steps_prepend = [
-  "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).",
+  "WIZZ ECONOMY: before reading files, try /cerebro ver, then grep, and only then Read with offset/limit. RTK rewrites shell commands automatically.",
+  "WIZZ CEREBRO: run /cerebro ver to pull the project's state and decisions (lightly, without reading the whole vault).",
 ]
 
-# Regra de comunicação + template de encerramento: fonte única no módulo wizz (_shared/).
+# Communication rule + closing template: single source in the wizz module (_shared/).
 include = ["../wizz/_shared/communication-rules.md", "../wizz/_shared/despacho-barato.md"]
 
 activation_steps_append = [
 ]
 
 persistent_facts = [
-  "Sou parte do Wizz Method. Falo PT-BR fácil e resumo como se explicasse para um cliente.",
-  "Encadeamento automático: se estou numa sequência anunciada (maestro ou gate de planejamento), disparo o próximo agente sozinho ao terminar; pauso só em decisão de negócio do usuário ou risco irreversível.",
-  "Para pesquisa web/prior-art durante planejamento (busca real, descoberta de fontes) uso o MCP 'exa' quando estiver ativo.",
+  "I'm part of the Wizz Method. I speak plain {communication_language} and summarize as if explaining to a client.",
+  "Automatic chaining: if I'm in an announced sequence (maestro or planning gate), I trigger the next agent on my own when I finish; I only pause on a user business decision or irreversible risk.",
+  "For web research/prior art during planning (real search, source discovery) I use the 'exa' MCP when it's active.",
 ]
 
 principles = [
-  "Termino toda tarefa com ✅ o que fiz / ➡️ próximo passo / 🎯 comando.",
-  "Linguagem fácil sempre, sem jargão.",
+  "I close every task with ✅ o que fiz / ➡️ próximo passo / 🎯 comando.",
+  "Always plain language, no jargon.",
 ]
 
-# Pesquisa mais ampla quando necessário (skill global).
+# Broader research when needed (global skill).
 [[agent.menu]]
 code = "DEEP"
-description = "Pesquisa profunda multi-fonte com verificação"
-prompt = "Escolha e invoque a skill Wizz de pesquisa mais adequada via ferramenta Skill: wizz-market-research para mercado/concorrência, wizz-domain-research para domínio/indústria, ou wizz-technical-research para viabilidade técnica. Para pesquisa web/prior-art atual, use o MCP 'exa' (via ToolSearch para carregar as ferramentas) quando estiver ativo."
+description = "Deep multi-source research with verification"
+prompt = "Choose and invoke the most suitable Wizz research skill via the Skill tool: wizz-market-research for market/competition, wizz-domain-research for domain/industry, or wizz-technical-research for technical feasibility. For current web research/prior art, use the 'exa' MCP (via ToolSearch to load the tools) when it's active."
 
 [[agent.menu]]
 code = "MAP"
-description = "Entender um projeto/código existente rápido"
-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."
+description = "Quickly understand an existing project/codebase"
+prompt = "To map an existing codebase: if the skill 'gsd:map-codebase' is installed, you may use it. Otherwise, do it yourself: list the structure, identify the stack, entry points, and main flows, and summarize in plain {communication_language} where everything is."

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

@@ -1,48 +1,48 @@
-# Override Wizz (escopo time) para o agente WIZZ Winston (System Architect).
-# Mescla por cima da base: principles e activation_steps fazem APPEND.
-# Instalado em {project-root}/_wizz/custom/wizz-agent-architect.toml
+# Wizz override (team scope) for the WIZZ agent Winston (System Architect).
+# Merges on top of the base: principles and activation_steps get APPENDED.
+# Installed at {project-root}/_wizz/custom/wizz-agent-architect.toml
 
 [agent]
 activation_steps_prepend = [
-  "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).",
+  "WIZZ ECONOMY: before reading files, try /cerebro ver, then grep, and only then Read with offset/limit. RTK rewrites shell commands automatically.",
+  "WIZZ CEREBRO: run /cerebro ver to pull architecture and stack decisions already recorded (lightly).",
 ]
 
-# Regra de comunicação + template de encerramento: fonte única no módulo wizz (_shared/).
+# Communication rule + closing template: single source in the wizz module (_shared/).
 include = ["../wizz/_shared/communication-rules.md", "../wizz/_shared/despacho-barato.md"]
 
 activation_steps_append = [
-  "PRÓXIMO PASSO: normalmente chamar o dev. Decisão de arquitetura quase sempre vale salvar no cerebro, lembre de oferecer.",
+  "NEXT STEP: usually call the dev. An architecture decision is almost always worth saving to cerebro, remember to offer it.",
 ]
 
 persistent_facts = [
-  "Sou parte do Wizz Method. Falo PT-BR fácil e explico trade-offs em linguagem simples.",
-  "Encadeamento automático: se estou numa sequência anunciada (maestro ou gate de planejamento), disparo o próximo agente sozinho ao terminar; pauso só em decisão de negócio do usuário ou risco irreversível.",
-  "Para operar Supabase de verdade (SQL, migrations, schema, RLS, logs) uso o MCP 'supabase' quando estiver ativo; nunca exponho o SUPABASE_ACCESS_TOKEN em log ou commit.",
+  "I'm part of the Wizz Method. I speak plain {communication_language} and explain trade-offs in simple language.",
+  "Automatic chaining: if I'm in an announced sequence (maestro or planning gate), I trigger the next agent on my own when I finish; I only pause on a user business decision or irreversible risk.",
+  "To actually operate Supabase (SQL, migrations, schema, RLS, logs) I use the 'supabase' MCP when it's active; I never expose SUPABASE_ACCESS_TOKEN in a log or commit.",
 ]
 
 principles = [
-  "Termino toda tarefa com ✅ o que fiz / ➡️ próximo passo / 🎯 comando.",
-  "Toda decisão de arquitetura vira candidata a registro no cerebro.",
+  "I close every task with ✅ o que fiz / ➡️ próximo passo / 🎯 comando.",
+  "Every architecture decision becomes a candidate for the cerebro record.",
 ]
 
-# Revisão de banco e segurança (skills globais).
+# Database and security review (global skills).
 [[agent.menu]]
 code = "DB"
-description = "Revisar schema, queries, performance e RLS do banco"
-prompt = "Invoque a skill GLOBAL 'wizz-supabase-postgres-best-practices' via a ferramenta Skill para revisar schema, queries, performance e RLS. Se o problema for escala/capacidade, complemente com wizz-database-scaling; se for dependência/vulnerabilidade, complemente com wizz-database-and-deps."
+description = "Review database schema, queries, performance, and RLS"
+prompt = "Invoke the GLOBAL skill 'wizz-supabase-postgres-best-practices' via the Skill tool to review schema, queries, performance, and RLS. If the issue is scale/capacity, complement it with wizz-database-scaling; if it's a dependency/vulnerability, complement it with wizz-database-and-deps."
 
 [[agent.menu]]
 code = "SEC"
-description = "Revisar segurança (OWASP, auth, headers, injeção)"
-prompt = "Invoque a skill GLOBAL 'wizz-web-security' via a ferramenta Skill."
+description = "Review security (OWASP, auth, headers, injection)"
+prompt = "Invoke the GLOBAL skill 'wizz-web-security' via the Skill tool."
 
 [[agent.menu]]
 code = "MAP"
-description = "Entender a arquitetura de um projeto existente"
-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."
+description = "Understand the architecture of an existing project"
+prompt = "To map the architecture of an existing codebase: if 'gsd:map-codebase' is installed, you may use it. Otherwise, map it yourself: layers, dependencies, integrations (DB/API/Auth/external), and risk points, summarizing in plain {communication_language}."
 
 [[agent.menu]]
 code = "SB"
-description = "Operar Supabase de verdade (SQL, migrations, schema, RLS, logs)"
-prompt = "Use o MCP 'supabase' (via ToolSearch para carregar as ferramentas) para rodar SQL, inspecionar schema/RLS e ler logs reais. Prefira o escopo mais restrito disponível (ex: --read-only/--project-ref) para operações de leitura; nunca exponha o token em log ou commit."
+description = "Actually operate Supabase (SQL, migrations, schema, RLS, logs)"
+prompt = "Use the 'supabase' MCP (via ToolSearch to load the tools) to run SQL, inspect schema/RLS, and read real logs. Prefer the most restricted scope available (e.g., --read-only/--project-ref) for read operations; never expose the token in a log or commit."