wizz-method 2.21.0 → 2.22.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 (80) hide show
  1. package/THIRD-PARTY-NOTICES.md +18 -0
  2. package/package.json +4 -2
  3. package/skills-registry.yaml +41 -0
  4. package/src/bmm-skills/1-analysis/wizz-set-feature/SKILL.md +1 -1
  5. package/src/bmm-skills/4-implementation/wizz-code-review/SKILL.md +1 -1
  6. package/src/bmm-skills/4-implementation/wizz-create-story/SKILL.md +1 -1
  7. package/src/bmm-skills/4-implementation/wizz-dev-story/SKILL.md +8 -1
  8. package/src/bmm-skills/4-implementation/wizz-quick-dev/SKILL.md +2 -2
  9. package/src/bmm-skills/4-implementation/wizz-quick-dev/step-03-implement.md +2 -0
  10. package/src/bmm-skills/4-implementation/wizz-sprint-status/SKILL.md +1 -1
  11. package/src/core-skills/wizz-party-mode/customize.toml +3 -3
  12. package/src/modules/lowticket/skills/wizz-lowticket-trafego/references/reguas.md +2 -0
  13. package/src/modules/wizz/_shared/cerebro.md +1 -1
  14. package/src/modules/wizz/_shared/organizacao.md +2 -2
  15. package/src/modules/wizz/agents/wizz-copy/SKILL.md +1 -0
  16. package/src/modules/wizz/agents/wizz-copy/customize.toml +5 -0
  17. package/src/modules/wizz/agents/wizz-copy/knowledge/playbook.md +2 -1
  18. package/src/modules/wizz/agents/wizz-social/knowledge/blueprint-roteiro-viral.md +14 -0
  19. package/src/modules/wizz/agents/wizz-social/knowledge/legenda-instagram.md +12 -0
  20. package/src/skills-lib/wizz-cerebro/SKILL.md +18 -5
  21. package/src/skills-lib/wizz-design-needs/SKILL.md +7 -0
  22. package/src/skills-lib/wizz-design-needs/references/design-state.md +34 -2
  23. package/src/skills-lib/wizz-design-needs/references/gap-analysis.md +1 -1
  24. package/src/skills-lib/wizz-design-needs/scripts/design_state.py +305 -0
  25. package/src/skills-lib/wizz-design-needs/scripts/tests/test_design_state.py +143 -0
  26. package/src/skills-lib/wizz-impeccable/references/design-rules.md +18 -0
  27. package/src/skills-lib/wizz-motion-3d-director/references/motion-paths.md +2 -0
  28. package/src/skills-lib/wizz-paid-ads/SKILL.md +2 -1
  29. package/src/skills-lib/wizz-premium-landing-ui-researcher/SKILL.md +6 -2
  30. package/src/skills-lib/wizz-premium-landing-ui-researcher/references/audit-protocol.md +7 -34
  31. package/src/skills-lib/wizz-premium-landing-ui-researcher/references/component-sources.md +2 -0
  32. package/src/skills-lib/wizz-premium-landing-ui-researcher/references/design-sources.yaml +252 -0
  33. package/src/skills-lib/wizz-premium-landing-ui-researcher/references/mandatory-process.md +1 -1
  34. package/src/skills-lib/wizz-premium-landing-ui-researcher/references/mining-rubric.md +123 -0
  35. package/src/skills-lib/wizz-premium-landing-ui-researcher/references/source-first-protocol.md +10 -4
  36. package/src/skills-lib/wizz-premium-landing-ui-researcher/references/web-access-and-evidence.md +1 -1
  37. package/src/skills-lib/wizz-premium-landing-ui-researcher/scripts/design_sources.py +221 -0
  38. package/src/skills-lib/wizz-premium-landing-ui-researcher/scripts/tests/test_design_sources.py +130 -0
  39. package/src/skills-lib/wizz-router/references/routing-table-flat.md +2 -0
  40. package/src/skills-lib/wizz-taste-skill/references/anti-slop-tells.md +8 -0
  41. package/src/skills-lib/wizz-ui-component-curator/SKILL.md +8 -7
  42. package/src/skills-lib/wizz-video-effects/LICENSE-motionmaxxing.txt +202 -0
  43. package/src/skills-lib/wizz-video-effects/SKILL.md +5 -2
  44. package/src/skills-lib/wizz-video-effects/assets/chrome/collect_layout.js +113 -0
  45. package/src/skills-lib/wizz-video-effects/assets/effects.config.template.json +35 -0
  46. package/src/skills-lib/wizz-video-effects/references/data-contract.md +30 -1
  47. package/src/skills-lib/wizz-video-effects/references/gates.md +3 -1
  48. package/src/skills-lib/wizz-video-effects/scripts/check_chrome.py +376 -0
  49. package/src/skills-lib/wizz-video-effects/scripts/check_dead_frames.py +193 -0
  50. package/src/skills-lib/wizz-video-effects/scripts/config.py +13 -0
  51. package/src/skills-lib/wizz-video-effects/scripts/test_chrome.py +181 -0
  52. package/src/skills-lib/wizz-video-effects/scripts/test_dead_frames.py +171 -0
  53. package/src/skills-lib/wizz-video-styles/SKILL.md +6 -2
  54. package/src/skills-lib/wizz-video-styles/references/motion-laws.md +62 -0
  55. package/src/skills-lib/wizz-video-styles/references/styles/desafio-numero.md +1 -0
  56. package/src/skills-lib/wizz-video-styles/scripts/blind_review.py +159 -0
  57. package/src/skills-lib/wizz-video-styles/scripts/taste.mjs +110 -0
  58. package/src/skills-lib/wizz-video-styles/scripts/test_blind_review.py +82 -0
  59. package/src/skills-lib/wizz-vsl/LICENSE +49 -0
  60. package/src/skills-lib/wizz-vsl/SKILL.md +122 -0
  61. package/src/skills-lib/wizz-vsl/references/assembly-qa.md +123 -0
  62. package/src/skills-lib/wizz-vsl/references/blocks-and-leads.md +149 -0
  63. package/src/skills-lib/wizz-vsl/references/diagnosis.md +95 -0
  64. package/src/skills-lib/wizz-vsl/references/intake.md +200 -0
  65. package/src/skills-lib/wizz-vsl/references/mechanisms.md +138 -0
  66. package/src/skills-lib/wizz-vsl/references/niches.md +40 -0
  67. package/src/skills-lib/wizz-vsl/references/offer.md +91 -0
  68. package/src/skills-lib/wizz-vsl/references/production.md +75 -0
  69. package/tools/hooks/README.md +10 -9
  70. package/tools/hooks/wizz-arrumar.js +1 -0
  71. package/tools/hooks/wizz-artifact-guard.js +31 -5
  72. package/tools/hooks/wizz-cerebro-lib.js +36 -13
  73. package/tools/hooks/wizz-feature-lib.js +4 -1
  74. package/tools/hooks/wizz-feature.js +66 -76
  75. package/tools/hooks/wizz-sprint-archive-lib.js +311 -0
  76. package/tools/installer/core/hooks-settings.js +1 -0
  77. package/tools/installer/core/installer.js +6 -0
  78. package/tools/installer/modules/core-seed.js +72 -0
  79. package/tools/installer/modules/mcp-config.js +3 -0
  80. package/tools/installer/ui.js +16 -26
