wizz-method 2.1.1 → 2.3.0

package/src/skills-lib/wizz-premium-landing-ui-researcher/references/mandatory-process.md

@@ -1,35 +1,35 @@
 ## Mandatory Process
 
-Sempre seguir este processo. **Os passos 6, 7 e 8 são CHECKPOINTS DE FONTES e devem ser executados antes de qualquer código de UI.**
+Always follow this process. **Steps 6, 7, and 8 are SOURCE CHECKPOINTS and must be executed before any UI code.**
 
-1. Analisar o contexto do projeto.
-2. Fazer até 5 perguntas se faltarem dados essenciais.
-3. Classificar o nível do projeto.
-4. Definir direção visual.
-5. Decidir se precisa de landing, dashboard, 3D/WebGL ou combinação.
-6. **CHECKPOINT: Inventário de fontes do usuário.** Listar e inspecionar (ls + leitura mínima de READMEs/package.json) o projeto atual e os modelos nos caminhos fornecidos pelo usuário; reutilizar o resumo de memória do handoff. Identificar quais componentes/efeitos do que ele já tem podem ser reutilizados antes de qualquer fonte externa.
-7. **CHECKPOINT: Source-First Protocol (obrigatório).** Execute [source-first-protocol](source-first-protocol.md): busque fontes públicas, abra demos e código/registry, confira revisão, licença e dependências. Registre evidências e falhas no artefato de pesquisa; mostre 1–3 candidatos reais por componente.
-8. **CHECKPOINT: Escolher fontes.** Recomende a combinação adequada. Com direção e implementação já autorizadas, prossiga; pergunte apenas se faltar uma decisão material.
-9. Recomendar componentes e animações (já curados nos checkpoints anteriores).
-10. Escrever copy e estrutura.
-11. Sugerir plano de implementação (adaptação das fontes à marca, não recriação).
-12. **CHECKPOINT: Audit Protocol** (Pass 1 Taste Skill → Pass 2 Impeccable → Pass 3 Cross-check → Pass 4 Acessibilidade/Perf). Definido em references/audit-protocol.md. Nunca pular passes silenciosamente.
+1. Analyze the project context.
+2. Ask up to 5 questions if essential data is missing.
+3. Classify the project's level.
+4. Define the visual direction.
+5. Decide whether it needs a landing page, dashboard, 3D/WebGL, or a combination.
+6. **CHECKPOINT: Inventory of the user's sources.** List and inspect (ls + minimal reading of READMEs/package.json) the current project and the models at the paths provided by the user; reuse the memory summary from the handoff. Identify which components/effects the user already has that can be reused before any external source.
+7. **CHECKPOINT: Source-First Protocol (mandatory).** Run [source-first-protocol](source-first-protocol.md): search public sources, open demos and code/registry, check revision, license, and dependencies. Log evidence and failures in the research artifact; show 1-3 real candidates per component.
+8. **CHECKPOINT: Choose sources.** Recommend the appropriate combination. With direction and implementation already authorized, proceed; only ask if a material decision is missing.
+9. Recommend components and animations (already curated in the previous checkpoints).
+10. Write copy and structure.
+11. Suggest an implementation plan (adapting the sources to the brand, not recreating them).
+12. **CHECKPOINT: Audit Protocol** (Pass 1 Taste Skill → Pass 2 Impeccable → Pass 3 Cross-check → Pass 4 Accessibility/Performance). Defined in references/audit-protocol.md. Never silently skip passes.
 
-### Checkpoint de honestidade: antes de implementar
+### Honesty checkpoint: before implementing
 
-Antes de escrever qualquer componente, responder internamente:
+Before writing any component, answer internally:
 
-- Eu inspecionei o que o usuário já tem em `/modelos lp/` (ou equivalente)?
-- Eu abri as fontes exatas e registrei código/registry, revisão/data, licença e dependências?
-- Eu documentei candidatos aceitos/rejeitados e eventuais fontes indisponíveis?
-- O componente que estou prestes a escrever do zero ficou sem alternativa compatível nas fontes efetivamente pesquisadas, com justificativa registrada?
+- Did I inspect what the user already has in `/modelos lp/` (or equivalent)?
+- Did I open the exact sources and log code/registry, revision/date, license, and dependencies?
+- Did I document accepted/rejected candidates and any unavailable sources?
+- Did the component I'm about to write from scratch end up without a compatible alternative among the sources actually researched, with a logged justification?
 
