wizz-method 2.2.0 → 2.3.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (198) hide show
  1. package/README.md +62 -62
  2. package/SECURITY.md +15 -16
  3. package/THIRD-PARTY-NOTICES.md +49 -49
  4. package/package.json +1 -1
  5. package/src/bmm-skills/1-analysis/wizz-agent-analyst/customize.toml +1 -1
  6. package/src/bmm-skills/2-plan-workflows/wizz-agent-pm/customize.toml +1 -1
  7. package/src/bmm-skills/2-plan-workflows/wizz-agent-ux-designer/customize.toml +1 -1
  8. package/src/bmm-skills/3-solutioning/wizz-agent-architect/customize.toml +1 -1
  9. package/src/bmm-skills/4-implementation/wizz-agent-dev/customize.toml +1 -1
  10. package/src/core-skills/_shared/handoff-protocol.md +72 -71
  11. package/src/core-skills/wizz-review-adversarial-general/SKILL.md +1 -1
  12. package/src/modules/lowticket/skills/wizz-lowticket-funil/references/copy-das-paginas.md +39 -39
  13. package/src/modules/lowticket/skills/wizz-lowticket-funil/references/mapa-do-funil.md +23 -23
  14. package/src/modules/lowticket/skills/wizz-lowticket-metodologia/CATALOGO.md +72 -72
  15. package/src/modules/lowticket/skills/wizz-lowticket-metodologia/knowledge/01-principios.md +10 -10
  16. package/src/modules/lowticket/skills/wizz-lowticket-metodologia/knowledge/02-diagnostico-funil.md +50 -50
  17. package/src/modules/lowticket/skills/wizz-lowticket-metodologia/knowledge/03-campanha-bidcap.md +68 -68
  18. package/src/modules/lowticket/skills/wizz-lowticket-metodologia/knowledge/04-criativos.md +44 -44
  19. package/src/modules/lowticket/skills/wizz-lowticket-metodologia/knowledge/04a-criativos-ia.md +77 -77
  20. package/src/modules/lowticket/skills/wizz-lowticket-metodologia/knowledge/04b-criativos-formatos.md +121 -121
  21. package/src/modules/lowticket/skills/wizz-lowticket-metodologia/knowledge/05-oferta.md +35 -35
  22. package/src/modules/lowticket/skills/wizz-lowticket-metodologia/knowledge/06-pagina-vendas.md +122 -122
  23. package/src/modules/lowticket/skills/wizz-lowticket-metodologia/knowledge/06a-instagram.md +93 -93
  24. package/src/modules/lowticket/skills/wizz-lowticket-metodologia/knowledge/06b-player-vsl.md +57 -57
  25. package/src/modules/lowticket/skills/wizz-lowticket-metodologia/knowledge/07-funil-upsell.md +83 -83
  26. package/src/modules/lowticket/skills/wizz-lowticket-metodologia/knowledge/07a-copy-humanizacao.md +61 -61
  27. package/src/modules/lowticket/skills/wizz-lowticket-metodologia/knowledge/08-pesquisa-publico.md +11 -11
  28. package/src/modules/lowticket/skills/wizz-lowticket-metodologia/knowledge/09-especialista-coproducao.md +26 -26
  29. package/src/modules/lowticket/skills/wizz-lowticket-metodologia/knowledge/10-levantar-caixa.md +29 -29
  30. package/src/modules/lowticket/skills/wizz-lowticket-metodologia/knowledge/11-checklist-roi.md +22 -22
  31. package/src/modules/lowticket/skills/wizz-lowticket-metodologia/knowledge/12-mineracao-ofertas.md +80 -80
  32. package/src/modules/lowticket/skills/wizz-lowticket-metodologia/knowledge/12a-mineracao-veredito.md +72 -72
  33. package/src/modules/lowticket/skills/wizz-lowticket-metodologia/knowledge/12b-fabrica-de-ofertas.md +63 -63
  34. package/src/modules/lowticket/skills/wizz-lowticket-metodologia/knowledge/12c-anatomia-low-ticket.md +71 -71
  35. package/src/modules/lowticket/skills/wizz-lowticket-metodologia/knowledge/13-benchmarks-vsl.md +6 -6
  36. package/src/modules/lowticket/skills/wizz-lowticket-metodologia/knowledge/14-vocabulario.md +53 -51
  37. package/src/modules/lowticket/skills/wizz-lowticket-metodologia/knowledge/15-como-estender.md +26 -26
  38. package/src/modules/lowticket/skills/wizz-lowticket-metodologia/knowledge/17-rastreamento.md +76 -76
  39. package/src/modules/lowticket/skills/wizz-lowticket-metodologia/knowledge/18-copy-desejo-oferta.md +149 -149
  40. package/src/modules/lowticket/skills/wizz-lowticket-metodologia/knowledge/INDEX.md +45 -45
  41. package/src/modules/lowticket/skills/wizz-lowticket-metodologia/knowledge/guardrails.md +45 -45
  42. package/src/modules/lowticket/skills/wizz-lowticket-metodologia/knowledge/pontos-em-aberto.md +64 -66
  43. package/src/modules/lowticket/skills/wizz-lowticket-minerador/references/rubrica.md +63 -63
  44. package/src/modules/lowticket/skills/wizz-lowticket-pagina/references/metas-e-medicao.md +23 -23
  45. package/src/modules/lowticket/skills/wizz-lowticket-pagina/references/padroes-de-codigo.md +50 -50
  46. package/src/modules/lowticket/skills/wizz-lowticket-trafego/references/formato-do-diagnostico.md +9 -9
  47. package/src/modules/lowticket/skills/wizz-lowticket-trafego/references/reguas.md +42 -42
  48. package/src/modules/wizz/README.md +27 -27
  49. package/src/modules/wizz/_shared/cerebro.md +37 -37
  50. package/src/modules/wizz/_shared/communication-rules.md +15 -15
  51. package/src/modules/wizz/_shared/despacho-barato.md +6 -6
  52. package/src/modules/wizz/_shared/encerramento.md +23 -23
  53. package/src/modules/wizz/_shared/model-ladder.md +29 -29
  54. package/src/modules/wizz/_shared/planning-gate.md +30 -30
  55. package/src/modules/wizz/_shared/token-economy.md +28 -28
  56. package/src/modules/wizz/_shared/video-pipeline.md +42 -42
  57. package/src/modules/wizz/agents/wizz-ads/SKILL.md +16 -16
  58. package/src/modules/wizz/agents/wizz-ads/customize.toml +21 -21
  59. package/src/modules/wizz/agents/wizz-copy/SKILL.md +18 -18
  60. package/src/modules/wizz/agents/wizz-copy/customize.toml +24 -24
  61. package/src/modules/wizz/agents/wizz-designer/SKILL.md +24 -24
  62. package/src/modules/wizz/agents/wizz-designer/customize.toml +29 -29
  63. package/src/modules/wizz/agents/wizz-growth/SKILL.md +20 -20
  64. package/src/modules/wizz/agents/wizz-growth/customize.toml +34 -34
  65. package/src/modules/wizz/agents/wizz-maestro/SKILL.md +63 -63
  66. package/src/modules/wizz/agents/wizz-maestro/customize.toml +38 -38
  67. package/src/modules/wizz/agents/wizz-memoria/SKILL.md +19 -19
  68. package/src/modules/wizz/agents/wizz-memoria/customize.toml +24 -24
  69. package/src/modules/wizz/agents/wizz-qa/SKILL.md +22 -22
  70. package/src/modules/wizz/agents/wizz-qa/customize.toml +29 -29
  71. package/src/modules/wizz/agents/wizz-seo/SKILL.md +19 -19
  72. package/src/modules/wizz/agents/wizz-seo/customize.toml +27 -27
  73. package/src/modules/wizz/agents/wizz-social/SKILL.md +53 -53
  74. package/src/modules/wizz/agents/wizz-social/customize.toml +37 -37
  75. package/src/modules/wizz/agents/wizz-social/knowledge/analise-imagem-referencia.md +20 -20
  76. package/src/modules/wizz/agents/wizz-social/knowledge/biblioteca-prompts-imagem.md +71 -71
  77. package/src/modules/wizz/agents/wizz-social/knowledge/blueprint-roteiro-viral.md +196 -196
  78. package/src/modules/wizz/agents/wizz-social/knowledge/legenda-instagram.md +32 -32
  79. package/src/modules/wizz/agents/wizz-social/knowledge/prompts-imagem-video.md +48 -48
  80. package/src/modules/wizz/module.yaml +28 -28
  81. package/src/modules/wizz/overrides/wizz-agent-analyst.toml +17 -17
  82. package/src/modules/wizz/overrides/wizz-agent-architect.toml +21 -21
  83. package/src/modules/wizz/overrides/wizz-agent-dev.toml +20 -20
  84. package/src/modules/wizz/overrides/wizz-agent-pm.toml +11 -11
  85. package/src/modules/wizz/overrides/wizz-agent-tech-writer.toml +14 -14
  86. package/src/modules/wizz/overrides/wizz-agent-ux-designer.toml +14 -14
  87. package/src/modules/wizz/subagents/codex/wizz-exec-haiku.toml +17 -17
  88. package/src/modules/wizz/subagents/codex/wizz-exec-opus.toml +19 -19
  89. package/src/modules/wizz/subagents/codex/wizz-exec-review.toml +18 -18
  90. package/src/modules/wizz/subagents/codex/wizz-exec-sonnet.toml +18 -18
  91. package/src/modules/wizz/subagents/gemini/wizz-exec-haiku.md +17 -17
  92. package/src/modules/wizz/subagents/gemini/wizz-exec-opus.md +19 -19
  93. package/src/modules/wizz/subagents/gemini/wizz-exec-review.md +18 -18
  94. package/src/modules/wizz/subagents/gemini/wizz-exec-sonnet.md +18 -18
  95. package/src/modules/wizz/subagents/opencode/wizz-exec-haiku.md +17 -17
  96. package/src/modules/wizz/subagents/opencode/wizz-exec-opus.md +19 -19
  97. package/src/modules/wizz/subagents/opencode/wizz-exec-review.md +18 -18
  98. package/src/modules/wizz/subagents/opencode/wizz-exec-sonnet.md +18 -18
  99. package/src/modules/wizz/subagents/spec.yaml +84 -83
  100. package/src/modules/wizz/subagents/wizz-exec-haiku.md +17 -17
  101. package/src/modules/wizz/subagents/wizz-exec-opus.md +19 -19
  102. package/src/modules/wizz/subagents/wizz-exec-review.md +18 -18
  103. package/src/modules/wizz/subagents/wizz-exec-sonnet.md +18 -18
  104. package/src/skills-lib/cerebro/SKILL.md +61 -61
  105. package/src/skills-lib/cerebro/references/comandos-pesquisa-e-memoria.md +46 -46
  106. package/src/skills-lib/cerebro/references/comandos-rotina-e-captura.md +65 -65
  107. package/src/skills-lib/cerebro/references/comandos-sessao.md +74 -74
  108. package/src/skills-lib/ctc-align/SKILL.md +37 -37
  109. package/src/skills-lib/find-skills/SKILL.md +19 -19
  110. package/src/skills-lib/pesquisa-de-publico-do-piva/README.md +33 -33
  111. package/src/skills-lib/pesquisa-de-publico-do-piva/SKILL.md +42 -42
  112. package/src/skills-lib/pesquisa-de-publico-do-piva/prompts.md +20 -20
  113. package/src/skills-lib/references/premium-agency-rules.md +63 -63
  114. package/src/skills-lib/security-audit-pentest/SKILL.md +31 -31
  115. package/src/skills-lib/security-audit-pentest/references/stage-1-validacao-entrada.md +37 -37
  116. package/src/skills-lib/security-audit-pentest/references/stage-2-autorizacao.md +61 -61
  117. package/src/skills-lib/security-audit-pentest/references/stage-3-abuso-volume.md +37 -37
  118. package/src/skills-lib/security-audit-pentest/references/stage-4-vazamento-resposta.md +52 -52
  119. package/src/skills-lib/site-launch-kit/SKILL.md +42 -42
  120. package/src/skills-lib/site-launch-kit/references/01-cta-principal.md +20 -20
  121. package/src/skills-lib/site-launch-kit/references/02-barra-fixa-mobile.md +24 -24
  122. package/src/skills-lib/site-launch-kit/references/03-tempo-de-resposta.md +21 -21
  123. package/src/skills-lib/site-launch-kit/references/04-prova-social.md +22 -22
  124. package/src/skills-lib/site-launch-kit/references/05-faq-decisao.md +28 -28
  125. package/src/skills-lib/site-launch-kit/references/06-imagens-reais.md +27 -27
  126. package/src/skills-lib/site-launch-kit/references/07-endereco-como-chegar.md +25 -25
  127. package/src/skills-lib/site-launch-kit/references/08-titles.md +30 -30
  128. package/src/skills-lib/site-launch-kit/references/09-open-graph.md +23 -23
  129. package/src/skills-lib/site-launch-kit/references/10-breadcrumbs.md +23 -23
  130. package/src/skills-lib/site-launch-kit/references/11-alt-text.md +28 -28
  131. package/src/skills-lib/site-launch-kit/references/12-schema-local.md +22 -22
  132. package/src/skills-lib/site-launch-kit/references/13-robots-sitemap.md +26 -26
  133. package/src/skills-lib/site-launch-kit/references/14-privacidade-termos.md +27 -27
  134. package/src/skills-lib/site-launch-kit/references/15-medicao.md +23 -23
  135. package/src/skills-lib/wizz-ai-product-design/SKILL.md +70 -70
  136. package/src/skills-lib/wizz-auth-and-secrets/SKILL.md +78 -78
  137. package/src/skills-lib/wizz-caching-and-queues/SKILL.md +40 -40
  138. package/src/skills-lib/wizz-cloud-and-infra/SKILL.md +22 -22
  139. package/src/skills-lib/wizz-database-and-deps/SKILL.md +52 -52
  140. package/src/skills-lib/wizz-database-scaling/SKILL.md +31 -31
  141. package/src/skills-lib/wizz-desktop-security/SKILL.md +49 -49
  142. package/src/skills-lib/wizz-implementation-planner/SKILL.md +56 -56
  143. package/src/skills-lib/wizz-implementation-planner/references/folder-structure-and-dependencies.md +14 -14
  144. package/src/skills-lib/wizz-implementation-planner/references/implementation-phases.md +15 -15
  145. package/src/skills-lib/wizz-implementation-planner/references/implementation-types.md +9 -9
  146. package/src/skills-lib/wizz-implementation-planner/references/motion-path-implementation.md +19 -19
  147. package/src/skills-lib/wizz-implementation-planner/references/performance-plan.md +27 -27
  148. package/src/skills-lib/wizz-infrastructure/SKILL.md +21 -21
  149. package/src/skills-lib/wizz-inicio-de-projeto/SKILL.md +63 -63
  150. package/src/skills-lib/wizz-inicio-de-projeto/references/implementacao-api-forms.md +27 -27
  151. package/src/skills-lib/wizz-inicio-de-projeto/references/padroes-arquiteturais-e-pastas.md +31 -31
  152. package/src/skills-lib/wizz-inicio-de-projeto/references/seguranca-e-regras-codigo.md +21 -21
  153. package/src/skills-lib/wizz-launch-readiness/SKILL.md +61 -61
  154. package/src/skills-lib/wizz-launch-readiness/references/01-tecnico-build.md +16 -16
  155. package/src/skills-lib/wizz-launch-readiness/references/02-seguranca.md +16 -16
  156. package/src/skills-lib/wizz-launch-readiness/references/03-seo-descoberta.md +16 -16
  157. package/src/skills-lib/wizz-launch-readiness/references/04-analytics-medicao.md +15 -15
  158. package/src/skills-lib/wizz-launch-readiness/references/05-conteudo-prova-social.md +15 -15
  159. package/src/skills-lib/wizz-launch-readiness/references/06-legal-lgpd.md +15 -15
  160. package/src/skills-lib/wizz-launch-readiness/references/07-infra-deploy-rollback.md +16 -16
  161. package/src/skills-lib/wizz-launch-readiness/references/08-fusao-priorizacao.md +19 -19
  162. package/src/skills-lib/wizz-launch-readiness/references/09-persistencia-project-context.md +26 -26
  163. package/src/skills-lib/wizz-motion-3d-director/SKILL.md +70 -70
  164. package/src/skills-lib/wizz-motion-3d-director/references/image-to-video-workflow.md +34 -35
  165. package/src/skills-lib/wizz-motion-3d-director/references/motion-paths.md +70 -70
  166. package/src/skills-lib/wizz-motion-3d-director/references/performance-and-handoff.md +17 -17
  167. package/src/skills-lib/wizz-offer-forge/README.md +9 -9
  168. package/src/skills-lib/wizz-offer-forge/SKILL.md +64 -64
  169. package/src/skills-lib/wizz-offer-forge/references/empilhamento-valor.md +17 -17
  170. package/src/skills-lib/wizz-offer-forge/references/garantia-reversa.md +16 -16
  171. package/src/skills-lib/wizz-offer-forge/references/mecanismo-unico.md +19 -19
  172. package/src/skills-lib/wizz-offer-forge/references/ponte-trafego.md +17 -17
  173. package/src/skills-lib/wizz-premium-landing-ui-researcher/SKILL.md +36 -36
  174. package/src/skills-lib/wizz-premium-landing-ui-researcher/references/audit-protocol.md +81 -82
  175. package/src/skills-lib/wizz-premium-landing-ui-researcher/references/component-sources.md +105 -105
  176. package/src/skills-lib/wizz-premium-landing-ui-researcher/references/core-goal.md +39 -39
  177. package/src/skills-lib/wizz-premium-landing-ui-researcher/references/dashboard-and-portfolio-modes.md +49 -50
  178. package/src/skills-lib/wizz-premium-landing-ui-researcher/references/handoffs.md +33 -34
  179. package/src/skills-lib/wizz-premium-landing-ui-researcher/references/landing-page-strategy.md +141 -142
  180. package/src/skills-lib/wizz-premium-landing-ui-researcher/references/mandatory-process.md +24 -24
  181. package/src/skills-lib/wizz-premium-landing-ui-researcher/references/output-format-and-quality.md +73 -73
  182. package/src/skills-lib/wizz-premium-landing-ui-researcher/references/prompt-templates.md +4 -4
  183. package/src/skills-lib/wizz-premium-landing-ui-researcher/references/site-levels.md +282 -283
  184. package/src/skills-lib/wizz-premium-landing-ui-researcher/references/source-first-protocol.md +39 -39
  185. package/src/skills-lib/wizz-premium-landing-ui-researcher/references/source-links.md +8 -8
  186. package/src/skills-lib/wizz-premium-landing-ui-researcher/references/stack-and-visual-direction.md +63 -64
  187. package/src/skills-lib/wizz-router/SKILL.md +38 -38
  188. package/src/skills-lib/wizz-router/references/auditoria-360.md +12 -12
  189. package/src/skills-lib/wizz-router/references/routing-table-flat.md +80 -80
  190. package/src/skills-lib/wizz-tracking-audit/SKILL.md +48 -48
  191. package/src/skills-lib/wizz-tracking-audit/references/modo-diagnostico.md +43 -43
  192. package/src/skills-lib/wizz-tracking-audit/references/modo-implantacao.md +59 -59
  193. package/src/skills-lib/wizz-tracking-audit/references/utm-e-atribuicao.md +35 -35
  194. package/src/skills-lib/wizz-web-security/SKILL.md +35 -35
  195. package/src/skills-lib/wizz-web-security/references/checklist-deploy.md +50 -50
  196. package/src/skills-lib/wizz-web-security/references/headers-rate-limit-cors.md +33 -33
  197. package/src/skills-lib/wizz-web-security/references/owasp-top5-detalhado.md +36 -36
  198. package/tools/hooks/session-rules.js +14 -11