@@ -0,0 +1,95 @@
1
+ # Phase 2 · Market diagnosis (Schwartz)
2
+
3
+ > Three questions, in this order, **before** any mechanism or lead. Getting this wrong means a technically correct VSL that speaks to a market that does not exist. When the Piva research exists, its awareness-levels report is the first evidence: quote it.
4
+
5
+ ## 1. What is the mass desire?
6
+
7
+ Copy does not create desire. It **channels a desire that already exists** toward the product. If the desire is not in the market, no headline saves it.
8
+
9
+ Pick **ONE** dominant desire, not three. Score each candidate from 1 to 5 on three axes and the highest sum wins (not the noblest, not the expert's favourite):
10
+
11
+ | Axis | Question | Why it matters |
12
+ |---|---|---|
13
+ | **Urgency** | How strongly does she feel it *today*? | An urgent desire buys now |
14
+ | **Permanence** | Felt for years, or a fad? | A permanent desire sustains an evergreen funnel |
15
+ | **Reach** | How many in the audience share it? | Reach sets the scaling ceiling |
16
+
17
+ **Tie:** highest urgency wins. If the audience has two sub-profiles with different desires, pick the dominant one for the lead and treat the other as a secondary layer inside the VSL. Never write one lead for both.
18
+
19
+ **Test:** if a competitor could satisfy this desire tomorrow, would the audience buy from them? If yes, you found the right desire; the mechanism is what differentiates.
20
+
21
+ ## 2. Which awareness level is the market at?
22
+
23
+ | Level | The audience… | What the LEAD has to do |
24
+ |---|---|---|
25
+ | **1. Unaware** | does not know it has the problem | Tell a story, dramatize a scene until they recognize themselves. No product. |
26
+ | **2. Problem aware** | feels the pain, does not know a solution exists | **Name the pain with surgical precision.** The lead is the problem, not the promise. |
27
+ | **3. Solution aware** | knows solutions exist, does not know yours | Promise the result and hint that a different path exists |
28
+ | **4. Product aware** | knows your product, has not bought | Go to the mechanism or differentiator and break the real objection |
29
+ | **5. Most aware** | knows and wants it, needs a push | Offer, price, deadline. Short copy. |
30
+
31
+ **The VSL rule:** cold-traffic front end almost always runs at **2 or 3**. If the lead explains "why losing weight matters" to a level 3 audience, first-minute retention is gone, and the player chart will show it. Signal of a misreading: first-minute retention below 60%.
32
+
33
+ ## 3. Which sophistication stage is the market at?
34
+
35
+ Sophistication measures **how many promises the market already heard**, not how much it knows.
36
+
37
+ | Stage | State | What still works |
38
+ |---|---|---|
39
+ | **1** | Nobody promised anything yet | A direct, simple promise. Very rare today. |
40
+ | **2** | Someone already promised | Enlarge the promise. |
41
+ | **3** | Everyone promises the same thing | **New mechanism.** Not *what*, but *how*. This is where the VSL shines. |
42
+ | **4** | Everyone has a mechanism | **Elaborate the mechanism:** easier, faster, surer, removing the old limitation. |
43
+ | **5** | The market believes nothing | **Identification.** Sell who the person becomes. Proof and experience over promise. |
44
+
45
+ **Awareness and sophistication are independent axes.** A market can know your product (awareness 4) and still be immune to any promise (sophistication 5). Read sophistication from Block 8: five competitors promising the same with named mechanisms means stage 4; "already heard it a thousand times and doesn't believe" means 5.
46
+
47
+ ## The table that governs the rest of the VSL
48
+
49
+ | Awareness x Sophistication | What the VSL needs |
50
+ |---|---|
51
+ | 2 x 3 | Lead names the pain · problem mechanism is the heart · new, named solution mechanism |
52
+ | 2 x 4-5 | Lead names the pain **from an angle nobody used** · elaborated mechanism + heavy early proof |
53
+ | 3 x 3 | Lead promises result + hints at a different path · short problem mechanism, long solution |
54
+ | 3 x 4 | Counterintuitive lead (contradicts the expected mechanism) · mechanism with the limitation removed |
55
+ | 3-4 x 5 | Identification or story lead · social proof and demonstration replace the promise |
56
+ | 4-5 x any | Short VSL, or no VSL: go to an offer page |
57
+
58
+ **Short VSL** = the same four-block structure compressed, the pitch entering near the middle. When the low ticket ruler is in effect, its lengths replace these (SKILL.md, Step 0). State the chosen length in the script header.
59
+
60
+ ## Output · `01-diagnostico.md`
61
+
62
+ ```markdown
63
+ # Diagnóstico de mercado
64
+
65
+ ## Desejo de massa dominante
66
+ **<desejo em uma frase>**
67
+ - Urgência: <alta/média/baixa> · porque <evidência do briefing>
68
+ - Permanência: … | Alcance: …
69
+ - Descartados: <outros candidatos e por que perderam>
70
+
71
+ ## Nível de consciência: <1-5>
72
+ **Evidência:** <citação literal do briefing, da call ou da pesquisa do Piva>
73
+ **Implicação para a lead:** …
74
+
75
+ ## Estágio de sofisticação: <1-5>
76
+ **Evidência:** <o que o mercado já promete, segundo o Bloco 8>
77
+ **Implicação para o mecanismo:** <novo / elaborado / identificação>
78
+
79
+ ## O que isso proíbe
80
+ - <ex.: promessa direta de resultado está morta neste mercado>
81
+ ```
82
+
83
+ **Honesty rule:** if you cannot cite evidence from the briefing for the level you assigned, the diagnosis is a guess. Say so out loud instead of faking confidence.
84
+
85
+ ## Gate 1
86
+
87
+ Present the diagnosis with its evidence and ask explicitly:
88
+
89
+ > "Confirma consciência **N** e sofisticação **M**? Se você acha que o mercado está em outro ponto, me diga: isso muda o mecanismo inteiro."
90
+
91
+ Only after confirmation, record in `manifest.json`:
92
+
93
+ ```json
94
+ { "gate1_confirmado_em": "AAAA-MM-DD", "consciencia": 3, "sofisticacao": 4 }
95
+ ```
@@ -0,0 +1,200 @@
1
+ # Phases 0 and 1 · Ingestion and interview
2
+
3
+ > The goal is to reach `00-briefing.md` with everything the VSL needs, nothing invented, every answer with its source. A good VSL is mostly briefing.
4
+
5
+ ## §0 · Ingestion: never ask what is already answered
6
+
7
+ Before the first question, ask only this (in the user's language):
8
+
9
+ > "Antes de te entrevistar: você já tem material sobre esse expert ou essa oferta? Transcrição de call, questionário preenchido, página de vendas antiga, VSL anterior, aulas gravadas, site, Instagram, documento de oferta? Me passa os caminhos ou os links que eu leio antes."
10
+
11
+ Also check what the method already produced: an approved offer from `wizz-offer-forge` and the audience research from `wizz-pesquisa-de-publico-do-piva` (paths in SKILL.md, Step 0). They pre-fill whole blocks.
12
+
13
+ When there is material:
14
+
15
+ 1. **Read all of it.** A call transcript is the richest source there is: the expert talking loosely about their own method beats any rushed questionnaire.
16
+ 2. **Pre-fill the briefing, marking the source of each answer:** `(call 01:07:22)`, `(questionario.md §12.1)`, `(OFFER-x.md §mecanismo)`, `(pesquisa-piva/voc.md)`.
17
+ 3. **Then interview only the gaps.** Nothing degrades a briefing faster than asking what the person already answered.
18
+ 4. **Return what you extracted before asking:** "do material eu já tirei X, Y e Z; me confirma e responde só o que falta".
19
+
20
+ Without material, start at Block 1.
21
+
22
+ ## How to run the interview
23
+
24
+ - **One block at a time.** Never dump sixty questions at once. Ask a block, receive, save to disk, move on.
25
+ - **Numbered questions in the respondent's language,** without copy jargon ("qual seu USP?"). Ask like a curious friend.
26
+ - **Offer audio.** "Se for mais fácil, grava um áudio respondendo, eu transcrevo." The expert talking loosely gives vocabulary, catchphrases and stories they would never write.
27
+ - **"Não sei" is a valid answer.** It becomes `[LACUNA]` in the briefing, with one line on what that gap will cost the VSL.
28
+ - **Dig into numbers and stories.** Every case: who, when, what changed, how much, and can we cite it publicly. Every number: its source.
29
+ - **Save after each block** to `00-briefing.md`. An interview that lives only in the chat dies at the first context reset.
30
+ - **Contradicting sources:** do not pick silently. Record both versions with their sources and take the divergence to the person. When in doubt, what the expert says **now** wins; the old material stays as a note.
31
+
32
+ ### Map: every answer has a destination
33
+
34
+ | Block | Feeds |
35
+ |---|---|
36
+ | 1. Product and offer | the OFFER block (written first): modules, price, bonuses, guarantee |
37
+ | 2. Audience | everything: who we speak to, in which words |
38
+ | 3. Failed attempts | PROBLEM MECHANISM (the "what they tried" half) |
39
+ | 4. Root cause | PROBLEM MECHANISM (the "why it could not work" half) |
40
+ | 5. Method | SOLUTION MECHANISM (what it is + why it works) |
41
+ | 6. Story | STORY block + credibility of the lead |
42
+ | 7. Proof | proof type of the solution mechanism + `[DEPOIMENTO]` markers |
43
+ | 8. Market and competition | sophistication stage (Phase 2) |
44
+ | 9. Compliance | the LAW guardrail that crosses the whole VSL |
45
+ | 10. Voice | vocabulary, rhythm, catchphrases |
46
+ | 11. Operation | page rules, button delay, timer, upsell |
47
+
48
+ ## Block 1 · Product and offer `[MANDATORY]`
49
+
50
+ *The offer is written first. Without this block closed, no line gets written.* When an approved `wizz-offer-forge` offer exists, this block is a confirmation, not an interview.
51
+
52
+ 1. What exactly does this VSL sell? Product name (or "no name yet").
53
+ 2. Format and access: recorded course, dated challenge, community, protocol, mentorship? Where and for how long?
54
+ 3. Modules, steps or deliverables, each with **what the person gains** from it, not only its name.
55
+ 4. Price. Is there an anchor: what would the equivalent cost in consulting, one-to-one or competition?
56
+ 5. Bonuses, and **where each came from** (the story of why it was created).
57
+ 6. Guarantee: period and conditions.
58
+ 7. A live workshop or event that can be offered as an urgency bonus?
59
+ 8. `[optional]` An immediate upsell after purchase? Which, and for how much?
60
+ 9. Who is this product **not** for?
61
+ 10. The triad: besides the content, does the buyer get some **recommendation** (what to do in their case) and some **follow-up** (support, group, AI, team)?
62
+
63
+ ## Block 2 · Audience `[MANDATORY]`
64
+
65
+ *Pre-filled by the Piva research when it exists (VoC, psychographic profile, lexicon).*
66
+
67
+ 1. Who buys this? The real person: age, occupation, life moment, income.
68
+ 2. Who **pays you the most** today (real profile, not the desired one)?
69
+ 3. What is she feeling the day she watches this video? What happened that she is looking for this now?
70
+ 4. Which words does she use for the problem (hers, not the technical ones)?
71
+ 5. Beyond solving the problem, what does she **really** want? The dream behind the request.
72
+ 6. What keeps her awake? The biggest fear?
73
+
74
+ ## Block 3 · Failed attempts `[MANDATORY]`
75
+
76
+ 1. Everything this person **already tried** before finding you: products, methods, professionals, apps, courses, gurus.
77
+ 2. For each one: why it did not work (the technical explanation, not "she didn't try hard enough").
78
+ 3. How does she feel about failing so many times? Who does she blame?
79
+ 4. What has she heard so often she no longer listens? Which phrase in your market became a cliché?
80
+ 5. Why, with the problem knocking, does she keep putting the solution off?
81
+
82
+ ## Block 4 · Root cause `[MANDATORY]`
83
+
84
+ 1. In your expert opinion, what is the **real root cause** of the problem, the thing almost nobody sees?
85
+ 2. Which myth or "absolute truth" of your market would you take apart?
86
+ 3. The problem you solve is a consequence of what?
87
+ 4. Consequences of **not** solving it, on four fronts: physical, emotional, financial, relationships.
88
+ 5. Why does the problem keep growing despite so many solutions?
89
+
90
+ ## Block 5 · Method `[MANDATORY]`
91
+
92
+ *The solution mechanism is born here.*
93
+
94
+ 1. Do you have your own method? Describe it.
95
+ 2. Its steps, in order. Do they have names? Do you see them as modules?
96
+ 3. If you had to summarize it in 3 to 5 pillars, which?
97
+ 4. **Why does your method work where the others failed?** The most important question of the interview: insist until the answer is specific, not "because it's personalized".
98
+ 5. Why has your customer never heard anyone put it this way?
99
+ 6. Is the method hard to execute? What does it demand?
100
+ 7. Time to the first result? To the full transformation?
101
+ 8. What happens to whoever follows it to the letter?
102
+ 9. Your promise in ONE sentence.
103
+
104
+ ## Block 6 · Story `[MANDATORY]`
105
+
106
+ 1. Did you **live** this problem, or **study or treat** people who lived it?
107
+ 2. If you lived it: life before, what you tried, how you found the way out.
108
+ 3. If you studied it: what you saw happening to so many people; a specific patient or student who changed your mind.
109
+ 4. Two or three cases of people you helped: before, what you did together, after.
110
+ 5. A failure of yours? (failure gives more credibility than success)
111
+
112
+ ## Block 7 · Proof `[MANDATORY]`
113
+
114
+ 1. How do you prove, to someone who doesn't know you, that it works?
115
+ 2. How many clients or students so far?
116
+ 3. Recorded testimonials, screenshots, reviews? Where?
117
+ 4. For each case in Block 6: before and after numbers? **Can we cite it publicly** (name, initials, city)? Is authorization needed?
118
+ 5. A study, survey or public data that supports your mechanism? Which, and where?
119
+
120
+ > If 3 and 4 are "not yet", record it and mark `[DEPOIMENTO]` at those points of the VSL. Never write a fictional testimonial presented as real, not even "as an example". Missing proof does not block the rest of the script.
121
+
122
+ ## Block 8 · Market `[MANDATORY]`
123
+
124
+ *This defines the sophistication stage in Phase 2. Pre-filled by the Piva trend report and angle matrix when they exist.*
125
+
126
+ 1. Competitors and references: what do they promise?
127
+ 2. What is **everyone** in your market saying right now? The standard promise?
128
+ 3. Which promise has the audience heard so often they no longer believe it?
129
+ 4. A stance in your market you refuse to adopt?
130
+ 5. `[optional]` If you ran ads or a VSL before: what worked, what died?
131
+
132
+ ## Block 9 · Compliance `[MANDATORY]`
133
+
134
+ 1. Anything you **cannot** promise or say publicly because of a professional council, regulator or legal rule (CFM, CFN, CRP, CFC, CVM, ANVISA, OAB)?
135
+ 2. Traffic platform restrictions for your niche (health, finance, before and after, income claims)?
136
+ 3. A forbidden term, number or kind of image?
137
+
138
+ > The answers become a **GUARDRAIL (LEI)** header at the top of the VSL and override any copy rule of this skill.
139
+
140
+ ## Block 10 · Voice `[MANDATORY]`
141
+
142
+ 1. How would you describe your tone of voice? A catchphrase, an expression, a way of speaking that is yours?
143
+ 2. A word you **hate** and would never use?
144
+ 3. "Você" or "vocês"? Slang? Swearing?
145
+ 4. Two links of you speaking (Reels, YouTube, story) to calibrate rhythm.
146
+
147
+ > With video or audio available, transcribe and extract a mini glossary of real vocabulary. Copy that sounds like the expert converts; copy that sounds like AI is recognized in three seconds.
148
+
149
+ ## Block 11 · Operation `[optional]`
150
+
151
+ 1. Video player (VTurb, Panda, unlisted YouTube)? Can the button delay be set?
152
+ 2. Where is the page hosted? Checkout (Hotmart, Kiwify, Eduzz, Stripe)?
153
+ 3. One-click upsell? Order bump?
154
+ 4. A timer available for the urgency bonus?
155
+
156
+ ## Phase 1 exit
157
+
158
+ Before Phase 2, show the human this summary:
159
+
160
+ ```
161
+ BRIEFING · completude
162
+ ✅ Blocos completos: 1, 2, 3, 4, 5, 6, 9, 10, 11
163
+ ⚠️ LACUNAS que impactam a VSL:
164
+ - [LACUNA 7.4] Sem autorização de uso dos casos → a VSL fica com [DEPOIMENTO]
165
+ em 3 pontos e a prova social do pitch fica fraca. Custo: conversão do pitch.
166
+ - [LACUNA 8.3] Não sabemos que promessa o mercado já não acredita → a
167
+ sofisticação vai ser hipótese. Custo: risco de mecanismo gasto.
168
+ ▶️ Sigo pra Fase 2 assim, ou você fecha essas lacunas antes?
169
+ ```
170
+
171
+ A gap in a mandatory block does not stop the work, but it must not stay silent: say what is missing and what it costs. The human decides to go on with the gap, informed.
172
+
173
+ ## Template · `00-briefing.md`
174
+
175
+ ```markdown
176
+ # Briefing · <expert> / <produto>
177
+
178
+ > Fontes: <arquivos lidos, oferta aprovada, pesquisa do Piva>. Entrevista em <data>.
179
+ > Toda resposta traz a fonte entre parênteses. `[LACUNA]` = não respondido.
180
+
181
+ ## 1. Produto e oferta
182
+ - **Nome:** … (call 00:12:40)
183
+ - **Preço:** R$ … | **Âncora:** …
184
+ - **Módulos:** …
185
+ - **Bônus:** … (cada um com a história de origem)
186
+ - **Garantia:** …
187
+ - **Tríade:** conhecimento … | recomendação … | acompanhamento …
188
+
189
+ ## 2. Público
190
+ ## 3. Tentativas fracassadas
191
+ ## 4. Causa raiz
192
+ ## 5. Método
193
+ ## 6. História
194
+ ## 7. Provas
195
+ ## 8. Mercado
196
+ ## 9. GUARDRAIL (LEI) · proibições
197
+ ## 10. Voz · vocabulário real
198
+ ## 11. Operação
199
+ ## Lacunas em aberto
200
+ ```
@@ -0,0 +1,138 @@
1
+ # Phase 3 · Problem mechanism and solution mechanism
2
+
3
+ > **The whole VSL derives from the mechanism.** A mistake here costs re-recording the video, so this phase ends in a decision document and a human gate, never in your own choice. When an approved `wizz-offer-forge` offer already names the unique mechanism, it enters as the master solution mechanism by default (marked ⭐ with its source); the 5x5 still runs on the problem side and offers alternatives on the solution side.
4
+
5
+ ## What each one is
6
+
7
+ **PROBLEM mechanism:** the explanation of *why this person failed until today*, and why it is not her fault. It externalizes the blame **truthfully**, names the common enemy and turns accumulated frustration into attention.
8
+
9
+ > Formula: **what she already tried + why it could not work = the root cause**
10
+
11
+ **SOLUTION mechanism:** the explanation of *why the expert's method solves what the others did not*. Nameable, specific, defensible.
12
+
13
+ > Formula: **WHAT the method is + WHY it works.** The **HOW** stays for the offer.
14
+
15
+ Keeping the "how" back is what creates the need to buy. A VSL that teaches the step by step gives the value away and kills the pitch.
16
+
17
+ ### What a mechanism is NOT
18
+
19
+ | Not a mechanism | Why |
20
+ |---|---|
21
+ | "My method is personalized" | Everyone says it. Spent mechanism (sophistication 4+). |
22
+ | "You need consistency or discipline" | Hands the blame back to the viewer. |
23
+ | "A simple 5-step process" | That is product structure, not mechanism. |
24
+ | "Because I have 15 years of experience" | That is a credential. A credential does not explain a cause. |
25
+ | A pretty metaphor with no cause inside | A metaphor is packaging. |
26
+
27
+ ## Traceability rule
28
+
29
+ When the source material (call, questionnaire, class, approved offer) **already contains** an articulated mechanism, it is the **master mechanism**: extract it and cite it with timestamp or line. Your synthesis never replaces it; your original proposal enters marked `🆕 proposta nova (não veio da fonte)` and the human decides. The source mechanism enters as master by default and as your recommendation; the human may prefer another, as an explicit decision of theirs, never a silent substitution of yours.
30
+
31
+ ## The 5x5 format
32
+
33
+ Produce **5 problem mechanism proposals** and **5 solution mechanism proposals**. Five forces you out of the obvious: the first one is always the most predictable. Each proposal has exactly these fields:
34
+
35
+ ```markdown
36
+ ## P3 · <nome curto e memorável> ⭐/🆕
37
+ **Articulação:** <3 a 6 linhas, escritas como seriam ditas na VSL, nunca descrição em terceira pessoa>
38
+ **Hook exemplo:** *"<uma frase que abriria a VSL com esse mecanismo>"*
39
+ **Rastreabilidade:** ✅ <fonte + timestamp> | 🆕 proposta nova
40
+ **Schwartz:** <por que serve pra consciência N e sofisticação M>
41
+ **Risco:** <o que precisa ser verdade pra funcionar, ou onde quebra>
42
+ ```
43
+
44
+ ⭐ = came articulated from the source · 🆕 = your new proposal.
45
+
46
+ ### Angles for the 5 problem proposals
47
+
48
+ 1. **The math that does not add up:** she is rational, the cost is today and the reward is abstract.
49
+ 2. **The wrong ruler:** she got results and did not see them, because she measured with the slowest indicator.
50
+ 3. **Someone else's plan:** everything she received was designed for another profile.
51
+ 4. **The invisible part:** the market sells the visible slice of the problem and ignores the rest.
52
+ 5. **The inverted order:** she started at step 3; steps 1 and 2 never happened.
53
+ 6. **The system against her:** something structural (industry, algorithm, law, biology) works against her result and nobody told her.
54
+
55
+ ### Angles for the 5 solution proposals
56
+
57
+ The mechanism is the **variable only this method controls**:
58
+
59
+ 1. **The right order:** the same elements, in the sequence nobody respects.
60
+ 2. **The ignored variable:** what everyone treats as detail is the lever.
61
+ 3. **The measurement:** the method gives a new ruler that shows progress before the obvious result.
62
+ 4. **The old limitation removed:** what made it unfeasible (time, schedule, cost, discipline) no longer exists, and the mechanism explains how.
63
+ 5. **Diagnosis before prescription:** the method first finds out how *this person* works.
64
+ 6. **The layer nobody delivers:** the market sells the visible part; the method works the invisible one.
65
+
66
+ Each one answers "why it works" with **one of three proof types**, and the type follows the niche, not the expert's taste ([niches.md](niches.md)):
67
+
68
+ | Proof type | When | Format |
69
+ |---|---|---|
70
+ | **Scientific** | Health, performance, aesthetics, nutrition | Study, physiological mechanism, exam |
71
+ | **Logical** | Finance, business, legal, B2B | Math, cause and effect, side-by-side simulation |
72
+ | **Social** | Life change, hobby, relationship, volume | Cases, screenshots, number of students |
73
+
74
+ If the expert **lacks** the proof the niche asks for, that is a finding: record it as the proposal's risk, pick the mechanism that stands on the proof that exists, and tell the human what would have to be produced for the ideal mechanism.
75
+
76
+ **What/why versus how boundary:** a sentence that answers *why it works* belongs in the VSL; one that answers *what to do on Monday morning* belongs in the offer. Test: can the viewer execute it alone after hearing it? If yes, you gave away the how: cut it.
77
+
78
+ ### Proper name
79
+
80
+ Every approved solution mechanism gets a name: "Protocolo X", "Método das 3 Réguas". A name turns the mechanism into property, repeatable in the lead, the ad, the email and the page. A good name names the *cause* or the *turn*, not the category.
81
+
82
+ ## Pairing: not every P fits every S
83
+
84
+ Before recommending, test the pair:
85
+
86
+ - Does the S solve **exactly** the cause the P named? (if P says "you measured with the wrong ruler", S has to deliver a new ruler, not "personalized follow-up")
87
+ - Does the pair survive the diagnosed sophistication?
88
+ - Does the pair fit the speaking time of the problem and solution blocks under the ruler in effect?
89
+ - Does it respect the compliance guardrail of Block 9?
90
+
91
+ Recommend **one pair**, with one sentence on why this pair and not the others. Offer one or two secondary layers (reinforcement, not master).
92
+
93
+ ## Adversarial stress test (maker is not checker)
94
+
95
+ Before presenting, hand the draft to a **different** agent, or, failing that, run these six questions yourself with deliberate ill will:
96
+
97
+ 1. Has the market heard this? (if yes, it is spent: kill it)
98
+ 2. Is it falsifiable, or vague enough to never be wrong? (vague = weak)
99
+ 3. Do I overpromise? Does a sentence become a legal or compliance problem?
100
+ 4. Is the master mechanism traceable to the source, with timestamp?
101
+ 5. If I swap the expert's name, does it still fit? (if yes, too generic)
102
+ 6. Can a skeptical viewer rebut it in one sentence? Which one? Does the VSL answer it?
103
+
104
+ ## Gate 2
105
+
106
+ Present `02-mecanismos-5x5.md` as a **decision document**:
107
+
108
+ > "10 propostas. Preciso que você escolha **1 mecanismo-mestre do problema** e **1 da solução**. Minha recomendação: **P1 + S3**, porque … As demais estão numeradas pra você trocar. Camadas secundárias sugeridas: P2."
109
+
110
+ Only after the explicit choice, record:
111
+
112
+ ```json
113
+ { "gate2_aprovado_em": "AAAA-MM-DD", "aprovado_por": "<nome>",
114
+ "mecanismo_problema": "P1", "mecanismo_solucao": "S3", "camadas": ["P2"] }
115
+ ```
116
+
117
+ **Phase 4 reads this field and refuses to run while it is empty.** A draft becomes a recording.
118
+
119
+ ## Template · `02-mecanismos-5x5.md`
120
+
121
+ ```markdown
122
+ # Mecanismos 5×5 · <expert> (documento de decisão)
123
+
124
+ > Diagnóstico que governa as 10 propostas: consciência N, sofisticação M, desejo dominante <…>.
125
+ > Gate: escolher 1 mestre de cada lado → registrar no manifest → só então escrever a VSL.
126
+
127
+ ## Diagnóstico resumido
128
+ # PARTE 1 · MECANISMO DO PROBLEMA
129
+ ## P1 … P5
130
+ # PARTE 2 · MECANISMO DA SOLUÇÃO
131
+ ## S1 … S5
132
+ # RECOMENDAÇÃO
133
+ **Par recomendado:** P_ + S_ · porque …
134
+ **Camadas secundárias:** …
135
+ **Pares que eu descartaria:** … porque …
136
+ # STRESS-TEST
137
+ <as 6 perguntas respondidas contra o par recomendado>
138
+ ```
@@ -0,0 +1,40 @@
1
+ # Adapting to the niche
2
+
3
+ > Classify the niche in Phase 1 and apply it in every phase. The same framework written in the wrong tone converts half.
4
+
5
+ | Niche | Lead tone | Problem mechanism | Proof type | Typical front-end price |
6
+ |---|---|---|---|---|
7
+ | **Finance / investing** | Logical, direct, little emotion. Negative leads dominate | Fast and factual (broken system, inflation, math) | **Logical** | R$ 197-300 |
8
+ | **Health / fitness / aesthetics** | Emotional, deep, validates the frustration | Slow, digs the root cause, "não é culpa sua" | **Scientific** | R$ 97-197 |
9
+ | **Life change / digital business** | Aspirational with proof | Opportunity cost, lost time | **Social** | R$ 97-197 |
10
+ | **Professional (legal, medical, accounting)** | Sober, technical, no hype | Outdated method, career risk | **Logical + authority** | R$ 297-589 |
11
+ | **Volume / hobby / low ticket** | Light, close, community | Simple and short | **Social** | R$ 40-67 |
12
+
13
+ Price ranges are calibration, not copy. When the low ticket ruler applies, its price and guarantee ruler (through `wizz-offer-forge` and `wizz-lowticket-metodologia`) replaces this column.
14
+
15
+ ## Notes per niche
16
+
17
+ **Finance.** Broken-institution and math-comparison leads are the most resilient. Return promises are regulated in many countries.
18
+
19
+ **Health.** The problem block is the longest of the VSL, not the shortest. The audience arrives defeated by previous attempts; validating the frustration *before* proposing anything buys the attention. Compliance is risk number one.
20
+
21
+ **Life change.** High sophistication, a market saturated with promises. Usually asks for an elaborated mechanism (stage 4) or identification (5).
22
+
23
+ **Professional.** The buyer has a reputation at stake. Hype kills conversion. Authority, technical specificity and cases with numbers do the work.
24
+
25
+ **Volume.** Do not force a high-ticket structure. Short VSL, simple offer, focus on recurrence and community. The game is scale, not margin. When the operation is low ticket, the ruler in SKILL.md, Step 0, decides the runtime.
26
+
27
+ ## Compliance: the guardrail that beats every copy rule
28
+
29
+ Block 9 becomes a **LEI** header at the top of the VSL. No technique of this skill authorizes breaking it.
30
+
31
+ | Area | Typical restriction |
32
+ |---|---|
33
+ | Health, nutrition, psychology, dentistry | Councils often forbid promising results, before and after, guaranteed cure, patient images |
34
+ | Finance and investing | Return promises, personalized advice without registration |
35
+ | Traffic platforms | Meta and Google restrict income, health and weight-loss claims, and accusatory "você" |
36
+ | Third-party data | A student's or patient's name, image and numbers need recorded authorization |
37
+
38
+ Safe patterns under restriction: third-person scenes instead of direct accusation · a statistic with a cited source instead of diagnosing the viewer · an experience account instead of a result promise.
39
+
40
+ When the expert cannot answer Block 9, do not invent the answer: record `[LACUNA]` and write in **conservative mode**: no result promise ("você vai emagrecer X kg" becomes "o que o método faz"), no second-person diagnosis (becomes a third-person scene), no before and after, no number without a cited source, no third-party name. State in writing that the VSL is in this mode and what can be released once someone confirms the niche's rules.
@@ -0,0 +1,91 @@
1
+ # Phase 4.1 · The OFFER (written first)
2
+
3
+ > Counterintuitive and non-negotiable: **the offer is the first block written**, even though it is the last the viewer sees. Prerequisite: `manifest.gate2_aprovado_em` filled in. Check it before writing.
4
+ >
5
+ > When an approved `wizz-offer-forge` offer exists, it is the source for steps 2 to 13 (name, stack, bonuses, guarantee, anchor): this block turns it into **spoken** script, it does not redesign it. A change of price, bonus or guarantee goes back to `wizz-offer-forge` and reopens Gate 2.
6
+
7
+ Default position: the pitch enters at the 12 to 14 minute turn and runs 4 to 6 more (full VSL 16 to 20). Under the low ticket ruler, the pitch enters at about two thirds of the runtime the ruler sets.
8
+
9
+ ## The 15 steps, in order
10
+
11
+ **1. Transition from the mechanism to the offer.**
12
+ > "Agora que você entendeu <mecanismo da solução>, deixa eu te mostrar como aplicar isso na sua vida a partir de hoje."
13
+
14
+ Never cut dry to "so I created a course".
15
+
16
+ **2. Product name.** Strong and specific. Words that convey a system (*protocolo, método, sistema, programa, desafio*). Avoid *curso* and *formação*: they sound like content, not result.
17
+
18
+ **3. Who it is for, and who it is not for.**
19
+ > "Isso é pra você se <condição 1>, <condição 2> e <condição 3>. E não é pra você se <condição>."
20
+
21
+ The negative qualification raises perceived value and buyer quality (Block 1.9).
22
+
23
+ **4. What the person receives.** Module by module, always **benefit, not feature**:
24
+ > ❌ "Módulo 3: Alimentação"
25
+ > ✅ "Módulo 3: o que comer nos dias em que a agenda vira do avesso, pra você não recomeçar do zero toda segunda"
26
+
27
+ **5. The triad.** Strong products communicate three layers:
28
+
29
+ | Layer | Line | Example |
30
+ |---|---|---|
31
+ | **Knowledge** | "Eu te ensino a pescar" | the content, straight to the point |
32
+ | **Recommendation** | "Eu te dou o peixe" | what to do in her specific case (diagnosis, plan, AI) |
33
+ | **Follow-up** | "Eu te acompanho na pescaria" | continuous support: group, WhatsApp, AI, team |
34
+
35
+ Name the layers that exist and never invent the missing ones. If two are missing, flag it to the human: it is an offer weakness, not a copy one.
36
+
37
+ **6. Interleaved testimonials.** `[DEPOIMENTO 1]`, `[DEPOIMENTO 2]`… spread **between** modules, never piled in one block. When there is no proof material, the markers hold the place, or the block is omitted; the rest of the pitch goes on.
38
+
39
+ **7. Price anchoring.** Before revealing the price, compare with the real, expensive alternative:
40
+ > "Uma consultoria individual comigo sai R$ X por sessão. Um acompanhamento de 3 meses passa de R$ Y."
41
+
42
+ Anchor only against a real, supported alternative. A charging history or discount that never existed is never stated as fact.
43
+
44
+ **8. Price with contrast** · `[BOTÃO APARECE AQUI]`
45
+ > "Mas hoje não é nada disso. É R$ <preço>."
46
+
47
+ The button appears **here**, when the price is revealed: that is what the player delay waits for.
48
+
49
+ **9. Bonus with a 60-second timer.** A real urgency bonus with a visual countdown, typically a live workshop seat. It is one of the strongest levers of the format. Honesty requirement: the bonus exists and is delivered. A timer that resets and keeps offering destroys trust in the whole funnel.
50
+
51
+ **10. Guarantee.** Period and condition, in one clear sentence that matches the real terms exactly (an encouraged usage challenge is not automatically a refund condition).
52
+
53
+ **11. Extra bonuses, with a story.** Each bonus gets 2 or 3 lines of origin. A bonus listed without story is noise; with story it is value.
54
+
55
+ **12. Express stack.** Quick recap, in a list, with value per item:
56
+ > "Programa completo: R$ X · Bônus 1: R$ Y · Bônus 2: R$ Z · Total: R$ <soma>. Hoje: R$ <preço>."
57
+
58
+ **13. Surprise gift.**
59
+ > "E tem uma coisa que eu nem coloquei na lista: assim que você entrar, recebe um convite pra <aula/encontro>."
60
+
61
+ It raises the open rate of the first post-purchase message, where the whole backend starts.
62
+
63
+ **14. Emotional close.** Go back to the lead's problem and project the two futures.
64
+
65
+ **15. Final CTA.** One instruction, no ambiguity: "Clica no botão aqui embaixo agora." `[CTA → aponta pro botão que já apareceu no passo 8]`
66
+
67
+ ## The value equation (apply to every line of the pitch)
68
+
69
+ Every element of the offer pushes at least one of: **↑ dream outcome · ↑ perceived likelihood · ↓ time to result · ↓ effort and sacrifice**. A bonus or module that moves none of the four weakens the offer by dilution.
70
+
71
+ ## Page and player rules (they move conversion more than copy)
72
+
73
+ These belong to the page around the player, written by `wizz-copywriting`; list them in the hand-off.
74
+
75
+ | Rule | Why |
76
+ |---|---|
77
+ | **No headline above the video** | Removing the headline improves play rate |
78
+ | **No email or phone form before the VSL** | Capturing first lowers front-end conversion |
79
+ | **Delayed button**, only after the price | An early button anticipates the pitch and lowers retention |
80
+ | **No discount button or coupon on the page** | Discount buyers take the upsell far less |
81
+ | Traffic goes straight to the open page | No intermediate capture step |
82
+
83
+ Under the low ticket ruler, its page and player shards (`06b-player-vsl.md`, `12c-anatomia-low-ticket.md`) win over this table.
84
+
85
+ ## Output of this step
86
+
87
+ The offer block in **spoken language** (it is a script, not page text), with `[DEPOIMENTO]`, `[BOTÃO APARECE AQUI]` and `[A DEFINIR]` markers where information is missing.
88
+
89
+ ## OTO and downsell videos
90
+
91
+ A short upsell video after purchase follows a different sequence, in [blocks-and-leads.md](blocks-and-leads.md) §OTO. It never implies that the buyer accepted another optional offer.
@@ -0,0 +1,75 @@
1
+ # Phase 6 · Production plan and hand-off
2
+
3
+ > Animation makes a clear script easier to follow; it cannot rescue vague writing. Production starts only after the script-only audit and the claims ledger are closed ([assembly-qa.md](assembly-qa.md)). This skill **plans** the production and hands it off: drawing, voicing and assembling the video belong to the designer area. The copy agent never invokes another area's agent: offer `wizz-maestro` when the user wants the video in the same delivery.
4
+
5
+ ## 1. Beat sheet · `05-beat-sheet.md`
6
+
7
+ One row per beat, in presentation order. It is the contract the production reads.
8
+
9
+ | # | Narration (exact) | On-screen line | Visual evidence | Claim supported | Source |
10
+ |---|---|---|---|---|---|
11
+ | 1 | "…" | ≤ 6 words | product crop / real screen / `[B-ROLL: …]` | ledger #3 | `00-briefing.md` 7.4 |
12
+
13
+ - Capture product states only after confirming the script and the UI agree. Label fixture or example data honestly. Never expose customer data, credentials or live keys.
14
+ - A small visual system: two type roles, a restrained palette, consistent safe margins, a few repeatable scene types (intro, problem, reveal, demo, proof, guarantee, offer, CTA). Patterns, not required branding: the project's brand wins.
15
+ - No durations by hand: every beat's length comes from the final audio (section 3).
16
+
17
+ ## 2. Narration
18
+
19
+ - Record or generate the narration from the **exact** final script. Paid voice generation only with the user's explicit authorization; keep the complete inputs (text, voice and model settings, request IDs, returned alignment, audio hashes) so an uncertain job is resumed instead of paid twice.
20
+ - When revising, regenerate only the changed sentences if the voice splices cleanly, with adjacent text as prosody context. Listen to every seam; replace the whole paragraph only when the splice stays audible.
21
+
22
+ ## 3. Timing from the final audio
23
+
24
+ Invoke the `wizz-ctc-align` skill on the final narration and the exact spoken text: word-by-word timestamps snapped to real silences become the single timing source. Never estimate timing by hand and never use Whisper timestamps for a known script.
25
+
26
+ - Scene durations are built from that alignment.
27
+ - Big on-screen lines change on **spoken beats**, anchored to the word timings, never to arbitrary seconds.
28
+ - If a section is cut after alignment, update audio, word timings, captions, scene hosts, animation anchors, music ducking and the final fade **together**. Old offsets become invalid after an upstream edit.
29
+
30
+ ## 4. Drawing and assembly (designer area)
31
+
32
+ The method's video pipeline rule: **HyperFrames draws the screens (silent visual), Remotion assembles the film (audio, captions, frame timing).**
33
+
34
+ - `hyperframes` draws each silent scene from the beat sheet: kinetic headline cards, animated stack, price reveal, guarantee card, real product mockups.
35
+ - The `wizz-remotion-best-practices` skill assembles the scenes with the narration, captions, SFX and the motion anchored to the `wizz-ctc-align` timings.
36
+ - Effects and sound by semantic event, if wanted: the `wizz-video-effects` skill, after the assembly plan.
37
+
38
+ ### Motion rules for the big lines
39
+
40
+ - Split on-screen headlines into one to three short lines, each a complete, concrete thought.
41
+ - Enter lines in sequence with fast, damped motion; use scale, opacity or horizontal movement consistently.
42
+ - Highlight one decisive line or word with the accent colour; never colour every benefit.
43
+ - Keep copy readable after its entrance. Motion marks a beat, reveals evidence or guides focus.
44
+ - During demos the UI dominates: crops and pans focus attention without hiding the state needed to verify the claim. When the finished output is the strongest proof, play it unobstructed and long enough to judge.
45
+ - Respect title-safe areas, captions, mobile scaling and reduced motion.
46
+
47
+ **Illustrated VSL (optional reference).** For a slide-by-slide stickman or illustrated VSL with a timed image manifest and frame verification, `mikefilsaime-groove/stickman-vsl-director` (MIT) is a reference for the storyboard grammar (one image per narration span, a mandatory art-direction choice, a review deck before rendering). It is not installed by the method; its own scripts are not run from here.
48
+
49
+ ## 5. Verification of the rendered master
50
+
51
+ - Inspect frames from the rendered master, not only development snapshots.
52
+ - Watch with sound from start to end; listen at every splice and transition.
53
+ - Check captions against the final audio and the visible claims.
54
+ - No black gaps, clipped lines, stale frames, drift, missing fonts or unreadable demo crops.
55
+ - Measure streams, dimensions, runtime, loudness, peaks, file size and hashes when relevant. Keep a high-quality master separate from the web encode.
56
+
57
+ ## 6. Player QA (on the real page)
58
+
59
+ Test the actual page player on phone width and desktop: explicit sound start, restart behaviour, native controls, captions, close or escape, pause when out of viewport, poster, reduced motion, and the button delay set to the price moment (`[BOTÃO APARECE AQUI]`). Under the low ticket ruler, `06b-player-vsl.md` of `wizz-lowticket-metodologia` sets what the player must deliver.
60
+
61
+ Report the measured runtime and the remaining limitations. Nothing is published, deployed, or sent to paid generation without the user's authorization.
62
+
63
+ ## Hand-off block
64
+
65
+ Close Phase 6 with this block in the reply:
66
+
67
+ ```
68
+ 🎬 HANDOFF DE PRODUÇÃO · <produto>
69
+ Roteiro final: {output_folder}/vsl/<slug>/03-vsl-principal.md (lead default: <qual>)
70
+ Beat sheet: {output_folder}/vsl/<slug>/05-beat-sheet.md (<N> beats)
71
+ Ledger de claims: 04-qa.md (<N> claims, <N> com marcador pendente)
72
+ Régua: <default | lowticket: duração e posição do pitch>
73
+ Ordem: narração final → wizz-ctc-align → hyperframes (cenas mudas) → Remotion (montagem) → QA do player
74
+ Página em volta do player: wizz-copywriting com as regras de página e player
75
+ ```