wizz-method 1.16.1 → 1.18.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.
Files changed (148) hide show
  1. package/README.md +1 -1
  2. package/package.json +7 -2
  3. package/removals.txt +9 -0
  4. package/skills-registry.yaml +119 -36
  5. package/src/bmm-skills/1-analysis/wizz-agent-analyst/customize.toml +1 -1
  6. package/src/bmm-skills/1-analysis/wizz-set-feature/SKILL.md +41 -37
  7. package/src/bmm-skills/2-plan-workflows/wizz-agent-pm/customize.toml +1 -1
  8. package/src/bmm-skills/2-plan-workflows/wizz-agent-ux-designer/customize.toml +1 -1
  9. package/src/bmm-skills/3-solutioning/wizz-agent-architect/customize.toml +1 -1
  10. package/src/bmm-skills/3-solutioning/wizz-generate-project-context/project-context-template.md +5 -0
  11. package/src/bmm-skills/3-solutioning/wizz-generate-project-context/steps/step-01-discover.md +16 -5
  12. package/src/bmm-skills/3-solutioning/wizz-generate-project-context/steps/step-03-complete.md +5 -0
  13. package/src/bmm-skills/4-implementation/wizz-agent-dev/customize.toml +1 -1
  14. package/src/bmm-skills/4-implementation/wizz-retrospective/customize.toml +3 -1
  15. package/src/bmm-skills/4-implementation/wizz-retrospective/scripts/__pycache__/sprint_status.cpython-313.pyc +0 -0
  16. package/src/bmm-skills/4-implementation/wizz-retrospective/scripts/tests/__pycache__/test_git_evidence.cpython-313-pytest-9.1.1.pyc +0 -0
  17. package/src/bmm-skills/4-implementation/wizz-retrospective/scripts/tests/__pycache__/test_sprint_status.cpython-313-pytest-9.1.1.pyc +0 -0
  18. package/src/bmm-skills/4-implementation/wizz-sprint-planning/customize.toml +3 -1
  19. package/src/bmm-skills/4-implementation/wizz-sprint-planning/scripts/__pycache__/sprint_plan.cpython-313.pyc +0 -0
  20. package/src/bmm-skills/4-implementation/wizz-sprint-planning/scripts/tests/__pycache__/test_sprint_plan.cpython-313-pytest-9.1.1.pyc +0 -0
  21. package/src/core-skills/wizz-advanced-elicitation/scripts/__pycache__/pick_methods.cpython-313.pyc +0 -0
  22. package/src/core-skills/wizz-advanced-elicitation/scripts/tests/__pycache__/test_pick_methods.cpython-313-pytest-9.1.1.pyc +0 -0
  23. package/src/core-skills/wizz-brainstorming/scripts/__pycache__/brain.cpython-313.pyc +0 -0
  24. package/src/core-skills/wizz-brainstorming/scripts/tests/__pycache__/test_brain.cpython-313-pytest-9.1.1.pyc +0 -0
  25. package/src/core-skills/wizz-brainstorming/scripts/tests/__pycache__/test_brain.cpython-314.pyc +0 -0
  26. package/src/core-skills/wizz-forge-idea/scripts/__pycache__/resolve_personas.cpython-314.pyc +0 -0
  27. package/src/core-skills/wizz-forge-idea/scripts/tests/__pycache__/test_resolve_personas.cpython-314.pyc +0 -0
  28. package/src/core-skills/wizz-party-mode/scripts/__pycache__/resolve_party.cpython-314.pyc +0 -0
  29. package/src/core-skills/wizz-party-mode/scripts/tests/__pycache__/test_resolve_party.cpython-314.pyc +0 -0
  30. package/src/modules/lowticket/README.md +55 -0
  31. package/src/modules/lowticket/module.yaml +31 -0
  32. package/src/modules/lowticket/skills/lowticket-funil/SKILL.md +112 -0
  33. package/src/modules/lowticket/skills/lowticket-funil/references/copy-das-paginas.md +75 -0
  34. package/src/modules/lowticket/skills/lowticket-funil/references/mapa-do-funil.md +71 -0
  35. package/src/modules/lowticket/skills/lowticket-metodologia/CATALOGO.md +352 -0
  36. package/src/modules/lowticket/skills/lowticket-metodologia/SKILL.md +62 -0
  37. package/src/modules/lowticket/skills/lowticket-metodologia/knowledge/01-principios.md +12 -0
  38. package/src/modules/lowticket/skills/lowticket-metodologia/knowledge/02-diagnostico-funil.md +83 -0
  39. package/src/modules/lowticket/skills/lowticket-metodologia/knowledge/03-campanha-bidcap.md +95 -0
  40. package/src/modules/lowticket/skills/lowticket-metodologia/knowledge/04-criativos.md +66 -0
  41. package/src/modules/lowticket/skills/lowticket-metodologia/knowledge/04a-criativos-ia.md +79 -0
  42. package/src/modules/lowticket/skills/lowticket-metodologia/knowledge/04b-criativos-formatos.md +152 -0
  43. package/src/modules/lowticket/skills/lowticket-metodologia/knowledge/05-oferta.md +51 -0
  44. package/src/modules/lowticket/skills/lowticket-metodologia/knowledge/06-pagina-vendas.md +175 -0
  45. package/src/modules/lowticket/skills/lowticket-metodologia/knowledge/06a-instagram.md +138 -0
  46. package/src/modules/lowticket/skills/lowticket-metodologia/knowledge/07-funil-upsell.md +73 -0
  47. package/src/modules/lowticket/skills/lowticket-metodologia/knowledge/08-pesquisa-publico.md +14 -0
  48. package/src/modules/lowticket/skills/lowticket-metodologia/knowledge/09-especialista-coproducao.md +41 -0
  49. package/src/modules/lowticket/skills/lowticket-metodologia/knowledge/10-levantar-caixa.md +49 -0
  50. package/src/modules/lowticket/skills/lowticket-metodologia/knowledge/11-checklist-roi.md +36 -0
  51. package/src/modules/lowticket/skills/lowticket-metodologia/knowledge/12-mineracao-ofertas.md +63 -0
  52. package/src/modules/lowticket/skills/lowticket-metodologia/knowledge/12a-mineracao-veredito.md +78 -0
  53. package/src/modules/lowticket/skills/lowticket-metodologia/knowledge/12b-fabrica-de-ofertas.md +178 -0
  54. package/src/modules/lowticket/skills/lowticket-metodologia/knowledge/13-benchmarks-vsl.md +10 -0
  55. package/src/modules/lowticket/skills/lowticket-metodologia/knowledge/14-vocabulario.md +55 -0
  56. package/src/modules/lowticket/skills/lowticket-metodologia/knowledge/15-como-estender.md +35 -0
  57. package/src/modules/lowticket/skills/lowticket-metodologia/knowledge/INDEX.md +45 -0
  58. package/src/modules/lowticket/skills/lowticket-metodologia/knowledge/guardrails.md +33 -0
  59. package/src/modules/lowticket/skills/lowticket-metodologia/knowledge/pontos-em-aberto.md +42 -0
  60. package/src/modules/lowticket/skills/lowticket-metodologia/references/swipe-file.md +38 -0
  61. package/src/modules/lowticket/skills/lowticket-minerador/SKILL.md +115 -0
  62. package/src/modules/lowticket/skills/lowticket-minerador/references/rubrica.md +75 -0
  63. package/src/modules/lowticket/skills/lowticket-pagina/SKILL.md +106 -0
  64. package/src/modules/lowticket/skills/lowticket-pagina/references/metas-e-medicao.md +70 -0
  65. package/src/modules/lowticket/skills/lowticket-pagina/references/padroes-de-codigo.md +148 -0
  66. package/src/modules/lowticket/skills/lowticket-trafego/SKILL.md +88 -0
  67. package/src/modules/lowticket/skills/lowticket-trafego/references/formato-do-diagnostico.md +56 -0
  68. package/src/modules/lowticket/skills/lowticket-trafego/references/reguas.md +72 -0
  69. package/src/modules/wizz/README.md +1 -1
  70. package/src/modules/wizz/_shared/cerebro.md +35 -1
  71. package/src/modules/wizz/_shared/communication-rules.md +8 -1
  72. package/src/modules/wizz/_shared/encerramento.md +22 -0
  73. package/src/modules/wizz/_shared/token-economy.md +7 -10
  74. package/src/modules/wizz/agents/wizz-ads/customize.toml +1 -1
  75. package/src/modules/wizz/agents/wizz-copy/customize.toml +1 -1
  76. package/src/modules/wizz/agents/wizz-designer/SKILL.md +1 -1
  77. package/src/modules/wizz/agents/wizz-designer/customize.toml +1 -1
  78. package/src/modules/wizz/agents/wizz-growth/customize.toml +1 -1
  79. package/src/modules/wizz/agents/wizz-maestro/SKILL.md +5 -1
  80. package/src/modules/wizz/agents/wizz-maestro/customize.toml +1 -1
  81. package/src/modules/wizz/agents/wizz-memoria/SKILL.md +1 -1
  82. package/src/modules/wizz/agents/wizz-qa/SKILL.md +6 -0
  83. package/src/modules/wizz/agents/wizz-qa/customize.toml +1 -1
  84. package/src/modules/wizz/agents/wizz-seo/customize.toml +1 -1
  85. package/src/modules/wizz/agents/wizz-social/SKILL.md +1 -0
  86. package/src/modules/wizz/agents/wizz-social/customize.toml +1 -1
  87. package/src/modules/wizz/overrides/wizz-agent-analyst.toml +2 -2
  88. package/src/modules/wizz/overrides/wizz-agent-architect.toml +2 -2
  89. package/src/modules/wizz/overrides/wizz-agent-dev.toml +1 -1
  90. package/src/modules/wizz/overrides/wizz-agent-pm.toml +1 -1
  91. package/src/modules/wizz/overrides/wizz-agent-tech-writer.toml +1 -1
  92. package/src/modules/wizz/overrides/wizz-agent-ux-designer.toml +1 -1
  93. package/src/modules/wizz/subagents/codex/wizz-exec-haiku.toml +12 -0
  94. package/src/modules/wizz/subagents/codex/wizz-exec-opus.toml +12 -0
  95. package/src/modules/wizz/subagents/codex/wizz-exec-review.toml +11 -0
  96. package/src/modules/wizz/subagents/codex/wizz-exec-sonnet.toml +12 -0
  97. package/src/modules/wizz/subagents/gemini/wizz-exec-haiku.md +12 -0
  98. package/src/modules/wizz/subagents/gemini/wizz-exec-opus.md +12 -0
  99. package/src/modules/wizz/subagents/gemini/wizz-exec-review.md +11 -0
  100. package/src/modules/wizz/subagents/gemini/wizz-exec-sonnet.md +12 -0
  101. package/src/modules/wizz/subagents/opencode/wizz-exec-haiku.md +12 -0
  102. package/src/modules/wizz/subagents/opencode/wizz-exec-opus.md +12 -0
  103. package/src/modules/wizz/subagents/opencode/wizz-exec-review.md +11 -0
  104. package/src/modules/wizz/subagents/opencode/wizz-exec-sonnet.md +12 -0
  105. package/src/modules/wizz/subagents/wizz-exec-haiku.md +12 -0
  106. package/src/modules/wizz/subagents/wizz-exec-opus.md +12 -0
  107. package/src/modules/wizz/subagents/wizz-exec-review.md +11 -0
  108. package/src/modules/wizz/subagents/wizz-exec-sonnet.md +12 -0
  109. package/src/skills-lib/analytics-tracking/SKILL.md +2 -0
  110. package/src/skills-lib/analytics-tracking/references/utm-taxonomy.md +92 -0
  111. package/src/skills-lib/cerebro/SKILL.md +20 -17
  112. package/src/skills-lib/cerebro/references/comandos-pesquisa-e-memoria.md +96 -0
  113. package/src/skills-lib/cerebro/references/comandos-rotina-e-captura.md +25 -6
  114. package/src/skills-lib/cerebro/references/comandos-sessao.md +61 -37
  115. package/src/skills-lib/launch-readiness/SKILL.md +94 -0
  116. package/src/skills-lib/launch-readiness/references/01-tecnico-build.md +26 -0
  117. package/src/skills-lib/launch-readiness/references/02-seguranca.md +26 -0
  118. package/src/skills-lib/launch-readiness/references/03-seo-descoberta.md +27 -0
  119. package/src/skills-lib/launch-readiness/references/04-analytics-medicao.md +25 -0
  120. package/src/skills-lib/launch-readiness/references/05-conteudo-prova-social.md +25 -0
  121. package/src/skills-lib/launch-readiness/references/06-legal-lgpd.md +25 -0
  122. package/src/skills-lib/launch-readiness/references/07-infra-deploy-rollback.md +26 -0
  123. package/src/skills-lib/launch-readiness/references/08-fusao-priorizacao.md +33 -0
  124. package/src/skills-lib/launch-readiness/references/09-persistencia-project-context.md +48 -0
  125. package/src/skills-lib/premium-landing-ui-researcher/references/source-first-protocol.md +1 -1
  126. package/src/skills-lib/site-launch-kit/SKILL.md +1 -1
  127. package/src/skills-lib/taste-skill/SKILL.md +4 -2
  128. package/src/skills-lib/{taste-redesign → taste-skill}/references/design-audit.md +30 -41
  129. package/src/skills-lib/taste-skill/references/redesign-protocol.md +2 -2
  130. package/src/skills-lib/taste-skill/references/upgrade-techniques.md +33 -0
  131. package/src/skills-lib/tracking-audit/SKILL.md +78 -0
  132. package/src/skills-lib/tracking-audit/references/modo-diagnostico.md +72 -0
  133. package/src/skills-lib/tracking-audit/references/modo-implantacao.md +89 -0
  134. package/src/skills-lib/tracking-audit/references/utm-e-atribuicao.md +75 -0
  135. package/src/skills-lib/wizz-offer-forge/SKILL.md +30 -4
  136. package/src/skills-lib/wizz-offer-forge/references/plano-de-medicao.md +74 -0
  137. package/src/skills-lib/wizz-router/SKILL.md +8 -2
  138. package/src/skills-lib/wizz-router/references/routing-table-flat.md +4 -3
  139. package/tools/fetch-assets.mjs +3 -2
  140. package/tools/installer/commands/trace-report.js +248 -4
  141. package/tools/installer/modules/official-modules.js +5 -0
  142. package/tools/installer/modules/skills-lib.js +7 -1
  143. package/wizz-modules.yaml +20 -3
  144. package/src/skills-lib/cerebro/references/comandos-pesquisa-e-sync.md +0 -44
  145. package/src/skills-lib/graphify/.graphify_version +0 -1
  146. package/src/skills-lib/graphify/SKILL.md +0 -1199
  147. package/src/skills-lib/taste-redesign/SKILL.md +0 -42
  148. package/src/skills-lib/taste-redesign/references/upgrade-techniques.md +0 -31
