@mytechtoday/augment-extensions 2.4.0 → 2.5.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 (20) hide show
  1. package/augment-extensions/writing-standards/screenplay/commercials/CHARACTER-COUNT-TRACKING.md +226 -0
  2. package/augment-extensions/writing-standards/screenplay/commercials/CONFIGURATION.md +327 -0
  3. package/augment-extensions/writing-standards/screenplay/commercials/README.md +223 -0
  4. package/augment-extensions/writing-standards/screenplay/commercials/REFACTORING-SUMMARY.md +193 -0
  5. package/augment-extensions/writing-standards/screenplay/commercials/REFERENCES.md +157 -0
  6. package/augment-extensions/writing-standards/screenplay/commercials/VALIDATION-REPORT.md +109 -0
  7. package/augment-extensions/writing-standards/screenplay/commercials/examples/.gitkeep +0 -0
  8. package/augment-extensions/writing-standards/screenplay/commercials/module.json +111 -0
  9. package/augment-extensions/writing-standards/screenplay/commercials/rules/.gitkeep +0 -0
  10. package/augment-extensions/writing-standards/screenplay/commercials/rules/commercial-audience.md +343 -0
  11. package/augment-extensions/writing-standards/screenplay/commercials/rules/commercial-formats.md +396 -0
  12. package/augment-extensions/writing-standards/screenplay/commercials/rules/commercial-persuasion.md +387 -0
  13. package/augment-extensions/writing-standards/screenplay/commercials/rules/commercial-scripts.md +531 -0
  14. package/augment-extensions/writing-standards/screenplay/commercials/rules/commercial-techniques.md +912 -0
  15. package/augment-extensions/writing-standards/screenplay/commercials/rules/commercial-types.md +700 -0
  16. package/augment-extensions/writing-standards/screenplay/commercials/rules/commercials.md +285 -0
  17. package/augment-extensions/writing-standards/screenplay/commercials/scripts/validate-character-count.ts +284 -0
  18. package/cli/dist/cli.js +0 -2
  19. package/cli/dist/cli.js.map +1 -1
  20. package/package.json +4 -1