-Se a resposta for "não" para qualquer uma dessas perguntas, **PARE e volte para o Source-First Protocol antes de continuar**.
+If the answer is "no" to any of these questions, **STOP and go back to the Source-First Protocol before continuing**.
 
-### Detalhamento das etapas
+### Step details
 
-**Analisar o projeto.** Antes de criar ou alterar qualquer coisa, inspecione o projeto quando houver acesso ao repositório. Verifique: framework (Next.js, React, Vite, Remix), linguagem (TS/JS), styling (Tailwind, CSS Modules, styled-components, shadcn/ui, Radix), bibliotecas já instaladas (framer-motion, gsap, three, @react-three/fiber, lucide-react), estrutura de pastas, rotas existentes, componentes reutilizáveis, tema/cores/fontes/tokens, nível visual atual, problemas de UX, gargalos de conversão, responsividade e performance. Se não houver projeto acessível, trabalhar como planejador.
+**Analyze the project.** Before creating or changing anything, inspect the project when there is access to the repository. Check: framework (Next.js, React, Vite, Remix), language (TS/JS), styling (Tailwind, CSS Modules, styled-components, shadcn/ui, Radix), already-installed libraries (framer-motion, gsap, three, @react-three/fiber, lucide-react), folder structure, existing routes, reusable components, theme/colors/fonts/tokens, current visual level, UX problems, conversion bottlenecks, responsiveness, and performance. If there is no accessible project, work as a planner.
 
-**Entender o negócio.** Sempre identificar: negócio/produto/serviço, público-alvo, objetivo da página, oferta, diferenciais, nível de consciência do público, objeções prováveis, tom de marca, etapa do funil, ação principal desejada.
+**Understand the business.** Always identify: business/product/service, target audience, page objective, offer, differentiators, audience awareness level, likely objections, brand tone, funnel stage, main desired action.
 
-**Escolher referências e componentes.** Com base no nível classificado, decidir: quais seções devem existir, quais componentes melhoram conversão, quais animações ajudam ou atrapalham, quais referências visuais combinam com a marca, quais efeitos no hero, quais elementos devem ser estáticos por performance, quais componentes criar do zero, quais vêm de fontes autorizadas. Toda animação deve ter função: clareza, desejo, profundidade, guia visual, prova de valor ou sofisticação.
+**Choose references and components.** Based on the classified level, decide: which sections should exist, which components improve conversion, which animations help or hurt, which visual references fit the brand, which effects for the hero, which elements should be static for performance, which components to create from scratch, which come from authorized sources. Every animation must have a purpose: clarity, desire, depth, visual guidance, proof of value, or sophistication.

package/src/skills-lib/wizz-premium-landing-ui-researcher/references/output-format-and-quality.md

@@ -1,128 +1,128 @@
 
 ## Final Response Format
 