@@ -18,7 +18,7 @@ Document the current state before proposing changes:
18
18
  * **Information architecture** - page tree, primary nav, key conversion paths.
19
19
  * **Content blocks** - what exists, what's doing work, what's filler.
20
20
  * **Patterns to preserve** - signature interactions, recognisable hero, copy voice.
21
- * **Patterns to retire** - AI-slop tells, broken layouts, dead links, generic stock imagery, perf traps.
21
+ * **Patterns to retire** - AI-slop tells, broken layouts, dead links, generic stock imagery, perf traps. Run the full checklist in [design-audit.md](design-audit.md) (Section 11.G) against the project and list every match here.
22
22
  * **Dial reading of the existing site** - infer current `DESIGN_VARIANCE` / `MOTION_INTENSITY` / `VISUAL_DENSITY`. That's your starting point, not the baseline.
23
23
  * **SEO baseline** - current ranking pages, meta titles, structured data, OG cards. **SEO migration is the #1 redesign risk.**
24
24
 
@@ -30,7 +30,7 @@ Document the current state before proposing changes:
30
30
  * **Respect existing analytics events.** Do not rename buttons, form fields, section IDs that downstream tracking depends on.
31
31
 
32
32
  ### 11.D Modernisation Levers (priority order)
33
- Apply in order - stop when the brief is satisfied:
33
+ Apply in order - stop when the brief is satisfied. Concrete techniques for each lever live in [upgrade-techniques.md](upgrade-techniques.md) (Section 11.H).
34
34
  1. **Typography refresh** - biggest visual lift per unit of risk.
