wizz-method 2.2.0 → 2.3.1

package/src/skills-lib/wizz-launch-readiness/references/07-infra-deploy-rollback.md

@@ -1,26 +1,26 @@
-# Área 07 · Infra / Deploy / Rollback
+# Area 07 · Infra / Deploy / Rollback
 
-Checa se, quando (não "se") algo der errado no dia do lançamento, o time consegue reverter ou recuperar rápido. Ausência de plano de rollback é o achado mais caro desta área: um bug em produção sem caminho de volta vira incidente longo.
+Checks whether, when (not "if") something goes wrong on launch day, the team can revert or recover quickly. Missing a rollback plan is the most expensive finding in this area: a production bug with no way back turns into a long incident.
 
-## Checagens objetivas
+## Objective checks
 
-1. **Pipeline de deploy existe e é repetível.** Deploy manual/artesanal sem script/CI para o ambiente de produção é 🟠.
-2. **Rollback possível e testado.** Sem nenhuma forma de voltar pra versão anterior (revert de deploy, versionamento de release, feature flag) é 🔴 pra lançamento de risco alto (migração de banco, troca de fluxo de pagamento); 🟠 nos demais casos.
-3. **Migração de banco reversível.** Migration que altera/apaga coluna sem plano de reversão, rodando junto do lançamento, é 🔴.
-4. **Backup recente e testado.** Sem backup do banco de produção, ou backup nunca restaurado uma vez sequer pra validar que funciona, é 🔴 quando há dado de usuário real em jogo.
-5. **Domínio/DNS/SSL apontando pro ambiente certo.** Confirma o achado #7 da área 03 pelo lado de infra: domínio configurado mas TTL alto sem plano de propagação a tempo do lançamento é 🟠.
-6. **Paridade de ambiente (staging vs. produção).** Diferença conhecida entre o que foi testado em staging e o que vai pra produção (env var, versão de dependência, feature flag) é 🟠.
-7. **Plano de quem responde no dia.** Sem ninguém definido pra monitorar/responder no horário do lançamento (mesmo que informal) é 🟡; sobe pra 🟠 se o lançamento é fora do horário comercial normal do time.
-8. **Rate limiting / proteção contra pico na camada de infra.** Ausência de qualquer proteção (CDN, rate limit de borda) num lançamento com pico de tráfego esperado (campanha paga, imprensa) é 🟠.
+1. **Deploy pipeline exists and is repeatable.** Manual/artisanal deploy with no script/CI for the production environment is 🟠.
+2. **Rollback possible and tested.** No way at all to go back to the previous version (deploy revert, release versioning, feature flag) is 🔴 for a high-risk launch (database migration, payment flow change); 🟠 in other cases.
+3. **Reversible database migration.** A migration that alters/drops a column with no reversal plan, running alongside the launch, is 🔴.
+4. **Recent, tested backup.** No production database backup, or a backup never restored even once to validate that it works, is 🔴 when there's real user data at stake.
+5. **Domain/DNS/SSL pointing to the right environment.** Confirms finding #7 from area 03 from the infra side: a configured domain with high TTL and no propagation plan in time for launch is 🟠.
+6. **Environment parity (staging vs. production).** A known difference between what was tested in staging and what goes to production (env var, dependency version, feature flag) is 🟠.
+7. **Plan for who's on call that day.** Nobody defined to monitor/respond during the launch window (even informally) is 🟡; escalates to 🟠 if the launch is outside the team's normal business hours.
+8. **Rate limiting / spike protection at the infra layer.** No protection at all (CDN, edge rate limit) for a launch with an expected traffic spike (paid campaign, press) is 🟠.
 
-## Regra de corte
+## Cutoff rule
 
-"Rollback existe" só conta se alguém já testou o caminho de volta pelo menos uma vez, não só "em teoria dá pra reverter". Sem essa confirmação, marque PENDÊNCIA DE VERIFICAÇÃO em vez de 🟢.
+"Rollback exists" only counts if someone has actually tested the way back at least once, not just "in theory it can be reverted". Without that confirmation, mark VERIFICATION PENDING instead of 🟢.
 
-## Formato de saída
+## Output format
 
 ```
-| # | Item | Onde (arquivo/rota) | O que falta ou está errado | Severidade | Executor da correção |
+| # | Item | Where (file/route) | What's missing or wrong | Severity | Fix owner |
 ```
 
-Sem achado que passe na régua: responda só `NENHUM ACHADO NESTA ÁREA`.
+If no finding meets the bar: respond only `NO FINDINGS IN THIS AREA`.

package/src/skills-lib/wizz-launch-readiness/references/08-fusao-priorizacao.md