@@ -5,119 +5,119 @@ description: Technical implementation planning for premium websites, landing pag
5
5
 
6
6
  # Implementation Planner
7
7
 
8
- Esta skill **transforma estratégia, brief, landing, componentes, motion, 3D, vídeos e assets em um plano técnico** pronto para Claude Code, Codex, Cursor ou desenvolvimento manual.
8
+ This skill **turns strategy, brief, landing page, components, motion, 3D, videos, and assets into a technical plan** ready for Claude Code, Codex, Cursor, or manual development.
9
9
 
10
- Ela é o **último elo** do pipeline. Vem depois de:
10
+ It's the **last link** in the pipeline. It comes after:
11
11
 
12
- 1. `wizz-decision-maker` — brief visual
13
- 2. `wizz-premium-landing-ui-researcher` — estratégia, copy, estrutura, motion ladder
14
- 3. `wizz-ui-component-curator` — componentes, fontes, refs
15
- 4. `wizz-motion-3d-director` — motion path, prompts de imagem/vídeo, performance plan
12
+ 1. `wizz-decision-maker` — visual brief
13
+ 2. `wizz-premium-landing-ui-researcher` — strategy, copy, structure, motion ladder
14
+ 3. `wizz-ui-component-curator` — components, fonts, references
15
+ 4. `wizz-motion-3d-director` — motion path, image/video prompts, performance plan
16
16
 