35
35
  2. **Spacing & rhythm** - increase section padding, fix vertical rhythm.
36
36
  3. **Color recalibration** - desaturate, unify neutrals, keep brand accent.
@@ -0,0 +1,33 @@
1
+ > taste-skill reference file. Loaded on demand from the SKILL.md index.
2
+ > Cross-references like "Section N" map to sibling files via the index table in ../SKILL.md.
3
+
4
+ ## 11.H MODERNISATION TECHNIQUES (detail)
5
+
6
+ High-impact techniques for the Modernisation Levers in Section 11.D, once the audit checklist (Section 11.G) has identified which categories need work. Grouped by Typography, Layout, and Motion/Surface. Where a technique already has a canonical skeleton or named pattern elsewhere in this skill, this file points there instead of restating it, so there is one implementation to maintain.
7
+
8
+ ### Typography Upgrades
9
+
10
+ - **Variable font animation.** Interpolate weight or width on scroll or hover for text that feels alive.
11
+ - **Outlined-to-fill transitions.** Text starts as a stroke outline and fills with color on scroll entry or interaction. Named pattern: "Gradient Stroke Animation" in Section 10.
12
+ - **Text mask reveals.** Large typography acting as a window to video or animated imagery behind it. Named pattern: "Text Mask Reveal" in Section 10; use that vocabulary entry when scoping the work.
13
+
14
+ ### Layout Upgrades
15
+
16
+ - **Broken grid / asymmetry.** Elements that deliberately ignore column structure: overlapping, bleeding off-screen, or offset with calculated randomness. Reach for this beyond the baseline anti-center-bias rule in Section 4.3 when the brief wants a stronger break from the grid.
17
+ - **Whitespace maximization.** Aggressive use of negative space to force focus on a single element.
18
+ - **Parallax card stacks.** Sections that stick and physically stack over each other during scroll. Implement with the canonical Sticky-Stack skeleton in Section 5.A; named pattern "Sticky Scroll Stack" in Section 10.
19
+ - **Split-screen scroll.** Two halves of the screen sliding in opposite directions. Named pattern "Split-Screen Scroll" in Section 10.
20
+
21
+ ### Motion Upgrades
22
+
23
+ - **Smooth scroll with inertia.** Decouple scrolling from browser defaults for a heavier, cinematic feel.
24
+ - **Staggered entry.** Elements cascade in with slight delays, combining Y-axis translation with opacity fade. Never mount everything at once. Implement with the Scroll-Reveal Stagger skeleton in Section 5.C, or `staggerChildren` per Section 5.D.
25
+ - **Spring physics.** Replace linear easing with spring-based motion for a natural, weighty feel on all interactive elements. Parameters and when to use them: Section 5 (Perpetual Micro-Interactions).
26
+ - **Scroll-driven reveals.** Content entering through expanding masks, wipes, or draw-on SVG paths tied to scroll progress. Distinct from the simple enter-on-scroll stagger in Section 5.C: this is for a deliberate reveal choreography, not a generic list-item fade-in.
27
+
28
+ ### Surface Upgrades
29
+
30
+ - **True glassmorphism.** Go beyond `backdrop-filter: blur`. Full technique (1px inner border, inset shadow, reduced-transparency fallback) and the honest Apple Liquid Glass distinction live in Section 5 (Liquid Glass / Glassmorphism) and design-systems.md Appendix C.
31
+ - **Spotlight borders.** Card borders that illuminate dynamically under the cursor. Named pattern "Spotlight Border Card" in Section 10.
32
+ - **Grain and noise overlays.** A fixed, `pointer-events-none` overlay with subtle noise to break digital flatness. Apply per the DOM-cost rule in Section 6.E: fixed layer only, never on a scrolling container.
33
+ - **Colored, tinted shadows.** Shadows that carry the hue of the background rather than using generic black. Full rule in Section 4.4.
@@ -0,0 +1,78 @@
1
+ ---
2
+ name: tracking-audit
3
+ description: Auditoria e diagnóstico de rastreamento de resposta direta em dois modos. Modo implantação valida pixel, CAPI, domínio verificado, eventos priorizados, template de UTM com ID, repasse do parâmetro nativo pelo checkout, higiene de nomenclatura e compra-teste por caminho. Modo diagnóstico lê as transições do funil contra a régua, separa problema de medição de problema de conversão e diz qual transição está furando. Use quando alguém perguntar "por que a venda não bate com o gerenciador", "onde está furando o funil", "meu pixel está certo?", "as UTMs estão corretas?", "o tráfego orgânico está inflado", "qual dado falta pra eu decidir", ou antes de subir campanha nova. NÃO use para desenhar plano de medição de SaaS/produto (use analytics-tracking), para decidir bid e orçamento (use paid-ads) nem para criar a oferta (use wizz-offer-forge).
4
+ ---
5
+
6
+ # Tracking Audit
7
+
8
+ Auditoria de rastreamento para oferta de resposta direta. Uma hora aqui evita 30 dias de campanha medida errado.
9
+
10
+ A skill faz duas coisas e nada além: **valida o que foi instalado** e **diz onde o funil está furando**. Ela não cria oferta, não decide bid e não escreve copy.
11
+
12
+ ## Passo 0 — Achar a régua (obrigatório, sempre)
13
+
14
+ Benchmark sem origem é chute. Antes de qualquer análise, resolva de onde vêm os números, nesta ordem:
15
+
16
+ 1. **Skill `lowticket-metodologia` instalada?** Se sim, ela tem precedência. Leia a entrada de diagnóstico de funil no INDEX dela e use os benchmarks de lá. Declare na resposta: "régua: metodologia low ticket".
17
+ 2. **O projeto tem histórico próprio?** Trinta dias de dados reais do mesmo público valem mais que qualquer benchmark de mercado. Use a mediana do próprio histórico como linha de base.
18
+ 3. **Nenhum dos dois?** Peça ao usuário. Não invente faixa, não use número de memória, não cite benchmark sem dizer de onde saiu.
19
+
20
+ > Regra anti-invenção: todo número que aparecer no relatório tem fonte declarada, ou vira PENDÊNCIA. Um relatório com faixa inventada é pior que nenhum relatório, porque parece medido.
21
+
22
+ ## Escolher o modo
23
+
24
+ | O pedido é... | Modo | Referência |
25
+ |---|---|---|
26
+ | Vou subir campanha, está tudo instalado? | implantação | `references/modo-implantacao.md` |
27
+ | Está rodando e o número não fecha | diagnóstico | `references/modo-diagnostico.md` |
28
+ | A venda não bate com o gerenciador | diagnóstico, começando por atribuição | `references/utm-e-atribuicao.md` |
29
+ | Como monto as UTMs desta conta | implantação, só a parte de tags | `references/utm-e-atribuicao.md` |
30
+
31
+ Em dúvida entre os dois: se existe dado rodando, é diagnóstico. Implantação é para o que ainda não subiu.
32
+
33
+ ## Os princípios que decidem no empate
34
+
35
+ - **O banco próprio é a fonte de verdade.** Gerenciador e Analytics perdem venda (bloqueador, iOS, cookie recusado). O número oficial vem do banco alimentado por webhook da plataforma de pagamento. Quando as duas fontes divergem, a divergência é o achado, não um erro de leitura.
36
+ - **O pixel mede o pixel.** Connect rate é o instante em que o `PageView` dispara, não o instante em que a pessoa vê a oferta. Subir o pixel sem consertar a página é maquiagem de métrica.
37
+ - **Atribuir por ID, não por nome.** A UTM carrega nome e ID. Renomear campanha não pode quebrar a atribuição.
38
+ - **Orgânico não é canal, é ausência de UTM.** O balde "organic" é destaque sem tag, direct e recompra. Taguear tudo e ver o orgânico cair é a prova da origem real.
39
+ - **Higiene de nomenclatura é infraestrutura.** Nome de campanha sujo não se conserta depois: a plataforma continua servindo o nome antigo em cache para o que já foi entregue.
40
+ - **Diagnóstico é do fim para o começo.** Sempre. Recuperar venda iniciada é dinheiro que já era seu; mexer em criativo com checkout furando é desperdício.
41
+
42
+ ## Entradas que a auditoria precisa
43
+
44
+ Peça de uma vez, não uma por uma:
45
+
46
+ - URL da página de vendas e da página de checkout
47
+ - Plataforma de checkout e de pagamento
48
+ - Print ou export do gerenciador com: cliques no link, visitas à página, checkouts iniciados, compras, valor gasto, valor atribuído
49
+ - Acesso (ou print) do painel de atribuição, quando existir
50
+ - O template de UTM que está colado hoje no campo de parâmetros de URL
51
+
52
+ Faltou item: siga com o que dá e liste o que falta em PENDÊNCIAS. Nunca preencha buraco de dado com estimativa.
53
+
54
+ ## Saída
55
+
56
+ Um relatório em markdown, sempre com estas quatro partes:
57
+
58
+ 1. **Achados por severidade.** `CRÍTICO` (o dado está errado e a decisão em cima dele também), `ALTO` (perde venda ou perde atribuição), `MÉDIO` (higiene, vai doer depois), `BAIXO` (melhoria).
59
+ 2. **A transição que está furando**, com a taxa real calculada e a régua ao lado, sempre com a fonte da régua.
60
+ 3. **O que consertar, em ordem**, seguindo a hierarquia do modo diagnóstico. Um item por linha, com quem resolve (dev, checkout, criativo, página).
61
+ 4. **Plano de tags pronto para colar**, quando o modo for implantação ou quando a auditoria encontrar UTM errada.
62
+
63
+ Feche com **PENDÊNCIAS**: o que não deu para verificar e o que precisa de acesso ou de dado que não veio.
64
+
65
+ ## Ferramentas
66
+
67
+ - Inspeção de página: CLI `agent-browser`. Nunca Playwright.
68
+ - Nada mais é obrigatório. A auditoria funciona lendo print e página.
69
+
70
+ ## Quando delegar
71
+
72
+ | Situação | Vai para |
73
+ |---|---|
74
+ | O furo é a página (LCP, mobile, blocos) | `page-cro` |
75
+ | O furo é o criativo | `ad-creative` |
76
+ | O furo é bid, orçamento ou estrutura de campanha | `paid-ads` |
77
+ | Precisa desenhar medição de produto ou SaaS | `analytics-tracking` |
78
+ | A oferta em si não fecha | `wizz-offer-forge` |
@@ -0,0 +1,72 @@
1
+ # Modo diagnóstico
2
+
3
+ Está rodando e o número não fecha. Este modo descobre **qual transição está furando** e separa problema de medição de problema de conversão.
4
+
5
+ Régua: leia o Passo 0 do `SKILL.md`. Cada faixa citada no relatório declara de onde veio.
6
+
7
+ ## As 5 transições
8
+
9
+ Base do funil é a visita à página, igual a 100%. A taxa real de cada transição é a etapa dividida pela **anterior**, nunca pela base.
10
+
11
+ | # | Transição | O que ela revela |
12
+ |---|---|---|
13
+ | 1 | Cliques no anúncio → Visitas na página | Saúde técnica: velocidade, redirect, SSL, mobile, disparo do `PageView` |
14
+ | 2 | Visitas → Checkout iniciado | Casamento entre criativo, página e oferta |
15
+ | 3 | Checkout iniciado → Venda iniciada | Atrito de checkout: campos, meios de pagamento, frete, taxa surpresa |
16
+ | 4 | Venda iniciada → Aprovada (PIX) | Recuperação: lembrete, prazo, instrução |
17
+ | 5 | Venda iniciada → Aprovada (cartão) | Recusa: antifraude, parcelamento, emissor |
18
+
19
+ Sempre diagnosticar **do fim para o começo**.
20
+
21
+ ## Hierarquia do que atacar primeiro
22
+
23
+ Se dá para mexer em uma coisa só:
24
+
25
+ 1. **Venda iniciada → aprovada.** O ROI mais rápido do funil. Esse dinheiro já era seu.
26
+ 2. **Checkout iniciado → venda iniciada.** Ajuste barato, ganho grande.
27
+ 3. **Visitas → checkout.** Página e criativo. Mais lento e mais caro; só depois que o checkout está resolvido.
28
+ 4. **Cliques → visitas.** Técnico. Chama dev.
29
+
30
+ Ordem de prioridade das métricas: vendas > checkout iniciado > CPC > hook rate > hold rate > CPM. Não se mexe em CPC se a página não converte. Não se mexe em CPA se o checkout está furando.
31
+
32
+ ## Medição contra conversão
33
+
34
+ Antes de dizer "a conversão caiu", prove que a **medição** está de pé. As três perguntas:
35
+
36
+ | Sintoma | Se for medição | Se for conversão |
37
+ |---|---|---|
38
+ | Cliques muito acima das visitas | `PageView` não dispara, ou dispara tarde | Página fora do ar, redirect quebrado |
39
+ | Venda no banco e não no gerenciador | Falta CAPI, falta domínio verificado, iOS | Nada: a venda existe |
40
+ | Venda no gerenciador e não no banco | Deduplicação ausente, evento duplicado | Nada: a venda não existe |
41
+ | Orgânico subindo sozinho | Rota sem UTM | Recompra e boca a boca de verdade |
42
+ | Atribuição some ao renomear campanha | Atribuição por nome, não por ID | Nada |
43
+
44
+ Regra prática: se as duas fontes discordam, a discordância **é** o achado. Nunca escolha a fonte que confirma a tese.
45
+
46
+ ## Qual dado falta para decidir
47
+
48
+ Parte do trabalho é dizer o que não dá para responder ainda. Formato:
49
+
50
+ ```
51
+ PENDÊNCIA: não dá para separar atrito de checkout de desistência de preço.
52
+ Falta: evento AddPaymentInfo.
53
+ Custo de instalar: baixo.
54
+ O que muda quando existir: a transição 3 vira duas, e o conserto deixa de ser chute.
55
+ ```
56
+
57
+ Nunca invente o número que falta. Um "provavelmente uns 30%" contamina a decisão inteira.
58
+
59
+ ## ROI verdadeiro contra ROI falso
60
+
61
+ - **ROI falso:** valor atribuído pelo gerenciador dividido pelo gasto do gerenciador. Conta venda que não entrou e ignora venda que entrou sem atribuição.
62
+ - **ROI verdadeiro:** faturamento aprovado no banco próprio, menos taxa da plataforma e menos reembolso, dividido pelo gasto real do período.
63
+
64
+ Sempre reporte os dois lado a lado. A diferença entre eles é o tamanho do buraco de medição.
65
+
66
+ ## Leitura de print do gerenciador
67
+
68
+ Métricas que precisam aparecer no print para o diagnóstico rodar:
69
+
70
+ cliques no link, visualizações da página, checkouts iniciados, compras (ou resultados quando a campanha otimiza para compra), valor gasto, valor atribuído.
71
+
72
+ Faltou alguma: diga qual e o que ela impede de calcular. Não estime.
@@ -0,0 +1,89 @@
1
+ # Modo implantação
2
+
3
+ Checklist executável para antes de subir campanha. Roda de cima para baixo. Cada item tem um jeito de verificar, não é declaração de fé.
4
+
5
+ Régua: leia o Passo 0 do `SKILL.md` antes. Sem régua declarada, o relatório sai sem número.
6
+
7
+ ## 1. Página e carregamento
8
+
9
+ | Verificar | Como | Reprova quando |
10
+ |---|---|---|
11
+ | Página abre no mobile real | `agent-browser` em viewport de celular | Layout quebra ou bloco some |
12
+ | Tempo até o conteúdo principal | PageSpeed Insights, aba mobile | Fora da meta declarada pela régua do projeto |
13
+ | Redirect | Abrir o link do anúncio sem encurtador no meio | Qualquer salto extra ou loop |
14
+ | SSL | Cadeado e certificado válido no domínio final | Aviso do navegador |
15
+
16
+ Furou aqui: é trabalho de dev. Não mexa em criativo antes de resolver.
17
+
18
+ ## 2. Pixel e servidor
19
+
20
+ | Verificar | Como | Reprova quando |
21
+ |---|---|---|
22
+ | Pixel presente na página | Extensão de debug da plataforma ou console | Não dispara `PageView` |
23
+ | Posição do disparo | Ver se o `PageView` sobe antes do conteúdo visível | Dispara em `onload` tardio: infla connect rate e mente sobre a visita |
24
+ | Evento de conversão do lado do servidor (CAPI) | Painel de qualidade da plataforma | Só navegador, sem servidor |
25
+ | Deduplicação | `event_id` igual entre navegador e servidor | Sem `event_id`: a mesma venda conta duas vezes |
26
+ | Domínio verificado | Painel de negócio da plataforma | Não verificado: perde atribuição em iOS |
27
+
28
+ > O pixel mede o pixel. Um connect rate bonito com página lenta é métrica maquiada, não conversão.
29
+
30
+ ## 3. Eventos priorizados
31
+
32
+ Instale nesta ordem. Os quatro primeiros são obrigatórios; os outros entram quando o funil tiver a etapa.
33
+
34
+ 1. `PageView` — visita à página de vendas
35
+ 2. `ViewContent` — chegou ao bloco de oferta (não é o mesmo que abrir a página)
36
+ 3. `InitiateCheckout` — clicou para comprar
37
+ 4. `Purchase` — venda aprovada, com valor e moeda
38
+ 5. `AddPaymentInfo` — preencheu pagamento, separa atrito de checkout de desistência de preço
39
+ 6. `Lead` — captura, quando existir etapa de lead
40
+ 7. `Subscribe` ou evento de recorrência, quando existir
41
+ 8. Evento próprio de upsell ou order bump, quando existir
42
+
43
+ Regra: evento sem valor monetário em `Purchase` inutiliza ROAS. Evento duplicado inutiliza tudo.
44
+
45
+ ## 4. Tags e atribuição
46
+
47
+ Ver `utm-e-atribuicao.md` para os templates. O que a implantação precisa provar:
48
+
49
+ - O template de UTM está colado no campo de parâmetros de URL do anúncio, não no destino do anúncio.
50
+ - Cada parâmetro carrega nome **e** ID.
51
+ - O parâmetro nativo da plataforma de checkout (quando existir) recebe a mesma informação empacotada, porque o checkout nem sempre repassa `utm_*`.
52
+ - Nenhum nome de campanha, conjunto ou anúncio contém `|`, `#`, `&` ou `?`.
53
+ - O padrão de nomenclatura está escrito em algum lugar que a próxima pessoa lê.
54
+
55
+ ## 5. Repasse pelo checkout
56
+
57
+ Este é o item que mais falha e o mais fácil de esquecer.
58
+
59
+ 1. Abra a página com uma UTM de teste na URL.
60
+ 2. Clique para comprar.
61
+ 3. Na página de checkout, confirme que os parâmetros chegaram (URL, campo escondido ou painel da plataforma).
62
+ 4. Confirme que o webhook de venda entrega esses parâmetros para o destino final (banco, planilha, painel de atribuição).
63
+
64
+ Quebrou entre 2 e 3: o checkout não repassa. Use o parâmetro nativo.
65
+ Quebrou entre 3 e 4: o problema é a integração, não a tag.
66
+
67
+ ## 6. Compra-teste por caminho
68
+
69
+ Cada rota de entrada recebe uma compra real de teste antes de investir:
70
+
71
+ - anúncio
72
+ - link da bio
73
+ - story
74
+ - destaque
75
+ - direct ou conversa
76
+
77
+ Para cada rota, registre: a venda apareceu no banco, apareceu no painel de atribuição, e apareceu com a origem certa. Rota que não passa nas três é rota cega.
78
+
79
+ ## 7. Fechamento
80
+
81
+ Antes de liberar a subida, o relatório precisa responder sim para as cinco:
82
+
83
+ 1. A visita é medida no instante certo?
84
+ 2. A venda chega ao banco próprio?
85
+ 3. A venda sabe de qual anúncio veio, por ID?
86
+ 4. O orgânico é o que sobra depois de tudo taguear, e não um balde de preguiça?
87
+ 5. Existe pelo menos uma compra-teste aprovada por rota?
88
+
89
+ Qualquer "não" vira achado `CRÍTICO` ou `ALTO`. Nada sobe com um `CRÍTICO` aberto.
@@ -0,0 +1,75 @@
1
+ # UTM e atribuição
2
+
3
+ O cimento de todo o resto. Se a tag está errada, o funil inteiro mede ficção.
4
+
5
+ ## A regra central
6
+
7
+ Cada parâmetro carrega **nome e ID**, separados por um delimitador fixo. O nome existe para humano ler; o ID existe para a atribuição sobreviver a renomeação.
8
+
9
+ ```
10
+ utm_campaign={{campaign.name}}|{{campaign.id}}
11
+ utm_medium={{adset.name}}|{{adset.id}}
12
+ utm_content={{ad.name}}|{{ad.id}}
13
+ utm_term={{placement}}
14
+ utm_source=<plataforma>
15
+ ```
16
+
17
+ Cole no campo **parâmetros de URL** do anúncio, nunca no destino.
18
+
19
+ ## Redundância no parâmetro nativo
20
+
21
+ Muito checkout não repassa `utm_*` para o webhook de venda. Quando a plataforma de checkout tem parâmetro próprio (por exemplo `xcod`, `src` ou `sck`), empacote a mesma informação lá também, com um separador longo e improvável:
22
+
23
+ ```
24
+ xcod=<origem><SEP><campaign.name>|<campaign.id><SEP><adset.name>|<adset.id><SEP><ad.name>|<ad.id><SEP><placement>
25
+ ```
26
+
27
+ O separador precisa ser uma string que nunca apareça em nome de campanha. Escolha uma vez e nunca mude: mudar quebra o histórico.
28
+
29
+ ## Delimitadores proibidos em nomes
30
+
31
+ Nunca use `|`, `#`, `&` ou `?` em nome de campanha, conjunto ou anúncio. São delimitadores da própria string de tag.
32
+
33
+ Violou: **recriar a campanha**. Renomear não resolve, porque a plataforma continua servindo o nome antigo em cache para as impressões já entregues.
34
+
35
+ Padrão de nome que não dá problema: minúscula, sem acento, palavras separadas por hífen ou underscore, campos em ordem fixa. Escreva o padrão em algum lugar. Padrão que só existe na cabeça de alguém não é padrão.
36
+
37
+ ## Outras plataformas
38
+
39
+ O formato é o mesmo em toda plataforma de mídia: macro nativa da plataforma preenchendo `utm_*`, mais o empacotamento no parâmetro nativo do checkout quando ele existir.
40
+
41
+ | Plataforma | O que muda |
42
+ |---|---|
43
+ | Meta | Macros `{{campaign.name}}`, `{{campaign.id}}`, `{{adset.*}}`, `{{ad.*}}`, `{{placement}}` |
44
+ | Google | Macros entre chaves simples, mais `{lpurl}?` na frente e `keyword`, `device`, `network` |
45
+ | TikTok, Kwai, Taboola | Mesma estrutura, nomes de macro próprios da plataforma |
46
+
47
+ Antes de escrever o template de uma plataforma, confirme o nome exato da macro na documentação dela. Macro errada entrega a string literal `{{campaign.id}}` na URL, e ninguém percebe até a primeira venda.
48
+
49
+ Existe variação a mais quando há cloaker na frente do checkout: um conector extra para não quebrar a string. Confirme com quem instalou o cloaker.
50
+
51
+ ## O balde do orgânico
52
+
53
+ "Orgânico" não é canal. É tudo que chegou sem tag: destaque do Instagram sem UTM, link na bio sem UTM, direct, recompra, boca a boca.
54
+
55
+ Diagnóstico: tague **todas** as rotas próprias (bio, destaque, story, direct, e-mail, grupo) e observe o orgânico cair. O que sobrar depois disso é orgânico de verdade. O tamanho da queda é a prova de quanto o balde estava mentindo.
56
+
57
+ Padrão sugerido para rota própria:
58
+
59
+ ```
60
+ utm_source=instagram&utm_medium=<bio|destaque|story|direct>&utm_campaign=<nome-do-destaque-ou-post>
61
+ ```
62
+
63
+ ## Primeiro toque
64
+
65
+ Último clique é o padrão de quase toda ferramenta, e ele esconde qual anúncio **apresentou** a oferta. Guarde o primeiro toque no seu banco (primeira UTM vista pelo visitante, com data) e compare com o último. Multi-toque simples, dois campos, resolve a maior parte das decisões de criativo.
66
+
67
+ ## Conferência rápida
68
+
69
+ Cinco checagens que pegam quase todo erro de tag:
70
+
71
+ 1. Abra o anúncio em preview e leia a URL final: tem macro literal sobrando?
72
+ 2. A UTM sobrevive ao redirect até o checkout?
73
+ 3. O webhook de venda entrega os campos ao banco?
74
+ 4. Dois anúncios diferentes geram `utm_content` diferentes?
75
+ 5. Renomear um anúncio quebra a atribuição? Se quebrar, está atribuindo por nome.
@@ -16,6 +16,7 @@ Um artefato mestre `OFFER-SPEC.md` contendo:
16
16
  4. **Ancoragem de Preço, Modelagem de Planos & Order Bumps / Upsells**.