-Quando a skill entregar uma resposta completa, usar esta estrutura:
-
-1. Diagnóstico do projeto
-2. Nível recomendado
-3. Direção visual
-4. Estratégia de copy
-5. Estrutura da landing
-6. Copy completa
-7. Componentes recomendados
-8. Animações recomendadas
-9. Fontes usadas
-10. Plano de implementação
-11. Melhorias de conversão
-12. Estratégia de CTA externo / WhatsApp, se aplicável
-13. Selected Work + Case Deep-Dive, se Portfolio / Authority Mode estiver ativo
-14. Dashboard SaaS, se aplicável
-15. Plano 3D/WebGL, se aplicável
-16. Observações de performance/mobile
-
-Os blocos "Fontes usadas", "Estratégia de CTA externo / WhatsApp", "Selected Work" e "Plano 3D/WebGL" devem aparecer explicitamente quando aplicáveis.
-
-### Formato quando o usuário pedir análise + plano
+When the skill delivers a complete response, use this structure:
+
+1. Project diagnosis
+2. Recommended level
+3. Visual direction
+4. Copy strategy
+5. Landing structure
+6. Complete copy
+7. Recommended components
+8. Recommended animations
+9. Sources used
+10. Implementation plan
+11. Conversion improvements
+12. External CTA / WhatsApp strategy, if applicable
+13. Selected Work + Case Deep-Dive, if Portfolio / Authority Mode is active
+14. SaaS Dashboard, if applicable
+15. 3D/WebGL plan, if applicable
+16. Performance/mobile notes
+
+The "Sources used," "External CTA / WhatsApp strategy," "Selected Work," and "3D/WebGL plan" blocks must appear explicitly when applicable.
+
+### Format when the user asks for analysis + plan
 
 ```markdown
-# Diagnóstico do projeto
+# Project diagnosis
 
-## Nível recomendado
+## Recommended level
 ...
 
-## Direção estratégica da landing
+## Strategic direction of the landing page
 ...
 
-## Referências e fontes usadas
+## References and sources used
 ...
 
-## Componentes e animações escolhidos
+## Components and animations chosen
 ...
 
-## Estrutura da página
+## Page structure
 ...
 
-## Copy completa
+## Complete copy
 ...
 
-## Direção visual
+## Visual direction
 ...
 
-## Plano de implementação
+## Implementation plan
 ...
 
-## Melhorias de conversão
+## Conversion improvements
 ...
 
-## Estratégia de CTA externo / WhatsApp (se aplicável)
+## External CTA / WhatsApp strategy (if applicable)
 ...
 
-## Selected Work + Case Deep-Dive (se Portfolio / Authority Mode ativo)
+## Selected Work + Case Deep-Dive (if Portfolio / Authority Mode is active)
 ...
 
-## Plano 3D/WebGL (se aplicável)
+## 3D/WebGL plan (if applicable)
 ...
 
-## Dashboard SaaS (se aplicável)
+## SaaS Dashboard (if applicable)
 ...
 ```
 
-### Formato quando houver implementação no repositório
+### Format when there is implementation in the repository
 
-Entregar:
+Deliver:
 
-1. breve diagnóstico;
-2. arquivos alterados/criados;
-3. comandos necessários;
-4. componentes usados;
-5. fontes usadas;
-6. como testar;
-7. observações de performance;
-8. próximos passos.
+1. brief diagnosis;
+2. changed/created files;
+3. required commands;
+4. components used;
+5. sources used;
+6. how to test;
+7. performance notes;
+8. next steps.
 
-Não esconder decisões importantes. Se uma biblioteca pesada foi adicionada, justificar.
+Don't hide important decisions. If a heavy library was added, justify it.
 
 ## Quality Bar
 
-O resultado final deve parecer:
+The final result must look:
 
 - premium;
-- estratégico;
-- moderno;
-- pronto para implementação;
-- orientado à conversão;
-- visualmente sofisticado;
-- criado por especialista;
-- adequado ao valor do projeto;
-- não genérico;
-- não amador;
-- não artificial.
+- strategic;
+- modern;
+- ready for implementation;
+- conversion-oriented;
+- visually sophisticated;
+- built by an expert;
+- appropriate to the project's value;
+- not generic;
+- not amateurish;
+- not artificial.
 
-Sempre buscar aumentar: clareza, desejabilidade, credibilidade, valor percebido, diferenciação visual, conversão real.
+Always aim to increase: clarity, desirability, credibility, perceived value, visual differentiation, real conversion.
 
-Nunca entregar uma landing page que pareça template sem posicionamento.
+Never deliver a landing page that looks like a template with no positioning.
 
 ### Final Rule
 
-A skill não deve apenas procurar componentes bonitos.
+The skill should not just look for pretty components.
 
-A skill deve escolher componentes, animações, copy e direção visual com base em: objetivo da página, público-alvo, oferta, nível de consciência, ticket, sofisticação necessária, performance, clareza, marca, conversão, diferenciação.
+The skill must choose components, animations, copy, and visual direction based on: page objective, target audience, offer, awareness level, price point, required sophistication, performance, clarity, brand, conversion, differentiation.
 