@@ -1,33 +1,33 @@
-# Passo 08 · Fusão e Priorização
+# Step 08 · Merge and Prioritization
 
-Recebe as 7 tabelas das áreas (01 a 07) e funde num diagnóstico único. Não é uma nova rodada de investigação: é organização do que já foi levantado.
+Takes the 7 tables from the areas (01 to 07) and merges them into a single diagnosis. This is not a new round of investigation: it's organizing what has already been gathered.
 
-## Como fundir
+## How to merge
 
-1. **Cole as 7 tabelas** (ou as que rodaram, se alguma foi marcada `ITEM NÃO SE APLICA`).
-2. **Dedup por origem cruzada.** O mesmo problema pode aparecer em duas áreas (ex.: domínio apontando pro ambiente errado aparece na área 03 e na área 07). Mantenha uma linha só, citando as duas áreas de origem.
-3. **Ordene por severidade primeiro** (🔴 no topo, 🟢 no fim), e dentro da mesma severidade, pelo esforço estimado de correção (menor esforço primeiro): resolve mais rápido o que está mais perto do go-live.
-4. **Agrupe por executor.** Vários achados 🔴 que vão pro mesmo executor (ex.: 3 achados de `site-launch-kit`) formam um bloco só na entrega, pra virar um único despacho.
-5. **Conte pendências separadamente.** PENDÊNCIA DE VERIFICAÇÃO MANUAL não é severidade: é "não dá pra saber ainda". Liste à parte, com o que falta pra virar um veredito real.
+1. **Paste the 7 tables** (or whichever ran, if any was marked `ITEM DOES NOT APPLY`).
+2. **Dedup by cross-origin.** The same problem can show up in two areas (e.g., a domain pointing to the wrong environment appears in area 03 and area 07). Keep a single row, citing both source areas.
+3. **Sort by severity first** (🔴 at the top, 🟢 at the bottom), and within the same severity, by estimated fix effort (lowest effort first): resolve first whatever is closest to go-live.
+4. **Group by fix owner.** Several 🔴 findings going to the same owner (e.g., 3 findings for `site-launch-kit`) form a single block in the delivery, to become a single dispatch.
+5. **Count pending items separately.** MANUAL VERIFICATION PENDING is not a severity: it's "can't be known yet". List it separately, with what's needed to turn it into a real verdict.
 
-## Tabela final
+## Final table
 
 ```
-| # | Área | Item | Severidade | Executor | Esforço estimado |
+| # | Area | Item | Severity | Owner | Estimated effort |
 ```
 
-Seguida de:
+Followed by:
 
-**Bloqueantes de hoje (🔴):** lista curta, só o que impede literalmente o go-live. Se a lista tiver mais de 5 itens, isso já é sinal pro dono do projeto de que o lançamento provavelmente precisa adiar, diga isso explicitamente.
+**Today's blockers (🔴):** a short list, only what literally prevents go-live. If the list has more than 5 items, that's already a signal to the project owner that the launch probably needs to be postponed — say so explicitly.
 
-**Recomendação:** uma de três, nunca decidida pela skill sozinha, é leitura dos números:
+**Recommendation:** one of three, never decided by the skill alone, is a reading of the numbers:
 
-- **GO:** zero 🔴, poucos 🟠 documentados como aceitáveis pelo dono do projeto.
-- **GO COM RESSALVAS:** 🔴 zero, mas 🟠 relevante o suficiente pra avisar explicitamente antes do dono decidir.
-- **NO-GO:** qualquer 🔴 aberto.
+- **GO:** zero 🔴, few 🟠 documented as acceptable by the project owner.
+- **GO WITH CAVEATS:** zero 🔴, but 🟠 relevant enough to explicitly warn before the owner decides.
+- **NO-GO:** any open 🔴.
 
-A recomendação é uma leitura objetiva da tabela (contagem de severidade), não um palpite. Explique o critério usado (ex.: "NO-GO porque há 2 achados 🔴 abertos: X e Y") em vez de só declarar o rótulo.
+The recommendation is an objective reading of the table (severity count), not a guess. Explain the criterion used (e.g., "NO-GO because there are 2 open 🔴 findings: X and Y") instead of just stating the label.
 
-## Regra de corte
+## Cutoff rule
 
-Não amenize a contagem pra chegar num "GO" mais confortável. Se há 🔴 aberto, a recomendação é NO-GO, mesmo que o prazo de lançamento esteja apertado: apertar o prazo é decisão do dono do projeto, não da skill.
+Don't soften the count to reach a more comfortable "GO". If there's an open 🔴, the recommendation is NO-GO, even if the launch deadline is tight: tightening the deadline is the project owner's decision, not the skill's.

package/src/skills-lib/wizz-launch-readiness/references/09-persistencia-project-context.md

