@mytechtoday/augment-extensions 2.4.0 → 2.5.0

package/augment-extensions/writing-standards/screenplay/commercials/module.json

@@ -0,0 +1,111 @@
+{
+  "name": "commercials",
+  "version": "1.0.0",
+  "displayName": "Commercial Writing Standards",
+  "description": "Comprehensive commercial writing standards for TV, streaming, and digital advertising including format-specific rules, legal compliance, and persuasive techniques",
+  "type": "writing-standards",
+  "language": "screenplay",
+  "parent": "screenplay",
+  "tags": [
+    "commercials",
+    "advertising",
+    "tv-commercials",
+    "streaming-ads",
+    "digital-advertising",
+    "persuasion",
+    "legal-compliance",
+    "ftc",
+    "brand-messaging"
+  ],
+  "dependencies": {
+    "screenplay": "^1.0.0"
+  },
+  "augment": {
+    "characterCount": 408000,
+    "characterCountNote": "17 content files × 24,000 avg chars (3k-45k range) = ~408,000 total",
+    "perFileRange": "3,000 - 45,000",
+    "priority": "medium",
+    "category": "writing-standards",
+    "appliesTo": {
+      "filePatterns": [
+        "**/*.fountain",
+        "**/commercials/**/*.md",
+        "**/ads/**/*.fountain"
+      ],
+      "projectTypes": [
+        "commercial",
+        "advertising",
+        "marketing"
+      ]
+    }
+  },
+  "installation": {
+    "required": false,
+    "steps": [
+      "Link parent module: augx link writing-standards/screenplay",
+      "Link commercials module: augx link writing-standards/screenplay/commercials",
+      "Configure in .augment/screenplay-config.json with 'commercials' category",
+      "Use Fountain format (.fountain) for commercial scripts"
+    ]
+  },
+  "configuration": {
+    "file": ".augment/commercials-config.json",
+    "schema": {
+      "formats": {
+        "type": "array",
+        "items": {
+          "enum": [
+            "tv-15sec",
+            "tv-30sec",
+            "tv-60sec",
+            "streaming-pre-roll",
+            "streaming-mid-roll",
+            "digital-banner",
+            "social-media",
+            "radio"
+          ]
+        },
+        "description": "Commercial formats to apply"
+      },
+      "legalCompliance": {
+        "type": "boolean",
+        "default": true,
+        "description": "Enable FTC and legal compliance checks"
+      },
+      "brandGuidelines": {
+        "type": "object",
+        "description": "Brand-specific guidelines and restrictions"
+      }
+    }
+  },
+  "contents": {
+    "rules": [
+      "core-principles.md",
+      "format-15sec.md",
+      "format-30sec.md",
+      "format-60sec.md",
+      "streaming-pre-roll.md",
+      "streaming-mid-roll.md",
+      "digital-banner.md",
+      "social-media.md",
+      "radio.md",
+      "persuasion-techniques.md",
+      "call-to-action.md",
+      "brand-messaging.md",
+      "legal-compliance.md",
+      "ftc-guidelines.md",
+      "production-notes.md"
+    ],
+    "examples": [
+      "tv-30sec-example.fountain",
+      "streaming-pre-roll-example.fountain"
+    ]
+  },
+  "references": {
+    "ftc": "https://www.ftc.gov/business-guidance/advertising-marketing",
+    "aaa": "https://www.aaaa.org/",
+    "adAge": "https://adage.com/",
+    "cannesLions": "https://www.canneslions.com/"
+  }
+}
+

package/augment-extensions/writing-standards/screenplay/commercials/rules/commercial-audience.md

