@jaimevalasek/aioson 1.7.0 → 1.7.2

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 (34) hide show
  1. package/CHANGELOG.md +25 -0
  2. package/package.json +1 -1
  3. package/src/constants.js +13 -0
  4. package/template/.aioson/agents/copywriter.md +463 -0
  5. package/template/.aioson/agents/dev.md +29 -1
  6. package/template/.aioson/agents/deyvin.md +1 -0
  7. package/template/.aioson/agents/neo.md +5 -1
  8. package/template/.aioson/agents/qa.md +101 -0
  9. package/template/.aioson/agents/setup.md +17 -1
  10. package/template/.aioson/agents/squad.md +190 -0
  11. package/template/.aioson/agents/ux-ui.md +169 -3
  12. package/template/.aioson/genomes/copywriting.md +204 -0
  13. package/template/.aioson/skills/design/cognitive-core-ui/references/motion.md +2 -0
  14. package/template/.aioson/skills/marketing/references/anti-patterns.md +254 -0
  15. package/template/.aioson/skills/marketing/references/fascinations.md +192 -0
  16. package/template/.aioson/skills/marketing/references/five-acts.md +248 -0
  17. package/template/.aioson/skills/marketing/references/market-intelligence.md +198 -0
  18. package/template/.aioson/skills/marketing/references/offer-structure.md +203 -0
  19. package/template/.aioson/skills/marketing/references/one-belief.md +149 -0
  20. package/template/.aioson/skills/marketing/references/patterns.md +218 -0
  21. package/template/.aioson/skills/marketing/references/pms-research.md +193 -0
  22. package/template/.aioson/skills/marketing/vsl-craft.md +385 -0
  23. package/template/.aioson/skills/static/landing-page-deploy.md +192 -0
  24. package/template/.aioson/skills/static/landing-page-forge.md +730 -0
  25. package/template/.aioson/skills/static/ui-ux-modern.md +1 -0
  26. package/template/.aioson/tasks/squad-create.md +22 -0
  27. package/template/.aioson/tasks/squad-design.md +30 -0
  28. package/template/.aioson/templates/squads/digital-marketing-agency/template.json +96 -0
  29. package/template/CLAUDE.md +1 -0
  30. package/template/.aioson/skills/design-system/components/SKILL.md:Zone.Identifier +0 -0
  31. package/template/.aioson/skills/design-system/dashboards/SKILL.md:Zone.Identifier +0 -0
  32. package/template/.aioson/skills/design-system/foundations/SKILL.md:Zone.Identifier +0 -0
  33. package/template/.aioson/skills/design-system/motion/SKILL.md:Zone.Identifier +0 -0
  34. package/template/.aioson/skills/design-system/patterns/SKILL.md:Zone.Identifier +0 -0