17
17
  5. **Garantia Reversa / Inversão de Risco** (Risco Zero ou Ganho Duplo).
18
18
  6. **Ponte de Tráfego: Matriz de Hooks e Ângulos de Criativos**.
19
+ 7. **Plano de Medição** (eventos mínimos, padrão de UTM, metas por transição, hipótese e número que reprova).
19
20
 
20
21
  ## Princípios de Forja de Oferta
21
22
 
@@ -28,11 +29,21 @@ Um artefato mestre `OFFER-SPEC.md` contendo:
28
29
 
29
30
  ### Passo 0 — Coleta de Insumos & Ambição
30
31
 
31
- Consulte o contexto existente ou pergunte ao usuário:
32
+ **Antes de perguntar qualquer coisa, leia o que existe.** Oferta boa nasce do resultado da anterior, não de página em branco.
33
+
34
+ Se a skill `cerebro` estiver instalada, rode `/cerebro ver` do projeto e faça um grep por tema em `_decisions/`. Procure especificamente: oferta anterior do mesmo público, preço que já foi testado, garantia que já foi usada, e decisão registrada que proíba algum caminho. Traga o que achou como insumo e diga na resposta de onde veio. Sem a skill instalada, pule este bloco e siga com as perguntas abaixo.
35
+
36
+ Depois, consulte o contexto existente ou pergunte ao usuário:
32
37
  1. **Pesquisa de Público Prévia:** Existe um relatório da skill `pesquisa-de-publico-do-piva` ou notas de VoC? Se sim, importe como insumo primário. Se não, defina Avatar, Dor Latente e Nível de Consciência inicial.