@@ -0,0 +1,387 @@
1
+ # Commercial Persuasion Frameworks
2
+
3
+ ## Overview
4
+
5
+ Proven persuasion frameworks and psychological principles for creating compelling commercial content. These frameworks guide viewers from awareness to action through structured messaging strategies.
6
+
7
+ ---
8
+
9
+ ## Core Persuasion Frameworks
10
+
11
+ ### 1. AIDA Framework
12
+
13
+ **Attention → Interest → Desire → Action**
14
+
15
+ The classic advertising framework that guides viewers through a psychological journey.
16
+
17
+ #### Attention (0-3 seconds)
18
+ **Goal:** Stop the scroll, grab eyeballs, break through noise
19
+
20
+ **Techniques:**
21
+ - **Visual Hook:** Striking imagery, unexpected visuals, bold colors
22
+ - **Audio Hook:** Distinctive sound, music sting, silence break
23
+ - **Pattern Interrupt:** Something that doesn't belong, breaks expectations
24
+ - **Direct Address:** "Hey you!" "Stop!" "Listen up!"
25
+
26
+ **Examples:**
27
+ ```
28
+ GOOD: [OPEN ON: Car driving upside-down on ceiling]
29
+ GOOD: [SILENCE. Then sudden LOUD WHISPER: "Psst..."]
30
+ BAD: [Generic product shot with soft music]
31
+ ```
32
+
33
+ #### Interest (3-10 seconds)
34
+ **Goal:** Make them care, show relevance, create curiosity
35
+
36
+ **Techniques:**
37
+ - **Relatable Problem:** "Ever struggled with...?"
38
+ - **Surprising Fact:** "Did you know...?"
39
+ - **Benefit Tease:** "What if you could...?"
40
+ - **Story Setup:** Introduce character/situation
41
+
42
+ **Examples:**
43
+ ```
44
+ GOOD: "What if your phone battery lasted 3 days?"
45
+ GOOD: "Meet Sarah. She's about to discover something amazing."
46
+ BAD: "Our company has been in business since 1987."
47
+ ```
48
+
49
+ #### Desire (10-20 seconds)
50
+ **Goal:** Make them want it, show transformation, create emotional connection
51
+
52
+ **Techniques:**
53
+ - **Before/After:** Show the transformation
54
+ - **Social Proof:** "Join 10 million users"
55
+ - **Lifestyle Aspiration:** Show the better life
56
+ - **Emotional Payoff:** How it feels to have the solution
57
+
58
+ **Examples:**
59
+ ```
60
+ GOOD: [SHOW: Stressed person → Using product → Relaxed, smiling]
61
+ GOOD: "Imagine never worrying about [problem] again."
62
+ BAD: "Our product has many features."
63
+ ```
64
+
65
+ #### Action (20-30 seconds)
66
+ **Goal:** Tell them exactly what to do next
67
+
68
+ **Techniques:**
69
+ - **Clear CTA:** "Visit," "Call," "Download," "Try"
70
+ - **Urgency:** "Limited time," "While supplies last"
71
+ - **Low Barrier:** "Free trial," "No credit card required"
72
+ - **Incentive:** "Get 20% off," "Free shipping"
73
+
74
+ **Examples:**
75
+ ```
76
+ GOOD: "Download the app today. First month free."
77
+ GOOD: "Visit Nike.com/sale. 48 hours only."
78
+ BAD: "Learn more about our offerings."
79
+ ```
80
+
81
+ ### 2. PAS Framework
82
+
83
+ **Problem → Agitate → Solve**
84
+
85
+ Particularly effective for products that solve specific pain points.
86
+
87
+ #### Problem (0-5 seconds)
88
+ **Identify the pain point clearly and specifically**
89
+
90
+ **Techniques:**
91
+ - **Show the Problem:** Visual demonstration
92
+ - **Ask the Question:** "Tired of...?" "Frustrated by...?"
93
+ - **Relatable Scenario:** Everyday situation gone wrong
94
+
95
+ **Examples:**
96
+ ```
97
+ GOOD: [SHOW: Person struggling with tangled cables, frustrated]
98
+ GOOD: "Ever spend 20 minutes looking for your keys?"
99
+ BAD: "Life can be challenging sometimes."
100
+ ```
101
+
102
+ #### Agitate (5-15 seconds)
103
+ **Make the pain worse, amplify the frustration**
104
+
105
+ **Techniques:**
106
+ - **Consequences:** "And then it gets worse..."
107
+ - **Cumulative Effect:** "Day after day, week after week..."
108
+ - **Emotional Impact:** Show stress, anxiety, frustration
109
+ - **Missed Opportunities:** "While you're dealing with this..."
110
+
111
+ **Examples:**
112
+ ```
113
+ GOOD: "You're late. Again. Your boss is calling. Your phone is dead."
114
+ GOOD: "That's 2 hours a week. 104 hours a year. Wasted."
115
+ BAD: "This is not ideal."
116
+ ```
117
+
118
+ #### Solve (15-30 seconds)
119
+ **Present your product as the hero, the relief, the solution**
120
+
121
+ **Techniques:**
122
+ - **Immediate Relief:** Show problem disappearing
123
+ - **Simple Solution:** "Just [simple action]"
124
+ - **Transformation:** Before/after contrast
125
+ - **Peace of Mind:** Show calm, confidence, success
126
+
127
+ **Examples:**
128
+ ```
129
+ GOOD: [SHOW: One tap. Problem solved. Person smiles, relaxes]
130
+ GOOD: "KeyFinder. Never lose your keys again. Ever."
131
+ BAD: "Our solution addresses various pain points."
132
+ ```
133
+
134
+ ### 3. FAB Framework
135
+
136
+ **Features → Advantages → Benefits**
137
+
138
+ Translate product attributes into customer value.
139
+
140
+ #### Features
141
+ **What it is, what it has, technical specifications**
142
+
143
+ **Examples:**
144
+ - "24-hour battery life"
145
+ - "Military-grade encryption"
146
+ - "100% organic ingredients"
147
+
148
+ #### Advantages
149
+ **What the feature enables, how it's better**
150
+
151
+ **Examples:**
152
+ - "Lasts all day without charging"
153
+ - "Your data stays completely private"
154
+ - "No harmful chemicals or pesticides"
155
+
156
+ #### Benefits
157
+ **What it means for the customer's life, emotional payoff**
158
+
159
+ **Examples:**
160
+ - "Never worry about your phone dying during important moments"
161
+ - "Sleep soundly knowing your information is safe"
162
+ - "Feel good about what you're putting in your body"
163
+
164
+ **Complete FAB Example:**
165
+ ```
166
+ FEATURE: "Our mattress has 5 zones of support"
167
+ ADVANTAGE: "Each part of your body gets exactly the right firmness"
168
+ BENEFIT: "Wake up without back pain. Finally sleep through the night."
169
+ ```
170
+
171
+ ---
172
+
173
+ ## Emotional Connection Techniques
174
+
175
+ ### 1. Storytelling
176
+
177
+ **Why it works:** Stories bypass logical resistance and create emotional engagement
178
+
179
+ **Story Structure for Commercials:**
180
+
181
+ 1. **Character:** Relatable protagonist (customer avatar)
182
+ 2. **Problem:** Challenge they face (product solves)
183
+ 3. **Journey:** How they discover/use solution
184
+ 4. **Resolution:** Transformation, happy ending
185
+ 5. **Moral:** Implicit message (don't state it)
186
+
187
+ **Example - 30-Second Story:**
188
+ ```
189
+ [OPEN ON: Young woman, moving boxes into new apartment]
190
+ [She's overwhelmed, exhausted]
191
+ [Discovers TaskRabbit app on phone]
192
+ [Books help in seconds]
193
+ [MONTAGE: Helpers arrive, furniture assembled, boxes unpacked]
194
+ [CLOSE ON: Woman relaxing on couch, smiling]
195
+ VOICEOVER: "TaskRabbit. Life's easier with help."
196
+ ```
197
+
198
+ ### 2. Humor
199
+
200
+ **Why it works:** Laughter creates positive brand association and shareability
201
+
202
+ **Humor Types:**
203
+ - **Absurdity:** Unexpected, illogical situations (Old Spice)
204
+ - **Exaggeration:** Over-the-top scenarios (Geico)
205
+ - **Wordplay:** Puns, double meanings
206
+ - **Physical Comedy:** Slapstick, visual gags
207
+ - **Irony:** Opposite of expectations
208
+ - **Self-Deprecation:** Brand makes fun of itself
209
+
210
+ **Humor Best Practices:**
211
+ - ✅ Humor should relate to product/message
212
+ - ✅ Test with target audience (humor is subjective)
213
+ - ✅ Avoid offensive, divisive, or mean-spirited humor
214
+ - ✅ Don't let joke overshadow brand/CTA
215
+ - ✅ Make sure it's actually funny (get feedback)
216
+
217
+ **Example - Absurd Humor:**
218
+ ```
219
+ [OPEN ON: Man riding horse on beach, shirtless]
220
+ MAN: "Look at your man. Now back to me. Now back at your man.
221
+ Now back to me. Sadly, he isn't me."
222
+ [Man is now on a boat]
223
+ MAN: "But if he stopped using lady-scented body wash and
224
+ switched to Old Spice, he could smell like he's me."
225
+ [Boat becomes diamonds]
226
+ MAN: "Anything is possible when your man smells like Old Spice."
227
+ ```
228
+
229
+ ### 3. Nostalgia
230
+
231
+ **Why it works:** Positive memories create emotional warmth and trust
232
+
233
+ **Nostalgia Techniques:**
234
+ - **Period Music:** Songs from specific era
235
+ - **Retro Visuals:** Vintage film grain, old logos, classic styles
236
+ - **Cultural References:** TV shows, toys, trends from the past
237
+ - **Generational Targeting:** 80s/90s kids, boomers, etc.
238
+ - **Throwback Aesthetics:** Neon, VHS effects, pixel art
239
+
240
+ **Example - Nostalgia:**
241
+ ```
242
+ [OPEN ON: 1990s living room, VHS quality]
243
+ [Kid playing Nintendo, eating cereal]
244
+ [MUSIC: 90s pop hit]
245
+ VOICEOVER: "Remember when Saturday mornings meant cartoons
246
+ and cereal?"
247
+ [TRANSITION: Same person, now adult, streaming on modern TV]
248
+ VOICEOVER: "StreamNostalgia. All your favorite 90s shows.
249
+ All in one place."
250
+ ```
251
+
252
+ ### 4. Fear/Anxiety (Use Carefully)
253
+
254
+ **Why it works:** Fear motivates action, but can backfire if too intense
255
+
256
+ **Fear Types:**
257
+ - **Loss Aversion:** "Don't miss out"
258
+ - **Security Concerns:** "Protect what matters"
259
+ - **Health Anxiety:** "Prevent problems before they start"
260
+ - **Social Fear:** "Don't be left behind"
261
+
262
+ **Fear Best Practices:**
263
+ - ✅ Always provide solution/relief
264
+ - ✅ Don't traumatize or terrify
265
+ - ✅ Balance fear with hope
266
+ - ✅ Avoid exploiting serious tragedies
267
+ - ✅ Test for appropriate tone
268
+
269
+ **Example - Security (Balanced Fear):**
270
+ ```
271
+ [OPEN ON: Family sleeping peacefully]
272
+ [SUPER: "3 AM"]
273
+ [Sound of window breaking - but muted, not scary]
274
+ [Security system activates, lights flash]
275
+ [Intruder runs away]
276
+ [Family still sleeping peacefully]
277
+ VOICEOVER: "SimpliSafe. Protecting what matters most."
278
+ ```
279
+
280
+ ### 5. Aspiration
281
+
282
+ **Why it works:** People buy the life they want, not just the product
283
+
284
+ **Aspiration Techniques:**
285
+ - **Lifestyle Upgrade:** Show the better version of life
286
+ - **Status Symbols:** Luxury, exclusivity, prestige
287
+ - **Achievement:** Success, accomplishment, recognition
288
+ - **Transformation:** "Become the person you want to be"
289
+
290
+ **Example - Aspiration:**
291
+ ```
292
+ [OPEN ON: Sleek office, city skyline view]
293
+ [Confident executive in designer suit]
294
+ [Checking luxury watch]
295
+ [Getting into premium car]
296
+ VOICEOVER: "Success isn't given. It's earned."
297
+ [SUPER: Rolex. A Crown for Every Achievement.]
298
+ ```
299
+
300
+ ---
301
+
302
+ ## Comparison Table: When to Use Each Framework
303
+
304
+ | Framework | Best For | Typical Length | Emotional Tone | Example Products |
305
+ |-----------|----------|----------------|----------------|------------------|
306
+ | **AIDA** | General products, broad appeal | 15-60 sec | Positive, energetic | Consumer goods, apps, services |
307
+ | **PAS** | Problem-solving products | 30-60 sec | Frustration → Relief | SaaS, insurance, cleaning products |
308
+ | **FAB** | Technical/complex products | 30-90 sec | Informative, confident | B2B, electronics, automotive |
309
+ | **Story** | Emotional connection needed | 60-120 sec | Warm, relatable | Lifestyle brands, nonprofits |
310
+ | **Humor** | Memorable, shareable content | 15-30 sec | Fun, lighthearted | Snacks, beverages, casual brands |
311
+ | **Fear** | Security/protection products | 30-60 sec | Concern → Reassurance | Insurance, security, healthcare |
312
+
313
+ ---
314
+
315
+ ## Combining Frameworks
316
+
317
+ **Most effective commercials combine multiple frameworks:**
318
+
319
+ **Example: AIDA + Humor**
320
+ ```
321
+ ATTENTION: Absurd visual hook (humor)
322
+ INTEREST: Relatable problem (humor)
323
+ DESIRE: Product benefits (AIDA)
324
+ ACTION: Clear CTA (AIDA)
325
+ ```
326
+
327
+ **Example: PAS + Story**
328
+ ```
329
+ PROBLEM: Character faces challenge (story)
330
+ AGITATE: Consequences unfold (story)
331
+ SOLVE: Product saves the day (story + PAS)
332
+ ```
333
+
334
+ **Example: FAB + Aspiration**
335
+ ```
336
+ FEATURE: Premium materials (FAB)
337
+ ADVANTAGE: Superior performance (FAB)
338
+ BENEFIT: Elevated lifestyle (aspiration)
339
+ ```
340
+
341
+ ---
342
+
343
+ ## Persuasion Principles (Cialdini)
344
+
345
+ ### 1. Reciprocity
346
+ **Give something to get something**
347
+ - Free trial, free sample, free content
348
+ - "Try it free for 30 days"
349
+
350
+ ### 2. Scarcity
351
+ **Limited availability increases desire**
352
+ - "Only 3 left in stock"
353
+ - "Sale ends tonight"
354
+ - "Limited edition"
355
+
356
+ ### 3. Authority
357
+ **Expert endorsement builds trust**
358
+ - "Recommended by dentists"
359
+ - "Award-winning"
360
+ - "As seen on TV"
361
+
362
+ ### 4. Consistency
363
+ **People want to act consistently with past behavior**
364
+ - "You loved our first product, now try..."
365
+ - "Join millions who already switched"
366
+
367
+ ### 5. Liking
368
+ **We buy from people/brands we like**
369
+ - Attractive spokesperson
370
+ - Shared values
371
+ - Relatable personality
372
+
373
+ ### 6. Social Proof
374
+ **We follow what others do**
375
+ - "10 million users"
376
+ - Customer testimonials
377
+ - "Best-selling"
378
+ - Star ratings
379
+
380
+ ---
381
+
382
+ ## Resources
383
+
384
+ - **Books:** "Influence" by Robert Cialdini, "Made to Stick" by Chip & Dan Heath
385
+ - **Examples:** Ads of the World, Cannes Lions winners
386
+ - **Testing:** A/B test different frameworks with target audience
387
+