@@ -0,0 +1,343 @@
+# Commercial Audience Targeting
+
+## Overview
+
+Effective audience targeting ensures your commercial speaks directly to the right people with the right message. A commercial for everyone is a commercial for no one.
+
+---
+
+## Audience Segmentation
+
+### 1. Demographics
+
+**Quantifiable characteristics of your audience**
+
+#### Age
+**Why it matters:** Different generations have different values, media habits, and communication styles
+
+**Age Segments:**
+- **Gen Z (1997-2012):** Digital natives, social justice, authenticity, short attention spans
+- **Millennials (1981-1996):** Experience-focused, tech-savvy, value-driven, skeptical of ads
+- **Gen X (1965-1980):** Independent, pragmatic, work-life balance, brand loyal
+- **Boomers (1946-1964):** Traditional values, brand loyal, TV viewers, financial security
+- **Silent Gen (1928-1945):** Conservative, traditional media, trust established brands
+
+**Age-Appropriate Messaging:**
+```
+GEN Z (18-26):
+"No cap, this app is bussin'. Download now and get your first month free."
+[Fast cuts, TikTok-style, trending music]
+
+MILLENNIALS (27-42):
+"Adulting is hard. We make it easier."
+[Relatable humor, authentic testimonials, mobile-first]
+
+GEN X (43-58):
+"Quality you can trust. Value you deserve."
+[Straightforward, no-nonsense, practical benefits]
+
+BOOMERS (59-77):
+"Trusted for over 50 years. Serving families like yours."
+[Traditional format, clear messaging, established credibility]
+```
+
+#### Gender
+**Why it matters:** Different genders may have different needs, preferences, and pain points
+
+**Best Practices:**
+- ✅ Avoid stereotypes (women = cleaning, men = cars)
+- ✅ Show diverse gender representation
+- ✅ Consider non-binary and gender-fluid audiences
+- ✅ Focus on benefits, not gender assumptions
+- ❌ Don't alienate with gendered language unless product-specific
+
+**Example - Gender-Neutral Approach:**
+```
+BAD: "Ladies, tired of your husband leaving the toilet seat up?"
+GOOD: "Everyone deserves a bathroom that works for them."
+```
+
+#### Income Level
+**Why it matters:** Determines purchasing power and value perception
+
+**Income Segments:**
+- **Budget-Conscious:** Price, value, deals, savings
+- **Middle-Income:** Quality-to-price ratio, practical benefits
+- **Affluent:** Premium quality, exclusivity, status, experience
+
+**Income-Appropriate Messaging:**
+```
+BUDGET:
+"Get more for less. $9.99/month. Cancel anytime."
+
+MIDDLE:
+"Premium quality at a fair price. Worth every penny."
+
+AFFLUENT:
+"Handcrafted excellence. Limited availability."
+```
+
+#### Location
+**Why it matters:** Geographic differences in culture, climate, needs, regulations
+
+**Location Considerations:**
+- **Urban vs. Rural:** Different lifestyles, needs, values
+- **Regional Culture:** Southern hospitality, West Coast casual, Northeast direct
+- **Climate:** Seasonal products, weather-related needs
+- **International:** Language, cultural norms, legal requirements
+
+### 2. Psychographics
+
+**Psychological characteristics, values, attitudes, interests, lifestyle**
+
+#### Values
+**What your audience cares about deeply**
+
+**Value Categories:**
+- **Family:** Connection, tradition, legacy
+- **Achievement:** Success, recognition, excellence
+- **Security:** Safety, stability, protection
+- **Freedom:** Independence, adventure, choice
+- **Sustainability:** Environment, ethics, responsibility
+- **Innovation:** Progress, technology, future
+
+**Value-Based Messaging:**
+```
+FAMILY VALUES:
+"Because the moments that matter most are the ones we share."
+[SHOW: Multi-generational family gathering]
+
+ACHIEVEMENT VALUES:
+"For those who refuse to settle for second place."
+[SHOW: Athlete training, entrepreneur working late]
+
+SUSTAINABILITY VALUES:
+"Good for you. Good for the planet."
+[SHOW: Natural ingredients, eco-friendly packaging]
+```
+
+#### Lifestyle
+**How your audience lives, works, and plays**
+
+**Lifestyle Segments:**
+- **Active/Fitness:** Health-conscious, outdoorsy, athletic
+- **Professional:** Career-focused, busy, efficiency-driven
+- **Creative:** Artistic, expressive, unconventional
+- **Homebody:** Comfort, relaxation, family time
+- **Social:** Outgoing, experience-seeking, trend-following
+
+**Lifestyle-Targeted Messaging:**
+```
+ACTIVE LIFESTYLE:
+[OPEN ON: Runner at sunrise, mountain biker on trail]
+"Fuel your passion. Recover faster. Go further."
+
+PROFESSIONAL LIFESTYLE:
+[OPEN ON: Busy office, multiple screens, coffee]
+"Work smarter, not harder. Automate the boring stuff."
+
+HOMEBODY LIFESTYLE:
+[OPEN ON: Cozy living room, blanket, streaming]
+"Your perfect night in starts here."
+```
+
+#### Interests
+**What your audience is passionate about**
+
+**Interest Categories:**
+- **Technology:** Gadgets, apps, innovation
+- **Fashion:** Style, trends, self-expression
+- **Food:** Cooking, dining, culinary experiences
+- **Travel:** Adventure, exploration, culture
+- **Entertainment:** Movies, music, gaming, sports
+
+### 3. Behavioral Segmentation
+
+**How your audience interacts with products and brands**
+
+#### Purchase Behavior
+- **Impulse Buyers:** Emotional triggers, urgency, limited-time offers
+- **Researchers:** Detailed information, comparisons, reviews
+- **Loyal Customers:** Rewards, exclusivity, appreciation
+- **Price-Sensitive:** Deals, discounts, value propositions
+
+#### Media Consumption
+- **TV Viewers:** Traditional commercials, longer formats
+- **Streamers:** Pre-roll, mid-roll, skippable vs. non-skippable
+- **Social Media:** Short-form, mobile-optimized, shareable
+- **Podcast Listeners:** Audio-only, host-read, conversational
+
+#### Brand Relationship
+- **Aware but not engaged:** Education, benefits, trial offers
+- **Engaged but not purchased:** Overcome objections, social proof
+- **Customers:** Upsell, cross-sell, loyalty programs
+- **Advocates:** Referral programs, user-generated content
+
+---
+
+## Age-Appropriate Content
+
+### Children (Under 13)
+**HEAVILY REGULATED - COPPA Compliance Required**
+
+**Rules:**
+- ✅ Educational, positive messaging
+- ✅ No pressure tactics ("Buy now!")
+- ✅ No collection of personal data
+- ✅ Parental involvement in purchase decisions
+- ❌ No fear-based messaging
+- ❌ No unrealistic expectations
+- ❌ No comparison to other children
+
+**Example:**
+```
+"Ask your parents about [toy name]. Fun for the whole family!"
+[SHOW: Children playing happily, parents smiling]
+```
+
+### Teens (13-17)
+**Sensitive to authenticity and peer influence**
+
+**Best Practices:**
+- ✅ Authentic, not "trying too hard"
+- ✅ Peer acceptance, social belonging
+- ✅ Independence, self-expression
+- ✅ Current trends, music, slang (but don't overdo it)
+- ❌ Don't talk down or preach
+- ❌ Avoid obvious "fellow kids" pandering
+
+### Adults (18-64)
+**Widest range, segment by life stage**
+
+**Life Stages:**
+- **Young Adults (18-25):** Independence, career start, relationships
+- **Established Adults (26-40):** Career growth, family formation, homeownership
+- **Midlife (41-64):** Peak earning, children leaving home, retirement planning
+
+### Seniors (65+)
+**Respect, clarity, accessibility**
+
+**Best Practices:**
+- ✅ Clear, easy-to-read text
+- ✅ Slower pacing, clear audio
+- ✅ Respect and dignity (not condescending)
+- ✅ Practical benefits, value, reliability
+- ❌ Don't assume tech illiteracy
+- ❌ Avoid ageist stereotypes
+
+---
+
+## Cultural Sensitivity
+
+### Why It Matters
+**Insensitive commercials can:**
+- Damage brand reputation permanently
+- Trigger boycotts and backlash
+- Alienate entire demographics
+- Result in legal issues
+
+### Best Practices
+
+#### 1. Representation
+**Show diversity authentically**
+- ✅ Include diverse races, ethnicities, abilities, body types
+- ✅ Avoid tokenism (one person of color in background)
+- ✅ Show people in empowered, non-stereotypical roles
+- ✅ Consult with communities you're representing
+
+#### 2. Cultural References
+**Use cultural elements respectfully**
+- ✅ Research cultural significance
+- ✅ Avoid appropriation (using sacred symbols for profit)
+- ✅ Hire cultural consultants
+- ✅ Get feedback from community members
+- ❌ Don't use accents for comedy
+- ❌ Don't reduce cultures to stereotypes
+
+#### 3. Language
+**Choose words carefully**
+- ✅ Use inclusive language
+- ✅ Avoid gendered assumptions
+- ✅ Respect preferred terminology
+- ❌ Don't use slurs or offensive terms (even "reclaimed" ones)
+- ❌ Don't appropriate AAVE or other dialects
+
+#### 4. Religious Sensitivity
+**Respect religious beliefs and practices**
+- ✅ Avoid religious holidays for unrelated products
+- ✅ Respect religious symbols and imagery
+- ✅ Be aware of dietary restrictions, modesty standards
+- ❌ Don't mock or trivialize religious practices
+
+### Examples of Cultural Sensitivity
+
+**GOOD - Inclusive Representation:**
+```
+[SHOW: Diverse group of friends celebrating together]
+[Various ages, races, abilities, body types]
+[Everyone equally featured, no tokenism]
+VOICEOVER: "Everyone's invited. Everyone belongs."
+```
+
+**BAD - Stereotyping:**
+```
+[SHOW: Asian person doing math, wearing glasses]
+[Hispanic person doing yard work]
+[Black person playing basketball]
+[These are harmful stereotypes]
+```
+
+---
+
+## Audience Targeting Examples
+
+### Example 1: Fitness App
+
+**Primary Audience:**
+- **Demographics:** Women 25-40, urban, middle-to-upper income
+- **Psychographics:** Health-conscious, busy professionals, value convenience
+- **Behavioral:** Active on Instagram, follow fitness influencers, tried other apps
+
+**Messaging:**
+```
+"You're busy. We get it. 15-minute workouts that actually work."
+[SHOW: Woman doing quick workout in apartment, then at work looking energized]
+"FitQuick. Real results. Real life."
+```
+
+### Example 2: Retirement Planning
+
+**Primary Audience:**
+- **Demographics:** Adults 50-65, married, homeowners, $100k+ income
+- **Psychographics:** Security-focused, family-oriented, planning ahead
+- **Behavioral:** Watch cable news, read financial publications, risk-averse
+
+**Messaging:**
+```
+"You've worked hard for 30 years. Make sure it counts."
+[SHOW: Couple reviewing finances with advisor, relaxed and confident]
+"Fidelity Retirement Planning. Your future, secured."
+```
+
+### Example 3: Gaming Console
+
+**Primary Audience:**
+- **Demographics:** Males 18-35, students/young professionals
+- **Psychographics:** Entertainment-focused, social, tech-savvy, competitive
+- **Behavioral:** Heavy social media users, watch Twitch/YouTube, online communities
+
+**Messaging:**
+```
+[FAST CUTS: Epic game footage, friends playing together, tournament action]
+[MUSIC: High-energy electronic]
+"This is next-gen. This is PlayStation 5."
+```
+
+---
+
+## Resources
+
+- **Research Tools:** Google Analytics, Facebook Audience Insights, Nielsen ratings
+- **Cultural Consultants:** Hire experts from communities you're representing
+- **Testing:** Focus groups, A/B testing, social listening
+- **Guidelines:** ANA (Association of National Advertisers), IAB (Interactive Advertising Bureau)