wizz-method 2.2.0 → 2.3.0
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.
- package/README.md +62 -62
- package/SECURITY.md +15 -16
- package/THIRD-PARTY-NOTICES.md +49 -49
- package/package.json +1 -1
- package/src/bmm-skills/1-analysis/wizz-agent-analyst/customize.toml +1 -1
- package/src/bmm-skills/2-plan-workflows/wizz-agent-pm/customize.toml +1 -1
- package/src/bmm-skills/2-plan-workflows/wizz-agent-ux-designer/customize.toml +1 -1
- package/src/bmm-skills/3-solutioning/wizz-agent-architect/customize.toml +1 -1
- package/src/bmm-skills/4-implementation/wizz-agent-dev/customize.toml +1 -1
- package/src/core-skills/_shared/handoff-protocol.md +72 -71
- package/src/core-skills/wizz-review-adversarial-general/SKILL.md +1 -1
- package/src/modules/lowticket/skills/wizz-lowticket-funil/references/copy-das-paginas.md +39 -39
- package/src/modules/lowticket/skills/wizz-lowticket-funil/references/mapa-do-funil.md +23 -23
- package/src/modules/lowticket/skills/wizz-lowticket-metodologia/CATALOGO.md +72 -72
- package/src/modules/lowticket/skills/wizz-lowticket-metodologia/knowledge/01-principios.md +10 -10
- package/src/modules/lowticket/skills/wizz-lowticket-metodologia/knowledge/02-diagnostico-funil.md +50 -50
- package/src/modules/lowticket/skills/wizz-lowticket-metodologia/knowledge/03-campanha-bidcap.md +68 -68
- package/src/modules/lowticket/skills/wizz-lowticket-metodologia/knowledge/04-criativos.md +44 -44
- package/src/modules/lowticket/skills/wizz-lowticket-metodologia/knowledge/04a-criativos-ia.md +77 -77
- package/src/modules/lowticket/skills/wizz-lowticket-metodologia/knowledge/04b-criativos-formatos.md +121 -121
- package/src/modules/lowticket/skills/wizz-lowticket-metodologia/knowledge/05-oferta.md +35 -35
- package/src/modules/lowticket/skills/wizz-lowticket-metodologia/knowledge/06-pagina-vendas.md +122 -122
- package/src/modules/lowticket/skills/wizz-lowticket-metodologia/knowledge/06a-instagram.md +93 -93
- package/src/modules/lowticket/skills/wizz-lowticket-metodologia/knowledge/06b-player-vsl.md +57 -57
- package/src/modules/lowticket/skills/wizz-lowticket-metodologia/knowledge/07-funil-upsell.md +83 -83
- package/src/modules/lowticket/skills/wizz-lowticket-metodologia/knowledge/07a-copy-humanizacao.md +61 -61
- package/src/modules/lowticket/skills/wizz-lowticket-metodologia/knowledge/08-pesquisa-publico.md +11 -11
- package/src/modules/lowticket/skills/wizz-lowticket-metodologia/knowledge/09-especialista-coproducao.md +26 -26
- package/src/modules/lowticket/skills/wizz-lowticket-metodologia/knowledge/10-levantar-caixa.md +29 -29
- package/src/modules/lowticket/skills/wizz-lowticket-metodologia/knowledge/11-checklist-roi.md +22 -22
- package/src/modules/lowticket/skills/wizz-lowticket-metodologia/knowledge/12-mineracao-ofertas.md +80 -80
- package/src/modules/lowticket/skills/wizz-lowticket-metodologia/knowledge/12a-mineracao-veredito.md +72 -72
- package/src/modules/lowticket/skills/wizz-lowticket-metodologia/knowledge/12b-fabrica-de-ofertas.md +63 -63
- package/src/modules/lowticket/skills/wizz-lowticket-metodologia/knowledge/12c-anatomia-low-ticket.md +71 -71
- package/src/modules/lowticket/skills/wizz-lowticket-metodologia/knowledge/13-benchmarks-vsl.md +6 -6
- package/src/modules/lowticket/skills/wizz-lowticket-metodologia/knowledge/14-vocabulario.md +53 -51
- package/src/modules/lowticket/skills/wizz-lowticket-metodologia/knowledge/15-como-estender.md +26 -26
- package/src/modules/lowticket/skills/wizz-lowticket-metodologia/knowledge/17-rastreamento.md +76 -76
- package/src/modules/lowticket/skills/wizz-lowticket-metodologia/knowledge/18-copy-desejo-oferta.md +149 -149
- package/src/modules/lowticket/skills/wizz-lowticket-metodologia/knowledge/INDEX.md +45 -45
- package/src/modules/lowticket/skills/wizz-lowticket-metodologia/knowledge/guardrails.md +45 -45
- package/src/modules/lowticket/skills/wizz-lowticket-metodologia/knowledge/pontos-em-aberto.md +64 -66
- package/src/modules/lowticket/skills/wizz-lowticket-minerador/references/rubrica.md +63 -63
- package/src/modules/lowticket/skills/wizz-lowticket-pagina/references/metas-e-medicao.md +23 -23
- package/src/modules/lowticket/skills/wizz-lowticket-pagina/references/padroes-de-codigo.md +50 -50
- package/src/modules/lowticket/skills/wizz-lowticket-trafego/references/formato-do-diagnostico.md +9 -9
- package/src/modules/lowticket/skills/wizz-lowticket-trafego/references/reguas.md +42 -42
- package/src/modules/wizz/README.md +27 -27
- package/src/modules/wizz/_shared/cerebro.md +37 -37
- package/src/modules/wizz/_shared/communication-rules.md +15 -15
- package/src/modules/wizz/_shared/despacho-barato.md +6 -6
- package/src/modules/wizz/_shared/encerramento.md +23 -23
- package/src/modules/wizz/_shared/model-ladder.md +29 -29
- package/src/modules/wizz/_shared/planning-gate.md +30 -30
- package/src/modules/wizz/_shared/token-economy.md +28 -28
- package/src/modules/wizz/_shared/video-pipeline.md +42 -42
- package/src/modules/wizz/agents/wizz-ads/SKILL.md +16 -16
- package/src/modules/wizz/agents/wizz-ads/customize.toml +21 -21
- package/src/modules/wizz/agents/wizz-copy/SKILL.md +18 -18
- package/src/modules/wizz/agents/wizz-copy/customize.toml +24 -24
- package/src/modules/wizz/agents/wizz-designer/SKILL.md +24 -24
- package/src/modules/wizz/agents/wizz-designer/customize.toml +29 -29
- package/src/modules/wizz/agents/wizz-growth/SKILL.md +20 -20
- package/src/modules/wizz/agents/wizz-growth/customize.toml +34 -34
- package/src/modules/wizz/agents/wizz-maestro/SKILL.md +63 -63
- package/src/modules/wizz/agents/wizz-maestro/customize.toml +38 -38
- package/src/modules/wizz/agents/wizz-memoria/SKILL.md +19 -19
- package/src/modules/wizz/agents/wizz-memoria/customize.toml +24 -24
- package/src/modules/wizz/agents/wizz-qa/SKILL.md +22 -22
- package/src/modules/wizz/agents/wizz-qa/customize.toml +29 -29
- package/src/modules/wizz/agents/wizz-seo/SKILL.md +19 -19
- package/src/modules/wizz/agents/wizz-seo/customize.toml +27 -27
- package/src/modules/wizz/agents/wizz-social/SKILL.md +53 -53
- package/src/modules/wizz/agents/wizz-social/customize.toml +37 -37
- package/src/modules/wizz/agents/wizz-social/knowledge/analise-imagem-referencia.md +20 -20
- package/src/modules/wizz/agents/wizz-social/knowledge/biblioteca-prompts-imagem.md +71 -71
- package/src/modules/wizz/agents/wizz-social/knowledge/blueprint-roteiro-viral.md +196 -196
- package/src/modules/wizz/agents/wizz-social/knowledge/legenda-instagram.md +32 -32
- package/src/modules/wizz/agents/wizz-social/knowledge/prompts-imagem-video.md +48 -48
- package/src/modules/wizz/module.yaml +28 -28
- package/src/modules/wizz/overrides/wizz-agent-analyst.toml +17 -17
- package/src/modules/wizz/overrides/wizz-agent-architect.toml +21 -21
- package/src/modules/wizz/overrides/wizz-agent-dev.toml +20 -20
- package/src/modules/wizz/overrides/wizz-agent-pm.toml +11 -11
- package/src/modules/wizz/overrides/wizz-agent-tech-writer.toml +14 -14
- package/src/modules/wizz/overrides/wizz-agent-ux-designer.toml +14 -14
- package/src/modules/wizz/subagents/codex/wizz-exec-haiku.toml +17 -17
- package/src/modules/wizz/subagents/codex/wizz-exec-opus.toml +19 -19
- package/src/modules/wizz/subagents/codex/wizz-exec-review.toml +18 -18
- package/src/modules/wizz/subagents/codex/wizz-exec-sonnet.toml +18 -18
- package/src/modules/wizz/subagents/gemini/wizz-exec-haiku.md +17 -17
- package/src/modules/wizz/subagents/gemini/wizz-exec-opus.md +19 -19
- package/src/modules/wizz/subagents/gemini/wizz-exec-review.md +18 -18
- package/src/modules/wizz/subagents/gemini/wizz-exec-sonnet.md +18 -18
- package/src/modules/wizz/subagents/opencode/wizz-exec-haiku.md +17 -17
- package/src/modules/wizz/subagents/opencode/wizz-exec-opus.md +19 -19
- package/src/modules/wizz/subagents/opencode/wizz-exec-review.md +18 -18
- package/src/modules/wizz/subagents/opencode/wizz-exec-sonnet.md +18 -18
- package/src/modules/wizz/subagents/spec.yaml +84 -83
- package/src/modules/wizz/subagents/wizz-exec-haiku.md +17 -17
- package/src/modules/wizz/subagents/wizz-exec-opus.md +19 -19
- package/src/modules/wizz/subagents/wizz-exec-review.md +18 -18
- package/src/modules/wizz/subagents/wizz-exec-sonnet.md +18 -18
- package/src/skills-lib/cerebro/SKILL.md +61 -61
- package/src/skills-lib/cerebro/references/comandos-pesquisa-e-memoria.md +46 -46
- package/src/skills-lib/cerebro/references/comandos-rotina-e-captura.md +65 -65
- package/src/skills-lib/cerebro/references/comandos-sessao.md +74 -74
- package/src/skills-lib/ctc-align/SKILL.md +37 -37
- package/src/skills-lib/find-skills/SKILL.md +19 -19
- package/src/skills-lib/pesquisa-de-publico-do-piva/README.md +33 -33
- package/src/skills-lib/pesquisa-de-publico-do-piva/SKILL.md +42 -42
- package/src/skills-lib/pesquisa-de-publico-do-piva/prompts.md +20 -20
- package/src/skills-lib/references/premium-agency-rules.md +63 -63
- package/src/skills-lib/security-audit-pentest/SKILL.md +31 -31
- package/src/skills-lib/security-audit-pentest/references/stage-1-validacao-entrada.md +37 -37
- package/src/skills-lib/security-audit-pentest/references/stage-2-autorizacao.md +61 -61
- package/src/skills-lib/security-audit-pentest/references/stage-3-abuso-volume.md +37 -37
- package/src/skills-lib/security-audit-pentest/references/stage-4-vazamento-resposta.md +52 -52
- package/src/skills-lib/site-launch-kit/SKILL.md +42 -42
- package/src/skills-lib/site-launch-kit/references/01-cta-principal.md +20 -20
- package/src/skills-lib/site-launch-kit/references/02-barra-fixa-mobile.md +24 -24
- package/src/skills-lib/site-launch-kit/references/03-tempo-de-resposta.md +21 -21
- package/src/skills-lib/site-launch-kit/references/04-prova-social.md +22 -22
- package/src/skills-lib/site-launch-kit/references/05-faq-decisao.md +28 -28
- package/src/skills-lib/site-launch-kit/references/06-imagens-reais.md +27 -27
- package/src/skills-lib/site-launch-kit/references/07-endereco-como-chegar.md +25 -25
- package/src/skills-lib/site-launch-kit/references/08-titles.md +30 -30
- package/src/skills-lib/site-launch-kit/references/09-open-graph.md +23 -23
- package/src/skills-lib/site-launch-kit/references/10-breadcrumbs.md +23 -23
- package/src/skills-lib/site-launch-kit/references/11-alt-text.md +28 -28
- package/src/skills-lib/site-launch-kit/references/12-schema-local.md +22 -22
- package/src/skills-lib/site-launch-kit/references/13-robots-sitemap.md +26 -26
- package/src/skills-lib/site-launch-kit/references/14-privacidade-termos.md +27 -27
- package/src/skills-lib/site-launch-kit/references/15-medicao.md +23 -23
- package/src/skills-lib/wizz-ai-product-design/SKILL.md +70 -70
- package/src/skills-lib/wizz-auth-and-secrets/SKILL.md +78 -78
- package/src/skills-lib/wizz-caching-and-queues/SKILL.md +40 -40
- package/src/skills-lib/wizz-cloud-and-infra/SKILL.md +22 -22
- package/src/skills-lib/wizz-database-and-deps/SKILL.md +52 -52
- package/src/skills-lib/wizz-database-scaling/SKILL.md +31 -31
- package/src/skills-lib/wizz-desktop-security/SKILL.md +49 -49
- package/src/skills-lib/wizz-implementation-planner/SKILL.md +56 -56
- package/src/skills-lib/wizz-implementation-planner/references/folder-structure-and-dependencies.md +14 -14
- package/src/skills-lib/wizz-implementation-planner/references/implementation-phases.md +15 -15
- package/src/skills-lib/wizz-implementation-planner/references/implementation-types.md +9 -9
- package/src/skills-lib/wizz-implementation-planner/references/motion-path-implementation.md +19 -19
- package/src/skills-lib/wizz-implementation-planner/references/performance-plan.md +27 -27
- package/src/skills-lib/wizz-infrastructure/SKILL.md +21 -21
- package/src/skills-lib/wizz-inicio-de-projeto/SKILL.md +63 -63
- package/src/skills-lib/wizz-inicio-de-projeto/references/implementacao-api-forms.md +27 -27
- package/src/skills-lib/wizz-inicio-de-projeto/references/padroes-arquiteturais-e-pastas.md +31 -31
- package/src/skills-lib/wizz-inicio-de-projeto/references/seguranca-e-regras-codigo.md +21 -21
- package/src/skills-lib/wizz-launch-readiness/SKILL.md +61 -61
- package/src/skills-lib/wizz-launch-readiness/references/01-tecnico-build.md +16 -16
- package/src/skills-lib/wizz-launch-readiness/references/02-seguranca.md +16 -16
- package/src/skills-lib/wizz-launch-readiness/references/03-seo-descoberta.md +16 -16
- package/src/skills-lib/wizz-launch-readiness/references/04-analytics-medicao.md +15 -15
- package/src/skills-lib/wizz-launch-readiness/references/05-conteudo-prova-social.md +15 -15
- package/src/skills-lib/wizz-launch-readiness/references/06-legal-lgpd.md +15 -15
- package/src/skills-lib/wizz-launch-readiness/references/07-infra-deploy-rollback.md +16 -16
- package/src/skills-lib/wizz-launch-readiness/references/08-fusao-priorizacao.md +19 -19
- package/src/skills-lib/wizz-launch-readiness/references/09-persistencia-project-context.md +26 -26
- package/src/skills-lib/wizz-motion-3d-director/SKILL.md +70 -70
- package/src/skills-lib/wizz-motion-3d-director/references/image-to-video-workflow.md +34 -35
- package/src/skills-lib/wizz-motion-3d-director/references/motion-paths.md +70 -70
- package/src/skills-lib/wizz-motion-3d-director/references/performance-and-handoff.md +17 -17
- package/src/skills-lib/wizz-offer-forge/README.md +9 -9
- package/src/skills-lib/wizz-offer-forge/SKILL.md +64 -64
- package/src/skills-lib/wizz-offer-forge/references/empilhamento-valor.md +17 -17
- package/src/skills-lib/wizz-offer-forge/references/garantia-reversa.md +16 -16
- package/src/skills-lib/wizz-offer-forge/references/mecanismo-unico.md +19 -19
- package/src/skills-lib/wizz-offer-forge/references/ponte-trafego.md +17 -17
- package/src/skills-lib/wizz-premium-landing-ui-researcher/SKILL.md +36 -36
- package/src/skills-lib/wizz-premium-landing-ui-researcher/references/audit-protocol.md +81 -82
- package/src/skills-lib/wizz-premium-landing-ui-researcher/references/component-sources.md +105 -105
- package/src/skills-lib/wizz-premium-landing-ui-researcher/references/core-goal.md +39 -39
- package/src/skills-lib/wizz-premium-landing-ui-researcher/references/dashboard-and-portfolio-modes.md +49 -50
- package/src/skills-lib/wizz-premium-landing-ui-researcher/references/handoffs.md +33 -34
- package/src/skills-lib/wizz-premium-landing-ui-researcher/references/landing-page-strategy.md +141 -142
- package/src/skills-lib/wizz-premium-landing-ui-researcher/references/mandatory-process.md +24 -24
- package/src/skills-lib/wizz-premium-landing-ui-researcher/references/output-format-and-quality.md +73 -73
- package/src/skills-lib/wizz-premium-landing-ui-researcher/references/prompt-templates.md +4 -4
- package/src/skills-lib/wizz-premium-landing-ui-researcher/references/site-levels.md +282 -283
- package/src/skills-lib/wizz-premium-landing-ui-researcher/references/source-first-protocol.md +39 -39
- package/src/skills-lib/wizz-premium-landing-ui-researcher/references/source-links.md +8 -8
- package/src/skills-lib/wizz-premium-landing-ui-researcher/references/stack-and-visual-direction.md +63 -64
- package/src/skills-lib/wizz-router/SKILL.md +38 -38
- package/src/skills-lib/wizz-router/references/auditoria-360.md +12 -12
- package/src/skills-lib/wizz-router/references/routing-table-flat.md +80 -80
- package/src/skills-lib/wizz-tracking-audit/SKILL.md +48 -48
- package/src/skills-lib/wizz-tracking-audit/references/modo-diagnostico.md +43 -43
- package/src/skills-lib/wizz-tracking-audit/references/modo-implantacao.md +59 -59
- package/src/skills-lib/wizz-tracking-audit/references/utm-e-atribuicao.md +35 -35
- package/src/skills-lib/wizz-web-security/SKILL.md +35 -35
- package/src/skills-lib/wizz-web-security/references/checklist-deploy.md +50 -50
- package/src/skills-lib/wizz-web-security/references/headers-rate-limit-cors.md +33 -33
- package/src/skills-lib/wizz-web-security/references/owasp-top5-detalhado.md +36 -36
- 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
|
-
|
|
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
|
-
|
|
10
|
+
It's the **last link** in the pipeline. It comes after:
|
|
11
11
|
|
|
12
|
-
1. `wizz-decision-maker` — brief
|
|
13
|
-
2. `wizz-premium-landing-ui-researcher` —
|
|
14
|
-
3. `wizz-ui-component-curator` —
|
|
15
|
-
4. `wizz-motion-3d-director` — motion path, prompts
|
|
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
|
-
|
|
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
|
-
##
|
|
21
|
+
## Goal
|
|
22
22
|
|
|
23
|
-
|
|
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
|
-
##
|
|
27
|
+
## When to use (first step: confirm the trigger)
|
|
28
28
|
|
|
29
|
-
|
|
29
|
+
Trigger when the user asks:
|
|
30
30
|
|
|
31
|
-
- "
|
|
32
|
-
- "
|
|
33
|
-
- "
|
|
34
|
-
- "
|
|
35
|
-
- "
|
|
36
|
-
- "
|
|
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
|
-
|
|
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
|
-
|
|
42
|
+
Skip this skill when:
|
|
43
43
|
|
|
44
|
-
-
|
|
45
|
-
-
|
|
46
|
-
-
|
|
47
|
-
-
|
|
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
|
-
|
|
49
|
+
Implementation without upstream decisions produces pretty code that serves the wrong tool.
|
|
50
50
|
|
|
51
51
|
---
|
|
52
52
|
|
|
53
|
-
##
|
|
53
|
+
## Expected input
|
|
54
54
|
|
|
55
|
-
|
|
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
|
-
|
|
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
|
-
##
|
|
61
|
+
## Main rule
|
|
62
62
|
|
|
63
|
-
**
|
|
63
|
+
**Do not invent strategic decisions that other skills have already made.** Follow the handoff received.
|
|
64
64
|
|
|
65
|
-
|
|
65
|
+
In case of conflict between upstream decisions, prioritize in this order:
|
|
66
66
|
|
|
67
|
-
1.
|
|
68
|
-
2.
|
|
69
|
-
3. Motion path (`wizz-motion-3d-director`) —
|
|
70
|
-
4.
|
|
71
|
-
5.
|
|
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
|
-
**
|
|
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
|
-
##
|
|
77
|
+
## Standard stack
|
|
78
78
|
|
|
79
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
##
|
|
99
|
+
## Mandatory output
|
|
100
100
|
|
|
101
|
-
|
|
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
|
-
##
|
|
105
|
+
## Final rule
|
|
106
106
|
|
|
107
|
-
|
|
107
|
+
`wizz-implementation-planner` **does not decide visual taste**. It turns decisions already made into a clear, implementable, performant architecture.
|
|
108
108
|
|
|
109
|
-
|
|
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 —
|
|
113
|
+
## Reference map — load each file when needed
|
|
114
114
|
|
|
115
|
-
- `references/implementation-types.md` —
|
|
116
|
-
- `references/motion-path-implementation.md` —
|
|
117
|
-
- `references/folder-structure-and-dependencies.md` —
|
|
118
|
-
- `references/output-templates.md` —
|
|
119
|
-
- `references/performance-plan.md` —
|
|
120
|
-
- `references/implementation-phases.md` — template
|
|
121
|
-
- `references/handoff-template.md` —
|
|
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
|
-
|
|
123
|
+
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-implementation-planner/references/folder-structure-and-dependencies.md
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
|
-
#
|
|
1
|
+
# Recommended folder structure + dependencies
|
|
2
2
|
|
|
3
|
-
|
|
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
|
-
##
|
|
5
|
+
## Standard folder structure
|
|
6
6
|
|
|
7
7
|
```
|
|
8
8
|
app/
|
|
@@ -74,17 +74,17 @@ public/
|
|
|
74
74
|
logos/
|
|
75
75
|
```
|
|
76
76
|
|
|
77
|
-
**
|
|
77
|
+
**Adjust based on the project:**
|
|
78
78
|
|
|
79
|
-
-
|
|
80
|
-
-
|
|
81
|
-
-
|
|
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
|
-
##
|
|
85
|
+
## Recommended dependencies
|
|
86
86
|
|
|
87
|
-
|
|
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
|
-
#
|
|
105
|
+
# or, if the project uses Motion:
|
|
106
106
|
npm install motion
|
|
107
107
|
```
|
|
108
108
|
|
|
109
|
-
**3D
|
|
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 (
|
|
115
|
+
**Dashboard (only if needed):**
|
|
116
116
|
|
|
117
117
|
```bash
|
|
118
118
|
npm install recharts
|
|
119
119
|
```
|
|
120
120
|
|
|
121
|
-
**Forms / validation (
|
|
121
|
+
**Forms / validation (if needed):**
|
|
122
122
|
|
|
123
123
|
```bash
|
|
124
124
|
npm install react-hook-form zod
|
|
125
125
|
```
|
|
126
126
|
|
|
127
|
-
**Analytics (
|
|
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
|
-
|
|
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
|
-
|
|
7
|
+
Always split into phases.
|
|
8
8
|
|
|
9
|
-
**
|
|
9
|
+
**Phase 1 — Foundation**
|
|
10
10
|
|
|
11
|
-
- setup
|
|
11
|
+
- project setup;
|
|
12
12
|
- Tailwind;
|
|
13
13
|
- shadcn;
|
|
14
14
|
- tokens;
|
|
15
15
|
- typography;
|
|
16
16
|
- layout;
|
|
17
|
-
-
|
|
17
|
+
- base components.
|
|
18
18
|
|
|
19
|
-
**
|
|
19
|
+
**Phase 2 — Static Landing**
|
|
20
20
|
|
|
21
|
-
-
|
|
21
|
+
- main sections;
|
|
22
22
|
- copy;
|
|
23
23
|
- responsive layout;
|
|
24
|
-
-
|
|
24
|
+
- images;
|
|
25
25
|
- CTA;
|
|
26
|
-
- SEO
|
|
26
|
+
- initial SEO.
|
|
27
27
|
|
|
28
|
-
**
|
|
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
|
-
-
|
|
35
|
+
- microinteractions.
|
|
36
36
|
|
|
37
|
-
**
|
|
37
|
+
**Phase 4 — 3D / Video** (if applicable)
|
|
38
38
|
|
|
39
|
-
- video hero
|
|
39
|
+
- video hero or R3F;
|
|
40
40
|
- fallback;
|
|
41
41
|
- performance;
|
|
42
42
|
- reduced motion;
|
|
43
43
|
- mobile assets.
|
|
44
44
|
|
|
45
|
-
**
|
|
45
|
+
**Phase 5 — Polish**
|
|
46
46
|
|
|
47
|
-
- QA
|
|
47
|
+
- visual QA;
|
|
48
48
|
- accessibility;
|
|
49
49
|
- performance;
|
|
50
50
|
- analytics;
|
|
@@ -1,28 +1,28 @@
|
|
|
1
|
-
#
|
|
1
|
+
# Implementation types — adaptation by project type
|
|
2
2
|
|
|
3
|
-
|
|
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
|
-
##
|
|
5
|
+
## Implementation types
|
|
6
6
|
|
|
7
|
-
|
|
7
|
+
Adapt the plan to the project type.
|
|
8
8
|
|
|
9
9
|
### 1. Landing page
|
|
10
10
|
|
|
11
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
7
|
+
The implementation **must follow the motion path chosen** by `wizz-motion-3d-director`.
|
|
8
8
|
|
|
9
|
-
###
|
|
9
|
+
### If the path is real 3D
|
|
10
10
|
|
|
11
|
-
**
|
|
11
|
+
**Use:** React Three Fiber; Three.js; Drei; dynamic import; Suspense; poster fallback; reduced motion; dpr cap; pause offscreen.
|
|
12
12
|
|
|
13
|
-
**
|
|
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
|
-
###
|
|
21
|
+
### If the path is image-to-video
|
|
22
22
|
|
|
23
|
-
**
|
|
23
|
+
**Do not implement R3F/Three.js for the main hero.**
|
|
24
24
|
|
|
25
|
-
**
|
|
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
|
-
**
|
|
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
|
-
###
|
|
38
|
+
### If the path is hybrid motion
|
|
39
39
|
|
|
40
|
-
**
|
|
40
|
+
**Combine:**
|
|
41
41
|
|
|
42
|
-
-
|
|
43
|
-
- Framer Motion
|
|
44
|
-
- React Bits
|
|
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
|
-
-
|
|
47
|
+
- small optional WebGL touches, if approved.
|
|
48
48
|
|
|
49
|
-
**
|
|
49
|
+
**Clear separation:** video for atmosphere; HTML/CSS for content; Framer Motion for narrative; WebGL only if necessary.
|
|
50
50
|
|
|
51
|
-
###
|
|
51
|
+
### If the path is premium 2D motion
|
|
52
52
|
|
|
53
|
-
**
|
|
53
|
+
**Use:** Framer Motion; React Bits; CSS transitions; SVG animation; clip-path reveal; light parallax; magnetic buttons.
|
|
54
54
|
|
|
55
|
-
**
|
|
55
|
+
**Do not use Three.js.**
|
|
56
56
|
|
|
57
57
|
---
|
|
@@ -1,44 +1,44 @@
|
|
|
1
1
|
# Performance Plan
|
|
2
2
|
|
|
3
|
-
|
|
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
|
-
###
|
|
7
|
+
### For any site
|
|
8
8
|
|
|
9
|
-
-
|
|
10
|
-
-
|
|
11
|
-
-
|
|
12
|
-
-
|
|
13
|
-
- lazy load
|
|
14
|
-
-
|
|
15
|
-
-
|
|
16
|
-
-
|
|
17
|
-
-
|
|
18
|
-
-
|
|
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
|
-
###
|
|
20
|
+
### For video
|
|
21
21
|
|
|
22
22
|
- WebM + MP4 fallback;
|
|
23
23
|
- poster image;
|
|
24
|
-
- preload
|
|
25
|
-
-
|
|
26
|
-
- mobile crop
|
|
27
|
-
-
|
|
28
|
-
-
|
|
29
|
-
- fallback
|
|
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
|
-
###
|
|
31
|
+
### For real 3D
|
|
32
32
|
|
|
33
|
-
- dynamic import
|
|
33
|
+
- dynamic import with `ssr: false`;
|
|
34
34
|
- Suspense fallback;
|
|
35
35
|
- dpr cap;
|
|
36
|
-
-
|
|
36
|
+
- reduced particle count on mobile;
|
|
37
37
|
- pause offscreen;
|
|
38
|
-
- dispose
|
|
39
|
-
-
|
|
40
|
-
-
|
|
41
|
-
- fallback
|
|
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+
|
|
50
|
+
- Lighthouse Performance 90+ when possible.
|
|
51
51
|
|
|
52
52
|
---
|
|
@@ -1,34 +1,34 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: wizz-infrastructure
|
|
3
|
-
description:
|
|
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 (
|
|
11
|
-
-
|
|
12
|
-
-
|
|
13
|
-
- Cooldown period:
|
|
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 (
|
|
16
|
-
-
|
|
17
|
-
- Use
|
|
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
|
|
20
|
-
- HPA (Horizontal Pod Autoscaler):
|
|
21
|
-
- VPA (Vertical Pod Autoscaler):
|
|
22
|
-
- PodDisruptionBudget:
|
|
23
|
-
- Resource requests/limits:
|
|
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
|
-
-
|
|
27
|
-
- API responses
|
|
28
|
-
- Edge functions:
|
|
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
|
-
##
|
|
31
|
-
-
|
|
32
|
-
-
|
|
33
|
-
- Load testing:
|
|
34
|
-
- Capacity planning:
|
|
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
|