@azerogluemin/ai-bootstrap 0.2.1

package/templates/skills/screenwriter/knowledge/categories/short-form/formats/tiktok-storytime.md

@@ -0,0 +1,110 @@
+# TikTok Storytime — Format
+
+> Personal narrative on TikTok. 30-90s. Native voice. "POV" or first-person.
+
+## Format basics
+
+- Length: 30-90 seconds
+- Aspect: 9:16 vertical
+- Personal narrative
+- Native TikTok voice (casual, conversational)
+- Selfie or POV camera angle
+
+## Structure
+
+```
+0-3s    HOOK
+        "POV: ..." or shocking statement
+
+3-10s   SETUP
+        Context for the story
+
+10-30s  ESCALATION
+        Story builds, twist hinted
+
+30-50s  CLIMAX
+        The big moment
+
+50-60s  PUNCHLINE / CLIFFHANGER
+        Resolution or part 2 hook
+```
+
+## Sample 60s TikTok storytime
+
+```
+"POV: You crash your ex's wedding by accident"
+
+0-3s: HOOK
+Selfie angle. Direct to camera. Whisper-urgent.
+"Okay so this happened to me last weekend and I'm STILL not okay."
+
+3-10s: SETUP
+Walking outside a hotel.
+Voiceover: "I was in town for my friend Sarah's wedding. Different
+friend. Different venue. So I thought."
+
+10-25s: ESCALATION
+Inside hotel, finding the wedding signs.
+"I show up, walk in, sit at table 7 like the invitation said."
+Reaction shot.
+
+25-40s: TWIST
+Quick cuts: bride entering, then the groom turns toward camera.
+"And then I see..."
+Dramatic pause.
+"HIM."
+Photo of ex (face blurred).
+
+40-55s: REVEAL
+"At the altar. With someone who was DEFINITELY not me."
+Reaction shot at her face.
+"I checked my phone. Wrong venue. Same hotel. Different floor."
+
+55-60s: CLIFFHANGER
+"Reader, the bride saw me. And invited me to stay.
+Follow for part 2 because she had QUESTIONS."
+
+End on subscribe button overlay.
+```
+
+## Key principles
+
+### Native voice
+Talk like you talk to friends. Don't perform.
+
+### Vulnerability
+Real emotions, even ridiculous.
+
+### "POV" framing
+Audience identifies, becomes the character.
+
+### Dramatic pauses
+Use silence for impact.
+
+### Cliffhanger ending
+Drives part 2 follow.
+
+## Common storytime templates
+
+- "POV: you ___"
+- "Storytime about the time I ___"
+- "The audacity of ___"
+- "Things that happened to me at ___"
+- "I'm not okay after ___"
+
+## When to use
+
+- Personal narrative
+- Drama / juicy story
+- Comedy from real life
+- Series / serialized stories
+- Building creator personal brand
+- High engagement potential
+
+## Common mistakes
+
+- Performing instead of being yourself
+- Slow opening (3s rule)
+- Boring middle
+- Resolution too clean (cliffhanger drives follow)
+- Generic story (specifics make it shareable)

package/templates/skills/screenwriter/knowledge/categories/short-form/formats/tiktok-trend.md