17
- A regra-mestre desta skill: **não decide gosto visual.** Recebe decisões já tomadas e produz arquitetura técnica clara, implementável e performática.
17
+ This skill's master rule: **it does not decide visual taste.** It receives decisions already made and produces a clear, implementable, performant technical architecture.
18
18
 
19
19
  ---
20
20
 
21
- ## Objetivo
21
+ ## Goal
22
22
 
23
- Receber handoffs das skills upstream e produzir: stack recomendada, dependências, estrutura de pastas, component map, motion map, asset map, plano de performance, plano de acessibilidade, plano de SEO, analytics/tracking, fases de implementação, checklist final, e handoff prompt pronto para Claude Code / Codex / Cursor.
23
+ Receive handoffs from the upstream skills and produce: recommended stack, dependencies, folder structure, component map, motion map, asset map, performance plan, accessibility plan, SEO plan, analytics/tracking, implementation phases, final checklist, and a handoff prompt ready for Claude Code / Codex / Cursor.
24
24
 
25
25
  ---
26
26
 
27
- ## Quando usar (primeiro passo: confirmar o gatilho)
27
+ ## When to use (first step: confirm the trigger)
28
28
 
29
- Acionar quando o usuário pedir:
29
+ Trigger when the user asks:
30
30
 
31
- - "como implementar isso?";
32
- - "crie o plano técnico" / "me dá a arquitetura";
33
- - "estrutura de pastas" / "quais dependências instalar?";
34
- - "como mando para o Codex?" / "como faço no Claude Code?";
35
- - "prepara o projeto" / "plano de implementação";
36
- - "quero construir essa landing" / "quero transformar isso em código".
31
+ - "how do I implement this?";
32
+ - "create the technical plan" / "give me the architecture";
33
+ - "folder structure" / "which dependencies should I install?";
34
+ - "how do I send this to Codex?" / "how do I do this in Claude Code?";
35
+ - "prepare the project" / "implementation plan";
36
+ - "I want to build this landing page" / "I want to turn this into code".
37
37
 
