@azerogluemin/ai-bootstrap 0.2.1

package/templates/skills/screenwriter/knowledge/categories/advertising/formats/90s-manifesto.md

@@ -0,0 +1,184 @@
+# 90s Manifesto — Format
+
+> Brand manifesto. Long-form emotional declaration of brand values. Often launch piece for campaign.
+
+## Format basics
+
+- Length: 90 seconds (sometimes up to 120s)
+- Aspect: 16:9 cinematic
+- Maximum production value
+- Voice-over driven
+- Emotional, philosophical
+- Defines brand "why"
+
+## Structure (Manifesto arc)
+
+```
+0-10s   OPENING DECLARATION
+        Strong opening line
+        Visual atmosphere
+        Brand voice established
+
+10-30s  BUILDING THE THESIS
+        Examples of philosophy
+        Multiple vignettes
+        Pattern recognition
+
+30-60s  PEAK / PHILOSOPHY
+        Core insight
+        Emotional center
+        "This is what we believe"
+
+60-80s  EXPANSION / PROOF
+        How brand embodies this
+        Continued examples
+        Universal-to-specific
+
+80-88s  BRAND CONNECTION
+        Brand named
+        Tagline lands
+        Final image
+
+88-90s  LOGO
+```
+
+## Sample 90s manifesto
+
+```
+TITLE: "Karavan — 90s Manifesto: 'For Those Who Carry'"
+
+FADE IN:
+
+EXT. BAKU CITY - DAWN (0-10s)
+
+Slow aerial. The city wakes. Lights blink on in apartment buildings.
+A woman runs. A man unlocks his shop. A baker pulls bread from oven.
+
+V.O. (warm, deliberate)
+This is for the ones who rise before the sun.
+
+INT. KITCHEN - SAME (10-25s)
+
+A FATHER prepares lunches for his children. Makes coffee. The day's
+weight is already on him.
+
+V.O.
+For the ones who carry their family's hopes.
+
+INT. HOSPITAL - DAY (25-35s)
+
+A NURSE clocks in for the third double shift. Pulls her hair back.
+Drinks deeply from a thermos. Squares her shoulders.
+
+V.O.
+For the ones who carry strangers' grief.
+
+INT. CLASSROOM - MORNING (35-45s)
+
+A TEACHER writes on the board. Twenty children watch. She looks at
+them — each one a future. Begins.
+
+V.O.
+For the ones who carry the next generation.
+
+EXT. CONSTRUCTION SITE - DAY (45-55s)
+
+WORKERS in silent rhythm. Lifting. Building. The skyline rising.
+
+V.O.
+For the ones who carry the city itself.
+
+INT. STUDIO - NIGHT (55-65s)
+
+An ARTIST works alone late. Coffee cools beside her. She begins
+again. And again. Refusing to surrender to the blank.
+
+V.O.
+For the ones who carry their own questions.
+
+EXT. CITY ROOFTOP - SUNSET (65-78s)
+
+Many of these people, in different locations across the city, take
+a moment. Each holds a Karavan thermos. Each takes a breath. Each
+begins again.
+
+V.O.
+We make coffee for those who carry.
+
+CUT TO:
+
+V.O.
+Because we know that a real morning fuel
+is not a luxury.
+
+It is a partner.
+
+LOGO REVEAL (78-90s):
+
+Karavan logo materializes, gold against deep navy.
+
+V.O.
+Karavan. The fuel for what you carry.
+
+karavan.az appears below.
+
+FADE OUT.
+```
+
+## Key principles
+
+### Manifesto voice
+Singular V.O. — calm, considered, declarative:
+- "This is for..."
+- "We believe..."
+- "For those who..."
+
+Not pitching, declaring.
+
+### Vignette structure
+Multiple short scenes proving the thesis:
+- 5-10 short character moments
+- Each represents the larger truth
+- Universal through specific people
+
+### Build to brand
+Brand emerges at climax:
+- Audience already feels the value
+- Brand contextualizes the feeling
+- "This is who we serve"
+
+### Music as backbone
+- Building orchestration
+- Crescendo at brand reveal
+- Singular emotional arc
+
+### Production value
+Manifesto films are HERO content:
+- Top-tier directors
+- Cinematic everything
+- No corners cut
+
+## Common mistakes
+
+- Too much VO (let images breathe)
+- Generic vignettes (need specificity)
+- Brand too late or too early
+- Multiple competing themes
+- Music dominating dialogue
+- Tagline cliché
+- Self-importance without earning
+
+## When to make a manifesto
+
+- Brand launch
+- Major repositioning
+- Annual brand statement
+- Cause marketing
+- Crisis response (carefully)
+
+## Pairs well with
+
+- 30s spots (excerpts of manifesto philosophy)
+- 6s bumpers (tagline reinforcement)
+- Print + outdoor (manifesto lines as headlines)
+- Brand campaign year-long arc