33
38
  2. **Modelo de Negócio:** Low-ticket (R$ 10 a R$ 97), Front-end médio (R$ 197 a R$ 497) ou High-ticket / Mentoria (R$ 1.000 a R$ 10.000+)?
34
39
  3. **Veículo de Entrega:** Curso gravado, comunidade, templates/ferramentas, mentoria ao vivo, SaaS ou híbrido?
35
40
 
41
+ ### Passo 0.5 — Régua local tem precedência
42
+
43
+ Se a skill `lowticket-metodologia` estiver instalada neste projeto, leia as entradas de **oferta, preço e garantia** do INDEX dela e use esses valores como régua acima dos padrões desta skill (faixas de preço, múltiplo de upsell, prazo de garantia). Declare na resposta qual régua está valendo. Onde a régua local contradisser esta skill, **a régua local vence**.
44
+
45
+ Sem essa skill instalada, siga com os padrões desta skill. Nada muda.
46
+
36
47
  ### Passo 1 — Destilação do Mecanismo Único
37
48
 
38
49
  Consulte `references/mecanismo-unico.md`:
@@ -49,8 +60,9 @@ Formule a Promessa Primária em 1 frase de alto impacto:
49
60
  Consulte `references/empilhamento-valor.md`:
50
61
  - **Produto Principal:** O caminho mais rápido e direto ao resultado.