-A entrega deve parecer um trabalho premium de estratégia, copywriting, design e implementação.
+The delivery must feel like premium strategy, copywriting, design, and implementation work.
 
-### Self-check antes de fechar a entrega
+### Self-check before closing the delivery
 
-Antes de declarar a landing pronta, perguntar-se honestamente:
+Before declaring the landing page ready, honestly ask yourself:
 
-- Eu **abri demos e código/registry dos componentes recomendados** e registrei buscas, URLs/paths, revisão/data, licença, dependências e motivo da escolha?
-- Eu **inspecionei `/modelos lp/`** (ou pasta equivalente) do usuário antes de escrever shader/animação/hero?
-- Eu registrei fontes indisponíveis e usei cache sem sobrescrever alterações locais?
-- Cada componente que entreguei tem uma **fonte rastreável** (URL exata de código/registry, revisão do repo ou arquivo local), ou foi escrito do zero com declaração explícita?
-- Apliquei os 4 passes do **Audit Protocol** (Taste Skill cedo → Impeccable tarde → Cross-check com referências → Acessibilidade/Perf), ou declarei qual passe foi pulado e por quê?
-- O **Pass 4 (Acessibilidade + Performance)** foi executado? Esse passe nunca pode ser pulado.
+- Did I **open demos and code/registry of the recommended components** and log searches, URLs/paths, revision/date, license, dependencies, and reason for the choice?
+- Did I **inspect `/modelos lp/`** (or equivalent folder) of the user before writing any shader/animation/hero?
+- Did I log unavailable sources and use the cache without overwriting local changes?
+- Does every component I delivered have a **traceable source** (exact code/registry URL, repo revision, or local file), or was it written from scratch with an explicit declaration?
+- Did I apply the 4 passes of the **Audit Protocol** (Taste Skill early → Impeccable late → Cross-check against references → Accessibility/Performance), or did I declare which pass was skipped and why?
+- Was **Pass 4 (Accessibility + Performance)** executed? This pass can never be skipped.
 
-Se qualquer resposta for "não" sem justificativa declarada ao usuário, **a entrega não está pronta**. Voltar pro Source-First Protocol ou pro Audit Protocol conforme o caso.
+If any answer is "no" without a justification declared to the user, **the delivery is not ready**. Go back to the Source-First Protocol or the Audit Protocol as appropriate.
 
-Esta skill é um agregador de fontes maduras. Reinventar shaders/animações/componentes do zero é o anti-pattern principal. Releia o `<EXTREMELY-IMPORTANT>` no topo de references/source-first-protocol.md se houver qualquer dúvida.
+This skill is a curator of mature sources. Reinventing shaders/animations/components from scratch is the main anti-pattern. Re-read the `<EXTREMELY-IMPORTANT>` at the top of references/source-first-protocol.md if there is any doubt.
 
 ---

package/src/skills-lib/wizz-premium-landing-ui-researcher/references/prompt-templates.md

@@ -1,6 +1,6 @@
-### Prompt base para criação de landing page
+### Base prompt for creating a landing page
 
-Use este briefing como base quando o usuário pedir uma landing page completa.
+Use this briefing as a base when the user asks for a complete landing page. (The template below stays in Portuguese: it is the literal prompt text used to produce Portuguese-language landing page copy for the Brazilian market.)
 
 ```text
 Crie uma landing page completa, premium e estratégica para o seguinte negócio/produto:
@@ -149,9 +149,9 @@ O resultado deve parecer um site premium, estratégico, pronto para implementaç
 Agora crie o site completo com base nas informações fornecidas.
 ```
 
-### Prompt para hero section com animação 3D no scroll
+### Prompt for a hero section with 3D scroll animation
 
-Use este prompt quando o usuário pedir uma hero section cinematográfica com vídeo ou animação 3D no scroll.
+Use this prompt when the user asks for a cinematic hero section with video or 3D scroll animation. (The template below stays as originally written, mixing English and Portuguese, since it is the literal prompt text.)
 
 ```text
 Create me a 3d scroll animation hero section based on the folder that has the skill.