wizz-method 1.18.2 → 1.19.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 (50) hide show
  1. package/README.md +1 -1
  2. package/package.json +1 -1
  3. package/skills-registry.yaml +2 -11
  4. package/src/modules/lowticket/README.md +2 -2
  5. package/src/modules/lowticket/module.yaml +1 -1
  6. package/src/modules/lowticket/skills/lowticket-funil/SKILL.md +3 -3
  7. package/src/modules/lowticket/skills/lowticket-funil/references/copy-das-paginas.md +5 -3
  8. package/src/modules/lowticket/skills/lowticket-funil/references/mapa-do-funil.md +2 -0
  9. package/src/modules/lowticket/skills/lowticket-metodologia/SKILL.md +3 -3
  10. package/src/modules/lowticket/skills/lowticket-metodologia/knowledge/03-campanha-bidcap.md +18 -0
  11. package/src/modules/lowticket/skills/lowticket-metodologia/knowledge/04a-criativos-ia.md +47 -1
  12. package/src/modules/lowticket/skills/lowticket-metodologia/knowledge/04b-criativos-formatos.md +33 -2
  13. package/src/modules/lowticket/skills/lowticket-metodologia/knowledge/05-oferta.md +7 -4
  14. package/src/modules/lowticket/skills/lowticket-metodologia/knowledge/06-pagina-vendas.md +10 -8
  15. package/src/modules/lowticket/skills/lowticket-metodologia/knowledge/06a-instagram.md +9 -0
  16. package/src/modules/lowticket/skills/lowticket-metodologia/knowledge/06b-player-vsl.md +79 -0
  17. package/src/modules/lowticket/skills/lowticket-metodologia/knowledge/07-funil-upsell.md +61 -7
  18. package/src/modules/lowticket/skills/lowticket-metodologia/knowledge/07a-copy-humanizacao.md +73 -0
  19. package/src/modules/lowticket/skills/lowticket-metodologia/knowledge/09-especialista-coproducao.md +1 -1
  20. package/src/modules/lowticket/skills/lowticket-metodologia/knowledge/11-checklist-roi.md +3 -3
  21. package/src/modules/lowticket/skills/lowticket-metodologia/knowledge/12-mineracao-ofertas.md +64 -5
  22. package/src/modules/lowticket/skills/lowticket-metodologia/knowledge/12a-mineracao-veredito.md +48 -2
  23. package/src/modules/lowticket/skills/lowticket-metodologia/knowledge/12b-fabrica-de-ofertas.md +41 -94
  24. package/src/modules/lowticket/skills/lowticket-metodologia/knowledge/12c-anatomia-low-ticket.md +111 -0
  25. package/src/modules/lowticket/skills/lowticket-metodologia/knowledge/15-como-estender.md +5 -3
  26. package/src/modules/lowticket/skills/lowticket-metodologia/knowledge/17-rastreamento.md +127 -0
  27. package/src/modules/lowticket/skills/lowticket-metodologia/knowledge/18-copy-desejo-oferta.md +245 -0
  28. package/src/modules/lowticket/skills/lowticket-metodologia/knowledge/INDEX.md +14 -7
  29. package/src/modules/lowticket/skills/lowticket-metodologia/knowledge/guardrails.md +59 -5
  30. package/src/modules/lowticket/skills/lowticket-metodologia/knowledge/pontos-em-aberto.md +72 -11
  31. package/src/modules/lowticket/skills/lowticket-minerador/SKILL.md +6 -6
  32. package/src/modules/lowticket/skills/lowticket-minerador/references/rubrica.md +27 -2
  33. package/src/modules/lowticket/skills/lowticket-pagina/SKILL.md +5 -3
  34. package/src/modules/lowticket/skills/lowticket-pagina/references/metas-e-medicao.md +1 -0
  35. package/src/modules/lowticket/skills/lowticket-pagina/references/padroes-de-codigo.md +4 -0
  36. package/src/modules/lowticket/skills/lowticket-trafego/SKILL.md +2 -0
  37. package/src/modules/lowticket/skills/lowticket-trafego/references/reguas.md +4 -3
  38. package/src/modules/wizz/README.md +1 -1
  39. package/src/modules/wizz/_shared/model-ladder.md +2 -0
  40. package/src/modules/wizz/agents/wizz-ads/SKILL.md +3 -6
  41. package/src/modules/wizz/agents/wizz-ads/customize.toml +1 -8
  42. package/src/modules/wizz/agents/wizz-maestro/SKILL.md +1 -1
  43. package/src/modules/wizz/module.yaml +1 -1
  44. package/src/skills-lib/ad-creative/SKILL.md +1 -1
  45. package/src/skills-lib/paid-ads/SKILL.md +1 -1
  46. package/src/skills-lib/wizz-router/references/routing-table-flat.md +2 -5
  47. package/tools/installer/core/installer.js +20 -3
  48. package/tools/installer/modules/env-vars.js +41 -0
  49. package/tools/installer/modules/mcp-config.js +98 -14
  50. package/tools/installer/ui.js +6 -1
package/README.md CHANGED
@@ -21,7 +21,7 @@ O ponto de entrada técnico é o `wizz-router`: ele faz a triagem e manda pedido
21
21
  | ✍️ `wizz-copy` | Copy, e-mail, headlines | copywriting, email-sequence, humanizer, copy-editing |
22
22
  | 🔍 `wizz-seo` | SEO tradicional e de IA | seo-audit, ai-seo, schema-markup, programmatic-seo, site-architecture |
23
23
  | 📈 `wizz-growth` | Marketing, CRO, lançamento, preço, churn | marketing-ideas, page-cro, launch-strategy, pricing-strategy, churn-prevention |
24
- | 📢 `wizz-ads` | Mídia paga | paid-ads, ad-creative, analytics-tracking, MCP meta-ads |
24
+ | 📢 `wizz-ads` | Mídia paga | paid-ads, ad-creative, analytics-tracking |
25
25
  | 🧠 `wizz-memoria` | Memória do projeto | cerebro |
26
26
 
27
27
  Os papéis de dev e produto reusam os agentes WIZZ (Mary, John, Winston, Amelia, Sally, Paige), personalizados em PT-BR pelos overrides em `src/modules/wizz/overrides/`.
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://json.schemastore.org/package.json",
3
3
  "name": "wizz-method",
4
- "version": "1.18.2",
4
+ "version": "1.19.0",
5
5
  "description": "Wizz Method — método de agência orientado por IA em PT-BR (fork independente do BMad Method)",