@@ -0,0 +1,126 @@
+# TikTok Trend — Format
+
+> Riding a current TikTok trend. Use trending sound, format, or transition. 15-60s.
+
+## Format basics
+
+- Length: 15-60 seconds
+- Aspect: 9:16 vertical
+- Uses trending sound / format / hashtag
+- Must move FAST (trends die in days)
+- Add unique twist (don't just copy)
+
+## Trend types
+
+### Sound trends
+- Specific song/audio clip currently popular
+- Use the original audio
+- Match cuts to beats
+
+### Format trends
+- Specific structure ("Tell me without telling me", "I bet you can't...")
+- Use format with your content
+
+### Visual trends
+- Specific transition (drop, swipe, snap)
+- Specific filter or effect
+
+### Dance trends
+- Choreographed dance to specific song
+
+### Challenge trends
+- Specific task or activity
+
+## Structure (varies by trend)
+
+Generally:
+```
+0-2s    HOOK
+        Trend recognized immediately
+
+2-15s   YOUR TWIST
+        Your unique take
+
+15-30s  CONTENT
+        Format completion
+
+End     CTA / hashtag
+```
+
+## Sample TikTok trend script
+
+```
+TREND: "Tell me you're [X] without telling me you're [X]"
+
+CREATOR'S TAKE: "Tell me you own a coffee shop without telling me
+you own a coffee shop"
+
+0-2s: TEXT OVERLAY
+"Tell me you own a coffee shop without telling me you own a coffee shop"
+
+2-50s: VISUAL CONTENT
+Quick cuts:
+- Smelling beans, eyes closed in pleasure
+- Wiping down a counter at 5 AM
+- Disappointed reaction at someone making instant coffee
+- Pulling out a small grinder from pocket at someone's house
+- Knowing every regular's order before they order
+- Side-eye at decaf orderer
+- Multiple coffee mugs in dishwasher (way too many)
+- Beans in pocket (carrying samples)
+- Receipt printer at 6:47 AM (3 morning regulars)
+
+50-60s: PUNCHLINE / CTA
+Final shot: standing in own coffee shop, smiling.
+Text: "Just opened our second location! Link in bio."
+```
+
+## Key principles
+
+### Use the trending sound
+Use original audio, not sound-alike. Algorithm rewards it.
+
+### Move fast
+Trends have 3-7 day window. Wait too long, irrelevant.
+
+### Add unique twist
+Don't just copy. Make it about YOUR content.
+
+### Match cuts to beats
+Music + video must sync.
+
+### Native TikTok feel
+Don't over-produce. Match the vibe.
+
+## When to use
+
+- Building reach (algorithm boosts trending)
+- Riding cultural moment
+- Brand activation (with trend awareness)
+- Creator audience-building
+- Brand humanizing
+
+## Common mistakes
+
+- Wrong audio (not trending)
+- Trend-late (already over)
+- Over-produced (lacks authenticity)
+- No twist (just copy)
+- Brand voice forced
+
+## How to find trends
+
+- TikTok Creative Center (free tool)
+- TikTok For You Page
+- Other creators in your niche
+- Sounds that are spiking
+
+## Brand consideration
+
+Brands often try to ride trends. Risk:
+- Authenticity
+- Trying too hard
+- Trend-late by approval cycles
+- Brand voice mismatch
+
+Best brand trends: feel native to platform, genuine fit with brand.

package/templates/skills/screenwriter/knowledge/categories/short-form/formats/voiceover-listicle.md

@@ -0,0 +1,147 @@
+# Voiceover Listicle — Format
+
+> "5 reasons / 3 things / 7 ways" format. Voiceover-driven. Visual variety. 30-90s.
+
+## Format basics
+
+- Length: 30-90 seconds
+- Aspect: 9:16 vertical
+- Numbered list structure
+- Voiceover narration
+- B-roll visuals
+- Educational or entertaining
+
+## Structure
+
+```
+0-3s    HOOK
+        "5 reasons why..."
+        "Here are 3 things..."
+
+3-15s   ITEM 1
+        Numbered + short explanation
+
+15-30s  ITEM 2
+        Same pattern
+
+30-45s  ITEM 3
+        Same pattern
+
+45-55s  ITEM 4-5 (if applicable)
+        Same pattern
+
+55-60s  CTA
+        Subscribe / save / share
+```
+
+## Sample 60s voiceover listicle
+
+```
+"5 things you should know before opening a coffee shop"
+
+0-3s: HOOK
+Visual: opening sign on a coffee shop
+Voice: "Five things you should know before opening a coffee shop."
+
+3-15s: ITEM 5
+On screen: "5. Location matters more than you think."
+Visual: B-roll of various street locations.
+Voice: "A great coffee shop in a bad location will fail. A mediocre
+shop in a great location will survive."
+
+15-25s: ITEM 4
+On screen: "4. Margins are tight."
+Visual: Money / receipts / spreadsheet.
+Voice: "Coffee margin sounds great. Then you account for rent,
+labor, equipment, waste. The margin shrinks."
+
+25-37s: ITEM 3
+On screen: "3. Equipment costs more than you'll budget for."
+Visual: Espresso machines, grinders.
+Voice: "Quality equipment is expensive. Cheap equipment will
+cost you more in repairs and customer dissatisfaction."
+
+37-47s: ITEM 2
+On screen: "2. Your staff matters most."
+Visual: Baristas making drinks, smiling.
+Voice: "Bad coffee with great service survives. Great coffee with
+bad service doesn't. People come back for people."
+
+47-57s: ITEM 1
+On screen: "1. You'll work harder than ever."
+Visual: Owner working alone at 4 AM, doing inventory.
+Voice: "If you're not ready for 12-hour days for the first year,
+this isn't for you."
+
+57-60s: CTA
+Voice: "I run Karavan Coffee. Follow for more shop owner truths."
+On screen: "Karavan Coffee | Follow"
+```
+
+## Key principles
+
+### Number specificity
+- "5 reasons" beats "Some reasons"
+- Specific number = clear promise
+- Audience knows length commitment
+
+### Order matters
+- Most surprising or important last (countdown)
+- Or most basic first (count up)
+- Save the punch for end
+
+### Visual B-roll variety
+- Different visual per item
+- Don't talking-head only
+- Show, not just tell
+
+### Quick pacing per item
+- 8-12 seconds per item ideal
+- Don't dwell
+- Voice carries narrative
+
+### Authority position
+- Speak as expert
+- Specific examples
+- Trust-building
+
+## Sub-types
+
+### Educational
+"5 things to know about ___"
+
+### Recommendation
+"3 books you should read"
+
+### Warning
+"5 mistakes to avoid"
+
+### Inspirational
+"7 habits of successful ___"
+
+### Curiosity
+"3 things you didn't know about ___"
+
+## When to use
+
+- Educational content
+- Authority building
+- High-engagement (lists save well)
+- Long-form supplement
+- Newsletter/blog companion
+
+## Common mistakes
+
+- Inconsistent visual style across items
+- Too many items (5+ is ideal max)
+- Voice monotone
+- No clear CTA
+- Generic items (specifics matter)
+
+## Voice work tips
+
+- Conversational tone
+- Slight pauses between items
+- Emphasis on key words
+- Energy maintained throughout
+- Clear pronunciation (captions back you up but voice matters)

package/templates/skills/screenwriter/knowledge/categories/short-form/formats/youtube-shorts.md

@@ -0,0 +1,142 @@
+# YouTube Shorts — Format
+
+> YouTube's vertical short-form. 15-60s. Slightly different conventions than TikTok.
+
+## Format basics
+
+- Length: 15-60 seconds (max 60s)
+- Aspect: 9:16 vertical
+- YouTube algorithm
+- Connected to long-form YouTube content (often)
+- Sound-on default
+
+## YouTube Shorts vs TikTok
+
+| Aspect | YouTube Shorts | TikTok |
+|--------|----------------|--------|
+| Audience | Often more general | Younger, trend-focused |
+| Discovery | YouTube algorithm | TikTok FYP |
+| Music library | YouTube's | TikTok's (largely different) |
+| Creators | Often crossover from long-form | Native short-form |
+| Polish | Slightly higher | Variable |
+| CTAs | Subscribe + watch long-form | Follow |
+
+## Structure
+
+```
+0-3s    HOOK
+        Visual + question
+        YouTube viewers slightly more patient than TikTok
+
+3-15s   SETUP
+        Context
+
+15-45s  CONTENT
+        Value or story
+
+45-60s  CTA
+        Subscribe / watch full video
+```
+
+## Sample 60s YouTube Short
+
+```
+"5 Things Every Coffee Beginner Gets Wrong"
+
+0-3s: HOOK
+Visual: hands grinding coffee badly.
+Voice: "If you're new to coffee, you're probably making these
+five mistakes."
+
+3-12s: ITEM 1
+"Number 5: Pre-ground coffee from the supermarket."
+Quick cut: bag of pre-ground coffee → bin.
+"Whole beans only. Fresh ground."
+
+12-21s: ITEM 2
+"Number 4: Brewing with old beans."
+Visual: bag with old roast date.
+"Fresh = roasted within 2 weeks."
+
+21-30s: ITEM 3
+"Number 3: Cheap water."
+Visual: tap water.
+"Filtered or spring. Water is 98% of your coffee."
+
+30-39s: ITEM 4
+"Number 2: Wrong grind size."
+Visual: too-fine grind for French press.
+"Match your grind to your method."
+
+39-48s: ITEM 5
+"Number 1: Pouring too fast."
+Slow pour-over demonstration.
+"Slow steady spiral. Thirty seconds bloom."
+
+48-58s: PAYOFF
+Beautiful pour-over result. Sip. Smile.
+Voice: "Better coffee in five steps."
+
+58-60s: CTA
+"Full guide on my channel. Link in description."
+Subscribe overlay.
+```
+
+## Key principles
+
+### Channel integration
+- Hook viewers from Shorts to subscribe
+- Tease long-form content
+- Cross-promote channel
+
+### Slightly higher polish
+- YouTube audience expects production value
+- Good audio quality
+- Color-corrected
+
+### Structure value
+- "5 things..."
+- "Here's how..."
+- Numbered lists work well
+
+### CTA explicit
+- Subscribe ask
+- Long-form video link in description
+- Channel name visible
+
+## YouTube Short types
+
+### Educational quick
+- Tutorial / tip / fact
+- Numbered or step-by-step
+
+### Reaction short
+- Reacting to content
+- Often pulled from long-form
+
+### Behind-the-scenes
+- Creator life
+- Process glimpse
+
+### Shorts trailer for long-form
+- Tease an upcoming video
+- "Full video drops Friday"
+
+### Compilation / best moments
+- Pulled from larger content
+
+## When to use
+
+- YouTube creator audience-building
+- Cross-platform content (YT + TikTok + IG)
+- Brand awareness
+- Long-form companion content
+- Algorithm boost for channel
+
+## Common mistakes
+
+- Too TikTok-y (loses YouTube audience)
+- Forgetting subscribe CTA
+- Not connecting to long-form
+- Captions missing
+- Bad audio (YouTube audience picky)

package/templates/skills/screenwriter/knowledge/categories/short-form/personas/atmospheric-cinematic.md

@@ -0,0 +1,55 @@
+# Atmospheric Cinematic — Short-Form Persona
+
+> Poetik, mood-yönlü reel/Short — viral hook-dan çox **hiss və atmosfer**. Sözlər az, vizual çox, ritm yavaş və qəsdli.
+
+## Janr gücü
+- POV həsrət / nostalji reels
+- Şəhər / fəsil mood parçaları
+- Brend mood-film (15-90s, məhsuldan çox hissi satan)
+- Musiqi-driven montaj
+- Sənədli mikro-portret
+
+## Bir cümlə
+Söz minimumdur, kadr maksimumdur. Bir hiss, bir personaj, bir məkan — və izləyici öz hekayəsini qurur.
+
+## Üslubi prinsiplər
+
+### Hook (0-3s)
+Söz yox, **vizual qənaət**: bir əl, bir gözün yaxın planı, bir obyekt, bir hərəkət. İdeya yox, **toxunma**.
+
+### Struktur
+- 0-3s — **vizual hook** (toxunma, anlıq detal)
+- 3-15s — **kontekst aşkarlanır** (geniş kadrlar, məkan, personaj nəfəs alır)
+- 15-25s — **emosional dönüş** (bir obyekt, bir baxış, bir xatirə)
+- 25-30s — **buraxılma** (qeyri-aşkar son, suspended an)
+
+### Söz qənaəti
+- **Voiceover** — 2-3 cümlədən çox yox; ya da heç yox.
+- **Dialoq olsa** — qısa, fraqment, yarımçıq cümlə.
+- **Subtitr** — atmosferi pozursa, **subtitirsiz**.
+
+### Ritm
+- Kəsim **2-5 saniyədə bir** (viral 1-saniyəlik cut deyil).
+- Kadrları **uzun saxla** — izləyici nəfəs alsın.
+- Musiqi və ya ambient sürdür, sözlər yox.
+
+### Vizual
+- **Bir palitra, bir işıq tonu** — kadr-kadr dəyişmir.
+- **Çərçivə içində çərçivə** — qapı, pəncərə, güzgü.
+- **Detal insert-ləri** — əl, obyekt, fokus dəyişimi.
+
+## Hansı rejissor üslubları yaxşı tamamlayır
+- **Wong Kar-wai** — həsrət, doymuş rəng aksenti, intim handheld
+- **Nuri Bilge Ceylan** — uzun planlar, təbii işıq, mənzərə
+- **Sofia Coppola** — yumşaq pastel, izolyasiya, gənc qadın POV
+
+## Anti-pattern
+- ❌ Yüksək tempo viral hook ("STOP scrolling!!!" tipində)
+- ❌ Çox sözlü voiceover
+- ❌ Hər kadrda fərqli işıq/palitra
+- ❌ Tutoriyal-tipli "1-cisi, 2-cisi" struktur
+- ❌ Mətn overlay-lərlə dolğunluq
+
+## İstifadə nümunəsi
+> Mövzu: "qışda tənhalıq" / 30s Instagram reel / AZ
+> Bu persona seç: **atmospheric-cinematic** → ssenari: VO 2 sətir, 5 vizual beat, soyuq palitra + bir kəhrəba aksent, kəsim 4-6s, son qeyri-aşkar.

package/templates/skills/screenwriter/knowledge/categories/short-form/personas/atmospheric-reel.md

@@ -0,0 +1,46 @@
+# Atmospheric Reel — Persona
+
+> Mood-driven, cinematic, poetic short-form. The opposite of viral/punchy. For reels that feel like a held breath — not a slap.
+
+## Üslubun mahiyyəti
+- **Tək dayanıqlı hiss** — bütün reel bir emosional notu daşıyır (tənhalıq, sevinc, həsrət, anlıq möcüzə).
+- **Qoyulmuş söz, atılmış söz deyil** — minimal VO və ya dialoqsuz; söz görüntünü tamamlayır, idarə etmir.
+- **Qısa runtime-da yavaş daxili tempo** — kəsimlər var, amma hər kadr nəfəs alır.
+- **Musiqi və ya səssizlik aparıcıdır** — tələsən cut yox; mood qatdır.
+
+## Nə vaxt istifadə et
+- Şəxsi POV reel-lər (qışda tənhalıq, səhər ritualı, xatirə, ayrılıq)
+- Brendin emosional manifest reel-i (yalnız aesthetic, satış-yönlü deyil)
+- Aesthetic / vibe content — qəhvə, kitablar, küçə, yağış
+- Şeir / sitat reel — söz + atmosferik kadr
+
+## Texnikalar
+- **Hook ≠ təcili hadisə.** Hook = vizual atmosfer + bir intriqalı detal (sönmüş telefon, yarımçıq fincan, açıq pəncərə).
+- **VO sparse, low-register** — sakit, intim, içdən danışan (ElevenLabs v3 `[quietly]`, `[hesitant]` tag-ləri).
+- **Səhnə çox vaxt bir məkanda baş verir** — mühit personajın daxili vəziyyətinin əksidir.
+- **Görüntü dilini söz əvəz edir** — yarımçıq jest, nəfəs, geri çəkilmiş kadr; izah etmə.
+- **Final açıqdır** — sual qoyur, cavab vermir; tamaşaçı tamamlayır.
+
+## Struktur şablonu (30s)
+```
+0–3s    HOOK         vizual atmosfer + intriqalı detal
+3–10s   SETUP        məkan + personajın mövcudluğu (kim, harada)
+10–20s  TURN         emosional kəşf (obyekt, jest, xatirə)
+20–26s  CLIMAX       sakit pik — heç nə partlamır, daxili dəyişim
+26–30s  RESOLUTION   açıq sonluq; jest, baxış, və ya sönüb gedən detal
+```
+
+## Referans üsluba
+- Cinematic POV reel-ləri yaradan AZ/INT aesthetic creator-lar — slow-life vibe, kino-baxışı
+- "Wong Kar-wai for reels" — rəng + həsrət, qısaldılmış
+- Sənədli-poetik qısa metraj (Terrence Malick mood-u, Ken Burns ritmi)
+
+## Anti-pattern
+- ❌ Hər 1 saniyəyə hard cut — atmosferin qatilidir
+- ❌ Aqressiv hook ("Bunu görməlisən!") — üslubu pozur
+- ❌ Çox VO — söz görüntünü öldürür; az söz, çox kadr
+- ❌ Aydın happy ending / satış CTA — janrın tonu deyil
+- ❌ Stylized filter (VHS, glitch) — mood işıqdan gəlir, filter-dən yox
+
+## screenwriter qeydi
+Bu persona `character-designer` + `location-designer` + `director` (Wong Kar-wai / Nuri Bilge Ceylan persona) ilə qoşa işləyir. Üslub vizual + səs koordinasiyasından sıx asılıdır.