38
- Também usar automaticamente quando a landing já tiver: estrutura definida; copy escrita; direção visual aprovada; componentes escolhidos; animações decididas; plano 3D/motion fechado (handoff de `wizz-motion-3d-director` em mãos); assets identificados; stack recomendada.
38
+ Also use it automatically when the landing page already has: defined structure; written copy; approved visual direction; chosen components; decided animations; a closed 3D/motion plan (handoff from `wizz-motion-3d-director` in hand); identified assets; a recommended stack.
39
39
 
40
40
  ## Skip when
41
41
 
42
- Pular esta skill quando:
42
+ Skip this skill when:
43
43
 
44
- - Ainda não há brief aprovado — rodar `wizz-decision-maker` primeiro.
45
- - Ainda não há copy nem direção visual — rodar `wizz-premium-landing-ui-researcher` primeiro.
46
- - O projeto é **3D High-End** ou **Signature 3D** mas o motion path ainda não foi decidido — rodar `wizz-motion-3d-director` primeiro. Implementar sem motion path leva a Three.js gratuito ou vídeo mal posicionado.
47
- - O usuário quer só refinar copy, componentes, ou direção visual — voltar para a skill upstream correspondente.
44
+ - There's no approved brief yet — run `wizz-decision-maker` first.
45
+ - There's no copy or visual direction yet — run `wizz-premium-landing-ui-researcher` first.
46
+ - The project is **3D High-End** or **Signature 3D** but the motion path hasn't been decided yet — run `wizz-motion-3d-director` first. Implementing without a motion path leads to gratuitous Three.js or poorly placed video.
47
+ - The user just wants to refine copy, components, or visual direction — go back to the corresponding upstream skill.
48
48
 
49
- Implementação sem decisões a montante produz código bonito que serve à ferramenta errada.
49
+ Implementation without upstream decisions produces pretty code that serves the wrong tool.
50
50
 
51
51
  ---
52
52
 
53
- ## Entrada esperada
53
+ ## Expected input
54
54
 
55
- A skill pode receber: brief visual (do `wizz-decision-maker`); estrutura da landing (do `wizz-premium-landing-ui-researcher`); copy; direção visual; componentes recomendados (do `wizz-ui-component-curator`); animações recomendadas; fontes/componentes; 3D plan (do `wizz-motion-3d-director`); image-to-video plan; dashboard plan, se SaaS; CTA plan; stack definida; restrições de performance; assets disponíveis; assets que ainda precisam ser criados.
55
+ The skill can receive: visual brief (from `wizz-decision-maker`); landing structure (from `wizz-premium-landing-ui-researcher`); copy; visual direction; recommended components (from `wizz-ui-component-curator`); recommended animations; fonts/components; 3D plan (from `wizz-motion-3d-director`); image-to-video plan; dashboard plan, if SaaS; CTA plan; defined stack; performance constraints; available assets; assets that still need to be created.
56
56
 
57
- Se faltar **informação crítica**, perguntar no máximo **5 coisas**. Se faltar detalhe menor, usar hipóteses coerentes e marcar como `[editável]`.
57
+ If **critical information** is missing, ask at most **5 things**. If a minor detail is missing, use coherent assumptions and mark them as `[editable]`.
58
58
 
59
59
  ---
60
60
 
61
- ## Regra principal
61
+ ## Main rule
62
62
 
63
- **Não inventar decisões estratégicas que já foram tomadas por outras skills.** Seguir o handoff recebido.
63
+ **Do not invent strategic decisions that other skills have already made.** Follow the handoff received.
64
64
 