@@ -1,48 +1,48 @@
-# Passo 09 · Persistência no project-context.md
+# Step 09 · Persistence in project-context.md
 
-O resultado da auditoria não fica só na conversa: um resumo persiste no `project-context.md` do projeto, pra qualquer agente (ou humano) que abrir o projeto depois saber, sem re-perguntar, se ele já passou por uma auditoria de lançamento e como ficou.
+The audit's result doesn't stay only in the conversation: a summary persists in the project's `project-context.md`, so any agent (or human) who opens the project later knows, without re-asking, whether it has already been through a launch audit and how it went.
 
-## Localizar o arquivo
+## Locate the file
 
-Mesmo padrão fail-open usado pelo router e pelo maestro: `grep -m1 '^stage:' {project-root}/**/project-context.md`.
+Same fail-open pattern used by the router and the maestro: `grep -m1 '^stage:' {project-root}/**/project-context.md`.
 
-- **Achou o arquivo:** siga pra "Gravar a seção" abaixo.
-- **Não achou:** não bloqueie a entrega do diagnóstico por causa disso. Avise que não existe `project-context.md` pra persistir o resultado, ofereça rodar `wizz-generate-project-context` primeiro (cria o arquivo e o campo `stage:`), e entregue o diagnóstico normalmente mesmo sem persistir.
+- **Found the file:** proceed to "Write the section" below.
+- **Not found:** don't block delivering the diagnosis because of this. Note that there's no `project-context.md` to persist the result to, offer to run `wizz-generate-project-context` first (creates the file and the `stage:` field), and deliver the diagnosis normally even without persisting.
 
-## Gravar a seção
+## Write the section
 