package/templates/skills/screenwriter/knowledge/categories/advertising/formats/comparison-ad.md

@@ -0,0 +1,207 @@
+# Comparison Ad — Format
+
+> "Us vs them" advertising. Direct competitor positioning. Risky but powerful.
+
+## Format basics
+
+- Length: 30s - 60s
+- Aspect: 16:9 or 9:16
+- Side-by-side or sequential comparison
+- Clear differentiator focus
+- Legal compliance critical
+
+## Structure
+
+```
+0-5s    SETUP / SHARED CONTEXT
+        Common scenario
+        Both products implied
+
+5-20s   COMPETITOR DEMONSTRATION
+        Generic / nameless competitor
+        Pain point / limitation shown
+        Neutral framing
+
+20-40s  YOUR PRODUCT DEMONSTRATION
+        Same scenario, your product
+        Solves limitation
+        Visible improvement
+
+40-55s  KEY DIFFERENTIATOR
+        Specific advantage stated
+        Why this matters
+        Proof point
+
+55-60s  CTA + BRAND
+        Logo
+        Where to choose better
+```
+
+## Sample 60s comparison ad
+
+```
+TITLE: "Karavan vs Generic — 60s Comparison"
+
+INT. SAME APARTMENT KITCHEN - MORNING (0-5s)
+
+WOMAN (32) at coffee maker. Morning routine.
+
+ON SCREEN TEXT: "Two mornings. Same coffee maker."
+
+INT. SAME - "Other coffee" morning (5-20s)
+
+She uses an unbranded "other coffee" — package shown but logo blurred
+(generic instant or supermarket bag).
+
+She brews. Pours. Sips.
+
+Her face: blank, "okay."
+
+ON SCREEN TEXT: "Roasted: unknown date. Origin: 'blend.'"
+
+CUT TO HER LEAVING for work. Looking at watch. Tense.
+
+V.O.
+Other coffee gets you out the door.
+
+INT. SAME - "Karavan" morning (20-40s)
+
+Same routine, but with Karavan bag.
+
+She brews. Pours. Sips.
+
+Her face: pause. Notice. Smile.
+
+ON SCREEN TEXT: "Roasted: 12 days ago. Origin: Ethiopia + Brazil, single farms."
+
+She sits with the coffee. Reads a book. Has time.
+
+V.O.
+Karavan starts the day.
+
+DUAL SCREEN COMPARISON (40-55s):
+
+LEFT: Other coffee package + tasteless graph
+RIGHT: Karavan + tasting notes graphic
+
+ON SCREEN COMPARISON CHART:
+- Roast date transparency
+- Single-origin
+- Subscription convenience
+- Cost per cup
+
+V.O.
+Karavan: roast date on every bag. Single-origin. Subscription delivery.
+Same price as your supermarket coffee.
+
+CUT TO Karavan branding (55-60s):
+
+Karavan logo. URL.
+
+V.O.
+Karavan. Why settle for okay?
+
+karavan.az
+```
+
+## Key principles
+
+### Don't name competitor (legally safer)
+- "Other coffee"
+- "Generic brand"
+- "What you're using now"
+
+Naming competitor opens legal exposure (false advertising claims).
+
+### Show, don't trash-talk
+- Visual demonstration of difference
+- Avoid putting competitor down explicitly
+- Focus on YOUR advantages
+
+### Specific, substantiated claims
+- Numbers, dates, sources
+- Verifiable facts
+- Avoid vague superiority
+
+### Same conditions
+- Same scenario / setup
+- Same user / context
+- Only the product changes
+- Fair comparison
+
+### Differentiator clarity
+- ONE main differentiator (not five)
+- Easy to remember
+- Important to audience
+- Demonstrable
+
+## Sub-types
+
+### Side-by-side
+- Split screen
+- Same moment, different products
+- Visual comparison
+
+### Sequential
+- One then the other
+- Same character experiences both
+- Transformation shown
+
+### Chart-based
+- Feature comparison chart
+- Clear winner
+- Specs side by side
+
+### Customer comparison
+- "I tried X, then I tried Y"
+- Personal story
+- Authentic switch
+
+## Compliance considerations
+
+### Legal restrictions
+- Can't make false claims about competitor
+- Must substantiate advantages
+- Country-specific regulations
+- "Best" claims need proof
+
+### Industry restrictions
+- Pharma: heavily regulated
+- Financial: disclosures required
+- Telecom: detailed comparison rules
+- Auto: specific claim limits
+
+### Best practice
+Always have legal review before airing comparison ads.
+
+## When to use
+
+- Clear differentiator vs competitors
+- Established competitor to position against
+- Audience considering switch
+- Quality difference visible/demonstrable
+- Regulatory environment permits
+
+## Risks
+
+- Competitor lawsuit
+- Audience sympathy for "underdog"
+- Looking petty
+- Inviting competitor response
+- Validating competitor by mentioning
+
+## Alternative: implicit comparison
+
+Less risky:
+- "Coffee with roast dates" (implies others don't)
+- "Premium without the markup" (implies others overcharge)
+- Audience fills in the comparison
+
+## Common mistakes
+
+- Naming competitor (legal risk)
+- Vague claims ("better")
+- Unfair comparison (different conditions)
+- No specific differentiator
+- Trashing tone (alienates)
+- Forgetting your own brand

package/templates/skills/screenwriter/knowledge/categories/advertising/formats/holiday-seasonal.md

@@ -0,0 +1,223 @@
+# Holiday / Seasonal — Format
+
+> Holiday or seasonal advertising. Tied to specific calendar moment. Emotional, traditional, often family-focused.
+
+## Format basics
+
+- Length: 30s - 90s (often 60s+)
+- Aspect: 16:9 (TV) and 9:16 (social)
+- Emotionally heightened
+- Cultural moment integration
+- Often premium production
+
+## Holiday categories
+
+| Holiday | Mood | Themes |
+|---------|------|--------|
+| Christmas / NY | Magical, family | Generosity, togetherness, light in dark |
+| Novruz | Renewal, spring | Rebirth, family, tradition |
+| Ramadan / Eid | Reflection, community | Generosity, family, breaking fast |
+| Mother's/Father's Day | Gratitude | Family bonds, recognition |
+| Valentine's Day | Romance | Love, connection, gestures |
+| Halloween | Playful, spooky | Costume, fun, candy |
+| Back-to-School | Anticipation | New beginnings, preparation |
+| Black Friday | Urgency | Deals, buying, scarcity |
+| International Women's Day | Empowerment | Strength, recognition, pride |
+
+## Structure (Holiday emotional arc)
+
+```
+0-5s    OPENING SCENE
+        Holiday mood established
+        Visual cues (color, setting)
+
+5-25s   STORY SETUP
+        Character / family situation
+        Emotional context
+        Tradition or ritual
+
+25-45s  EMOTIONAL JOURNEY
+        Beat that moves audience
+        Holiday meaning embodied
+        Connection moment
+
+45-55s  PRODUCT INTEGRATION
+        Brand part of moment
+        Product enables/enhances
+
+55-60s  BRAND + WISH
+        Logo
+        "Happy [Holiday]" message
+        Brand sign-off
+```
+
+## Sample 60s holiday ad — Novruz
+
+```
+TITLE: "Karavan — Novruz Spot 'Yenidən Başla'"
+
+EXT. APARTMENT BALCONY - DAWN, EARLY SPRING (0-5s)
+
+GRANDMOTHER (70) sets out a Novruz table on a small balcony.
+Cherry blossoms beginning. The first warm morning of spring.
+
+V.O. (warm, considered)
+Some traditions wait all year.
+
+INT. KITCHEN - CONTINUOUS (5-15s)
+
+She prepares samani (sprouted wheat). Carefully arranges seven dishes
+beginning with "S".
+
+CUT TO B-ROLL: Painted eggs, sweets, candle lighting.
+
+V.O.
+For something better.
+
+EXT. BALCONY - LATER (15-30s)
+
+Her DAUGHTER (45) arrives with grandkids. Hugs. The grandkids run
+inside. Daughter sits with Grandmother. Pours coffee from a Karavan
+thermos for both.
+
+V.O.
+And together, we begin again.
+
+INT. APARTMENT - SAME (30-45s)
+
+Whole family around the Novruz table. Grandmother lights the candle.
+Children watch wide-eyed. The grandfather reads a Novruz poem.
+
+Coffee in everyone's cups. Karavan-branded.
+
+V.O.
+We bring back the table. The candle. The taste of spring.
+
+CUT TO: Hands holding the same Karavan thermos, four generations
+visible at table.
+
+V.O. (45-55s)
+And the cup that pours for everyone.
+
+CUT TO LOGO (55-60s):
+
+Karavan logo + Novruz greeting in Azerbaijani:
+"Novruz Bayramınız Mübarək!"
+
+karavan.az appears below.
+
+V.O.
+Karavan. The fuel for what we share.
+```
+
+## Key principles
+
+### Cultural authenticity
+- Real traditions correctly depicted
+- Authentic settings
+- Local voices
+- Avoid stereotypes
+
+### Emotional core
+- Holiday emotional truth
+- Universal but specific feeling
+- Often nostalgic
+- Family/community themes
+
+### Brand as part of tradition
+- Product fits naturally
+- Doesn't dominate
+- Adds to moment, doesn't define it
+
+### Generous spirit
+- Holiday ads about giving/sharing
+- Brand demonstrates values
+- Cause integration possible
+
+### Production value
+- Holiday spots expected to be premium
+- Cinematic
+- Music score
+- Beautiful visuals
+
+## Sub-types
+
+### Family gathering
+- Multi-generation
+- Around table or shared space
+- Tradition focus
+- Brand serves family
+
+### Single character moment
+- Personal reflection
+- Remembrance
+- Quiet emotional beat
+- Brand companion
+
+### Children's holiday
+- Wonder, magic
+- Playful
+- Toy/candy/gift focus
+- Magic of moment
+
+### Surprise / gift moment
+- Setup of surprise
+- Reveal
+- Reaction
+- Brand as gift or enabler
+
+### Cause / generosity
+- Brand gives back
+- Holiday spirit beyond product
+- Donation, support, kindness
+- Brand purpose
+
+## Best practices
+
+### Music
+- Often classical / orchestral
+- Familiar melodies (carefully licensed)
+- Builds emotional arc
+- Crescendo at brand reveal
+
+### Cinematography
+- Warm color grading
+- Practical lighting (candles, fireplaces)
+- Cozy interiors / festive exteriors
+- Wide enough to show scale + close enough to feel
+
+### Casting
+- Authentic to demographic
+- Multi-generational mix
+- Real-feeling families
+- Cultural authenticity
+
+## Compliance
+
+### Religious holidays
+- Respectful representation
+- Avoid commercialization of sacred
+- Consult cultural advisors
+
+### Children
+- Specific advertising rules
+- Age-appropriate
+- Parent-friendly
+
+## Common mistakes
+
+- Generic holiday (not specific to culture)
+- Brand too prominent (intrudes on moment)
+- Stereotypical depiction
+- Missing the holiday emotion
+- Using wrong music (license/cultural)
+- Western default for global audience
+- Stale tropes
+
+## When to use
+
+- Holiday-relevant brands (food, gifts, family products)
+- Annual brand moments
+- Cultural relevance demonstration
+- Emotional connection building
+- Cause-tied campaigns