65
- Em caso de conflito entre decisões upstream, priorizar nesta ordem:
65
+ In case of conflict between upstream decisions, prioritize in this order:
66
66
 
67
- 1. Brief visual (`wizz-decision-maker`).
68
- 2. Nível do site (`wizz-premium-landing-ui-researcher`).
69
- 3. Motion path (`wizz-motion-3d-director`) — regras completas em `references/motion-path-implementation.md`.
70
- 4. Stack padrão.
71
- 5. Perguntar — se o conflito afetar implementação e nenhuma das fontes resolver.
67
+ 1. Visual brief (`wizz-decision-maker`).
68
+ 2. Site tier (`wizz-premium-landing-ui-researcher`).
69
+ 3. Motion path (`wizz-motion-3d-director`) — full rules in `references/motion-path-implementation.md`.
70
+ 4. Standard stack.
71
+ 5. Ask — if the conflict affects implementation and none of the sources resolve it.
72
72
 
73
- **Exemplo crítico:** se `wizz-motion-3d-director` escolheu **image-to-video**, **não** implementar R3F/Three.js para o hero — usar `<video>` + Framer Motion para o overlay. Se escolheu **3D real**, planejar R3F com mobile fallback, dynamic import, e poster.
73
+ **Critical example:** if `wizz-motion-3d-director` chose **image-to-video**, **do not** implement R3F/Three.js for the hero — use `<video>` + Framer Motion for the overlay. If it chose **real 3D**, plan R3F with mobile fallback, dynamic import, and a poster.
74
74
 
75
75
  ---
76
76
 
77
- ## Stack padrão
77
+ ## Standard stack
78
78
 
79
- Se nenhuma stack for definida no handoff, usar: **Framework** Next.js (App Router) + React + TypeScript; **Styling** Tailwind CSS + shadcn/ui; **Motion** Framer Motion/Motion + React Bits; **3D (opcional)** React Three Fiber + Three.js + Drei, apenas se motion path exigir; **Charts (opcional)** Recharts, apenas para dashboards; **Icons** lucide-react; **Fonts** next/font; **Deploy** Vercel.
79
+ If no stack is defined in the handoff, use: **Framework** Next.js (App Router) + React + TypeScript; **Styling** Tailwind CSS + shadcn/ui; **Motion** Framer Motion/Motion + React Bits; **3D (optional)** React Three Fiber + Three.js + Drei, only if the motion path requires it; **Charts (optional)** Recharts, only for dashboards; **Icons** lucide-react; **Fonts** next/font; **Deploy** Vercel.
80
80
 
81
- Estrutura de pastas padrão e lista completa de dependências por categoria em `references/folder-structure-and-dependencies.md`.
81
+ Standard folder structure and the full list of dependencies by category are in `references/folder-structure-and-dependencies.md`.
82
82
 
83
83
  ---
84
84
 
85
85
  ## Accessibility Plan
86
86
 
87
- Incluir: semantic HTML; contraste AA; focus states; aria-labels onde necessário; navegação por teclado; reduced motion; texto alternativo em imagens; evitar conteúdo importante somente em vídeo/3D; CTA acessível; links descritivos.
87
+ Include: semantic HTML; AA contrast; focus states; aria-labels where needed; keyboard navigation; reduced motion; alt text on images; avoid important content that's only in video/3D; accessible CTA; descriptive links.
88
88
 
89
89
  ## SEO Plan
90
90
 
91
- Incluir: title; meta description; Open Graph; Twitter card; canonical; structured data (se fizer sentido); headings claros; sitemap/robots (se aplicável); alt text; performance.
91
+ Include: title; meta description; Open Graph; Twitter card; canonical; structured data (if it makes sense); clear headings; sitemap/robots (if applicable); alt text; performance.
92
92
 
93
93
  ## Analytics / Tracking
94
94
 
95
- Se o site tiver CTA, incluir eventos (`cta_click`, `whatsapp_click`, `calendly_click`, `email_click`, `case_open`, `pricing_view`, `hero_video_play`, `form_submit`). Para WhatsApp: tracking no clique, mensagem pré-preenchida, UTM se necessário.
95
+ If the site has a CTA, include events (`cta_click`, `whatsapp_click`, `calendly_click`, `email_click`, `case_open`, `pricing_view`, `hero_video_play`, `form_submit`). For WhatsApp: track the click, pre-filled message, UTM if needed.
96
96
 
97
97
  ---
98
98
 
99
- ## Output obrigatório
99
+ ## Mandatory output
100
100
 
101
- A resposta da skill deve sempre incluir: resumo técnico; stack recomendada; dependências; estrutura de pastas; component map; motion map; asset map; plano de performance; plano de acessibilidade; plano de SEO; analytics/tracking; fases de implementação; checklist final; handoff para Claude Code/Codex. Ver reference map abaixo para onde carregar o template de cada item.
101
+ The skill's response must always include: technical summary; recommended stack; dependencies; folder structure; component map; motion map; asset map; performance plan; accessibility plan; SEO plan; analytics/tracking; implementation phases; final checklist; handoff for Claude Code/Codex. See the reference map below for where to load each item's template.
102
102
 
103
103
  ---
104
104
 
105
- ## Regra final
105
+ ## Final rule
106
106
 
107
- A `wizz-implementation-planner` **não decide gosto visual**. Ela transforma decisões já tomadas em arquitetura clara, implementável e performática.
107
+ `wizz-implementation-planner` **does not decide visual taste**. It turns decisions already made into a clear, implementable, performant architecture.
108
108
 
109
- O melhor plano técnico é aquele que: reduz risco; preserva a direção visual; evita dependências inúteis; mantém performance; facilita manutenção; deixa claro o que o dev/AI precisa construir.
109
+ The best technical plan is one that: reduces risk; preserves the visual direction; avoids useless dependencies; maintains performance; eases maintenance; makes clear what the dev/AI needs to build.
110
110
 
111
111
  ---
112
112
 
113
- ## Reference map — carregar cada arquivo quando necessário
113
+ ## Reference map — load each file when needed
114
114
 
