@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,396 @@
1
+ # Commercial Formats: Duration-Specific Guidelines
2
+
3
+ ## Overview
4
+
5
+ Commercial length dictates structure, pacing, and creative approach. Each format has unique constraints and opportunities. This guide provides specific rules, word counts, timing breakdowns, and best practices for all standard commercial durations.
6
+
7
+ ## Format Comparison Table
8
+
9
+ | Duration | Word Count | Sentences | Key Points | Best Use Case | Cost Factor |
10
+ |----------|------------|-----------|------------|---------------|-------------|
11
+ | 6-second | 8-12 words | 1 | 1 (brand awareness) | Digital pre-roll, bumpers | 1x |
12
+ | 15-second | 30-40 words | 2-3 | 1-2 (simple message) | Radio, digital, TV filler | 2x |
13
+ | 30-second | 60-75 words | 4-6 | 2-3 (standard message) | TV, streaming, radio | 4x |
14
+ | 60-second | 140-160 words | 8-12 | 3-5 (full narrative) | Premium TV, brand storytelling | 8x |
15
+ | 90-second | 210-240 words | 12-18 | 4-6 (complex story) | Infomercial intro, brand films | 12x |
16
+ | 2-minute | 280-320 words | 16-24 | 5-8 (detailed explanation) | Direct response, product demos | 16x |
17
+ | 5-minute | 700-800 words | 40-60 | 10+ (comprehensive) | Infomercials, brand documentaries | 40x |
18
+ | 30-minute | 4,200-4,800 words | 240-360 | 20+ (full program) | Long-form infomercials | 240x |
19
+ | 60-minute | 8,400-9,600 words | 480-720 | 40+ (documentary) | Brand documentaries, sponsored content | 480x |
20
+
21
+ ## 6-Second Commercials (Bumpers)
22
+
23
+ ### Specifications
24
+ - **Word Count:** 8-12 words maximum
25
+ - **Sentences:** 1 (maybe 2 very short)
26
+ - **Structure:** Brand + tagline OR hook + brand
27
+ - **Pacing:** Extremely fast, no wasted frames
28
+
29
+ ### Best Practices
30
+ - **Logo/brand must be visible entire duration**
31
+ - **One visual idea only**
32
+ - **Audio: Music sting or single voiceover line**
33
+ - **No complex messaging—brand awareness only**
34
+ - **Often used as "reminder" after longer spot**
35
+
36
+ ### Timing Breakdown
37
+ - 0:00-0:02 - Visual hook or brand reveal
38
+ - 0:02-0:05 - Tagline/message delivery
39
+ - 0:05-0:06 - Brand reinforcement
40
+
41
+ ### Example Scripts
42
+
43
+ **Example 1: Fast Food**
44
+ ```
45
+ [OPEN ON: Burger being assembled in fast-motion]
46
+ VOICEOVER: "Hungry? McDonald's."
47
+ [LOGO]
48
+ ```
49
+
50
+ **Example 2: Streaming Service**
51
+ ```
52
+ [OPEN ON: Netflix logo animation]
53
+ VOICEOVER: "Your next obsession awaits."
54
+ [LOGO HOLD]
55
+ ```
56
+
57
+ **Example 3: Automotive**
58
+ ```
59
+ [OPEN ON: Car speeding past camera]
60
+ SUPER: "The New Apex. Coming Soon."
61
+ [LOGO]
62
+ ```
63
+
64
+ ## 15-Second Commercials
65
+
66
+ ### Specifications
67
+ - **Word Count:** 30-40 words
68
+ - **Sentences:** 2-3 short sentences
69
+ - **Structure:** Hook + benefit + CTA
70
+ - **Pacing:** Fast, every word counts
71
+
72
+ ### Best Practices
73
+ - **Single message only—no room for complexity**
74
+ - **Hook in first 2 seconds**
75
+ - **CTA in final 3-4 seconds**
76
+ - **Visual storytelling > dialogue**
77
+ - **Often paired with 30-second version**
78
+
79
+ ### Timing Breakdown
80
+ - 0:00-0:03 - Hook (visual or audio)
81
+ - 0:03-0:10 - Benefit demonstration
82
+ - 0:10-0:15 - CTA + brand
83
+
84
+ ### Example Scripts
85
+
86
+ **Example 1: Insurance (Problem-Solution)**
87
+ ```
88
+ 0:00-0:03
89
+ [OPEN ON: Car accident (toy cars)]
90
+ VOICEOVER: "Accidents happen."
91
+
92
+ 0:03-0:10
93
+ [REVEAL: Real car, protected]
94
+ VOICEOVER: "SafeGuard Insurance has you covered."
95
+
96
+ 0:10-0:15
97
+ VOICEOVER: "Get a quote in 60 seconds. SafeGuard.com."
98
+ [SUPER: SafeGuard.com]
99
+ ```
100
+
101
+ **Example 2: Retail (Promotional)**
102
+ ```
103
+ 0:00-0:03
104
+ [OPEN ON: "50% OFF" graphic, dynamic]
105
+ VOICEOVER: "Fifty percent off everything."
106
+
107
+ 0:03-0:10
108
+ [MONTAGE: Products, fast cuts]
109
+ VOICEOVER: "This weekend only at Target."
110
+
111
+ 0:10-0:15
112
+ VOICEOVER: "In stores and online. Target."
113
+ [LOGO]
114
+ ```
115
+
116
+ **Example 3: Tech Product (Feature Focus)**
117
+ ```
118
+ 0:00-0:03
119
+ [OPEN ON: Phone screen, fingerprint unlock]
120
+ VOICEOVER: "Unlock with a touch."
121
+
122
+ 0:03-0:10
123
+ [DEMONSTRATE: Face ID, seamless]
124
+ VOICEOVER: "Or a glance. iPhone 15."
125
+
126
+ 0:10-0:15
127
+ VOICEOVER: "Available now at Apple.com."
128
+ [LOGO + URL]
129
+ ```
130
+
131
+ ### Word Count Guidelines
132
+ - **Voiceover:** 30-35 words (comfortable pace)
133
+ - **On-screen text:** 5-10 words maximum
134
+ - **CTA:** 8-12 words
135
+ - **Total:** Should feel unhurried despite short duration
136
+
137
+ ## 30-Second Commercials (Industry Standard)
138
+
139
+ ### Specifications
140
+ - **Word Count:** 60-75 words
141
+ - **Sentences:** 4-6 sentences
142
+ - **Structure:** Problem-solution-CTA OR narrative arc
143
+ - **Pacing:** Moderate, room for storytelling
144
+
145
+ ### Best Practices
146
+ - **Most versatile format**
147
+ - **Full problem-solution structure possible**
148
+ - **2-3 key messages maximum**
149
+ - **Emotional connection achievable**
150
+ - **Standard for TV, streaming, radio**
151
+
152
+ ### Timing Breakdown (Problem-Solution)
153
+ - 0:00-0:08 - Problem/hook (establish need)
154
+ - 0:08-0:22 - Solution (product demonstration)
155
+ - 0:22-0:30 - CTA + brand reinforcement
156
+
157
+ ### Timing Breakdown (Narrative)
158
+ - 0:00-0:10 - Setup (introduce character/situation)
159
+ - 0:10-0:20 - Conflict/transformation
160
+ - 0:20-0:30 - Resolution + CTA
161
+
162
+ ### Example Scripts
163
+
164
+ **Example 1: Healthcare (Problem-Solution)**
165
+ ```
166
+ 0:00-0:08 - PROBLEM
167
+ [OPEN ON: Man at pharmacy counter, frustrated]
168
+ MAN: "My prescription costs how much?"
169
+ PHARMACIST: "Three hundred dollars."
170
+
171
+ 0:08-0:22 - SOLUTION
172
+ [TRANSITION: Same man, using app]
173
+ VOICEOVER: "GoodRx finds you the lowest price.
174
+ Same prescription, same pharmacy."
175
+ [SHOW: Price comparison, $45]
176
+ MAN: "Forty-five dollars. Thank you."
177
+
178
+ 0:22-0:30 - CTA
179
+ VOICEOVER: "Download GoodRx free. Save up to 80%."
180
+ [SUPER: GoodRx.com - Free App]
181
+ [LOGO]
182
+ ```
183
+
184
+ **Example 2: Automotive (Emotional Narrative)**
185
+ ```
186
+ 0:00-0:10 - SETUP
187
+ [OPEN ON: Father and teenage daughter in car]
188
+ [Awkward silence]
189
+ DAUGHTER: "So... how was work?"
190
+ FATHER: "Good. You?"
191
+
192
+ 0:10-0:20 - TRANSFORMATION
193
+ [Music starts, they both relax]
194
+ [Conversation becomes natural, they laugh]
195
+ VOICEOVER: "The journey matters as much as the destination."
196
+
197
+ 0:20-0:30 - RESOLUTION + CTA
198
+ [PULL BACK: Reveal car brand]
199
+ VOICEOVER: "The new Honda Accord. Bringing families together."
200
+ [SUPER: TestDrive.Honda.com]
201
+ [LOGO]
202
+ ```
203
+
204
+ **Example 3: Food Delivery (Lifestyle)**
205
+ ```
206
+ 0:00-0:10 - SETUP
207
+ [OPEN ON: Group of friends, game night]
208
+ FRIEND 1: "I'm starving."
209
+ FRIEND 2: "Pizza?"
210
+ FRIEND 3: "Had it yesterday."
211
+ FRIEND 4: "Thai?"
212
+ FRIEND 1: "Too far."
213
+
214
+ 0:10-0:20 - SOLUTION
215
+ [FRIEND 2 opens app]
216
+ FRIEND 2: "DoorDash has everything."
217
+ [MONTAGE: Multiple restaurants, fast delivery]
218
+
219
+ 0:20-0:30 - CTA
220
+ VOICEOVER: "Whatever you're craving, DoorDash delivers."
221
+ [SUPER: DoorDash.com - $0 Delivery Fee]
222
+ [LOGO]
223
+ ```
224
+
225
+ ### Word Count Guidelines
226
+ - **Voiceover:** 60-70 words (natural pace)
227
+ - **Dialogue:** 40-50 words (if character-driven)
228
+ - **On-screen text:** 10-15 words
229
+ - **CTA:** 12-18 words
230
+ - **Total:** Should feel complete, not rushed
231
+
232
+ ## 60-Second Commercials (Premium Format)
233
+
234
+ ### Specifications
235
+ - **Word Count:** 140-160 words
236
+ - **Sentences:** 8-12 sentences
237
+ - **Structure:** Full 3-act narrative OR detailed demonstration
238
+ - **Pacing:** Relaxed, room for emotional depth
239
+
240
+ ### Best Practices
241
+ - **Full storytelling possible**
242
+ - **Multiple benefits can be shown**
243
+ - **Emotional resonance is key**
244
+ - **Higher production value expected**
245
+ - **Often used for brand building, not direct response**
246
+
247
+ ### Timing Breakdown (3-Act Narrative)
248
+ - 0:00-0:15 - Act 1: Setup (introduce world, character, conflict)
249
+ - 0:15-0:45 - Act 2: Development (show transformation, build emotion)
250
+ - 0:45-0:60 - Act 3: Resolution (payoff, CTA, brand)
251
+
252
+ ### Timing Breakdown (Product Demonstration)
253
+ - 0:00-0:10 - Hook (capture attention, establish need)
254
+ - 0:10-0:40 - Features/Benefits (demonstrate 3-5 key points)
255
+ - 0:40-0:50 - Social proof (testimonials, awards, data)
256
+ - 0:50-0:60 - CTA + brand
257
+
258
+ ### Example Scripts
259
+
260
+ **Example 1: Financial Services (Emotional Narrative)**
261
+ ```
262
+ 0:00-0:15 - ACT 1: SETUP
263
+ [OPEN ON: Young couple, looking at houses online]
264
+ [They close laptop, disappointed]
265
+ WOMAN: "We'll never be able to afford a house."
266
+ MAN: "Maybe in a few years."
267
+
268
+ 0:15-0:45 - ACT 2: DEVELOPMENT
269
+ [TRANSITION: Meeting with financial advisor]
270
+ ADVISOR: "Let's look at your options."
271
+ [MONTAGE: Budgeting, saving, planning]
272
+ VOICEOVER: "At First National, we don't just give you a loan.
273
+ We help you build a future."
274
+ [SHOW: Couple viewing actual houses, excited]
275
+
276
+ 0:45-0:60 - ACT 3: RESOLUTION
277
+ [COUPLE standing in front of their new home, keys in hand]
278
+ [They embrace, emotional]
279
+ VOICEOVER: "First National Bank. Your partner in life's biggest moments."
280
+ [SUPER: FirstNational.com/HomeLoans]
281
+ [LOGO]
282
+ ```
283
+
284
+ **Example 2: Technology (Product Demo)**
285
+ ```
286
+ 0:00-0:10 - HOOK
287
+ [OPEN ON: Cluttered desk, multiple devices, cables everywhere]
288
+ VOICEOVER: "Your workspace doesn't have to be this complicated."
289
+
290
+ 0:10-0:40 - FEATURES/BENEFITS
291
+ [REVEAL: Single laptop, clean desk]
292
+ VOICEOVER: "The new MacBook Pro. One device. Unlimited power."
293
+ [DEMONSTRATE: Video editing, 3D rendering, music production]
294
+ VOICEOVER: "Edit 8K video. Render 3D models. Produce music.
295
+ All on battery power that lasts all day."
296
+ [SHOW: Portability, working in coffee shop, park, home]
297
+
298
+ 0:40-0:50 - SOCIAL PROOF
299
+ [TESTIMONIALS: Creative professionals]
300
+ DESIGNER: "It's replaced my entire studio."
301
+ FILMMAKER: "I edit feature films on this."
302
+
303
+ 0:50-0:60 - CTA
304
+ VOICEOVER: "MacBook Pro. Starting at $1,999.
305
+ Visit Apple.com or your nearest Apple Store."
306
+ [SUPER: Apple.com/MacBookPro]
307
+ [LOGO]
308
+ ```
309
+
310
+ ### Word Count Guidelines
311
+ - **Voiceover:** 140-150 words (relaxed, natural pace)
312
+ - **Dialogue:** 80-100 words (if character-driven)
313
+ - **On-screen text:** 15-25 words
314
+ - **CTA:** 20-30 words
315
+ - **Total:** Should feel cinematic, not rushed
316
+
317
+ ## Format Selection Guide
318
+
319
+ ### Choose 6-Second When:
320
+ - Budget is extremely limited
321
+ - Need digital pre-roll (YouTube, streaming)
322
+ - Brand awareness is only goal
323
+ - Part of larger campaign (reminder spot)
324
+
325
+ ### Choose 15-Second When:
326
+ - Simple, single message
327
+ - Radio advertising
328
+ - Digital platforms (social media, streaming)
329
+ - Budget-conscious but need more than bumper
330
+ - Paired with 30-second version
331
+
332
+ ### Choose 30-Second When:
333
+ - Standard TV or streaming buy
334
+ - Need problem-solution structure
335
+ - 2-3 key messages
336
+ - Industry standard, most versatile
337
+ - Balance of cost and storytelling
338
+
339
+ ### Choose 60-Second When:
340
+ - Premium brand building
341
+ - Emotional storytelling is priority
342
+ - Multiple product benefits to show
343
+ - Higher budget allows for production value
344
+ - Launching new brand or major product
345
+
346
+ ### Choose 90-Second+ When:
347
+ - Direct response/infomercial
348
+ - Complex product requiring explanation
349
+ - B2B with technical details
350
+ - Brand documentary approach
351
+ - Sponsored content or native advertising
352
+
353
+ ## Cross-Format Strategies
354
+
355
+ ### The 60-30-15 Suite
356
+ Create three versions of same campaign:
357
+ - **60-second:** Full emotional narrative (brand building)
358
+ - **30-second:** Condensed version (standard rotation)
359
+ - **15-second:** Reminder spot (high frequency, low cost)
360
+
361
+ ### The Modular Approach
362
+ Build 60-second spot from modular 15-second segments:
363
+ - Segment 1: Problem (0:00-0:15)
364
+ - Segment 2: Solution (0:15-0:30)
365
+ - Segment 3: Benefits (0:30-0:45)
366
+ - Segment 4: CTA (0:45-0:60)
367
+
368
+ Each segment can run independently as 15-second spot.
369
+
370
+ ## Pacing and Rhythm
371
+
372
+ ### Words Per Second by Format
373
+ - **6-second:** 1.5-2 words/second (very fast)
374
+ - **15-second:** 2-2.5 words/second (fast)
375
+ - **30-second:** 2-2.5 words/second (moderate)
376
+ - **60-second:** 2.3-2.7 words/second (relaxed)
377
+ - **90-second+:** 2.3-2.5 words/second (conversational)
378
+
379
+ ### Silence and Pauses
380
+ - **6-second:** No silence, continuous
381
+ - **15-second:** Minimal pauses (0.5-1 second total)
382
+ - **30-second:** Strategic pauses (2-3 seconds total)
383
+ - **60-second:** Breathing room (5-8 seconds total)
384
+ - **90-second+:** Natural conversation pace
385
+
386
+ ## Conclusion
387
+
388
+ Format selection is a strategic decision that impacts creative approach, budget, and effectiveness. Understand the constraints and opportunities of each duration, and choose the format that best serves your message, audience, and business objectives.
389
+
390
+ ---
391
+
392
+ **Next Steps:**
393
+ - Review [Commercial Types](./commercial-types.md) for category-specific guidelines
394
+ - Explore [Commercial Scripts](./commercial-scripts.md) for formatting standards
395
+ - Study [Persuasion Techniques](./commercial-persuasion.md) for advanced strategies
396
+