6
6
  "keywords": [
7
7
  "agile",
@@ -280,7 +280,7 @@ areas:
280
280
  # Módulo lowticket (src/modules/lowticket) — ver nota em ads.skills.
281
281
  - id: lowticket-metodologia
282
282
  module: lowticket
283
- when: "Roteador da base low ticket BR/PT: gatilho → um shard. Régua de preço, garantia e oferta que tem precedência sobre a skill genérica."
283
+ when: "Roteador da base low ticket BR/PT: gatilho → um shard. Régua de preço, garantia, copy e rastreamento que tem precedência sobre a skill genérica."
284
284
  not_when:
285
285
  - "SaaS, B2B, site de cliente, high ticket ou mentoria: os números não transferem."
286
286
  - id: lowticket-funil
@@ -346,7 +346,7 @@ areas:
346
346
  # copiar de src/skills-lib, e o router continua enxergando as entradas.
347
347
  - id: lowticket-metodologia
348
348
  module: lowticket
349
- when: "Roteador da base low ticket BR/PT: gatilho → um shard (diagnóstico de funil, bid cap, criativo, oferta, página, Instagram, upsell, mineração). Carrega guardrails junto."
349
+ when: "Roteador da base low ticket BR/PT: gatilho → um shard (diagnóstico de funil, bid cap, criativo, oferta, página, Instagram, player de VSL, upsell, copy, rastreamento, mineração). Carrega guardrails junto."
350
350
  not_when:
351
351
  - "SaaS, B2B, site de cliente, high ticket ou mentoria: os números não transferem."
352
352
  - id: lowticket-trafego
@@ -355,15 +355,6 @@ areas:
355
355
  not_when:
356
356
  - "Google Ads institucional, campanha de marca, lead gen B2B."
357
357
  - "Escrever copy ou criativo: a skill lê número, não produz anúncio."
358
- mcps:
359
- - id: meta-ads
360
- when: "Gestão real de campanha Meta/Facebook/Instagram via API (criar/editar/medir ads)."
361
- server:
362
- command: npx
363
- # Pin de supply chain (2026-08-23): versão fixa; atualizar conscientemente.
364
- args: ["-y", "mcp-meta-ads@1.0.0"]
365
- env:
366
- META_ACCESS_TOKEN: "${META_ACCESS_TOKEN}"
367
358
 
368
359
  architect:
369
360
  agent: wizz-agent-architect
@@ -18,7 +18,7 @@ All five read the Cérebro on activation and **none of them keeps its own memory
18
18
 
19
19
  ## The loading contract
20
20
 
21
- The knowledge base is 20 shards. It is not loaded whole. Reading everything costs around 36k tokens; a typical answer needs under 5k.
21
+ The knowledge base is 25 shards. It is not loaded whole. Reading everything costs well over 40k tokens; a typical answer needs under 5k.
22
22
 
23
23
  | Step | Read | When |
24
24
  |---|---|---|
@@ -38,7 +38,7 @@ The knowledge here is a distillation: facts, benchmarks, checklists and critical
38
38
 
39
39
  If you extend a shard, keep it that way: write the fact, never the quote. `knowledge/15-como-estender.md` has the full process.
40
40
 
41
- Three tactics present in the source material are recorded and **not adopted** in `knowledge/guardrails.md`: buying engagement, AI avatars passing as real people, and synthetic testimonials. They are loaded on every activation and stay blocked until the operation's owner decides otherwise.
41
+ Seven tactics present in the source material are recorded and **not adopted** in `knowledge/guardrails.md`: buying engagement, AI avatars passing as real people, synthetic testimonials, borrowing a third party's ID document to verify a profile, using a real person's name as borrowed proof, reposting someone else's video as your own creative, and a struck-through reference price that was never charged. They are loaded on every activation and stay blocked until the operation's owner decides otherwise.
42
42
 
43
43
  ## Optional config
44
44
 
@@ -1,6 +1,6 @@
1
1
  code: lowticket
2
2
  name: "Wizz Low Ticket"
3
- description: "Low ticket direct-response playbook for Meta Ads (BR/PT): funnel diagnosis, bid-cap campaigns, creatives, sales pages, upsell ladders and offer mining. Knowledge base in Portuguese, loaded one shard at a time."
3
+ description: "Low ticket direct-response playbook for Meta Ads (BR/PT): funnel diagnosis, bid-cap campaigns, creatives, offers, sales pages, VSL players, upsell ladders, copy diagnosis, tracking setup and offer mining. Knowledge base in Portuguese, loaded one shard at a time."
4
4
  default_selected: false
5
5
 
6
6
  # --- Origin note (read this before editing the knowledge base) ---
@@ -17,7 +17,7 @@ Every offer in the ladder exists because it answers that question for the step b
17
17
 
18
18
  ## Source of truth
19
19
 
20
- Read the Cérebro state first (via the `cerebro` skill). Then, if `lowticket-metodologia` is installed, read `knowledge/INDEX.md` + `knowledge/guardrails.md` and the shard `07-funil-upsell.md`, especially §7.4 (the conversion and ticket cascade). Where a generic skill contradicts that shard, the shard wins and you say so.
20
+ Read the Cérebro state first (via the `cerebro` skill). Then, if `lowticket-metodologia` is installed, read `knowledge/INDEX.md` + `knowledge/guardrails.md` and the shard `07-funil-upsell.md`, especially §7.4 (the conversion and ticket cascade) and §7.5-7.9 (pain per step, tone per page, copy rules, the technical block for post-checkout pages and the pre-build checklist). Its sibling shard `07a-copy-humanizacao.md` carries the humanization checklist used before delivering any page. Where a generic skill contradicts that shard, the shard wins and you say so.
21
21
 
22
22
  This skill has **no memory of its own**. What gets decided goes to the Cérebro; the artifact goes to a file.
23
23
 
@@ -92,7 +92,7 @@ If asked for five or more paid steps, say the recommendation is to consolidate.
92
92
 
93
93
  ### Numbers, only when asked
94
94
 
95
- Treat these as reference, never as a promise: U1 15-25%, U2 20-35% among U1 buyers, downsell 20-35%, final offer 18-28%, total ticket around 1.5x to 2.3x the front. The canonical version is §7.4 of shard `07`.
95
+ Treat these as reference, never as a promise: U1 15-25%, U2 20-35% among U1 buyers, downsell 20-35%, final offer 18-28%, total ticket around 1.5x to 2.3x the front. The canonical version is §7.4 of shard `07`, which also names the likely cause when a step lands below its floor (for example, U1 under 10% points to wrong pain or wrong price) — use that instead of guessing.
96
96
 
97
97
  ## Hard limits on the copy
98
98
 
@@ -105,7 +105,7 @@ Treat these as reference, never as a promise: U1 15-25%, U2 20-35% among U1 buye
105
105
 
106
106
  Portuguese (BR), spoken register, short sentences, no em-dashes. Concrete scenes instead of abstract emotion: not "você se sente inseguro", but "você abre o computador às 9h e às 11h ainda está tentando descobrir por onde começar". Repeat the product's name instead of cycling through synonyms.
107
107
 
108
- The full anti-AI word list and the rhythm rules are in `references/copy-das-paginas.md`. For a deeper pass, hand the draft to the `humanizer` skill.
108
+ The full anti-AI word list and the rhythm rules are in `references/copy-das-paginas.md`. Before delivering, run the 10-filter checklist in `07a-copy-humanizacao.md` (sibling shard of `07-funil-upsell.md`): fail 3 or more, rewrite.
109
109
 
110
110
  ## Out of scope
111
111
 
@@ -33,7 +33,7 @@ A ordem não se mexe. Ela é o que faz a pessoa entender onde está no fluxo ant
33
33
 
34
34
  Não prometer resultado que o produto não entrega.
35
35
 
36
- **CTA.** Um por página. Ação mais benefício: `SIM, QUERO [BENEFÍCIO]`, `QUERO ACESSAR AGORA`, `SIM, QUERO ADICIONAR ISSO`.
36
+ **CTA.** Um por página. Ação mais benefício: `SIM, QUERO [BENEFÍCIO]`, `QUERO ACESSAR AGORA`, `SIM, QUERO ADICIONAR ISSO`. Uma dor, um CTA: página que tenta vender duas coisas ao mesmo tempo vende zero (§7.7 de `07-funil-upsell.md`).
37
37
 
38
38
  **Recusa.** O link existe sempre, discreto e não escondido: "Não, obrigado. Quero seguir sem essa oferta." Nada de manipulação agressiva do tipo "não, prefiro continuar perdendo dinheiro".
39
39
 
@@ -46,6 +46,8 @@ Não prometer resultado que o produto não entrega.
46
46
  | Downsell | empático: a recusa não foi um erro |
47
47
  | Oferta final | universal e simples: dá para entender a utilidade em cinco segundos |
48
48
 
49
+ > Quem chega no upsell acabou de comprar: é o nível 5 (totalmente consciente) da escada de `18-copy-desejo-oferta.md` (§18.3). Fala direto (oferta, bônus, garantia, urgência), sem reconstruir o problema do zero. Modelos de abertura por tom: §7.6 de `07-funil-upsell.md`.
50
+
49
51
  ## Humanização
50
52
 
51
53
  Cortar antes de entregar:
@@ -64,7 +66,7 @@ No lugar: linguagem falada. "do jeito certo", "na prática", "pra valer", "na re
64
66
 
65
67
  **Sem travessão longo.** Vírgula, ponto, dois pontos ou parênteses.
66
68
 
67
- Para um passe mais fundo, mandar o rascunho para a skill `humanizer`.
69
+ Antes de entregar, rodar o checklist de 10 filtros de `07a-copy-humanizacao.md` (shard irmão de `07-funil-upsell.md`, na `lowticket-metodologia`): falhou em 3 ou mais, refaz. A lista de palavras banidas acima é a base; a lista ampliada e a tabela de substituição estão no shard.
68
70
 
69
71
  ## Objeções
70
72
 
@@ -72,4 +74,4 @@ Antecipar as reais: "está caro", "não tenho tempo", "será que funciona pro me
72
74
 
73
75
  ## HTML
74
76
 
75
- Só gerar quando pedido. Quando gerar: HTML/CSS simples, mobile primeiro, carregamento leve, CTA e preço em destaque, link de recusa discreto, os 10 blocos preservados. Nada de script estranho e nada de integração inventada. Se a integração pedida não for conhecida, pedir a documentação em vez de improvisar.
77
+ Só gerar quando pedido. Quando gerar: HTML/CSS simples, mobile primeiro, carregamento abaixo de 2s, `noindex` nas páginas do funil (evita canibalizar busca e mapeamento por concorrente), CTA e preço em destaque, link de recusa discreto, os 10 blocos preservados. Nada de script estranho e nada de integração inventada. Se a integração pedida não for conhecida, pedir a documentação em vez de improvisar. (§7.8 de `07-funil-upsell.md`.)
@@ -7,6 +7,7 @@ FRONT-END
7
7
  Nome:
8
8
  Preço:
9
9
  Dor:
10
+ Público:
10
11
 
11
12
  UPSELL 1
12
13
  Nome:
@@ -69,3 +70,4 @@ Máximo três etapas pagas depois do checkout. Todo comprador chega na oferta fi
69
70
  - [ ] O preço do front continuou intacto?
70
71
  - [ ] Os três resultados de cada degrau são resultados, e não conteúdo?
71
72
  - [ ] A plataforma suporta OTO de um clique? Se não, isso foi dito antes de prometer?
73
+ - [ ] Este mapa se preenche em 5 minutos? Se não, os produtos ainda não estão claros o bastante para construir (§7.9 de `07-funil-upsell.md`).
@@ -1,11 +1,11 @@
1
1
  ---
2
2
  name: lowticket-metodologia
3
- description: Routes any low ticket direct-response question to the one knowledge shard that answers it, and loads the guardrails alongside. Covers funnel diagnosis, bid-cap campaigns, creatives, offers, sales pages, Instagram, upsell ladders, offer mining and market benchmarks for the BR/PT market. Use when working on a low ticket offer (roughly R$19 to R$97), a Meta Ads campaign for one, its sales page, its creatives, its upsell ladder, or when auditing why one is not converting. Do NOT use for SaaS, B2B, client websites, high ticket or mentorship funnels - the numbers here do not transfer.
3
+ description: Routes any low ticket direct-response question to the one knowledge shard that answers it, and loads the guardrails alongside. Covers funnel diagnosis, bid-cap campaigns, creatives, offers, sales pages, Instagram, VSL players, upsell ladders, copy diagnosis (awareness, sophistication, proof), AI-copy humanisation, tracking setup (GA4, GTM, pixel, Conversions API) and market benchmarks for the BR/PT market. Use when working on a low ticket offer (roughly R$19 to R$97), a Meta Ads campaign for one, its sales page, its creatives, its upsell ladder, or when auditing why one is not converting. Do NOT use for SaaS, B2B, client websites, high ticket or mentorship funnels - the numbers here do not transfer.
4
4
  ---
5
5
 
6
6
  # Low Ticket Methodology
7
7
 
8
- A knowledge base of 20 shards in Portuguese, plus a swipe file analysis of 155 real creatives. The knowledge is loaded **one shard at a time**: the full base is around 36k tokens, a typical answer needs under 5k.
8
+ A knowledge base of 25 shards in Portuguese, plus a swipe file analysis of 155 real creatives. The knowledge is loaded **one shard at a time**: the full base is well over 40k tokens, a typical answer needs under 5k.
9
9
 
10
10
  Everything below the surface of this skill is in Portuguese on purpose. The market it describes is Brazil and Portugal, and the vocabulary (`bid cap`, `connect rate`, `order bump`, `Utmify`, `Pix`) is how the operators actually speak. Answer the user in their language; read the shards as they are.
11
11
 
@@ -25,7 +25,7 @@ Never open two shards to find out which one it was. The INDEX has a third column
25
25
 
26
26
  This matters constantly. `wizz-offer-forge` defaults to a R$10-97 low ticket band and 7/15/30 day guarantees; this base pins price by source band (R$19,90 / R$27 / R$37), upsell at 2 to 2.5x the entry, and has an unresolved point about 7 vs 14 day guarantees. Same for `page-cro`, `paid-ads` and `ad-creative`: the generic skill has the technique, this base has the numbers for this market.
27
27
 
28
- The one thing that outranks a shard is `knowledge/guardrails.md`. Three tactics present in the source material are recorded there and **not adopted**: buying engagement, AI avatars passing as real people, and synthetic testimonials. They are blocked until the operation's owner decides otherwise. If a shard teaches one, the inline block line is there too.
28
+ The one thing that outranks a shard is `knowledge/guardrails.md`. Seven tactics present in the source material are recorded there and **not adopted**: buying engagement, AI avatars passing as real people, synthetic testimonials, borrowing a third party's ID document to verify a profile, using a real person's name as borrowed proof, reposting someone else's video as your own creative, and a struck-through reference price that was never charged. They are blocked until the operation's owner decides otherwise. If a shard teaches one, the inline block line is there too.
29
29
 
30
30
  ## Flow
31
31
 
@@ -56,6 +56,8 @@ A fonte de origem trata CPM/CPC baixo como resultado de **infraestrutura de cont
56
56
 
57
57
  **Redundância de acesso:** compartilhar o acesso à página entre perfis diferentes, como proteção contra perda de senha. Permite continuar operando as mesmas campanhas se um acesso cair.
58
58
 
59
+ **Idade da conta não é o fator.** Conta T1 contra conta T4 não faz diferença relevante para o teste inicial. O que faz a conta "cair" na prática é erro de pagamento ou de verificação, não o tempo de conta. A conta tem de ficar ativa e monitorada.
60
+
59
61
  > ⚠️ **Compra de engajamento — registrado, não recomendado.** A fonte de origem cita uma ferramenta paga para comprar likes e comentários em vídeos e inflar sinais de engajamento para o algoritmo. Isso é **engajamento inautêntico e viola os Termos da Meta**, com risco de banimento da conta e da BM — justamente os ativos que o resto desta seção está tentando proteger. Fica registrado porque está no material de origem, mas não entra como prática recomendada aqui. Ver [guardrails 20](guardrails.md).
60
62
 
61
63
  ### 3.7 A régua do gestor de tráfego
@@ -93,3 +95,19 @@ Este arquivo é o **prompt operacional de diagnóstico de campanha** de origem.
93
95
  **Uma mudança por vez.** Nunca trocar criativo + LP + checkout + orçamento + BidCap ao mesmo tempo: o resultado fica ilegível.
94
96
 
95
97
  > **Não mexer é decisão válida.** O prompt trata esperar por evidência suficiente como ação legítima, não como omissão. É a mesma postura da régua de 3x e do corte de 14 dias do minerador (12.5).
98
+
99
+ ### 3.9 Escala com Bid Cap: leitura de uma fonte externa
100
+
101
+ > ⚠️ **Fonte com ruído.** O arquivo é ata automática de uma live, e a transcrição está danificada em pontos verificáveis: caracteres chineses no lugar de "leilão", e um "$1.000 por impressão" que não faz sentido como número. **O que está abaixo é só o que sobrevive à conferência.** Número específico dessa fonte não entra em decisão sem checar a gravação.
102
+
103
+ **O mecanismo, dito de outra forma.** Bid Cap não é teto de orçamento: é teto de **preço por resultado**. Ele obriga o algoritmo a disputar leilão dentro desse limite, e o desperdício é cortado por recusa de leilão caro, não por fim de verba. Isso é a mesma régua de 3.7, com a ênfase deslocada do cálculo para o efeito.
104
+
105
+ **Qualidade antes de volume.** Escalar campanha com criativo fraco não escala nada, só acelera o gasto. Os anúncios que mais gastam costumam ser os melhores, e por isso devem ser testados isolados **antes** de puxar o funil inteiro para cima. Casa com 3.3 (análise no anúncio individual) e com 4.12 (validar no orgânico antes de subir).
106
+
107
+ **Orçamento sobe de cima para baixo.** Aumento periódico grande e planejado, não microajuste no meio do dia. O ajuste diário é o vício que reseta aprendizado. A régua numérica que vale continua a de 3.2 (máx. +30% ao dia) e a ordem de alavancas de 3.7 (Bid Cap primeiro, orçamento por último).
108
+
109
+ **Multi-serviço sem inchar a conta.** Operação com vários serviços (agência é o caso citado) usa **uma campanha Bid Cap por oferta específica**, mantendo as campanhas gerais de tráfego separadas. Cada oferta ganha espaço próprio de teste sem transformar a conta num emaranhado.
110
+
111
+ **Decidir rápido e assumir erro.** A paralisia analítica gasta em branco. Isto **não** licencia mexer antes da hora: a régua de 3x de 3.7 continua valendo, e "não mexer" continua sendo decisão válida. O alvo aqui é outro, é o gestor que já tem evidência e adia a decisão para não admitir que errou.
112
+
113
+ > **Duas divergências com 3.7 ficaram abertas:** a filosofia "day trade" (escalar agressivo, cortar imediato) contra a régua de 3x e a janela de 10 dias, e a ideia de separar em campanhas individuais quando o desempenho diverge, que 3.7 proíbe. Ver [pontos em aberto 39 e 40](pontos-em-aberto.md).
@@ -3,7 +3,7 @@
3
3
  > Shard da metodologia desta base. Índice: [`INDEX.md`](INDEX.md) · Sempre carregado junto: [`guardrails.md`](guardrails.md)
4
4
  > Onde a skill genérica contradisser este shard, **o shard vence**, e isso deve ser dito na resposta.
5
5
 
6
- **O que tem aqui:** `4.6` realismo em vídeo com IA · `4.9` imagens e avatares realistas · `4.13` avatares de fala, continuação de cena e pipeline sem marca d'água
6
+ **O que tem aqui:** `4.6` realismo em vídeo com IA · `4.9` imagens e avatares realistas · `4.13` avatares de fala, continuação de cena e pipeline sem marca d'água · `4.14` pipeline de 20 min para TikTok · `4.15` banco de ferramentas gratuitas
7
7
  **Irmãos:** fundamentos em [`04-criativos.md`](04-criativos.md) · roteiro, moldes e swipe file em [`04b-criativos-formatos.md`](04b-criativos-formatos.md)
8
8
  **Atenção:** avatar de IA passando por pessoa real é tática bloqueada — ver [guardrails 21](guardrails.md).
9
9
 
@@ -77,3 +77,49 @@ Material da aula prática focada na criação de vídeos com avatares falantes u
77
77
  ```text
78
78
  Generate a realistic vertical selfie video format. The character should speak naturally with perfect lip-sync to the audio. Capture an authentic, informal vibe with subtle hand tremors typical of holding a smartphone. Include natural micro-expressions, soft blinking, light head nods, and organic hand gestures emphasizing words. The mood should feel candid, friendly, and spontaneous. Background is a warm, softly lit everyday setting (like a living room or cozy cafe) remaining static with soft depth of field. Ultra-photorealistic 8k video quality.
79
79
  ```
80
+
81
+ ### 4.14 Pipeline de 20 minutos — criativo de vídeo para TikTok
82
+
83
+ > ⚠️ Avatar de IA apresentado como pessoa real: ver [guardrails 21](guardrails.md). Vale também a regra de lip-sync: nunca reaproveitar take de avatar cuja boca não corresponde 1:1 ao áudio da peça.
84
+
85
+ Mesma stack de §4.6, §4.9 e §4.13 — Google Flow, Eleven Labs, CapCut. O que muda aqui é a **ordem de operação e o tempo**, não a ferramenta.
86
+
87
+ **Preparar tudo antes de abrir qualquer ferramenta.** A fonte de origem monta um bloco de notas prévio com avatares, movimentos e cópias de áudio baseadas no prompt. Só depois disso abre Google Flow, Eleven Labs ou CapCut. É essa preparação que compra os 20 minutos, não a velocidade dentro de cada ferramenta.
88
+
89
+ **Fluxo:**
90
+
91
+ 1. Pedir ao Google Flow, via **prompt JSON**, o avatar em formato **selfie / falando para a câmera**, geração em **9:16**.
92
+ 2. Gerar a voz e, no mesmo Eleven Labs, **adaptar o sotaque** para pt-PT ou pt-BR ("mude somente as nuances, os jeitos e as gírias").
93
+ > Isso é adaptação de **sotaque no áudio**, e não substitui a **transcriação de texto** de §4.8 de [`04b-criativos-formatos.md`](04b-criativos-formatos.md). São duas operações diferentes; esta aula só cobre a primeira.
94
+ 3. Sincronizar lip-sync e editar no CapCut.
95
+ 4. Fechar a edição com legendas coloridas (mesma prática de §4.5 de [`04-criativos.md`](04-criativos.md)) e efeitos sonoros.
96
+
97
+ **Um cenário só, várias falas.** É o truque que torna o pipeline de 20 minutos viável: em vez de um cenário novo por vídeo, repete-se o mesmo cenário (exemplo da aula: uma cozinha) com falas diferentes, cortando com frequência e variando ângulo para manter o dinamismo visual.
98
+
99
+ **Detalhes de qualidade citados na aula:**
100
+
101
+ - Ajustar a **iluminação** do avatar melhora a precisão do lip-sync gerado por IA.
102
+ - **Transições sonoras tipo "riser"** reacendem a atenção do espectador ao longo do vídeo.
103
+ - **B-roll de banco de imagens e áudio** entre os cortes quebra a monotonia do cenário único.
104
+ - Exportar a **30 fps**. A fonte de origem é explícita: 60 fps deixa o arquivo mais pesado sem ganho.
105
+
106
+ ### 4.15 Banco de ferramentas — alternativas gratuitas
107
+
108
+ > ⚠️ **Duas táticas desta aula não são adotadas.** Descarregar vídeo de terceiro do TikTok (com ou sem marca d'água) para rodar como criativo próprio, e usar imagem de pessoa de outro país para "testar aceitação" sem direito de uso. Motivo e alternativa em [guardrails 45](guardrails.md). O resto da aula — bancos gratuitos, alternativa de voz, TikTok como referência para ESTUDAR formato — continua valendo.
109
+
110
+ A parte do TikTok que fica valendo é usar a plataforma para **observar e modelar formato** (o que está funcionando, como estão cortando, que ganchos usam), nunca para extrair o arquivo de outra pessoa e reaproveitar como próprio.
111
+
112
+ > 💡 Os nomes abaixo vêm de **ata automática de aula, com transcrição danificada**. Onde a grafia é duvidosa, o nome está marcado como leitura provável e **não verificado**. Conferir antes de instalar ou assinar qualquer ferramenta.
113
+
114
+ | Ferramenta | Para que serve | Nota |
115
+ |---|---|---|
116
+ | **MiniMax** (ata grafa "Minimax IO") | Geração de voz — alternativa gratuita ao Eleven Labs | Comparada na aula com o TurboScribe |
117
+ | **TurboScribe** | Transcrição | Citada em comparação com o MiniMax |
118
+ | **Magnific** (ata grafa "Magnifique") | Geração/tratamento de imagem | — |
119
+ | **Pexels** | Banco gratuito de imagem e vídeo | — |
120
+ | **TikTok** | Fonte de B-roll e referência para estudar formato | Só para observar/modelar — ver aviso acima, nunca para baixar e reaproveitar vídeo alheio |
121
+ | "Coque Coque" na ata — provavelmente o navegador **Cốc Cốc**, que tem descarregador de vídeo embutido | Descarregar vídeo do TikTok sem marca d'água | **Nome não confirmado: verificar antes de instalar.** E o próprio uso está bloqueado — ver aviso acima |
122
+
123
+ **Não identificado:** a ata cita "Eddes" em comparação com o Eleven Labs, sem contexto suficiente para saber a que ferramenta se refere. Registrado aqui como pendente, não como recomendação.
124
+
125
+ **Pendente de esclarecimento:** "YouTube Russo", citado na ata para avatares realistas e formato de perguntas e respostas, não tem contexto suficiente na fonte para identificar do que se trata. Não incorporado até nova fonte esclarecer.
@@ -3,7 +3,7 @@
3
3
  > Shard da metodologia desta base. Índice: [`INDEX.md`](INDEX.md) · Sempre carregado junto: [`guardrails.md`](guardrails.md)
4
4
  > Onde a skill genérica contradisser este shard, **o shard vence**, e isso deve ser dito na resposta.
5
5
 
6
- **O que tem aqui:** `4.7` VSL em 6 blocos · `4.8` transcriação pt-BR → pt-PT · `4.10` swipe file de 155 peças · `4.11` os 14 moldes de formato visual · `4.11-A` o que o swipe file realmente usa
6
+ **O que tem aqui:** `4.7` VSL em 6 blocos · `4.8` transcriação pt-BR → pt-PT · `4.10` swipe file de 155 peças · `4.11` os 14 moldes de formato visual · `4.11-A` o que o swipe file realmente usa · `4.11-B` os formatos orgânicos de 2026
7
7
  **Irmãos:** fundamentos em [`04-criativos.md`](04-criativos.md) · produção com IA em [`04a-criativos-ia.md`](04a-criativos-ia.md)
8
8
 
9
9
  ### 4.7 Estrutura da VSL — 6 blocos
@@ -19,9 +19,12 @@ Estrutura fechada, na ordem, para VSL de oferta digital. Duração alvo da aula:
19
19
  | 5 | CTA | Chamada explícita: onde clica, o que preenche, quando recebe |
20
20
  | 6 | Perguntas | Quebra de objeção final, o FAQ dito em vídeo |
21
21
 
22
+ > 🔗 **Versão fina desta lista:** os **7 blocos** de [`18-copy-desejo-oferta.md`](18-copy-desejo-oferta.md) §18.8, que separam `Quem fala` de `História` e nomeiam o bloco `Tese` (o mecanismo), que esta lista de 6 esconde dentro de `Produto`. O mapa entre as duas está no [Ponto em aberto 47](pontos-em-aberto.md). Os 6 continuam válidos como checagem rápida.
23
+ >
22
24
  > **Retenção vem da ordem, não da produção.** A fonte de origem insiste que a autoridade se constrói no bloco de história — pular direto para o produto é o erro que derruba a retenção.
23
25
  >
24
- > ⚠️ Essa duração de 7-9 min conflita com os 90s-2min da seção 11.3 para low ticket. Ver [Ponto em aberto 18](pontos-em-aberto.md).
26
+ > ⚠️ Essa duração de 7-9 min conflita com os 90s-2min da seção 11.3 para low ticket.
27
+ > **Regra adotada (2026-08-28):** o que decide é o que a VSL precisa provar. Produto que se prova na tela (showrun) fica em 90s-2min; oferta que precisa construir mecanismo e autoridade antes do preço fica em 7-9 min. A estrutura de 6 blocos vale nos dois, muda só o tempo de cada bloco. No empate, comece curto. Ver [Ponto em aberto 18](pontos-em-aberto.md).
25
28
 
26
29
  ### 4.8 Transcriação pt-BR → pt-PT
27
30
 
@@ -150,3 +153,31 @@ Classifiquei as 155 peças de 4.10 também neste segundo eixo, olhando os frames
150
153
  > ⚠️ **Cuidado de leitura.** O PDF é a amostra grátis de um pack de **50 formatos** (as próprias páginas dizem "clique no botão para ver o resto dos 50 formatos que escalam"). Ou seja, **o material é ele mesmo um criativo de venda**, e os números que ele cita ("ROI 3", "escalou 10x", "o CTR vai lá em cima, o ROI dispara e o CPC cai") são **copy de anúncio, não benchmark**. Nenhum deles tem lastro. Use os moldes; ignore os números.
151
154
  >
152
155
  > Os moldes que imitam interface de terceiro (`CHOQUEI`, `NOTÍCIA`, `TWEET`, `LIVE`, `GOOGLE MEET`) exigem cuidado: imitar o **layout** é prática comum, mas usar marca, logo ou nome de veículo real vira uso indevido de marca e risco de reprovação na Meta. Manter a moldura genérica, como está no template.
156
+
157
+ ### 4.11-B Os formatos orgânicos de 2026
158
+
159
+ Aula sobre os formatos que estão a funcionar **no orgânico**. O princípio não é novidade — §4.4 e §4.11 já mandam o criativo se disfarçar de conteúdo nativo. O que a fonte de origem acrescenta é a **lista atualizada** de formatos em alta e uma **rotina de garimpo** para os encontrar.
160
+
161
+ > Fonte é ata automática de reunião, não transcrição revisada. Números, timestamps e o exemplo de ferramentas abaixo vêm dessa ata: tratar como ilustrativo, não como benchmark.
162
+
163
+ **1. Reconciliação com os 14 moldes de §4.11.**
164
+
165
+ | Formato citado na aula | Molde de §4.11 | Situação |
166
+ |---|---|---|
167
+ | tela dividida | `TELA DIVIDIDA` | já catalogado |
168
+ | caixinha de perguntas | `CAIXINHA` | já catalogado |
169
+ | fofoca | `CHOQUEI` | já catalogado |
170
+ | POV | `MEME` / `POV + DEPOIMENTO` | já catalogado |
171
+ | Tierlist | `RANKING` | já catalogado |
172
+ | **quadro branco** | — | **molde novo, não está nos 14** |
173
+ | **UGC** | — | **não é molde visual, é origem do material** |
174
+
175
+ `UGC` não entra na tabela de moldes porque mede outra coisa: os 14 moldes de §4.11 classificam a **moldura de interface** que o criativo simula (notícia, tweet, live...); `UGC` classifica **quem parece ter filmado** — conteúdo com cara de feito pelo utilizador, não pela marca. É o mesmo tipo de eixo independente que §4.11 já registra para ângulo × formato de fala × formato visual: `UGC` pertence ao eixo de §4.3/§4.5 (formato de fala e produção), não à taxonomia visual desta seção.
176
+
177
+ **2. O achado que muda decisão de produção.** Cruzando com §4.11-A: `RANKING` aparece em **0 das 155 peças** do swipe file, e `TELA DIVIDIDA` em só **7%**. A fonte de origem empurra justamente o Tierlist — a versão de venda do `RANKING` — como formato de aposta. Leitura: o swipe file é retrato de um momento anterior (catalogado em 2026-08-22; esta aula é de 2026-09-09), e `RANKING`/Tierlist é **terreno vazio** — nenhum concorrente do swipe usa. É oportunidade real, mas é oportunidade **não validada nesta operação**: nenhum dado das 155 peças mostra que Tierlist converte, só que ninguém tentou. As duas leituras ficam de pé ao mesmo tempo: vale testar, não vale assumir que já funciona.
178
+
179
+ **3. O ângulo de oferta.** A fonte de origem usa o Tierlist não só como formato de criativo, mas como **argumento de oferta**: uma lista curada que une várias ferramentas (o exemplo da ata é juntar Figma e After Effects) vende a ideia de pack ao mesmo tempo em que informa — formato e oferta colapsam num único criativo. Isso liga direto à oferta "pack de ferramentas": ver [`12-mineracao-ofertas.md`](12-mineracao-ofertas.md) para a régua de mineração e validação desse tipo de oferta antes de produzir o criativo em cima dela.
180
+
181
+ **4. A rotina de garimpo.** A fonte de origem recomenda consumir Reels, Stories e TikTok diariamente para identificar o formato que está a correr, em vez de repetir criativo estático. Isso não é a mesma coisa que §4.12 (validação orgânico-pago): §4.12 valida o **seu** criativo já pronto no orgânico antes de subir como pago; esta rotina descobre **qual formato tentar**, um passo antes, olhando o orgânico alheio. Sequência: garimpar formato (aqui) → produzir → validar no orgânico (§4.12) → subir pago.
182
+
183
+ **5. Cuidado.** A fonte de origem fala em "disfarçar a ideia de venda". O limite é o mesmo de §4.4 e dos moldes de §4.11: parecer nativo do feed, sim; esconder que é anúncio ao ponto de enganar sobre o que está a ser vendido, não. Anúncio pago continua a ser identificado como pago pela plataforma — disfarce de moldura não é disfarce de natureza comercial.
@@ -21,11 +21,11 @@ Reduzir tempo e esforço percebidos permite cobrar mais.
21
21
 
22
22
  ### 5.3 Preço e planos
23
23
 
24
- - **Modelo de dois planos**, não preço único. Ex. Portugal: Essencial $790 e Premium $1490, com propósitos diferentes no funil.
24
+ - **Modelo de dois planos**, não preço único. *(Regra adotada em 2026-08-28: vale de R$47 para cima. Até R$37 a página é de preço único, pela anatomia de 12.7-A. Ver [Ponto em aberto 25](pontos-em-aberto.md).)* Ex. Portugal: Essencial $790 e Premium $1490, com propósitos diferentes no funil.
25
25
  - Ancoragem sempre visível: "de R$ X por R$ Y".
26
26
  - Selo "mais vendido" para guiar o olho ao plano principal.
27
27
  - **Decoy**: plano isca que faz o principal parecer óbvio.
28
- - **Order bump apenas no plano premium**; remover do básico aumenta a conversão de entrada, mantê-lo no premium sobe o ticket.
28
+ - **Order bump apenas no plano premium**; remover do básico aumenta a conversão de entrada, mantê-lo no premium sobe o ticket. *(Isto responde ONDE. Quantos é 11.4: 3 a 5 ativos no checkout que tem bump. Ver [Ponto em aberto 8](pontos-em-aberto.md).)*
29
29
  - **Pop-up no clique do plano básico** oferecendo o VIP com desconto agressivo. O básico existe para gerar o clique; o pop-up é onde o ticket sobe.
30
30
  - Nome evocativo nos planos aumenta engajamento emocional.
31
31
 
@@ -37,13 +37,16 @@ Reduzir tempo e esforço percebidos permite cobrar mais.
37
37
 
38
38
  O que transforma um produto comum em oferta exclusiva. É a soma de duas peças:
39
39
 
40
+ > 📐 **A fórmula de redação do mecanismo** (o vilão com nome, o herói com nome) está em [`18-copy-desejo-oferta.md`](18-copy-desejo-oferta.md) §18.5. Esta seção define o que o mecanismo **é**; a 18.5 dá a frase pronta.
41
+
40
42
  - **Mecanismo do problema**: a causa raiz que impede o cliente de ter o resultado (ex.: homens 40+ não emagrecem porque o problema é hormonal, não de dieta).
41
43
  - **Mecanismo da solução**: o método comprovado que ataca essa causa raiz (ex.: treino que restabelece o metabolismo; método de alfabetização validado por Harvard).
42
44
 
43
45
  **Regras:**
44
46
 
45
- - **Promessa atrai, mecanismo converte.** A headline carrega só a promessa/transformação ("Emagreça 10kg"); a explicação do mecanismo fica na VSL, que é o canal principal para transmiti-lo (áudio + imagem + comprovação visual).
46
- - Ancorar o mecanismo em evidência verificável (estudo, metodologia validada) reforça o item 4 do framework em 5.2.
47
+ - **Promessa atrai, mecanismo converte.** A **explicação** do mecanismo fica na VSL, que é o canal principal para transmiti-lo (áudio + imagem + comprovação visual).
48
+ > 📌 **A headline nomeia, a VSL explica** *(regra adotada em 2026-09-09, ver [Ponto em aberto 46](pontos-em-aberto.md))*. Esta linha proíbe **explicar** o mecanismo na headline, não **nomeá-lo**. Na página de vendas a headline carrega o mecanismo com nome (§18.13 de [`18-copy-desejo-oferta.md`](18-copy-desejo-oferta.md)); no gancho de criativo ele entra nos primeiros 5 segundos, não na primeira linha. Em mercado de estágio 1-2 (§18.4) a promessa sozinha basta; de 3 para cima, o mecanismo entra.
49
+ - Ancorar o mecanismo em evidência verificável (estudo, metodologia validada); reforça o item 4 do framework em 5.2.
47
50
  - **Modelar antes de criar**: estudar os grandes especialistas do nicho (biblioteca de anúncios + YouTube) para identificar os mecanismos ativos; modelar um existente é válido, criar do zero exige pesquisa de mercado.
48
51
  - Sem mecanismo, o cliente já conhece a oferta: ela vira commodity comparável às concorrentes.
49
52
  - Vale para qualquer ticket: low ticket de R$ 9 escala do mesmo jeito se o mecanismo for bem estruturado.
@@ -3,6 +3,8 @@
3
3
  > Shard da metodologia desta base. Índice: [`INDEX.md`](INDEX.md) · Sempre carregado junto: [`guardrails.md`](guardrails.md)
4
4
  > Onde a skill genérica contradisser este shard, **o shard vence**, e isso deve ser dito na resposta.
5
5
 
6
+ **Irmãos:** perfil e Instagram em [`06a-instagram.md`](06a-instagram.md) · os dois prompts do player de VSL em [`06b-player-vsl.md`](06b-player-vsl.md)
7
+
6
8
  ### 6.1 Anatomia de 12 blocos
7
9
 
8
10
  | # | Bloco | Status | Função |
@@ -22,7 +24,7 @@
22
24
 
23
25
  Essa estrutura converteu em 90% das ofertas rodadas.
24
26
 
25
- **Por que cada bloco existe.** Os dois exemplos de página analisados são **Pack de Planilhas** (R$10, infoproduto genérico) e **ViviTrick** (assistente de mira para jogo, público jovem).
27
+ **Por que cada bloco existe.** As duas páginas analisadas são um **pack de planilhas** (R$10, infoproduto genérico, público amplo) e um **assistente de mira para jogo** (público jovem, compra por impulso).
26
28
 
27
29
  | # | O trabalho do bloco | O mecanismo psicológico |
28
30
  |---|---------------------|--------------------------|
@@ -41,17 +43,17 @@ Essa estrutura converteu em 90% das ofertas rodadas.
41
43
 
42
44
  **Padrões de oferta extraídos dos dois exemplos (bloco 08):**
43
45
 
44
- - **Pack de Planilhas:** Básico R$10 contra Premium R$19,90, com valor total riscado de R$147. Order bump sobe o ticket.
45
- - **ViviTrick:** três opções onde a terceira é o alvo. Mensal R$4,99, trimestral R$9,99, permanente R$13,90 (de R$358). Os dois primeiros são isca para fazer o permanente parecer óbvio.
46
+ - **Pack de planilhas:** Básico R$10 contra Premium R$19,90, com valor total de R$147 exibido como ancoragem. Order bump sobe o ticket.
47
+ - **Assistente de mira:** três opções onde a terceira é o alvo. Mensal R$4,99, trimestral R$9,99, permanente R$13,90 (ancorado em R$358). Os dois primeiros são isca para fazer o permanente parecer óbvio.
46
48
 
47
49
  > Regra que aparece nos dois: o plano-alvo nunca é o mais barato nem aparece sozinho. Ele aparece cercado de opções que existem para fazê-lo parecer a escolha racional.
48
50
 
49
- **Notas de copy dos exemplos:**
51
+ **O que a copy das duas páginas faz (o mecanismo, não a frase):**
50
52
 
51
- - Headline do Pack: "Pacote com +13 mil planilhas profissionais. Economize tempo e dinheiro."
52
- - Headline da ViviTrick embute prova + quebra de objeção: "O assistente de mira que transformou +15.000 players numa máquina de capa. 100% aprovado pela Garena, nunca deu ban."
53
- - Bloco de dor da ViviTrick nomeia o público direto: pra você que não aceita mais perder x1 pros amigos."
54
- - Blocos 01 e 09 são opcionais e entram conforme o tamanho da página; a ViviTrick abre direto no headline, sem barra de urgência.
53
+ - A do pack de planilhas monta a headline sobre **quantidade + economia**: número de itens entregues, seguido do que a pessoa deixa de gastar. Promessa de commodity, resolvida por volume.
54
+ - A do assistente de mira empilha **prova e quebra de objeção dentro da própria headline**: número de usuários, a transformação em uma imagem, e a objeção principal do nicho (risco de punição) negada na mesma linha.
55
+ - O bloco de dor da segunda **nomeia o público em vez de descrever o problema**: fala com quem se reconhece na situação, não com quem tem o sintoma.
56
+ - Blocos 01 e 09 são opcionais e entram conforme o tamanho da página. A segunda abre direto na headline, sem barra de urgência.
55
57
 
56
58
  ### 6.2 Regras de copy e layout
57
59
 
@@ -50,6 +50,15 @@ Passou nos cinco, compra pela bio ou pelo story. Falhou em um, sai — e o cliqu
50
50
 
51
51
  **Sinais de conta fake** (marcou 3 ou mais, não sobe tráfego ainda): sem foto, @ com número, bio genérica, menos de 5 posts, zero destaque, comentários desativados, story parado há uma semana.
52
52
 
53
+ ### 6A.3-A Verificação do perfil — categoria Comunidade
54
+
55
+ - Checar se o perfil está na categoria **"Comunidade"**, que é a mais fácil de verificar.
56
+ - Usar foto coerente com o documento de identidade **da própria pessoa** (mesmo nome, mesmo gênero).
57
+ - **Efeito relatado:** CPA e CPM mais baixos mesmo sem o selo oficial de verificado.
58
+ - Útil sobretudo para operar em mercados como Portugal.
59
+
60
+ > A fonte também ensina a enviar documento de **terceiro** (o exemplo dado é usar o documento da mãe) para passar a verificação. **Este projeto não faz isso.** Ver [`guardrails.md`](guardrails.md) item 32 e [Ponto em aberto 32](pontos-em-aberto.md).
61
+
53
62
  ### 6A.4 Destaques — organize por objeção, não por assunto
54
63
 
55
64
  A ordem que mata objeção:
@@ -0,0 +1,79 @@
1
+ ## 6-B. Player de VSL customizado — as duas especificações
2
+
3
+ > Shard da metodologia desta base. Índice: [`INDEX.md`](INDEX.md) · Sempre carregado junto: [`guardrails.md`](guardrails.md)
4
+ > Onde a skill genérica contradisser este shard, **o shard vence**, e isso deve ser dito na resposta.
5
+
6
+ **O que tem aqui:** `6B.1` especificação de player próprio estilo VTurb · `6B.2` especificação para substituir o embed do YouTube · `6B.3` o que cada especificação resolve
7
+ **Irmão:** anatomia da página e connect rate em [`06-pagina-vendas.md`](06-pagina-vendas.md)
8
+
9
+
10
+ §6.3 e §6.4 de [`06-pagina-vendas.md`](06-pagina-vendas.md) já dizem **que** se usa capa estática e player customizado no lugar do embed padrão — "capa estática no lugar do player, que vira o LCP" e "player de vídeo customizado sobre YouTube, com controles parecidos com os do VTurb". Este shard traz as duas especificações operacionais que dizem **como**.
11
+
12
+ ### 6B.1 Especificação: player próprio, estilo VTurb
13
+
14
+ Cobre: posição do player logo abaixo da headline sem conteúdo intermediário, autoplay mudo, aviso "Clique para ouvir", barra de progresso não clicável, ocultar a duração, bloquear pause/seek, responsivo, animação de pulsar no botão de som, pausar ao sair da tela e retomar ao voltar.
15
+
16
+ > **Regra adotada (2026-09-04, decisão do dono da operação).** A barra adiantada fica: é o comportamento padrão de player de VSL no nicho, não viola termo de plataforma nenhum e não põe a conta em risco. A especificação vale inteira, item 10 incluído. Registrado em [Ponto em aberto 33](pontos-em-aberto.md) porque é padrão escuro assumido, não porque esteja proibido.
17
+
18
+ O player recebe a URL do vídeo (hospedado externamente) como parâmetro de entrada e usa essa URL como fonte. Ele fica posicionado imediatamente após a headline principal da página, sem nenhum conteúdo intermediário: headline principal → player da VSL → restante da página. A partir daí, valem estes requisitos de design e comportamento:
19
+
20
+ 1. O vídeo inicia automaticamente mudo (autoplay muted).
21
+ 2. O canto superior do player mostra o texto "Clique para ouvir" junto com um ícone de som/mudo.
22
+ 3. Ao clicar no botão, o áudio é ativado e o aviso desaparece.
23
+ 4. A parte inferior do player tem uma barra de progresso estilo cronômetro, minimalista, que avança conforme o vídeo, não aceita clique nem arraste (só visual) e usa as cores principais do site.
24
+ 5. A duração total do vídeo fica totalmente oculta (nenhum tempo total é mostrado).
25
+ 6. O player bloqueia qualquer pausa ou avanço: sem botão de pause, sem botão de avançar, timeline não clicável.
26
+ 7. Visual limpo, minimalista, sem distrações.
27
+ 8. Player totalmente responsivo: mobile, tablet e desktop.
28
+ 9. O botão "Clique para ouvir" tem animação leve (pulsar/fade) para incentivar o clique.
29
+ 10. Barra de progresso, comportamento simulado (especificação técnica, não é 1:1 com `currentTime`/`duration`): calcula-se um progresso visual `P_vis` que tende a ficar adiantado em relação ao progresso real do vídeo, para dar a sensação de que ele "avança rápido e está quase terminando", sem chegar a mentir por completo sobre quanto falta. Implementação de referência:
30
+ - `t_real` = tempo atual do vídeo (`video.currentTime`); `d` = duração total (`video.duration`).
31
+ - `leadFactor` inicial entre 1.05 e 1.25 (fator que faz o progresso visual andar mais rápido que o real) — por exemplo, 1.15.
32
+ - `P_target = clamp((t_real * leadFactor) / d, 0, 0.95)`, ou seja, nunca deixar `P_target` chegar a 0.95 cedo demais.
33
+ - Inserir de 1 a 3 pausas/plateaus curtos e aleatórios em `P_vis` (200 a 800ms cada) para reforçar a sensação de "quase lá, mas ainda não".
34
+ - Quando `t_real` atinge `d * 0.9` (últimos 10% do vídeo), remover o limite e fazer um catch-up suave: interpolar `P_vis` até 1.0 sincronizando com os segundos reais restantes (ease-out rápido), garantindo que a barra chegue a 100% perto do fim real do vídeo.
35
+ - Nunca mostrar 100% antes do vídeo terminar de fato.
36
+ - O movimento da barra usa easing suave (ex.: `cubic-bezier(.2,.9,.2,1)`) para evitar saltos bruscos.
37
+ - As cores da barra usam as cores principais do site, expostas como variáveis CSS para facilitar customização.
38
+ - A barra é só indicativa: não é interativa, não mostra tempo, não permite seek.
39
+ 11. Se o usuário rolar a página para baixo e o player sair parcial ou totalmente da tela, o vídeo pausa automaticamente.
40
+ 12. Quando o scroll trouxer o player de volta à área visível, o vídeo pode retomar automaticamente do ponto onde parou.
41
+ 13. O player fica logo abaixo da headline principal, com estrutura limpa e focada em conversão.
42
+
43
+ Entregável: código completo em HTML, CSS e JavaScript implementando este player totalmente customizado, usando a URL do vídeo informada como fonte.
44
+
45
+ ### 6B.2 Especificação: substituir o embed do YouTube
46
+
47
+ Cobre: thumbnail `https://img.youtube.com/vi/{VIDEO_ID}/maxresdefault.jpg` como estado inicial, troca para iframe com autoplay ao clicar, overlay com cor de destaque a 50% de opacidade, textos "Seu vídeo já começou" e "Clique para ouvir", ícone de alto-falante mutado, animação de pulse, componente client-side, responsivo. Esta especificação **não tem** bloqueio: é a implementação concreta do que §6.3 já pede (capa estática vira o LCP, script entra na primeira intenção).
48
+
49
+ Problema que resolve: o embed padrão do YouTube polui a interface, especialmente no mobile, com elementos indesejados — logo do YouTube, botão "assistir no YouTube", título do vídeo, foto de perfil do canal.
50
+
51
+ Comportamento:
52
+
53
+ - Estado inicial: mostra a thumbnail do vídeo do YouTube como imagem estática (`https://img.youtube.com/vi/{VIDEO_ID}/maxresdefault.jpg`), com um overlay/botão centralizado por cima incentivando o clique.
54
+ - Ao clicar: substitui a thumbnail pelo iframe do YouTube com autoplay ativado (`?autoplay=1&rel=0&modestbranding=1&playsinline=1`), reproduzindo o vídeo direto na página.
55
+
56
+ Design do botão overlay:
57
+
58
+ - Caixa centralizada sobre a thumbnail, com cantos arredondados.
59
+ - Cor de fundo: a cor de destaque/accent do site, a 50% de opacidade, para o rosto/thumbnail ficar visível por trás.
60
+ - Textos e ícone em preto (ou em cor que contraste com o accent do site).
61
+ - Texto superior: "Seu vídeo já começou".
62
+ - Ícone central: alto-falante mutado (ondas sonoras com linha diagonal cortando).
63
+ - Texto inferior: "Clique para ouvir".
64
+ - Tamanho compacto: não domina a thumbnail, só chama atenção.
65
+ - Animação de pulse infinita: o botão pulsa suavemente (cerca de 6% de scale, mais intensificação do glow/shadow) em loop de 2 segundos.
66
+ - Efeito hover: leve scale up adicional.
67
+
68
+ Requisitos técnicos:
69
+
70
+ - Componente client-side (`'use client'`) com estado para alternar entre thumbnail e iframe.
71
+ - Responsivo: tamanhos menores no mobile, maiores no desktop.
72
+ - Overlay escuro sutil (`bg-black/25`) sobre a thumbnail inteira, para dar profundidade antes do botão.
73
+
74
+ ### 6B.3 O que cada especificação resolve
75
+
76
+ | Especificação | Resolve |
77
+ |---|---|
78
+ | 6B.1 (player próprio) | controle da sessão de visualização — autoplay mudo, sem pause/seek, retomar ao voltar à tela |
79
+ | 6B.2 (substituir embed) | performance e limpeza visual no mobile — o embed padrão do YouTube polui com logo, título, foto do canal e botão "assistir no YouTube" |