@@ -0,0 +1,149 @@
1
+ ---
2
+ name: one-belief-reference
3
+ description: One Belief framework — the central psychological thesis that every high-converting page or VSL must establish. Loaded by @copywriter and vsl-craft when building marketing pages.
4
+ ---
5
+
6
+ # One Belief — Framework & Examples
7
+
8
+ ## The formula
9
+
10
+ Every high-converting page orbits ONE belief the prospect must accept:
11
+
12
+ > "Doing **[New Opportunity]** is the key to **[Primary Benefit]**, and this is only possible through **[Unique Mechanism]**."
13
+
14
+ If the prospect believes this single statement, they are ready for the offer.
15
+ If they don't believe it, no amount of design or features will convert them.
16
+
17
+ ---
18
+
19
+ ## Components explained
20
+
21
+ ### New Opportunity
22
+ A shift from what the prospect has tried before. NOT an improvement on the old thing — a replacement.
23
+
24
+ - Old thing: "doing cardio to lose weight" → New Opportunity: "metabolic stimulation"
25
+ - Old thing: "posting more content" → New Opportunity: "audience asset building"
26
+ - Old thing: "cold calling" → New Opportunity: "inbound demand engine"
27
+
28
+ ### Primary Benefit
29
+ The outcome the prospect actually wants — stated in their vocabulary, not yours.
30
+
31
+ - Bad: "increase your ROI" (vague, corporate)
32
+ - Good: "get 20 new clients a month without creating content" (specific, desired)
33
+
34
+ ### Unique Mechanism
35
+ The "secret sauce" — the specific method that makes the result possible. Must be:
36
+ 1. **Believable** — aligns with what the prospect already suspects is true
37
+ 2. **Named** — has a memorable, curiosity-inducing name ("The 7-Minute Metabolic Reset")
38
+ 3. **Exclusive** — only available through this product/expert
39
+
40
+ ---
41
+
42
+ ## Pattern: Well-constructed One Beliefs
43
+
44
+ ### Example 1 — Health / Weight loss
45
+ > "Activating your **dormant metabolic enzymes** (New Opportunity) is the key to **losing weight without dieting or exercising** (Primary Benefit), and this is only possible through the **Morning Kiwi Protocol** (Unique Mechanism)."
46
+
47
+ **Why it works:**
48
+ - "Dormant metabolic enzymes" sounds scientific enough to be believable
49
+ - "Without dieting or exercising" is the dream outcome in the audience's words
50
+ - "Morning Kiwi Protocol" is specific, curious, and named — forces them to watch to learn what it is
51
+
52
+ ### Example 2 — Business / Client acquisition
53
+ > "Building an **automated demand engine** (New Opportunity) is the key to **getting 15+ qualified leads every week without posting on social media** (Primary Benefit), and this is only possible through the **Silent Funnel Method** (Unique Mechanism)."
54
+
55
+ **Why it works:**
56
+ - "Automated demand engine" replaces "cold outreach" (the old painful thing)
57
+ - "Without posting on social media" directly addresses the audience's exhaustion
58
+ - "Silent Funnel Method" creates curiosity — what makes it "silent"?
59
+
60
+ ### Example 3 — Education / Language learning
61
+ > "Reprogramming your **auditory pattern recognition** (New Opportunity) is the key to **understanding native speakers in 90 days** (Primary Benefit), and this is only possible through the **Immersion Loop Technique** (Unique Mechanism)."
62
+
63
+ **Why it works:**
64
+ - "Auditory pattern recognition" sounds neuroscience-based (believable)
65
+ - "Understanding native speakers in 90 days" is the specific dream
66
+ - "Immersion Loop Technique" sounds systematic and learnable
67
+
68
+ ### Example 4 — Finance / Investing
69
+ > "Using **asymmetric micro-positions** (New Opportunity) is the key to **consistent 3-5% monthly returns with controlled risk** (Primary Benefit), and this is only possible through the **3-Filter Portfolio System** (Unique Mechanism)."
70
+
71
+ **Why it works:**
72
+ - "Asymmetric micro-positions" sounds sophisticated but not intimidating
73
+ - "3-5% monthly" is specific and believable (not "get rich quick")
74
+ - "3-Filter" implies a clear, simple process
75
+
76
+ ### Example 5 — SaaS / Productivity
77
+ > "Replacing your task list with a **decision pipeline** (New Opportunity) is the key to **finishing your real work in 4 focused hours** (Primary Benefit), and this is only possible through the **Priority Inversion Framework** (Unique Mechanism)."
78
+
79
+ **Why it works:**
80
+ - "Decision pipeline" reframes productivity as decision-making (novel angle)
81
+ - "4 focused hours" is specific and appeals to the overworked audience
82
+ - "Priority Inversion" is counter-intuitive — makes them want to know more
83
+
84
+ ### Example 6 — Real estate
85
+ > "Targeting **pre-foreclosure micro-markets** (New Opportunity) is the key to **buying properties 40% below market without competing with other investors** (Primary Benefit), and this is only possible through the **County Signal System** (Unique Mechanism)."
86
+
87
+ ### Example 7 — Relationships / Dating
88
+ > "Developing **emotional polarity** (New Opportunity) is the key to **attracting committed partners who pursue you** (Primary Benefit), and this is only possible through the **Mirror Protocol** (Unique Mechanism)."
89
+
90
+ ---
91
+
92
+ ## Anti-pattern: Broken One Beliefs
93
+
94
+ ### Anti-pattern 1 — No New Opportunity (just improving the old thing)
95
+ > "Our course teaches you **better copywriting techniques** to **increase your sales**."
96
+
97
+ **Why it fails:** "Better copywriting" is not a new opportunity — it's the same thing they've tried. No paradigm shift, no curiosity.
98
+
99
+ ### Anti-pattern 2 — No Unique Mechanism
100
+ > "Intermittent fasting is the key to losing weight and you can do it with our app."
101
+
102
+ **Why it fails:** Intermittent fasting is well-known — there's no unique mechanism. The prospect thinks "I can just Google this."
103
+
104
+ ### Anti-pattern 3 — Unbelievable mechanism
105
+ > "Our quantum frequency alignment bracelet will cure all your diseases in 24 hours."
106
+
107
+ **Why it fails:** The mechanism doesn't align with any logic the prospect already holds. Even low-sophistication audiences need internal logical consistency.
108
+
109
+ ### Anti-pattern 4 — Vague benefit
110
+ > "Our method will transform your life and help you achieve your goals."
111
+
112
+ **Why it fails:** No specific primary benefit. "Transform your life" means nothing — the prospect can't visualize the outcome.
113
+
114
+ ### Anti-pattern 5 — Feature-first (no belief structure)
115
+ > "Our platform has AI-powered analytics, 50+ integrations, and real-time dashboards."
116
+
117
+ **Why it fails:** Features are not a belief. The prospect doesn't know why they should care. There's no "key to [benefit]" structure — just a feature list.
118
+
119
+ ### Anti-pattern 6 — Multiple beliefs competing
120
+ > "Our program teaches you copywriting, media buying, funnel building, and email marketing to grow your business."
121
+
122
+ **Why it fails:** Four things competing for attention. One Belief means ONE. The prospect can't hold four beliefs simultaneously — they lose focus and leave.
123
+
124
+ ---
125
+
126
+ ## Calibration by market sophistication
127
+
128
+ As markets become more skeptical, the One Belief must evolve:
129
+
130
+ | Level | Audience state | One Belief strategy |
131
+ |---|---|---|
132
+ | 1 — Unaware | Doesn't know they have the problem | Lead with the problem discovery, then the belief |
133
+ | 2 — Problem-aware | Knows the problem, hasn't tried solutions | Simple New Opportunity + clear mechanism |
134
+ | 3 — Solution-aware | Has tried things that didn't work | Must invalidate previous solutions before introducing the new one |
135
+ | 4 — Product-aware | Knows your type of product exists | Mechanism must be hyper-specific and unique — "why THIS method is different" |
136
+ | 5 — Most sophisticated | Skeptical of everything | Lead with proof/results first, then reverse-engineer the belief |
137
+
138
+ ---
139
+
140
+ ## How to extract the One Belief from a project
141
+
142
+ Ask these questions (in this order):
143
+
144
+ 1. What has the prospect already tried that didn't work? → This reveals the OLD opportunity to replace
145
+ 2. What does the prospect actually want? (outcome, not feature) → This is the Primary Benefit
146
+ 3. Why does THIS product/method work when others didn't? → This is the Unique Mechanism
147
+ 4. Can you name the mechanism something memorable? → The "chiclete" name
148
+
149
+ If the user can't answer #3, the product doesn't have a clear mechanism yet — help them find one before writing copy.
@@ -0,0 +1,218 @@
1
+ ---
2
+ name: copy-patterns-reference
3
+ description: Proven copy patterns — headline formulas, CTA patterns, social proof formats, section copy structures. Loaded by @copywriter when writing any marketing/sales page.
4
+ ---
5
+
6
+ # Copy Patterns — What Works and Why
7
+
8
+ ## 1. Headline patterns
9
+
10
+ ### Pattern 1: Result + Timeframe + Objection Killer
11
+ > "[Achieve specific result] in [timeframe] — even if [main objection]"
12
+
13
+ **Examples:**
14
+ - "Get 20 new clients in 30 days — even if you have zero followers and hate selling"
15
+ - "Speak conversational Spanish in 90 days — even if you failed every language class in school"
16
+ - "Build a 6-figure freelance business in 6 months — even if you've never had a single client"
17
+
18
+ **Why it works:** Promises a specific outcome, sets a deadline (urgency + believability), and preemptively kills the #1 reason they'd scroll past.
19
+
20
+ ### Pattern 2: The Curious Discovery
21
+ > "The [adjective] [thing] that [produces unexpected result]"
22
+
23
+ **Examples:**
24
+ - "The 30-second morning ritual that shrinks waist measurements in 14 days"
25
+ - "The forgotten 1947 sales technique that outperforms modern AI copy 4:1"
26
+ - "The single LinkedIn setting that 94% of professionals leave turned off — and it's costing them job offers"
27
+
28
+ **Why it works:** Creates a curiosity gap. The reader must consume the content to satisfy the itch.
29
+
30
+ ### Pattern 3: Bold Claim + Proof Anchor
31
+ > "[Bold promise]. [Specific proof point that makes it credible]."
32
+
33
+ **Examples:**
34
+ - "We helped 14,000 patients reverse metabolic syndrome. Without a single prescription."
35
+ - "Our students have generated R$47M in combined revenue. Here's the system they all used."
36
+ - "93% of our graduates get hired within 60 days. Here's why."
37
+
38
+ **Why it works:** Bold claim alone = skepticism. Bold claim + specific number = curiosity + "maybe this is real."
39
+
40
+ ### Pattern 4: "How to" + Eliminate the Pain
41
+ > "How to [desired result] without [painful thing they hate doing]"
42
+
43
+ **Examples:**
44
+ - "How to fill your calendar with qualified leads without cold calling, networking events, or posting daily content"
45
+ - "How to lose 10 kg without giving up carbs, counting calories, or spending hours at the gym"
46
+ - "How to launch a SaaS product without writing code, hiring developers, or spending 6 months building"
47
+
48
+ ### Pattern 5: The Question That Hits Home
49
+ > "[Question that describes their exact situation]?"
50
+
51
+ **Examples:**
52
+ - "Still paying R$3,000/month for a marketing agency that can't explain where your leads come from?"
53
+ - "Working 12-hour days and still can't afford to take a real vacation?"
54
+ - "How many more diets will you start on Monday and quit by Wednesday?"
55
+
56
+ **Why it works:** If the question describes their reality, they feel seen. Feeling seen = trust = continued reading.
57
+
58
+ ### Pattern 6: The New Category
59
+ > "Introducing [New Category Name]: the [alternative] to [old way]"
60
+
61
+ **Examples:**
62
+ - "Introducing Metabolic Signaling: the alternative to calorie counting that actually lasts"
63
+ - "Introducing Silent Funnels: client acquisition without content, cold outreach, or ads"
64
+ - "Introducing Micro-SaaS Stacking: building income streams without raising capital or hiring teams"
65
+
66
+ ---
67
+
68
+ ## 2. Subheadline patterns
69
+
70
+ The subheadline qualifies the headline — who it's for, how it works at surface level.
71
+
72
+ **Pattern: For [audience] who [situation]**
73
+ - "For coaches, consultants, and service providers who are tired of trading time for money"
74
+ - "For women over 40 who've tried every diet and feel like their body has given up"
75
+
76
+ **Pattern: The [method] that [differentiator]**
77
+ - "The 21-day protocol used by 14,000 patients — now available for home use"
78
+ - "The exact funnel template responsible for R$2.3M in revenue — no tech skills required"
79
+
80
+ **Pattern: Without [pain] / No [requirement]**
81
+ - "No gym membership. No meal prep. No willpower required."
82
+ - "Without posting daily. Without cold DMs. Without hiring an agency."
83
+
84
+ ---
85
+
86
+ ## 3. Social proof patterns
87
+
88
+ ### The Specific Number Strip
89
+ > "[Number] [people/companies] already [achieved result]"
90
+
91
+ **Good:**
92
+ - "14,237 professionals trained since 2019"
93
+ - "R$47M in combined student revenue"
94
+ - "4.9/5 average rating across 2,300 reviews"
95
+
96
+ **Bad:**
97
+ - "Thousands of satisfied customers" (vague)
98
+ - "Trusted by many companies" (unmeasurable)
99
+
100
+ ### The Named Testimonial
101
+ > "[Specific result] — [Name], [Role/Location]"
102
+
103
+ **Good:**
104
+ - "I went from 3 clients to 42 in 8 months — Fernanda Oliveira, Digital Strategist, São Paulo"
105
+ - "Lost 12 kg in the first 21 days without changing what I eat — only when I eat — Carlos Mendes, 47, Engineer"
106
+
107
+ **Bad:**
108
+ - "Great product, loved it!" — J.S. (no specificity, initials only)
109
+ - "Changed my life" — Anonymous (no detail, not credible)
110
+
111
+ ### The Logo Bar
112
+ Show 5-8 client/media logos. If you don't have logos, use "As seen in" with publication names. If you don't have either, use specific numbers instead.
113
+
114
+ ### The Mini Case Study (3 lines)
115
+ > **Before:** [situation before]
116
+ > **After:** [situation after]
117
+ > **Time:** [how long it took]
118
+
119
+ **Example:**
120
+ > **Before:** R$8,000/month, working 14-hour days, 3 clients
121
+ > **After:** R$42,000/month, working 6 hours/day, 28 clients on autopilot
122
+ > **Time:** 5 months with the Silent Funnel Blueprint
123
+
124
+ ---
125
+
126
+ ## 4. CTA (Call to Action) patterns
127
+
128
+ ### Benefit-framed (always preferred)
129
+ - "Start My 21-Day Reset"
130
+ - "Get My Free Analysis"
131
+ - "Download the Blueprint"
132
+ - "See My Personalized Plan"
133
+ - "Start Getting Clients Today"
134
+
135
+ ### Anti-pattern CTAs (never use)
136
+ - "Submit" — sounds like surrendering
137
+ - "Buy Now" — focuses on the cost, not the benefit
138
+ - "Click Here" — meaningless
139
+ - "Learn More" — weak commitment, delays action
140
+ - "Sign Up" — bureaucratic
141
+
142
+ ### CTA supporting copy (below the button)
143
+ - "Join 14,237 professionals who already use this system"
144
+ - "30-day money-back guarantee — zero risk"
145
+ - "Takes 2 minutes. No credit card required."
146
+ - "You can cancel anytime. No questions asked."
147
+
148
+ ---
149
+
150
+ ## 5. Section copy patterns
151
+
152
+ ### The "Why This Exists" section
153
+ > "I created [Product] because [personal experience or observed problem].
154
+ > After [working with X people / spending Y years], I saw the same pattern:
155
+ > [The common mistake or gap].
156
+ > [Product] fixes that — in [timeframe], not [longer alternative]."
157
+
158
+ ### The "How It Works" section (3 steps max)
159
+ ```
160
+ Step 1: [Simple action] → [Immediate micro-result]
161
+ Step 2: [Next action] → [Progress marker]
162
+ Step 3: [Final action] → [The desired outcome]
163
+ ```
164
+
165
+ **Example:**
166
+ ```
167
+ Step 1: Take the 5-minute assessment → Get your personalized protocol
168
+ Step 2: Follow the morning sequence for 21 days → Watch your markers change
169
+ Step 3: Lock in maintenance mode → Keep your results permanently
170
+ ```
171
+
172
+ **Anti-pattern:** More than 3 steps. If it looks complex, they won't start.
173
+
174
+ ### The "Who This Is For / Not For" section
175
+
176
+ **Pattern:**
177
+ ```
178
+ This is for you if:
179
+ ✓ [Qualifying statement that makes the ideal buyer feel seen]
180
+ ✓ [Another qualifier]
181
+ ✓ [Another qualifier]
182
+
183
+ This is NOT for you if:
184
+ ✗ [Disqualifier that makes non-buyers self-select out]
185
+ ✗ [Disqualifier]
186
+ ```
187
+
188
+ **Why it works:** Qualifying IN makes the right person feel like this was made for them. Qualifying OUT creates scarcity (not everyone can access this) and removes future complaints.
189
+
190
+ ### The FAQ section (objection handling)
191
+
192
+ Every FAQ answer should follow: **Validate → Answer → Proof**
193
+
194
+ **Example:**
195
+ > **Q: "How is this different from other diet programs?"**
196
+ > A: Fair question — you've probably tried programs that worked for 2 weeks and then stopped. The Morning Reset Protocol is different because it addresses the root cause (metabolic thermostat) instead of the symptom (calorie intake). That's why 78% of our participants maintain results after 12 months — not just the first 21 days.
197
+
198
+ **Anti-pattern FAQ:**
199
+ > **Q: "Is this good?"**
200
+ > A: "Yes, it's great!" — Not a real objection, not a real answer.
201
+
202
+ ---
203
+
204
+ ## 6. Congruence rule
205
+
206
+ **The landing page must be a direct continuation of the ad that brought the visitor.**
207
+
208
+ | Element | Ad | Landing Page |
209
+ |---|---|---|
210
+ | Promise | Same primary promise | Same words, expanded |
211
+ | Tone | Conversational, urgent, etc. | Must match exactly |
212
+ | Visual | Color palette, imagery style | Same or very similar |
213
+ | Hook | The curiosity element | Resolved (or deepened) on the page |
214
+ | CTA | Implied action | Explicit button |
215
+
216
+ **Why:** If the ad says "discover the morning ritual that burns fat" and the landing page says "Welcome to our health platform," the prospect feels bait-and-switched. Their guard goes UP, not down.
217
+
218
+ **Implementation note for @copywriter:** If the user provides ad copy or context, extract the promise, tone, and hook — and ensure the landing page mirrors them. If no ad context is provided, note it in the copy document as `[Congruence note: no ad context provided — landing page copy is standalone. When ads are created, align them to this page's hero headline and tone.]`
@@ -0,0 +1,193 @@
1
+ ---
2
+ name: pms-research-reference
3
+ description: PMS (Problems, Myths, Dreams) research framework — structured audience intelligence before writing copy. Loaded by @copywriter during Phase 3 research.
4
+ ---
5
+
6
+ # PMS Research — Problems, Myths/Lies, Dreams
7
+
8
+ ## What is PMS?
9
+
10
+ PMS is the foundational audience research framework for direct response marketing. Before writing a single word of copy, map the prospect's:
11
+
12
+ - **P — Problems (Problemas):** What frustrates them daily? What have they tried that failed?
13
+ - **M — Myths & Lies (Mitos e Mentiras):** What do they believe that isn't true? What has the industry told them that keeps them stuck?
14
+ - **S — Dreams (Sonhos):** What do they actually want? What does their ideal outcome look like in specific terms?
15
+
16
+ Copy that mirrors PMS back to the prospect in their OWN vocabulary converts. Copy that uses marketing speak doesn't.
17
+
18
+ ---
19
+
20
+ ## Where to research PMS
21
+
22
+ ### Tier 1 — High-signal sources (use first)
23
+
24
+ | Source | What to capture | How to search |
25
+ |---|---|---|
26
+ | **Amazon reviews** (books in the niche) | Exact phrases describing pain, disappointment, and transformation. 1-star reviews = problems. 5-star reviews = dreams. | Search Amazon for "[topic] book", read reviews of top 5 books |
27
+ | **Reddit** | Anonymous, unfiltered language about real problems. Subreddits are niche-specific goldmines. | Search `site:reddit.com "[problem]"` or browse r/[niche] |
28
+ | **YouTube comments** | What people say under popular videos about the topic — their questions reveal gaps, their complaints reveal objections. | Find top 5 videos on the topic, read top 50 comments each |
29
+ | **Google autocomplete** | What real people are typing — reveals questions, comparisons, and pain language. | Type "[topic] why..." / "[topic] how to..." / "[topic] vs..." |
30
+
31
+ ### Tier 2 — Competitive intelligence
32
+
33
+ | Source | What to capture |
34
+ |---|---|
35
+ | **Competitor sales pages** | What promises they make, what language they use, what objections they address |
36
+ | **Competitor reviews/testimonials** | The words THEIR customers use to describe results |
37
+ | **Facebook Groups** | Questions members ask = problems. Complaints = myths. Success posts = dreams. |
38
+ | **Quora** | Longer-form problem descriptions with emotional context |
39
+
40
+ ### Tier 3 — Data validation
41
+
42
+ | Source | What to capture |
43
+ |---|---|
44
+ | **Google Trends** | Is interest rising or falling? Seasonal patterns? |
45
+ | **Industry reports / studies** | Specific numbers to anchor claims |
46
+ | **Forum/community polls** | Quantified pain points |
47
+
48
+ ---
49
+
50
+ ## PMS mapping template
51
+
52
+ After research, fill this structure:
53
+
54
+ ```markdown
55
+ ## PMS Map — [Audience / Niche]
56
+
57
+ ### P — Problems (what keeps them up at night)
58
+
59
+ 1. **[Problem in their words]**
60
+ - Frequency: how often mentioned across sources
61
+ - Emotional weight: frustration / shame / anger / fear
62
+ - Quote: "[exact quote from source]" — [source]
63
+
64
+ 2. **[Problem 2]**
65
+ - ...
66
+
67
+ 3. **[Problem 3]**
68
+ - ...
69
+
70
+ ### M — Myths & Lies (what they believe that isn't true)
71
+
72
+ 1. **"[Myth in their words]"**
73
+ - Why they believe it: [who told them / cultural context]
74
+ - The truth: [what's actually correct]
75
+ - Copy angle: how to address this without insulting them
76
+
77
+ 2. **"[Myth 2]"**
78
+ - ...
79
+
80
+ ### S — Dreams (what they actually want)
81
+
82
+ 1. **[Dream in their words]**
83
+ - Specificity: how concretely can they describe it?
84
+ - Emotional core: freedom / status / safety / belonging / health
85
+ - Quote: "[exact quote]" — [source]
86
+
87
+ 2. **[Dream 2]**
88
+ - ...
89
+
90
+ ### Vocabulary Bank
91
+ Words and phrases the audience uses repeatedly:
92
+ - "[phrase 1]"
93
+ - "[phrase 2]"
94
+ - "[phrase 3]"
95
+ - ...
96
+
97
+ ### Primary Objections (derived from PMS)
98
+ 1. [Objection]: derived from [Problem/Myth]
99
+ 2. [Objection]: derived from [Problem/Myth]
100
+ ```
101
+
102
+ ---
103
+
104
+ ## Example: Complete PMS map — Weight loss niche
105
+
106
+ ### P — Problems
107
+
108
+ 1. **"I lose 5 kg and then gain 7 back"**
109
+ - Frequency: mentioned in 80%+ of diet book reviews
110
+ - Emotional weight: shame + frustration
111
+ - Quote: "Every January I start a new diet. By March I've gained everything back plus more. I'm tired of the cycle." — Amazon review, The Obesity Code
112
+
113
+ 2. **"I don't have time to cook special meals"**
114
+ - Frequency: top 3 complaint in fitness subreddits
115
+ - Emotional weight: guilt (they feel they "should" have time)
116
+ - Quote: "I work 10 hours, have 2 kids. When am I supposed to meal prep for 3 hours on Sunday?" — r/loseit
117
+
118
+ 3. **"I've spent thousands on nutritionists and nothing sticks"**
119
+ - Frequency: common in 2-3 star Amazon reviews
120
+ - Emotional weight: anger at the industry + hopelessness
121
+ - Quote: "R$350 per session, 6 months, and I'm exactly where I started. Expensive failure." — Google review of nutrition clinic
122
+
123
+ ### M — Myths & Lies
124
+
125
+ 1. **"Calories in, calories out is all that matters"**
126
+ - Why they believe it: every doctor, trainer, and magazine says it
127
+ - The truth: hormonal and metabolic factors (insulin, cortisol, thyroid) play a dominant role
128
+ - Copy angle: "Your doctor meant well — but the calorie model was debunked by [study]"
129
+
130
+ 2. **"You need to exercise more to lose weight"**
131
+ - Why they believe it: fitness industry profits from this belief
132
+ - The truth: exercise is excellent for health but accounts for only 10-15% of caloric expenditure
133
+ - Copy angle: "What if the gym was the wrong battle?" (challenge without shaming)
134
+
135
+ 3. **"Eating fat makes you fat"**
136
+ - Why they believe it: 1990s nutritional guidelines, still culturally embedded
137
+ - The truth: healthy fats are essential for metabolic function; sugar is the bigger driver
138
+ - Copy angle: "The 1992 food pyramid was based on politics, not science"
139
+
140
+ ### S — Dreams
141
+
142
+ 1. **"I want to eat without guilt"**
143
+ - Specificity: very concrete — they imagine a dinner where they enjoy food without counting
144
+ - Emotional core: freedom
145
+ - Quote: "I just want to sit at a restaurant with my husband and order what I actually want without calculating macros in my head." — Reddit
146
+
147
+ 2. **"I want to look good in photos again"**
148
+ - Specificity: tied to a specific event or situation (beach, wedding, reunion)
149
+ - Emotional core: belonging / status
150
+ - Quote: "My daughter's wedding is in 6 months. I don't want to hate every photo." — Facebook group
151
+
152
+ 3. **"I want energy to play with my kids"**
153
+ - Specificity: physical activity with children, keeping up
154
+ - Emotional core: love / fear of missing out on family life
155
+ - Quote: "My 6-year-old asked me to run with him and I couldn't keep up for 2 minutes. That was my wake-up call." — YouTube comment
156
+
157
+ ### Vocabulary Bank
158
+ - "yo-yo dieting"
159
+ - "nothing works for me"
160
+ - "slow metabolism"
161
+ - "food guilt"
162
+ - "cheat day"
163
+ - "I've tried everything"
164
+ - "my body fights against me"
165
+ - "I just want to feel normal"
166
+ - "tired of the cycle"
167
+
168
+ ### Primary Objections
169
+ 1. "I've tried everything and nothing works" → derived from Problem 1
170
+ 2. "I don't have time for this" → derived from Problem 2
171
+ 3. "How is this different from the last thing I tried?" → derived from Problem 3 + Myth 1
172
+
173
+ ---
174
+
175
+ ## How PMS maps to the 5 Acts
176
+
177
+ | PMS element | Where it appears in the 5 Acts |
178
+ |---|---|
179
+ | Problems | Act 1 (Lead hook — name their pain), Act 3 (Mechanism — why they failed) |
180
+ | Myths | Act 3 (Mechanism — invalidate the old belief), Act 5 (FAQ — handle objections) |
181
+ | Dreams | Act 1 (Lead — promise the dream), Act 4 (Offer — the product delivers the dream), Act 5 (Two Paths — visualize the dream vs. staying stuck) |
182
+ | Vocabulary | Everywhere — use their exact words, not marketing speak |
183
+
184
+ ---
185
+
186
+ ## PMS research rules
187
+
188
+ 1. **Spend 30-60 minutes max** on PMS research. Depth comes from quality of sources, not quantity.
189
+ 2. **Capture exact quotes** — verbatim language is gold. Paraphrasing dilutes the power.
190
+ 3. **3 problems, 3 myths, 3 dreams minimum** — if you can't find 3 of each, the niche research isn't deep enough.
191
+ 4. **Prioritize by emotional weight** — the problem that causes the most shame/frustration is usually the best lead hook.
192
+ 5. **Save to `researchs/{slug}/pms-map-{date}.md`** for reuse by other agents.
193
+ 6. **If web search is unavailable:** use LLM knowledge to construct a provisional PMS map. Mark it as `[inferred — not validated]` and recommend the user validate with real audience data.