115
- - `references/implementation-types.md` — o que incluir por tipo de projeto (Landing page, Portfolio/Authority Site, SaaS Landing, SaaS Dashboard, 3D/Motion Site). **Carregar ao identificar o tipo de projeto.**
116
- - `references/motion-path-implementation.md` — regras e arquivos a planejar para cada um dos 4 motion paths. **Carregar sempre que houver decisão de wizz-motion-3d-director a seguir.**
117
- - `references/folder-structure-and-dependencies.md` — estrutura de pastas padrão + dependências recomendadas por categoria. **Carregar ao montar stack/estrutura.**
118
- - `references/output-templates.md` — exemplos preenchidos de Component Map, Motion Map e Asset Map. **Carregar ao produzir esses três mapas.**
119
- - `references/performance-plan.md` — requisitos de performance (geral, vídeo, 3D) + targets. **Carregar ao montar o plano de performance.**
120
- - `references/implementation-phases.md` — template das 5 fases padrão. **Carregar ao dividir o plano em fases.**
121
- - `references/handoff-template.md` — template exato do prompt de handoff para Claude Code/Codex. **Carregar ao fechar o plano.**
115
+ - `references/implementation-types.md` — what to include per project type (Landing page, Portfolio/Authority Site, SaaS Landing, SaaS Dashboard, 3D/Motion Site). **Load when identifying the project type.**
116
+ - `references/motion-path-implementation.md` — rules and files to plan for each of the 4 motion paths. **Load whenever there's a wizz-motion-3d-director decision to follow.**
117
+ - `references/folder-structure-and-dependencies.md` — standard folder structure + recommended dependencies by category. **Load when building the stack/structure.**
118
+ - `references/output-templates.md` — filled-in examples of Component Map, Motion Map, and Asset Map. **Load when producing these three maps.**
119
+ - `references/performance-plan.md` — performance requirements (general, video, 3D) + targets. **Load when building the performance plan.**
120
+ - `references/implementation-phases.md` — template of the 5 standard phases. **Load when splitting the plan into phases.**
121
+ - `references/handoff-template.md` — the exact handoff prompt template for Claude Code/Codex. **Load when closing out the plan.**
122
122
 
123
- Nenhum conteúdo foi perdido nessa divisão — cada regra, exemplo e template acima vive integralmente no seu arquivo `references/`.
123
+ No content was lost in this split — every rule, example, and template above lives in full in its `references/` file.
@@ -1,8 +1,8 @@
1
- # Estrutura de pastas + dependências recomendadas
1
+ # Recommended folder structure + dependencies
2
2
 
3
- Carregar ao montar a estrutura de pastas padrão (com notas de quando remover cada diretório) e a lista de dependências recomendadas por categoria (base, UI, motion, 3D, dashboard, forms, analytics), instalando apenas o que o projeto usa.
3
+ Load when building the standard folder structure (with notes on when to remove each directory) and the list of recommended dependencies by category (base, UI, motion, 3D, dashboard, forms, analytics), installing only what the project uses.
4
4
 
5
- ## Estrutura de pastas padrão
5
+ ## Standard folder structure
6
6
 
7
7
  ```
8
8
  app/
@@ -74,17 +74,17 @@ public/
74
74
  logos/
75
75
  ```
76
76
 
77
- **Ajustar de acordo com o projeto:**
77
+ **Adjust based on the project:**
78
78
 
79
- - Se não houver 3D real, **remover** `components/three/`.
80
- - Se não houver vídeo, **remover** `components/media/`.
81
- - Se não houver portfolio, **remover** `lib/content/cases.ts`.
79
+ - If there's no real 3D, **remove** `components/three/`.
80
+ - If there's no video, **remove** `components/media/`.
81
+ - If there's no portfolio, **remove** `lib/content/cases.ts`.
82
82
 
83
83
  ---
84
84
 
85
- ## Dependências recomendadas
85
+ ## Recommended dependencies
86
86
 
87
- Instalar **apenas o que o projeto usa**.
87
+ Install **only what the project uses**.
88
88
 
89
89
  **Base:**
90
90
 
@@ -102,29 +102,29 @@ npm install tailwindcss lucide-react clsx tailwind-merge
102
102
 
103
103
  ```bash
104
104
  npm install framer-motion
105
- # ou, se o projeto usar Motion:
105
+ # or, if the project uses Motion:
106
106
  npm install motion
107
107
  ```
108
108
 
109
- **3D real (apenas se necessário):**
109
+ **Real 3D (only if needed):**
110
110
 
111
111
  ```bash
112
112
  npm install three @react-three/fiber @react-three/drei
113
113
  ```
114
114
 
115
- **Dashboard (apenas se necessário):**
115
+ **Dashboard (only if needed):**
116
116
 
117
117
  ```bash
118
118
  npm install recharts
119
119
  ```
120
120
 
121
- **Forms / validation (se necessário):**
121
+ **Forms / validation (if needed):**
122
122
 
123
123
  ```bash
124
124
  npm install react-hook-form zod
125
125
  ```
126
126
 
127
- **Analytics (se necessário):**
127
+ **Analytics (if needed):**
128
128
 