51
62
  - **Bônus 1 (Velocidade):** Templates, atalhos, checklists prontos que encurtam a execução.
52
- - **Bônus 2 (Segurança):** Como evitar o erro mais comum ou o que fazer em caso de dúvida.
53
- - **Bônus 3 (Próximo Passo):** O que fazer depois de atingir o primeiro marco.
63
+ - **Bônus 2 (Quebra de Objeção):** Elimina a maior desculpa para não comprar.
64
+ - **Bônus 3 (Blindagem / Segurança):** Como evitar o erro mais comum ou o que fazer em caso de imprevisto.
65
+ - **Bônus 4 (Próximo Nível):** O que fazer depois de atingir o primeiro marco.
54
66
  - **Order Bump Estratégico:** Complemento impulsivo de alta margem (30-50% de take rate).
55
67
 
56
68
  ### Passo 4 — Ancoragem de Preço & Garantia Reversa
@@ -69,6 +81,20 @@ Consulte `references/ponte-trafego.md`:
69
81
  3. *Gancho da Demonstração do Mecanismo*
70
82
  4. *Gancho da História de Transformação / Case*
71
83
 
72
- ### Passo 6 — Compilação e Entrega
84
+ ### Passo 6 — Plano de Medição
85
+
86
+ Consulte `references/plano-de-medicao.md`.
87
+
88
+ Uma oferta sem definição de sucesso não pode ser diagnosticada depois: quando ela não converte, ninguém sabe se o furo foi criativo, página, checkout ou a oferta em si. Este passo fecha esse buraco enquanto a promessa ainda está fresca.
89
+
90
+ Derive da própria oferta, sem inventar número:
91
+ - **Eventos mínimos** que precisam existir para medir esta promessa.
92
+ - **Padrão de UTM** por canal de entrada.
93
+ - **Metas por transição do funil**, calibradas para este ticket, com a fonte da régua declarada.
94
+ - **A hipótese principal** em uma frase, e o **número que reprova a oferta**.
95
+
96
+ Se a skill `tracking-audit` estiver instalada, delegue a implantação e a conferência para ela: aqui se declara o que precisa ser verdade, lá se prova que é.
97
+
98
+ ### Passo 7 — Compilação e Entrega
73
99
 
