@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.
- package/augment-extensions/writing-standards/screenplay/commercials/CHARACTER-COUNT-TRACKING.md +226 -0
- package/augment-extensions/writing-standards/screenplay/commercials/CONFIGURATION.md +327 -0
- package/augment-extensions/writing-standards/screenplay/commercials/README.md +223 -0
- package/augment-extensions/writing-standards/screenplay/commercials/REFACTORING-SUMMARY.md +193 -0
- package/augment-extensions/writing-standards/screenplay/commercials/REFERENCES.md +157 -0
- package/augment-extensions/writing-standards/screenplay/commercials/VALIDATION-REPORT.md +109 -0
- package/augment-extensions/writing-standards/screenplay/commercials/examples/.gitkeep +0 -0
- package/augment-extensions/writing-standards/screenplay/commercials/module.json +111 -0
- package/augment-extensions/writing-standards/screenplay/commercials/rules/.gitkeep +0 -0
- package/augment-extensions/writing-standards/screenplay/commercials/rules/commercial-audience.md +343 -0
- package/augment-extensions/writing-standards/screenplay/commercials/rules/commercial-formats.md +396 -0
- package/augment-extensions/writing-standards/screenplay/commercials/rules/commercial-persuasion.md +387 -0
- package/augment-extensions/writing-standards/screenplay/commercials/rules/commercial-scripts.md +531 -0
- package/augment-extensions/writing-standards/screenplay/commercials/rules/commercial-techniques.md +912 -0
- package/augment-extensions/writing-standards/screenplay/commercials/rules/commercial-types.md +700 -0
- package/augment-extensions/writing-standards/screenplay/commercials/rules/commercials.md +285 -0
- package/augment-extensions/writing-standards/screenplay/commercials/scripts/validate-character-count.ts +284 -0
- package/cli/dist/cli.js +0 -2
- package/cli/dist/cli.js.map +1 -1
- package/package.json +4 -1
package/augment-extensions/writing-standards/screenplay/commercials/rules/commercial-persuasion.md
ADDED
|
@@ -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
|
+
|