129
129
  ```bash
130
130
  npm install @vercel/analytics @vercel/speed-insights
@@ -1,50 +1,50 @@
1
1
  # Implementation Phases
2
2
 
3
- Carregar ao dividir o plano em fases. Template das 5 fases padrão: Foundation, Static Landing, Motion, 3D/Video (se aplicável), Polish.
3
+ Load when splitting the plan into phases. Template of the 5 standard phases: Foundation, Static Landing, Motion, 3D/Video (if applicable), Polish.
4
4
 
5
5
  ## Implementation Phases
6
6
 
7
- Sempre dividir em fases.
7
+ Always split into phases.
8
8
 
9
- **Fase 1 — Foundation**
9
+ **Phase 1 — Foundation**
10
10
 
11
- - setup do projeto;
11
+ - project setup;
12
12
  - Tailwind;
13
13
  - shadcn;
14
14
  - tokens;
15
15
  - typography;
16
16
  - layout;
17
- - componentes base.
17
+ - base components.
18
18
 
19
- **Fase 2 — Static Landing**
19
+ **Phase 2 — Static Landing**
20
20
 
21
- - seções principais;
21
+ - main sections;
22
22
  - copy;
23
23
  - responsive layout;
24
- - imagens;
24
+ - images;
25
25
  - CTA;
26
- - SEO inicial.
26
+ - initial SEO.
27
27
 
28
- **Fase 3 — Motion**
28
+ **Phase 3 — Motion**
29
29
 
30
30
  - text reveal;
31
31
  - section transitions;
32
32
  - hovers;
33
33
  - magnetic CTA;
34
34
  - parallax;
35
- - microinterações.
35
+ - microinteractions.
36
36
 
37
- **Fase 4 — 3D / Video** (se aplicável)
37
+ **Phase 4 — 3D / Video** (if applicable)
38
38
 
39
- - video hero ou R3F;
39
+ - video hero or R3F;
40
40
  - fallback;
41
41
  - performance;
42
42
  - reduced motion;
43
43
  - mobile assets.
44
44
 
45
- **Fase 5 — Polish**
45
+ **Phase 5 — Polish**
46
46
 
47
- - QA visual;
47
+ - visual QA;
48
48
  - accessibility;
49
49
  - performance;
50
50
  - analytics;
@@ -1,28 +1,28 @@
1
- # Tipos de implementação — adaptação por tipo de projeto
1
+ # Implementation types — adaptation by project type
2
2
 
3
- Carregar ao montar o plano, para saber o que incluir de acordo com o tipo de projeto: Landing page, Portfolio/Authority Site, SaaS Landing, SaaS Dashboard, ou 3D/Motion Site.
3
+ Load when building the plan, to know what to include based on the project type: Landing page, Portfolio/Authority Site, SaaS Landing, SaaS Dashboard, or 3D/Motion Site.
4
4
 
5
- ## Tipos de implementação
5
+ ## Implementation types
6
6
 
7
- Adaptar o plano para o tipo de projeto.
7
+ Adapt the plan to the project type.
8
8
 
9
9
  ### 1. Landing page
10
10
 
11
- Incluir: page structure; sections; component map; copy integration; CTA logic; animations; responsive layout; SEO; analytics; deploy.
11
+ Include: page structure; sections; component map; copy integration; CTA logic; animations; responsive layout; SEO; analytics; deploy.
12
12
 
13
13
  ### 2. Portfolio / Authority Site
14
14
 
15
- Incluir: selected work; case cards; case deep-dive; capabilities; recognition; manifesto; editorial CTA; content placeholders; **anti-invention rule** (não inventar nomes de clientes, métricas ou case studies); MDX ou content config para cases.
15
+ Include: selected work; case cards; case deep-dive; capabilities; recognition; manifesto; editorial CTA; content placeholders; **anti-invention rule** (don't invent client names, metrics, or case studies); MDX or content config for cases.
16
16
 
17
17
  ### 3. SaaS Landing
18
18
 
19
- Incluir: hero; product mockup; features; use cases; pricing (se necessário); testimonials; integrations; FAQ (se necessário); CTA; analytics.
19
+ Include: hero; product mockup; features; use cases; pricing (if needed); testimonials; integrations; FAQ (if needed); CTA; analytics.
20
20
 
21
21
  ### 4. SaaS Dashboard
22
22
 
23
- Incluir: app layout; sidebar; topbar; KPI cards; charts; tables; settings; billing; user profile; empty states; loading states; error states; responsive behavior; Recharts; mock data.
23
+ Include: app layout; sidebar; topbar; KPI cards; charts; tables; settings; billing; user profile; empty states; loading states; error states; responsive behavior; Recharts; mock data.
24
24
 
25
25
  ### 5. 3D / Motion Site
26
26
 
27
- Incluir: motion path; assets; hero implementation; video implementation; R3F implementation (se necessário); fallback mobile; performance plan; reduced motion; lazy load; asset compression.
27
+ Include: motion path; assets; hero implementation; video implementation; R3F implementation (if needed); mobile fallback; performance plan; reduced motion; lazy load; asset compression.
28
28
 
@@ -1,16 +1,16 @@
1
1
  # Motion Path Implementation Rules
2
2
 
3
- Carregar sempre — a implementação deve seguir o motion path escolhido pelo motion-3d-director. Cobre as regras e arquivos a planejar para cada um dos 4 paths: 3D real, image-to-video, hybrid motion, motion 2D premium.
3
+ Always load this — the implementation must follow the motion path chosen by the motion-3d-director. Covers the rules and files to plan for each of the 4 paths: real 3D, image-to-video, hybrid motion, premium 2D motion.
4
4
 
5
5
  ## Motion Path Implementation Rules
6
6
 
7
- A implementação **deve seguir o motion path escolhido** pelo `wizz-motion-3d-director`.
7
+ The implementation **must follow the motion path chosen** by `wizz-motion-3d-director`.
8
8
 
9
- ### Se o path for 3D real
9
+ ### If the path is real 3D
10
10
 
11
- **Usar:** React Three Fiber; Three.js; Drei; dynamic import; Suspense; poster fallback; reduced motion; dpr cap; pause offscreen.
11
+ **Use:** React Three Fiber; Three.js; Drei; dynamic import; Suspense; poster fallback; reduced motion; dpr cap; pause offscreen.
12
12
 
13
- **Planejar arquivos:**
13
+ **Plan files:**
14
14
 
15
15
  - `components/three/HeroScene.tsx`
16
16
  - `components/three/ParticleCluster.tsx`
@@ -18,13 +18,13 @@ A implementação **deve seguir o motion path escolhido** pelo `wizz-motion-3d-d
18
18
  - `components/three/CanvasFallback.tsx`
19
19
  - `lib/device/capability.ts`
20
20
 
21
- ### Se o path for image-to-video
21
+ ### If the path is image-to-video
22
22
 
23
- **Não implementar R3F/Three.js para o hero principal.**
23
+ **Do not implement R3F/Three.js for the main hero.**
24
24
 
25
- **Usar:** `<video>`; WebM; MP4 fallback; poster image; mobile video; reduced motion fallback; lazy loading quando possível; preload controlado; overlay HTML para copy/CTA.
25
+ **Use:** `<video>`; WebM; MP4 fallback; poster image; mobile video; reduced motion fallback; lazy loading when possible; controlled preload; HTML overlay for copy/CTA.
26
26
 
27
- **Planejar arquivos:**
27
+ **Plan files:**
28
28
 
29
29
  - `public/video/hero-desktop.webm`
30
30
  - `public/video/hero-desktop.mp4`