74
100
  Grave o artefato final em `{output_folder}/offers/OFFER-[NOME_SLUG].md` e apresente um resumo executivo com os 4 pontos de decisão para validação imediata do usuário.
@@ -0,0 +1,74 @@
1
+ # Plano de Medição da Oferta
2
+
3
+ O sétimo bloco do `OFFER-SPEC.md`. Não é arquivo separado, é uma seção do artefato.
4
+
5
+ Serve para uma coisa só: quando a oferta não converter, saber **onde** ela não converteu. Sem isso o diagnóstico vira arqueologia.
6
+
7
+ Regra que atravessa tudo: **nada de número inventado**. Toda meta tem fonte declarada (régua da metodologia local, histórico do próprio projeto, ou combinado com o usuário). O que não tiver fonte fica escrito como pendência.
8
+
9
+ ## 1. Eventos mínimos
10
+
11
+ Derive da promessa, não de uma lista pronta. A pergunta é: qual é o instante em que esta oferta foi aceita?
12
+
13
+ Base para quase toda oferta de resposta direta:
14
+
15
+ | Evento | Marca | Obrigatório |
16
+ |---|---|---|
17
+ | `PageView` | chegou à página | sim |
18
+ | `ViewContent` | chegou ao bloco da oferta | sim |
19
+ | `InitiateCheckout` | clicou para comprar | sim |
20
+ | `Purchase` (com valor e moeda) | venda aprovada | sim |
21
+ | `AddPaymentInfo` | preencheu pagamento | quando o checkout tiver a etapa |
22
+ | evento do order bump | aceitou o bump | quando houver bump |
23
+ | evento do upsell | aceitou o upsell | quando houver upsell |
24
+
25
+ `Purchase` sem valor monetário inutiliza qualquer cálculo de retorno. Evento duplicado inutiliza todos.
26
+
27
+ ## 2. Padrão de UTM por canal
28
+
29
+ Uma linha por rota de entrada que esta oferta vai usar. Toda rota, inclusive as próprias:
30
+
31
+ ```
32
+ anúncio utm_source=<plataforma>&utm_campaign=<nome>|<id>&utm_medium=<conjunto>|<id>&utm_content=<anúncio>|<id>
33
+ bio utm_source=instagram&utm_medium=bio&utm_campaign=<oferta>
34
+ destaque utm_source=instagram&utm_medium=destaque&utm_campaign=<nome-do-destaque>
35
+ story utm_source=instagram&utm_medium=story&utm_campaign=<oferta>
36
+ e-mail utm_source=email&utm_medium=<sequência>&utm_campaign=<oferta>
37
+ ```
38
+
39
+ Rota sem UTM cai no balde do orgânico e some da análise. Se a skill `tracking-audit` estiver instalada, ela é a dona da implantação e da conferência disso.
40
+
41
+ ## 3. Metas por transição
42
+
43
+ As cinco transições do funil, com a meta calibrada para **este** ticket e a fonte ao lado:
44
+
45
+ | Transição | Meta | Fonte da meta |
46
+ |---|---|---|
47
+ | Cliques → visitas | | |
48
+ | Visitas → checkout iniciado | | |
49
+ | Checkout iniciado → venda iniciada | | |
50
+ | Venda iniciada → aprovada (PIX) | | |
51
+ | Venda iniciada → aprovada (cartão) | | |
52
+
53
+ Preencher com régua declarada. Célula sem fonte fica vazia e vira pendência, nunca chute.
54
+
55
+ ## 4. Hipótese e número que reprova
56
+
57
+ Duas frases, e elas são o coração do bloco:
58
+
59
+ ```
60
+ Hipótese: <público> compra <promessa> a <preço> porque <mecanismo>,
61
+ e isso aparece como <métrica> acima de <número>.
62
+
63
+ Reprova: se depois de <volume mínimo de dados> a <métrica> ficar abaixo de <número>,
64
+ a oferta está errada e o próximo passo é <mudar promessa | mudar preço | mudar público>.
65
+ ```
66
+
67
+ O volume mínimo importa tanto quanto o número. "Não converteu" com 40 visitas não é informação.
68
+
69
+ ## 5. Ponte com o tracking
70
+
71
+ Este bloco **declara** o que precisa ser verdade. Ele não instala nada e não confere nada.
72
+
73
+ - Com `tracking-audit` instalada: o passo seguinte é rodar o modo implantação dela usando este bloco como entrada.
74
+ - Sem ela: entregue o bloco como checklist manual e diga que a conferência não foi feita.
@@ -10,7 +10,7 @@ description: "OBRIGATÓRIO: invoque ANTES de agir em qualquer pedido não-trivia
10
10
 
11
11
  Invoque esta skill ANTES de agir em pedidos não-triviais (feature, bug, design, marketing, SEO, infra, refactor, audit, review, integração, configuração — amplo OU específico).
12
12
 
13
- **Exceção única:** edições de 1 linha (typo, rename) e conversa pura.
13
+ **Exceção única:** edições de 1 linha (typo, rename) e conversa pura. **Critério objetivo (TRIVIALITY GATE):** pedido que toca ≤1 arquivo, ~≤10 linhas, sem comportamento novo, mudança de tipo conhecido → executa direto, sem acionar router/maestro.
14
14
 
15
15
  **Fora do Plan Mode:** liste candidatas via `AskUserQuestion` e aguarde confirmação ANTES de disparar. Nunca auto-dispare fora do Plan Mode.
16
16
  **Dentro do Plan Mode:** auto-dispare todas as relevantes para enriquecer o plano.