-A seção vive sob o cabeçalho `## Auditoria de Prontidão pra Lançamento`. Ela é SUBSTITUÍDA a cada nova rodada, não é um changelog acumulado: `project-context.md` existe pra ficar enxuto ("lean, LLM-optimized" é o objetivo declarado do próprio template), então o que importa pra um agente lendo depois é o estado ATUAL, não o histórico de rodadas antigas. Se encontrar uma seção com esse cabeçalho já existente, apague o conteúdo antigo e escreva o novo no lugar; não acumule.
+The section lives under the heading `## Launch Readiness Audit`. It is REPLACED on every new round, not an accumulated changelog: `project-context.md` exists to stay lean ("lean, LLM-optimized" is the template's own stated goal), so what matters to an agent reading it later is the CURRENT state, not the history of old rounds. If you find a section under that heading already existing, delete the old content and write the new one in its place; don't accumulate.
 
-Template exato da seção:
+Exact section template:
 
 ```markdown
-## Auditoria de Prontidão pra Lançamento
+## Launch Readiness Audit
 
-Última rodada: {{YYYY-MM-DD}}. Resultado da skill `wizz-launch-readiness`; substitui a rodada anterior (não é histórico).
+Latest round: {{YYYY-MM-DD}}. Result of the `wizz-launch-readiness` skill; replaces the previous round (not a history).
 
-**Resumo:** 🔴 {{n_bloqueante}} bloqueante(s) · 🟠 {{n_alto}} alto(s) · 🟡 {{n_medio}} médio(s) · 🟢 {{n_ok}} ok
+**Summary:** 🔴 {{n_blocking}} blocking · 🟠 {{n_high}} high · 🟡 {{n_medium}} medium · 🟢 {{n_ok}} ok
 
-**Recomendação:** {{GO | GO COM RESSALVAS | NO-GO}}
+**Recommendation:** {{GO | GO WITH CAVEATS | NO-GO}}
 
-**Bloqueantes abertos (🔴):**
-- {{item 1, uma linha}}
-- {{item 2, uma linha}}
+**Open blockers (🔴):**
+- {{item 1, one line}}
+- {{item 2, one line}}
 
-_Sem bloqueante aberto, escreva "Nenhum bloqueante aberto." em vez da lista._
+_If there's no open blocker, write "No open blockers." instead of the list._
 
-**Diagnóstico completo** (as 7 tabelas por área) foi entregue na sessão de {{YYYY-MM-DD}}; esta seção é o resumo persistido, não a íntegra.
+**Full diagnosis** (the 7 per-area tables) was delivered in the session on {{YYYY-MM-DD}}; this section is the persisted summary, not the full text.
 ```
 
-Insira a seção depois de `## Estado do Projeto` e antes de `## Technology Stack & Versions`, seguindo a ordem já usada pelo template (`project-context-template.md`). Se o arquivo tiver uma ordem diferente por já ter sido editado à mão, insira logo após `## Estado do Projeto`.
+Insert the section after `## Estado do Projeto` and before `## Technology Stack & Versions`, following the order already used by the template (`project-context-template.md`). If the file has a different order because it's already been hand-edited, insert it right after `## Estado do Projeto`.
 
-## Atualizar o estágio (stage:)
+## Updating the stage (stage:)
 
-O campo `stage:` no frontmatter (`prototype|mvp|production|maintenance`) reflete o momento real do projeto, e a auditoria pode revelar que ele está desatualizado:
+The `stage:` field in the frontmatter (`prototype|mvp|production|maintenance`) reflects the project's real moment, and the audit may reveal that it's outdated:
 
-- **Recomendação GO ou GO COM RESSALVAS, e o usuário confirma que vai lançar agora:** proponha atualizar `stage: mvp` → `stage: production` no frontmatter. Proponha, não edite sozinho: pergunte antes ("atualizo o stage do projeto pra `production`?"), porque esse campo direciona o comportamento de outros agentes (router, maestro) e mudar sem avisar é uma mutação silenciosa de configuração compartilhada.
-- **Recomendação NO-GO:** não sugira mudar o `stage:`. O projeto continua no estágio que já estava.
-- **Estágio já é `production`:** não mexa; a auditoria está sendo usada pra uma nova leva/feature, não pra estreia do projeto (ver gate de estágio no `SKILL.md`).
+- **GO or GO WITH CAVEATS recommendation, and the user confirms they're launching now:** propose updating `stage: mvp` → `stage: production` in the frontmatter. Propose, don't edit it on your own: ask first ("should I update the project's stage to `production`?"), because this field drives other agents' behavior (router, maestro), and changing it without notice is a silent mutation of shared configuration.
+- **NO-GO recommendation:** don't suggest changing `stage:`. The project stays at whatever stage it was already at.
+- **Stage is already `production`:** don't touch it; the audit is being used for a new batch/feature, not for the project's debut (see the stage gate in `SKILL.md`).
 
-## Regra de corte
+## Cutoff rule
 
-Não grave a seção com números inventados. O resumo tem que bater exatamente com a tabela final do passo 08 (fusão): mesma contagem, mesma recomendação. Se o passo 08 não rodou (ex.: usuário pediu só uma área isolada), não grave a seção completa: registre só o achado daquela área com a mesma data, deixando claro que não é uma rodada completa das 7 áreas.
+Don't write the section with invented numbers. The summary must match exactly the final table from step 08 (merge): same count, same recommendation. If step 08 didn't run (e.g., the user asked for just one isolated area), don't write the full section: log only that area's finding with the same date, making clear it's not a complete round across the 7 areas.

package/src/skills-lib/wizz-motion-3d-director/SKILL.md

@@ -5,134 +5,134 @@ description: Direction system for premium motion, 3D, image-to-video, WebGL, sha
 
 # Motion / 3D Director
 
-Esta skill é responsável por **direção de motion, 3D, image-to-video, vídeo hero, WebGL, shaders, scroll effects, React Three Fiber, Spline, Unicorn Studio e performance visual**.
+This skill is responsible for **motion direction, 3D, image-to-video, video hero, WebGL, shaders, scroll effects, React Three Fiber, Spline, Unicorn Studio, and visual performance**.
 
-A primeira função dela não é implementar — é **decidir** o melhor caminho visual antes que qualquer linha de Three.js seja escrita.
+Its first job isn't to implement — it's to **decide** the best visual path before a single line of Three.js is written.
 
 ---
 
-## Objetivo
+## Goal
 
-Entregar o melhor resultado visual possível com equilíbrio entre **impacto, performance, tempo de execução e valor percebido**.
+Deliver the best possible visual result balancing **impact, performance, execution time, and perceived value**.
 
-A regra-mestre: **nunca assumir automaticamente que 3D precisa ser feito do zero em Three.js.** Antes de qualquer recomendação técnica, decidir entre quatro caminhos:
+The master rule: **never automatically assume 3D needs to be built from scratch in Three.js.** Before any technical recommendation, decide between four paths:
 
-1. **3D real no navegador** (R3F/Three.js).
-2. **Image-to-video / vídeo cinematográfico** (pré-renderizado, leve, controlado).
-3. **Hybrid motion** (vídeo + UI animada — o caminho recomendado para a maioria dos sites high-end).
-4. **Motion 2D premium** (Framer Motion + scroll effects, sem 3D).
+1. **Real 3D in the browser** (R3F/Three.js).
+2. **Image-to-video / cinematic video** (pre-rendered, lightweight, controlled).
+3. **Hybrid motion** (video + animated UI — the recommended path for most high-end sites).
+4. **Premium 2D motion** (Framer Motion + scroll effects, no 3D).
 
-A escolha é estratégica. Errar o path desperdiça orçamento, mata performance e empurra o site para "tech demo" em vez de "marca premium". Detalhe completo de cada path (quando usar, stack, exemplos) em `references/motion-paths.md` — carregar depois de saber qual path se aplica.
+The choice is strategic. Getting the path wrong wastes budget, kills performance, and pushes the site toward "tech demo" instead of "premium brand". Full detail on each path (when to use, stack, examples) is in `references/motion-paths.md` — load it after knowing which path applies.
 
 ---
 
-## Quando usar (primeiro passo: confirmar o gatilho)
+## When to use (first step: confirm the trigger)
 
-Acionar quando o usuário disser ou o projeto indicar:
+Trigger when the user says, or the project indicates:
 
-- "quero 3D" / "hero 3D" / "vídeo hero" / "image-to-video";
-- "motion cinematográfico" / "scroll effects" / "WebGL" / "shader" / "partículas";
+- "I want 3D" / "3D hero" / "video hero" / "image-to-video";
+- "cinematic motion" / "scroll effects" / "WebGL" / "shader" / "particles";
 - "Spline" / "Unicorn Studio" / "React Three Fiber" / "Three.js";
-- "site high-end" / "Signature 3D Experience";
-- "quero causar uau" / "quero algo outro nível" / "quero um site premium com animações";
-- "quero transformar imagem em vídeo" / "quero usar minha logo como hero";
-- "não tenho imagem, mas quero algo 3D".
+- "high-end site" / "Signature 3D Experience";
+- "I want to make a splash" / "I want something next-level" / "I want a premium site with animations";
+- "I want to turn an image into a video" / "I want to use my logo as the hero";
+- "I don't have an image, but I want something 3D".
 
-Também usar automaticamente quando `wizz-premium-landing-ui-researcher` classificar o projeto como:
+Also use automatically when `wizz-premium-landing-ui-researcher` classifies the project as:
 
 - **3D High-End Site**;
-- **3D High-End Site — modo Signature 3D Experience**.
+- **3D High-End Site — Signature 3D Experience mode**.
 
 ## Skip when
 
-Pular esta skill quando:
+Skip this skill when:
 
-- O nível do projeto for **Basic Site** ou **Intermediate Site** — não há decisão de motion path a fazer; `wizz-premium-landing-ui-researcher` resolve sozinho com motion 2D leve.
-- O nível for **Advanced Site** e o usuário não pediu nenhum elemento 3D/vídeo — Advanced opera bem com motion 2D premium e a decisão de path é trivial.
-- O usuário ainda não tem brief (rodar `wizz-decision-maker` primeiro — sem feeling, hero object e three-second memory, qualquer direção de motion vira chute).
+- The project's level is **Basic Site** or **Intermediate Site** — there's no motion path decision to make; `wizz-premium-landing-ui-researcher` handles it alone with light 2D motion.
+- The level is **Advanced Site** and the user hasn't requested any 3D/video element — Advanced works fine with premium 2D motion and the path decision is trivial.
+- The user doesn't have a brief yet (run `wizz-decision-maker` first — without a feeling, hero object, and three-second memory, any motion direction becomes a guess).
 
 ---
 
-## Regra principal
+## Main rule
 
-Antes de recomendar qualquer implementação, decidir entre os quatro paths considerando:
+Before recommending any implementation, decide between the four paths considering:
 
-- objetivo do site; público; nível visual (do `wizz-premium-landing-ui-researcher`); hero object (do brief); feeling (do brief); three-second memory (do brief);
-- se existe logo; se existe imagem; se existe mockup; se existe produto;
-- se precisa de interação real; performance mobile; tempo de implementação; impacto desejado; custo de manutenção.
+- the site's goal; the audience; the visual level (from `wizz-premium-landing-ui-researcher`); the hero object (from the brief); the feeling (from the brief); the three-second memory (from the brief);
+- whether a logo exists; whether an image exists; whether a mockup exists; whether a product exists;
+- whether real interaction is needed; mobile performance; implementation time; desired impact; maintenance cost.
 
-A decisão vem **antes** de qualquer stack. Stack é consequência do path. **Carregue `references/motion-paths.md`** para o detalhe de cada um dos quatro paths antes de recomendar um.
+The decision comes **before** any stack. Stack is a consequence of the path. **Load `references/motion-paths.md`** for the detail on each of the four paths before recommending one.
 
 ---
 
 ## Signature 3D Experience
 
-Quando o projeto for **3D High-End Site — modo Signature 3D Experience**, esta skill deve buscar o maior nível de impacto visual possível sem perder performance.
+When the project is **3D High-End Site — Signature 3D Experience mode**, this skill should pursue the highest possible level of visual impact without sacrificing performance.
 
-Objetivo:
+Goal:
 
-> Uau. Isso não é uma landing comum.
+> Wow. This isn't an ordinary landing page.
 
-Deve parecer: autoral; raro; cinematográfico; técnico; premium; sofisticado; memorável; impossível de confundir com template.
+It should feel: original; rare; cinematic; technical; premium; sophisticated; memorable; impossible to mistake for a template.
 
-**Motion Budget e Signature Motion Checklist (Hero / Scroll / Background / Components) vivem em `wizz-premium-landing-ui-researcher`** — seção `## Motion & Interaction Complexity Ladder`. Não duplicar aqui. Consultar lá ao montar o plano do site e usar como entrada para a decisão de path desta skill.
+**Motion Budget and the Signature Motion Checklist (Hero / Scroll / Background / Components) live in `wizz-premium-landing-ui-researcher`** — the `## Motion & Interaction Complexity Ladder` section. Don't duplicate it here. Consult it there when building the site plan and use it as input for this skill's path decision.
 
-O que **esta skill** decide para Signature 3D:
+What **this skill** decides for Signature 3D:
 
-- qual dos quatro paths usar (na maioria dos casos: **Hybrid motion**);
-- qual o asset base (logo? objeto signature abstrato? cena atmosférica?);
-- prompts de imagem e vídeo — ver `references/image-to-video-workflow.md`;
-- performance plan completo;
-- handoff para `wizz-implementation-planner`.
+- which of the four paths to use (in most cases: **hybrid motion**);
+- what the base asset is (logo? abstract signature object? atmospheric scene?);
+- image and video prompts — see `references/image-to-video-workflow.md`;
+- the complete performance plan;
+- handoff to `wizz-implementation-planner`.
 
 ---
 
 ## Performance Requirements + Handoff
 
-Todo plano 3D, vídeo ou motion avançado precisa de fallback mobile, poster image, `prefers-reduced-motion`, lazy load e respeitar Core Web Vitals. Ao final, sempre entregar o bloco de handoff para `wizz-implementation-planner` (motion path, assets, arquivos esperados, stack, notas). Lista completa de requisitos + targets (LCP/CLS/INP) + template exato do handoff em `references/performance-and-handoff.md`.
+Every 3D, video, or advanced motion plan needs a mobile fallback, poster image, `prefers-reduced-motion`, lazy load, and must respect Core Web Vitals. At the end, always deliver the handoff block for `wizz-implementation-planner` (motion path, assets, expected files, stack, notes). Full requirements list + targets (LCP/CLS/INP) + exact handoff template in `references/performance-and-handoff.md`.
 
 ---
 
-## Output obrigatório
-
-Quando esta skill for acionada, entregar:
-
-1. **Diagnóstico de motion** — leitura do brief, nível, contexto.
-2. **Nível visual** — confirmar (3D High-End ou Signature 3D).
-3. **Caminho recomendado** — 3D real / image-to-video / hybrid motion / motion 2D premium.
-4. **Justificativa** — por que esse path para esse projeto.
-5. **Asset base recomendado** — logo / imagem / vídeo / mockup / símbolo abstrato / objeto signature / prompt visual.
-6. **O que o usuário precisa enviar** — assets faltantes ou decisões pendentes.
-7. **Prompt para imagem base** — preenchido com base no brief (template em `references/image-to-video-workflow.md`).
-8. **Prompt para vídeo / image-to-video** — preenchido (template em `references/image-to-video-workflow.md`).
-9. **Direção de câmera, luz, duração, loop behavior**.
-10. **Plano de implementação no site** — onde entra, como, com qual fallback.
-11. **Fallback mobile**.
+## Required output
+
+When this skill is triggered, deliver:
+
+1. **Motion diagnosis** — reading of the brief, level, context.
+2. **Visual level** — confirm it (3D High-End or Signature 3D).
+3. **Recommended path** — real 3D / image-to-video / hybrid motion / premium 2D motion.
+4. **Justification** — why this path for this project.
+5. **Recommended base asset** — logo / image / video / mockup / abstract symbol / signature object / visual prompt.
+6. **What the user needs to send** — missing assets or pending decisions.
+7. **Base image prompt** — filled in based on the brief (template in `references/image-to-video-workflow.md`).
+8. **Video / image-to-video prompt** — filled in (template in `references/image-to-video-workflow.md`).
+9. **Camera, light, duration, loop behavior direction**.
+10. **Site implementation plan** — where it goes, how, with what fallback.
+11. **Mobile fallback**.
 12. **Performance notes** (Core Web Vitals, lazy load, reduced motion).
-13. **O que evitar** (web3 template, neon, sci-fi barato, 3D gratuito).
-14. **Handoff para `wizz-implementation-planner`** (template em `references/performance-and-handoff.md`).
+13. **What to avoid** (web3 template, neon, cheap sci-fi, gratuitous 3D).
+14. **Handoff to `wizz-implementation-planner`** (template in `references/performance-and-handoff.md`).
 
 ---
 
-## Regra final
+## Final rule
 
-O objetivo é **resultado premium, não complexidade gratuita**. Sempre escolher o caminho que entrega mais impacto com menos risco.
+The goal is a **premium result, not gratuitous complexity**. Always choose the path that delivers the most impact with the least risk.
 
-**Ordem de preferência quando não houver necessidade de interação real:**
+**Order of preference when there's no need for real interaction:**
 
 1. Hybrid motion
 2. Image-to-video
-3. Motion 2D premium
-4. 3D real
+3. Premium 2D motion
+4. Real 3D
 
-3D real só quando a interação justifica. Se o objeto não precisa reagir ao usuário, 3D real é desperdício de orçamento, performance e tempo — e o vídeo cinematográfico costuma parecer mais caro.
+Real 3D only when the interaction justifies it. If the object doesn't need to react to the user, real 3D wastes budget, performance, and time — and the cinematic video usually looks more expensive.
 
 ---
 
-## Reference map — carregar cada arquivo quando necessário
+## Reference map — load each file when needed
 
-- `references/motion-paths.md` — os quatro paths em detalhe: quando usar, stack recomendada, exemplos, quando evitar. **Carregar antes de recomendar um path.**
-- `references/image-to-video-workflow.md` — fluxo completo (4 etapas) + templates de prompt (imagem base e image-to-video) com exemplos preenchidos. **Carregar quando o path escolhido for image-to-video ou hybrid motion.**
-- `references/performance-and-handoff.md` — lista completa de requisitos de performance + targets, e o template exato do bloco de handoff. **Carregar ao fechar o output desta skill.**
+- `references/motion-paths.md` — the four paths in detail: when to use, recommended stack, examples, when to avoid. **Load before recommending a path.**
+- `references/image-to-video-workflow.md` — the complete flow (4 steps) + prompt templates (base image and image-to-video) with filled-in examples. **Load when the chosen path is image-to-video or hybrid motion.**
+- `references/performance-and-handoff.md` — the full list of performance requirements + targets, and the exact handoff block template. **Load when closing out this skill's output.**
 
-Nenhum conteúdo foi perdido nessa divisão — cada regra, exemplo e template acima vive integralmente no seu arquivo `references/`.
+No content was lost in this split — every rule, example, and template above lives in full in its `references/` file.

package/src/skills-lib/wizz-motion-3d-director/references/image-to-video-workflow.md

@@ -1,56 +1,56 @@
-# Image-to-Video Workflow — fluxo completo + prompts
+# Image-to-Video Workflow — complete flow + prompts
 
-Carregar quando o path escolhido for image-to-video ou hybrid motion. Cobre: quando escolher esse caminho, as 4 etapas (conceito do hero, escolha do asset base incluindo regras de uso de logo, prompt de imagem base, prompt de image-to-video), com templates e exemplos preenchidos para ambos os prompts.
+Load when the chosen path is image-to-video or hybrid motion. Covers: when to choose this path, the 4 steps (hero concept, base asset choice including logo usage rules, base image prompt, image-to-video prompt), with templates and filled-in examples for both prompts.
 
 ## Image-to-Video Workflow
 
-Usar este workflow quando o projeto precisa de visual cinematográfico high-end **sem interação 3D em tempo real**.
+Use this workflow when the project needs a high-end cinematic visual **without real-time 3D interaction**.
 
-### Quando escolher image-to-video
+### When to choose image-to-video
 
-Escolher quando:
+Choose it when:
 
-- o hero precisa parecer caro;
-- a cena pode ser pré-renderizada;
-- o site precisa performar bem;
-- o usuário quer forte impacto visual;
-- o 3D real seria overkill;
-- o hero é mais atmosférico do que interativo;
-- o usuário quer transformar uma imagem em vídeo;
-- o usuário tem logo, mockup, imagem ou produto visual;
-- ou o usuário ainda não tem imagem, mas a marca precisa de um objeto signature.
+- the hero needs to look expensive;
+- the scene can be pre-rendered;
+- the site needs to perform well;
+- the user wants strong visual impact;
+- real 3D would be overkill;
+- the hero is more atmospheric than interactive;
+- the user wants to turn an image into a video;
+- the user has a logo, mockup, image, or visual product;
+- or the user doesn't have an image yet, but the brand needs a signature object.
 
-### Etapa 1 — Definir conceito do hero
+### Step 1 — Define the hero concept
 
-Definir: hero object; feeling; three-second memory; câmera; iluminação; atmosfera; color logic; duração; loop behavior; formato desktop; formato mobile.
+Define: hero object; feeling; three-second memory; camera; lighting; atmosphere; color logic; duration; loop behavior; desktop format; mobile format.
 
-Se faltar imagem, perguntar:
+If there's no image, ask:
 
-> Você tem logo, símbolo, imagem, produto, print, mockup ou dashboard que possa virar hero visual?
+> Do you have a logo, symbol, image, product, screenshot, mockup, or dashboard that could become the hero visual?
 
-Se o usuário disser não:
+If the user says no:
 
-> Vou criar uma direção de hero visual abstrato baseado na marca, no feeling e no hero object definidos no brief.
+> I'll create an abstract visual hero direction based on the brand, the feeling, and the hero object defined in the brief.
 
-### Etapa 2 — Escolher asset base
+### Step 2 — Choose the base asset
 
-Opções: logo da marca; símbolo da marca; produto; dashboard; mockup; print de interface; objeto abstrato signature; monólito; cluster de partículas; cena atmosférica; imagem gerada por prompt.
+Options: brand logo; brand symbol; product; dashboard; mockup; interface screenshot; abstract signature object; monolith; particle cluster; atmospheric scene; prompt-generated image.
 
-**Uso da logo.** A logo pode ser usada como base visual, mas **não automaticamente**.
+**Using the logo.** The logo can be used as a visual base, but **not automatically**.
 
-Usar logo quando: tem símbolo forte; é simples; é reconhecível; pode virar objeto 3D; reforça a marca; tem geometria interessante; o site é de autoridade/portfolio; o objetivo é memorabilidade de marca.
+Use the logo when: it has a strong symbol; it's simple; it's recognizable; it can become a 3D object; it reinforces the brand; it has interesting geometry; the site is for authority/portfolio; the goal is brand memorability.
 
-Não usar logo quando: é tipográfica demais; é genérica; não tem símbolo forte; fica institucional demais; o hero object do brief é mais forte; distorcer a logo prejudicaria a marca.
+Don't use the logo when: it's too typographic; it's generic; it has no strong symbol; it feels too institutional; the brief's hero object is stronger; distorting the logo would hurt the brand.
 
-Se usar logo: criar versão 3D / vidro / metal / cristal / partículas; manter legibilidade; não distorcer a marca; usar luz cinematográfica; animar com câmera lenta; exportar vídeo/poster.
+If using the logo: create a 3D / glass / metal / crystal / particle version; keep it legible; don't distort the brand; use cinematic light; animate with slow camera motion; export video/poster.
 
-**Quando não há logo nem imagem forte**, propor: objeto signature abstrato; monólito futurista; esfera de partículas; cluster cristalino; forma de vidro escuro; dashboard cinematográfico fictício; cena atmosférica; símbolo conceitual baseado no feeling.
+**When there's no logo or strong image**, propose: an abstract signature object; a futuristic monolith; a particle sphere; a crystalline cluster; a dark glass shape; a fictional cinematic dashboard; an atmospheric scene; a conceptual symbol based on the feeling.
 
-Nunca travar por falta de imagem.
+Never get stuck due to lack of an image.
 
-### Etapa 3 — Prompt para imagem base
+### Step 3 — Base image prompt
 
-Sempre entregar um prompt de imagem base quando recomendar image-to-video ou hybrid motion.
+Always deliver a base image prompt when recommending image-to-video or hybrid motion.
 
 **Template:**
 
@@ -82,7 +82,7 @@ Output:
 4K, clean composition, suitable for image-to-video animation and website hero.
 ```
 
-**Exemplo preenchido:**
+**Filled-in example:**
 
 ```
 Create a cinematic hero image for a premium technology studio website.
@@ -106,9 +106,9 @@ Output:
 4K, clean background, suitable for image-to-video animation.
 ```
 
-### Etapa 4 — Prompt para image-to-video
+### Step 4 — Image-to-video prompt
 
-Sempre entregar um prompt de vídeo.
+Always deliver a video prompt.
 
 **Template:**
 
@@ -140,7 +140,7 @@ Output:
 WebM and MP4, desktop crop, mobile crop, poster frame included.
 ```
 
-**Exemplo preenchido:**
+**Filled-in example:**
 
 ```
 Animate this image into a cinematic website hero loop.
@@ -163,4 +163,3 @@ Fast movement, shaky camera, excessive particles, dramatic explosions, cheap sci
 Output:
 WebM and MP4, 16:9 desktop crop and 9:16 mobile crop, poster frame included.
 ```
-