@@ -35,23 +35,23 @@ A implementação **deve seguir o motion path escolhido** pelo `wizz-motion-3d-d
35
35
  - `components/media/ResponsiveVideo.tsx`
36
36
  - `components/media/VideoFallback.tsx`
37
37
 
38
- ### Se o path for hybrid motion
38
+ ### If the path is hybrid motion
39
39
 
40
- **Combinar:**
40
+ **Combine:**
41
41
 
42
- - vídeo / image-to-video no hero;
43
- - Framer Motion para texto e seções;
44
- - React Bits para microinterações;
42
+ - video / image-to-video in the hero;
43
+ - Framer Motion for text and sections;
44
+ - React Bits for microinteractions;
45
45
  - hover effects;
46
46
  - scroll effects;
47
- - pequenos detalhes WebGL opcionais, se aprovados.
47
+ - small optional WebGL touches, if approved.
48
48
 
49
- **Separação clara:** vídeo para atmosfera; HTML/CSS para conteúdo; Framer Motion para narrativa; WebGL só se necessário.
49
+ **Clear separation:** video for atmosphere; HTML/CSS for content; Framer Motion for narrative; WebGL only if necessary.
50
50
 
51
- ### Se o path for motion 2D premium
51
+ ### If the path is premium 2D motion
52
52
 
53
- **Usar:** Framer Motion; React Bits; CSS transitions; SVG animation; clip-path reveal; parallax leve; magnetic buttons.
53
+ **Use:** Framer Motion; React Bits; CSS transitions; SVG animation; clip-path reveal; light parallax; magnetic buttons.
54
54
 
55
- **Não usar Three.js.**
55
+ **Do not use Three.js.**
56
56
 
57
57
  ---
@@ -1,44 +1,44 @@
1
1
  # Performance Plan
2
2
 
3
- Carregar ao montar o plano de performance. Cobre: requisitos gerais para qualquer site, requisitos específicos para vídeo, requisitos específicos para 3D real, e os targets sugeridos (LCP/CLS/INP/Lighthouse).
3
+ Load when building the performance plan. Covers: general requirements for any site, video-specific requirements, real-3D-specific requirements, and the suggested targets (LCP/CLS/INP/Lighthouse).
4
4
 
5
5
  ## Performance Plan
6
6
 
7
- ### Para qualquer site
7
+ ### For any site
8
8
 
9
- - otimizar imagens;
10
- - usar `next/image`;
11
- - usar `next/font`;
12
- - evitar JS desnecessário;
13
- - lazy load abaixo da dobra;
14
- - reduzir bundle inicial;
15
- - usar semantic HTML;
16
- - evitar layout shift;
17
- - usar contrastes AA;
18
- - respeitar `prefers-reduced-motion`.
9
+ - optimize images;
10
+ - use `next/image`;
11
+ - use `next/font`;
12
+ - avoid unnecessary JS;
13
+ - lazy load below the fold;
14
+ - reduce the initial bundle;
15
+ - use semantic HTML;
16
+ - avoid layout shift;
17
+ - use AA contrast ratios;
18
+ - respect `prefers-reduced-motion`.
19
19
 
20
- ### Para vídeo
20
+ ### For video
21
21
 
22
22
  - WebM + MP4 fallback;
23
23
  - poster image;
24
- - preload controlado;
25
- - vídeo `muted playsInline loop`;
26
- - mobile crop separado;
27
- - compressão forte;
28
- - não bloquear LCP;
29
- - fallback poster em reduced motion.
24
+ - controlled preload;
25
+ - video `muted playsInline loop`;
26
+ - separate mobile crop;
27
+ - strong compression;
28
+ - don't block LCP;
29
+ - poster fallback under reduced motion.
30
30
 
31
- ### Para 3D real
31
+ ### For real 3D
32
32
 
33
- - dynamic import com `ssr: false`;
33
+ - dynamic import with `ssr: false`;
34
34
  - Suspense fallback;
35
35
  - dpr cap;
36
- - redução de partículas mobile;
36
+ - reduced particle count on mobile;
37
37
  - pause offscreen;
38
- - dispose de geometria/material;
39
- - evitar shadow pesado;
40
- - limitar luzes;
41
- - fallback poster;
38
+ - dispose geometry/material;
39
+ - avoid heavy shadows;
40
+ - limit lights;
41
+ - poster fallback;
42
42
  - `prefers-reduced-motion`.
43
43
 
44
44
  ### Targets
@@ -47,6 +47,6 @@ Carregar ao montar o plano de performance. Cobre: requisitos gerais para qualque
47
47
  - LCP < 3.5s mobile;
48
48
  - CLS < 0.1;
49
49
  - INP < 200ms;
50
- - Lighthouse Performance 90+ quando possível.
50
+ - Lighthouse Performance 90+ when possible.
51
51
 
52
52
  ---
@@ -1,34 +1,34 @@
1
1
  ---
2
2
  name: wizz-infrastructure
3
- description: Escalabilidade de infraestrutura — auto-scaling, Kubernetes HPA/VPA, CDN, SLOs, load testing. Use quando o pedido envolver escala de servidores, Kubernetes, CDN, monitoramento de capacidade.
3
+ description: Infrastructure scalability — auto-scaling, Kubernetes HPA/VPA, CDN, SLOs, load testing. Use when the request involves server scaling, Kubernetes, CDN, capacity monitoring.
4
4
  ---
5
5
 
6
6
  # Infrastructure Scalability
7
7
 
8
8
  ## Auto-scaling
9
9
 
10
- ### Horizontal scaling (mais instâncias)
11
- - Melhor para aplicações stateless
12
- - Métricas de trigger: CPU > 70%, requisições/s, latência p99
13
- - Cooldown period: aguarde 2-3 min antes de escalar novamente para evitar flapping
10
+ ### Horizontal scaling (more instances)
11
+ - Best for stateless applications
12
+ - Trigger metrics: CPU > 70%, requests/s, p99 latency
13
+ - Cooldown period: wait 2-3 min before scaling again to avoid flapping
14
14
 
15
- ### Vertical scaling (instância maior)
16
- - Mais simples mas tem limite físico e downtime
17
- - Use para banco de dados antes de partir para clustering
15
+ ### Vertical scaling (bigger instance)
16
+ - Simpler but has a physical limit and downtime
17
+ - Use for databases before moving to clustering
18
18
 
19
- ## Kubernetes essentials para escala
20
- - HPA (Horizontal Pod Autoscaler): escala pods por CPU/memória/métricas customizadas
21
- - VPA (Vertical Pod Autoscaler): ajusta requests/limits automaticamente
22
- - PodDisruptionBudget: garante disponibilidade durante atualizações
23
- - Resource requests/limits: defina sempre, sem isso o scheduler não funciona corretamente
19
+ ## Kubernetes essentials for scale
20
+ - HPA (Horizontal Pod Autoscaler): scales pods by CPU/memory/custom metrics
21
+ - VPA (Vertical Pod Autoscaler): adjusts requests/limits automatically
22
+ - PodDisruptionBudget: guarantees availability during updates
23
+ - Resource requests/limits: always set them, without them the scheduler doesn't work correctly
24
24
 
25
25
  ## CDN
26
- - Assets estáticos (JS, CSS, imagens): sempre via CDN
27
- - API responses cacheáveis: use CDN com cache-control correto
28
- - Edge functions: lógica simples próxima ao usuário sem passar pelo servidor
26
+ - Static assets (JS, CSS, images): always via CDN
27
+ - Cacheable API responses: use a CDN with correct cache-control
28
+ - Edge functions: simple logic close to the user without hitting the server
29
29
 
30
- ## Monitoramento de capacidade
31
- - Defina SLOs: ex. p99 latência < 500ms, disponibilidade > 99.9%
32
- - Alertas proativos: avise quando tendência indica que vai estourar em 24h
33
- - Load testing: rode k6 ou Locust antes de lançamentos importantes
34
- - Capacity planning: projete crescimento de 3 meses e provisione com antecedência
30
+ ## Capacity monitoring
31
+ - Define SLOs: e.g. p99 latency < 500ms, availability > 99.9%
32
+ - Proactive alerts: warn when a trend indicates it will blow up within 24h
33
+ - Load testing: run k6 or Locust before major launches
34
+ - Capacity planning: project 3-month growth and provision ahead of time