@@ -20,10 +20,12 @@ Você é o **Diretor / porta de entrada** — não o orquestrador (esse é o `wi
20
20
 
21
21
  **Nota de escopo de instalação:** esta é a única skill do catálogo onde instalação **global** (`~/.claude/skills/wizz-router`) é o padrão operacionalmente correto, não uma exceção à regra "prefer local" (`skills-registry.yaml`, Doutrina de Instalação, regra 1) — sua razão de existir é rotear mesmo fora de um projeto Wizz. Fica sincronizada com o hook global `wizz-router-enforce.js` via `npm run sync:global`.
22
22
 
23
- **Economia de tokens:** o hook `rtk-rewrite.sh` já cuida do RTK automaticamente (não rode `rtk --version` a cada roteamento). Antes de ler arquivos crus, prefira `/graphify query`, `/cerebro ver`, ou `grep` específico.
23
+ **Economia de tokens:** o hook `rtk-rewrite.sh` já cuida do RTK automaticamente (não rode `rtk --version` a cada roteamento). Antes de ler arquivos crus, prefira `/cerebro ver` ou `grep` específico.
24
24
 
25
25
  ## Triagem e delegação (o coração do Diretor)
26
26
 
27
+ **Estágio do projeto (fail-open):** `grep -m1 '^stage:' {project-root}/**/project-context.md` (ex: `_wizz-output/project-context.md`, path configurável via `output_folder`). Se achar `prototype`/`mvp`, prefira solução leve e não recomende observabilidade/infra de produção; `production`, gates de qualidade valem integralmente. Sem arquivo: siga sem mencionar estágio.
28
+
27
29
  Descubra o contexto: **existe `{project-root}/_wizz/`?**
28
30
 
29
31
  ### A) Dentro de projeto Wizz — você DELEGA, nunca executa
@@ -42,6 +44,8 @@ Avalie a **Área**: quantas áreas o pedido toca (design, dev, copy, seo, growth
42
44
 
43
45
  > Um agente de área só cobre a área dele. 2+ áreas exigem coordenação = trabalho do maestro; a cláusula de área decide sozinha, sem somar com mais nada.
44
46
 
47
+ **Descoberta de capacidade (índice, não atalho de delegação):** a [tabela de roteamento flat](references/routing-table-flat.md) também pode ser consultada aqui, dentro de projeto Wizz, quando o pedido não nomeia a capacidade certa (ex.: "quero um carrossel" → índice aponta `canvas-design`). Ela só serve pra achar o nome da capacidade; a entrega continua pelo dispatch normal acima (agente da área / maestro) — nunca dispare a skill direto a partir da tabela dentro de projeto Wizz.
48
+
45
49
  **Exemplos calibrados de borda** (do dataset de evals, `evals/routing/dataset.json`):
46
50
 
47
51
  - *Trivial → direto (sem router):* `t07` ("trocar 'envie' por 'enviar' na linha 42"): edição de 1 linha.
@@ -55,6 +59,8 @@ Ao delegar (pro maestro ou pro agente de área), declare o brief no formato do [
55
59
 
56
60
  Não há agentes wizz nem maestro. Você é a porta de descoberta global. Fluxo: analise a intenção (pode ter várias dimensões) → mapeie candidatas pela **[tabela de roteamento](references/routing-table-flat.md)** → fora do Plan Mode, apresente via `AskUserQuestion` e confirme → dispare as aprovadas via `Skill` (em paralelo quando independentes). Se nada cobrir, use o protocolo de **skill/MCP faltante** (no fim da mesma tabela).
57
61
 
62
+ **Ao encerrar o modo flat**, emita 1 linha máquina-legível de decision-trace — telemetria de decisão coletada por hook — no formato exato: `🧭 {"rota":"flat:<skill>","sel":["id",...],"desc":[["id_descartado","motivo≤6 palavras"]],"gate":"n/a","repetiria":true}`
63
+
58
64
  ## Modo Auditoria 360°
59
65
 
60
66
  Ao detectar "auditoria completa / revisa tudo / 360 / análise geral", siga **[references/auditoria-360.md](references/auditoria-360.md)**.
@@ -1,6 +1,6 @@
1
1
  # Tabela de Roteamento — Modo Flat
2
2
 
3
- Use esta tabela **fora de projeto Wizz** (sem `_wizz/`), quando o router mapeia skills/CLIs/MCPs direto. Dentro de projeto Wizz a delegação é decidida pela regra de dispatch no SKILL.md (maestro vs agente de área) e esta tabela não é necessária.
3
+ Use esta tabela pra mapear skills/CLIs/MCPs direto **fora de projeto Wizz** (sem `_wizz/`) o router dispara a skill sozinho. **Dentro de projeto Wizz** ela também pode ser consultada como ÍNDICE DE CAPACIDADES, pra descobrir uma capacidade relevante que o usuário não nomeou (ex.: "quero um carrossel" → `canvas-design`); mas a delegação continua sendo feita pelo dispatch normal do SKILL.md (agente da área / maestro) a tabela nunca dispara a skill direto dentro de projeto Wizz.
4
4
 
5
5
  **Verificação de existência:** antes de oferecer qualquer skill, confirme que ela existe no ambiente (catálogo de skills da sessão ou `ls ~/.claude/skills`); se não existir, não ofereça: use o protocolo de skill faltante (`find-skills`).
6
6
 
@@ -16,6 +16,7 @@ Use esta tabela **só fora de projeto Wizz** (sem `_wizz/`), quando o router map
16
16
  | Dependências, packages, vulnerabilidades, npm audit | `database-and-deps` | 2 |
17
17
  | Segurança, XSS, CSRF, SQLi, IDOR, OWASP, rate limit, CORS, clickjacking, PII na resposta, enumeração de usuário, headers | `web-security` + `auth-and-secrets` | 1 |
18
18
  | Auditoria/pentest de segurança do app inteiro, "auditar segurança", "pentest", "encontrar vulnerabilidades", varredura antes de release | `security-audit-pentest` | 1 |
19
+ | Auditoria de prontidão pra lançamento, "tá pronto pra lançar?", checklist de release amplo (técnico, segurança, SEO, analytics, conteúdo, legal, infra), "o que falta antes de ir pra produção" | `launch-readiness` | 1 |
19
20
  | Desktop, Electron, contextIsolation, code signing | `desktop-security` | 2 |
20
21
 
21
22
  ## Área Técnica — Código e Qualidade
@@ -60,6 +61,7 @@ Use esta tabela **só fora de projeto Wizz** (sem `_wizz/`), quando o router map
60
61
  | Ideias de marketing, estratégia de marketing, posicionamento | `marketing-ideas` + `marketing-psychology` + `product-marketing-context` | 1 |
61
62
  | Paid ads, anúncios, Google Ads, Meta Ads, TikTok Ads, mídia paga | `paid-ads` + `ad-creative` + `analytics-tracking` + **MCP meta-ads** | 1 |
62
63
  | Gestão de campanha Meta/Facebook/Instagram via API real | **MCP meta-ads** (`mcp-meta-ads`) direto | 1 |
64
+ | Pixel/UTM/atribuição erradas, "a venda não bate com o gerenciador", "onde está furando o funil", tráfego orgânico inflado, conferir tracking antes de subir campanha | `tracking-audit` (+ `analytics-tracking` se for SaaS/produto) | 1 |
63
65
  | Lançamento de feature, lançamento de produto, go-to-market | `launch-strategy` + `social-content` + `email-sequence` | 1 |
64
66
  | Site pronto pra subir, pré-lançamento de SITE, "revisa antes do deploy", checklist de go-live, ou item pontual pré-lançamento (og:image/prévia de link, FAQ com schema, robots.txt, LGPD, alt text) | `site-launch-kit` | 1 |
65
67
  | Preço, planos, pricing, monetização | `pricing-strategy` + `paywall-upgrade-cro` | 1 |
@@ -77,14 +79,13 @@ Use esta tabela **só fora de projeto Wizz** (sem `_wizz/`), quando o router map
77
79
  | Copywriting, copy, persuasão, texto de venda | `copywriting` + `humanizer` | 1 |
78
80
  | Pesquisa de público de oferta, VoC, matriz de ângulos, léxico de infoproduto | `pesquisa-de-publico-do-piva` | 1 |
79
81
  | Forjar oferta, criar oferta irresistível, mecanismo único, bônus, garantia | `wizz-offer-forge` + `pricing-strategy` | 1 |
80
- | Pesquisa de mercado, inteligência competitiva | `deep-research` | 2 |
82
+ | Pesquisa de mercado, inteligência competitiva | `deep-research` (plugin externo — só se instalado) | 2 |
81
83
 
82
84
  ## Contexto e Memória
83
85
 
84
86
  | Intenção / palavras-chave | Skills a oferecer | Prioridade |
85
87
  |---|---|---|
86
88
  | O que foi decidido, contexto passado, aprendizados, histórico | `cerebro` (/ver ou /dia) | 1 |
87
- | Entender o codebase, mapear estrutura do projeto | `/graphify query` (antes de ler arquivos) | 1 |
88
89
 
89
90
  ---
90
91
 
@@ -4,8 +4,9 @@
4
4
  // Por que existe: `huashu-design/assets/**/*.mp3` (~30MB) e
5
5
  // `canvas-design/canvas-fonts/**/*.ttf` (~5.5MB) inflavam o pacote npm em
6
6
  // ~73%, mas só são necessários no primeiro uso real de export de vídeo
7
- // (BGM/SFX) ou de uma variante de fonte específica. Os arquivos continuam no
8
- // git (fonte de verdade); saem do tarball publicado. Este script baixa o
7
+ // (BGM/SFX) ou de uma variante de fonte específica. Fonte de verdade dos BGM
8
+ // é o GitHub Release assets-v1 (fora do git e do tarball desde o P2 da
9
+ // auditoria 360°); os SFX pequenos e as fontes seguem no git. Este script baixa o
9
10
  // bundle certo, no lugar certo, verificando sha256 (mesmo espírito do pin
10
11
  // com checksum do rtk — nunca extrai um bundle adulterado).
11
12
  //