@azerogluemin/ai-bootstrap 0.2.1

package/templates/skills/screenwriter/knowledge/categories/youtube-long/personas/wendover.md

@@ -0,0 +1,120 @@
+# Wendover — Persona
+
+> Educational / aviation / geography videos. Maps, infographics. Authoritative narration. Subject-deep dives.
+
+## Style Signatures
+
+- Educational deep dives
+- Aviation / transportation / geography focus
+- Maps and infographics dominant
+- Authoritative narration
+- Calm presenter voice
+- 10-20 min standard length
+- Topic-driven (not personality)
+
+## Common Devices
+
+- Animated maps
+- Infographic visualizations
+- Numbered statistics
+- Cause-and-effect explanations
+- Industry / system analysis
+- Specific examples
+- Citations in description
+
+## Voice Style
+
+Calm, authoritative, presenter-style. Educational but accessible. Slight British/Mid-Atlantic neutrality.
+
+```
+"Most people don't realize that..."
+"The reason for this is surprisingly simple..."
+"Here's what's actually happening..."
+"And this brings us to..."
+```
+
+## When Writing as Wendover
+
+- Educational subject
+- Aviation, transit, geography, business systems
+- 10-20 min length
+- Maps and infographics central
+- Authoritative narration
+- Specific data points
+- Logical progression
+- No personality-driven (focus on subject)
+
+## Sample Approach
+
+```
+"How Coffee Beans Travel from Farm to Cup"
+
+0-1min: HOOK
+- Animated graphic of world coffee belt
+- "Every cup of coffee you drink has traveled an average of 8,400
+kilometers. Here's how."
+
+1-3min: SETUP
+- Coffee belt explanation (maps)
+- Global production statistics
+- Why these specific countries
+
+3-7min: AT THE FARM
+- Production process explained
+- Animation of beans on tree
+- Picking, processing
+- Specific country examples
+
+7-12min: TRANSPORTATION
+- From farm to processing
+- To export terminals
+- Container ships (with stats)
+- Specific routes shown on map
+
+12-15min: ROASTING + DISTRIBUTION
+- Arrival in importing country
+- Roasting facility process
+- Distribution to retail/cafes
+- Time elapsed (often surprising)
+
+15-18min: THE CUP
+- Final brewing
+- Total time from farm: 6-12 weeks
+- Total cost breakdown
+- Where the money goes (animated graph)
+
+18-19min: CONCLUSION
+- The complexity of "just a cup of coffee"
+- Implications for ethics / sustainability
+
+19-20min: CTA
+- Subscribe
+- Sources in description
+- Next: "How tea travels"
+```
+
+## Avoid
+
+- Personality-driven (Wendover is subject-driven)
+- Slow pacing
+- Missing infographics (visuals essential)
+- Casual / informal tone
+- Too short (Wendover does deep dives)
+
+## Best for
+
+- Educational content
+- Subject-matter authority
+- SEO-friendly evergreen
+- Long-term audience growth
+- Patreon / premium content
+- Documentary-adjacent
+
+## Avoid pairing with
+
+- Vlog format
+- Personal storytime
+- Pure entertainment
+- TikTok format
+- Comedy
+- Drama

package/templates/skills/screenwriter/knowledge/core/character-arcs.md

@@ -0,0 +1,164 @@
+# Character Arcs — Script Core
+
+> How characters change over the course of a story. Even short formats need arcs.
+
+## What is a character arc
+
+A character arc = the internal journey from one state to another:
+- Belief → New belief
+- Flaw → Healing (or destruction)
+- Want → Need (recognized or rejected)
+
+## Arc types
+
+### Positive arc (growth)
+Character starts flawed, ends healed.
+- Example: Selfish protagonist learns sacrifice
+- Most common in mainstream
+
+### Negative arc (fall)
+Character starts okay, ends worse.
+- Example: Walter White becomes Heisenberg
+- Tragedy structure
+
+### Flat arc (steadfast)
+Character stays the same; world changes around them.
+- Example: Indiana Jones, Atticus Finch
+- They influence others to change
+
+### Disillusionment arc
+Character believes lie, learns truth.
+- Coming-of-age stories
+
+## Arc components
+
+### 1. Initial state
+- Where character starts
+- Their flaw / wound
+- Their belief about world
+
+### 2. Inciting incident
+- Event that disrupts initial state
+- Forces character into action
+
+### 3. False victories / setbacks
+- Character tries old ways → fails
+- Or tries new ways → succeeds temporarily
+
+### 4. Crisis / dark night
+- Lowest point
+- Old way fully fails
+- Character must change or be destroyed
+
+### 5. Choice
+- Character chooses new way (positive)
+- Or chooses old way (negative/tragic)
+
+### 6. Resolution
+- New state established
+- Echo of beginning showing change
+
+## Arc in different lengths
+
+### TikTok storytime (60s)
+Even here, an arc:
+- 0:00-0:10: Setup ("I thought I'd be alone forever")
+- 0:10-0:30: Escalation (event happens)
+- 0:30-0:50: Realization (insight)
+- 0:50-1:00: Change (new state)
+
+### 30s ad
+Often character/customer arc:
+- Has problem → discovers product → transformed
+
+### Short film
+Single clear arc, focused
+- One want/need
+- One major change
+
+### Series episode
+Episode-level arc + season arc
+- Each episode has self-contained arc
+- Season builds larger transformation
+
+### Feature film
+Major arc + subplot arcs
+- Protagonist's main arc
+- Supporting character arcs (smaller)
+
+## The "3 dimensions" of character
+
+### 1. Want (external goal)
+What they're chasing on screen.
+
+### 2. Need (internal truth)
+What would actually fulfill them.
+
+### 3. Wound (past hurt)
+Why they have the flaw they have.
+
+Best stories: All three connect.
+- Want = "Get the promotion"
+- Need = "Self-worth not from external validation"
+- Wound = "Father never said he was proud"
+
+## Setup → payoff for arcs
+
+### Setup arc clearly
+Show character's flaw EARLY through action:
+```
+EARLY SCENE: ƏLİ refuses help carrying groceries.
+"I've got it."
+He drops everything trying to prove he doesn't need help.
+```
+
+### Pay off arc clearly
+Show flaw resolved through opposite action:
+```
+LATE SCENE: ƏLİ asks for help with the moving van.
+"I can't do this alone."
+LEYLA helps. They smile.
+```
+
+This proves change without saying it.
+
+## Avoid
+
+### Static characters
+Character ends exactly where they started. Boring.
+
+### Unmotivated change
+Character changes because plot requires it, not because earned.
+
+### On-the-nose declarations
+```
+BAD:
+ƏLİ
+I've learned that I need to ask for help!
+```
+
+Show through action, not statement.
+
+### Multiple arcs without focus
+One main arc, supporting beats. Not three competing arcs.
+
+## Arc + plot relationship
+
+- Plot = external events
+- Arc = internal change
+- Best stories: external plot FORCES internal change
+
+Plot without arc = action with no meaning.
+Arc without plot = navel-gazing.
+
+## Quick check
+
+For any story, answer:
+1. Where does protagonist start (state, belief, flaw)?
+2. What event forces change?
+3. What do they try that doesn't work?
+4. What's the crisis?
+5. Where do they end up?
+6. How is the ending DIFFERENT from beginning?
+
+If you can't answer all, the arc is unclear.

package/templates/skills/screenwriter/knowledge/core/dialogue-craft.md

@@ -0,0 +1,139 @@
+# Dialogue Craft — Script Core
+
+> How to write dialogue that feels real, advances story, and reveals character.
+
+## The 4 jobs of dialogue
+
+Every line should do at least 2:
+1. **Reveal character** — voice, worldview, mood
+2. **Advance plot** — moves story forward
+3. **Subtext** — implies what's not said
+4. **Create conflict** — disagreement, tension
+
+## Voice — make characters sound different
+
+Each character should have:
+- **Vocabulary** — formal vs casual, educated vs street
+- **Rhythm** — short clipped vs long winding sentences
+- **Idioms** — regional/cultural expressions
+- **Topics** — what they bring up unprompted
+- **What they avoid** — what they don't say
+
+Test: Cover character names. Can you tell who's speaking?
+
+## The 3 levels of dialogue
+
+### Level 1: On-the-nose (BAD)
+```
+ƏLİ
+I'm angry at you because you left me.
+
+LEYLA  
+I left you because I was scared.
+```
+
+Characters explain their emotions directly. Boring.
+
+### Level 2: Indirect (GOOD)
+```
+ƏLİ
+I noticed you took your books.
+
+LEYLA
+There wasn't much room in my new place.
+```
+
+Surface conversation, deeper meaning underneath.
+
+### Level 3: Subtext through avoidance (BEST)
+```
+ƏLİ
+The radiator's been making that sound again.
+
+LEYLA
+I told you to call someone.
+
+ƏLİ
+You told me a lot of things.
+```
+
+Talking about the radiator, fighting about the relationship.
+
+## Brevity
+
+Most beginners write too much dialogue. Cut ruthlessly:
+- If two lines convey same info, keep the better one
+- If a beat works in silence, cut the line
+- "Less is more" especially in film
+
+## Interruptions
+
+Real conversation has interruptions:
+```
+ƏLİ
+I just thought maybe—
+
+LEYLA
+Don't.
+```
+
+Use `—` for interruption. Use sparingly for impact.
+
+## Beats (silence)
+
+Indicate silence with:
+```
+LEYLA
+(beat)
+
+LEYLA  
+That's not what I meant.
+```
+
+A beat = a pause. Lets emotion land.
+
+## Rhythm
+
+Vary line length:
+- Short bursts for tension
+- Long winding lines for character (Sorkin) or thoughtfulness
+- Mix for natural flow
+
+## Cultural / regional voice
+
+For Azerbaijani / Turkish / Persian characters:
+- Use natural language patterns of that culture
+- Untranslated idioms can add texture
+- Avoid stereotyping
+
+## Avoid
+
+- Names mentioned constantly ("Yes, ƏLİ, I will, ƏLİ.")
+- Greetings extended (cut "Hello, how are you, fine thanks")
+- Exposition disguised as conversation ("As you remember from college, when we...")
+- Period-inappropriate slang
+- Everyone sounding the same
+- Adverbs in dialogue tags ("she said angrily")
+
+## Improve dialogue checklist
+
+For each line, ask:
+1. Does it sound like THIS character (not generic)?
+2. Does it do at least 2 of the 4 jobs?
+3. Could it be shorter?
+4. Could it be replaced with action/silence?
+5. Is there subtext, or is it on-the-nose?
+
+If it fails any, revise or cut.
+
+## Dialogue and action interplay
+
+Best moments often combine:
+```
+ƏLİ
+I'm fine.
+
+He grips the edge of the table until his knuckles turn white.
+```
+
+The action contradicts the dialogue. That's the truth.

package/templates/skills/screenwriter/knowledge/core/fountain-format.md

@@ -0,0 +1,193 @@
+# Fountain Format — Script Core
+
+> Fountain is the industry-standard plain-text screenplay format. Like Markdown for screenplays. The system uses Fountain internally for parseable scripts.
+
+## Why Fountain
+
+- Plain text (version-controllable, AI-readable)
+- Parseable (scenes, characters, locations auto-extracted)
+- Industry standard (Highland, Final Draft import)
+- Readable as-is
+
+## Core syntax
+
+### Scene Heading (Slug Line)
+```
+INT. KAFETERİYA - GECƏ
+EXT. KÜÇƏ - GÜNDÜZ
+INT./EXT. AVTOMOBIL - DAWN
+```
+
+Pattern: `INT.` or `EXT.` + LOCATION + ` - ` + TIME
+
+### Action
+```
+ƏLİ pəncərə yanında oturub. Yağış yağır pəncərəyə.
+```
+
+Plain text, present tense, third person. Describes what is seen and heard.
+
+### Character (introducing dialogue)
+```
+ƏLİ
+```
+
+ALL CAPS. New line. The character about to speak.
+
+### Dialogue
+```
+ƏLİ
+O qayıtmayacaq.
+```
+
+Indented under character (in screenplay rendering). What they say.
+
+### Parenthetical
+```
+ƏLİ
+(öz-özünə)
+O qayıtmayacaq.
+```
+
+Stage direction within dialogue. Use sparingly.
+
+### Transition
+```
+> CUT TO:
+> FADE OUT.
+> SMASH CUT TO:
+```
+
+Transitions between scenes. End-of-scene action.
+
+### Centered text
+```
+> THE END <
+```
+
+For special centered moments.
+
+### Notes (will not appear in final)
+```
+[[This is a note for the writer, not in final script]]
+```
+
+### Section / Synopsis (organizational)
+```
+# Act 1
+## Sequence A
+```
+
+## Sample full Fountain
+
+```fountain
+Title: Yağışlı Axşam
+Credit: Written by
+Author: Emin
+Draft date: 4/5/2026
+
+FADE IN:
+
+INT. KAFETERİYA - GECƏ
+
+Yağış pəncərəyə vurur. Diner sakitdir. ƏLİ (35), atletik, çal palto-da,
+pəncərə yanında oturub. Çay fincanını əlində fırladır.
+
+ƏLİ
+(öz-özünə)
+O qayıtmayacaq.
+
+Qapı zəngi səslənir. LEYLA (30), saçları islaq, içəri girir.
+Onun gözü dərhal Əliyə düşür.
+
+LEYLA
+Səhv edirsən.
+
+Əli başını qaldırır. Donur.
+
+> CUT TO:
+
+EXT. KÜÇƏ - DAVAMI
+
+İki adam pəncərə kənarında. Yağış davam edir.
+
+FADE OUT.
+```
+
+## Auto-extraction rules
+
+System parses Fountain to extract:
+- **Scenes**: every `INT.` / `EXT.` heading
+- **Characters**: every ALL-CAPS name introducing dialogue
+- **Locations**: text between `INT./EXT.` and ` - `
+- **Time of day**: text after ` - `
+- **Action**: paragraph text not under character
+
+This automated extraction populates `characters[]` and `locations[]` in DB.
+
+## Multi-language note
+
+Fountain works in any language. Use language of script naturally:
+- Azerbaijani scenes = `İNT. KAFETERİYA — GECƏ` (AZ-native, tövsiyə) və ya `INT. KAFETERİYA - GECƏ` (klassik parser-compatible)
+- English scenes = `INT. CAFETERIA - NIGHT`
+- Russian scenes = `ИНТ. КАФЕТЕРИЯ - НОЧЬ`
+
+System detects language and parses accordingly.
+
+## AZ-native Fountain (tam Azərbaycanca ssenari üçün)
+
+Bu layihənin default qaydası: **ssenari tam AZ olur** (oxunan sənəd). Aşağıdakı AZ-native konvensiyalar Fountain spirit-inə uyğundur:
+
+| Element | Klassik (EN) | AZ-native (tövsiyə) |
+|---|---|---|
+| Interior | `INT.` | `İNT.` |
+| Exterior | `EXT.` | `EKS.` |
+| Interior/Exterior | `INT./EXT.` | `İNT./EKS.` |
+| Cut | `> CUT TO:` | `> KƏSİK:` |
+| Smash cut | `> SMASH CUT TO:` | `> SƏRT KƏSİK:` |
+| Dissolve | `> DISSOLVE TO:` | `> SOLUR:` |
+| Cut to black | `> CUT TO BLACK:` | `> QARANLIĞA KƏSİK:` |
+| Fade in | `FADE IN:` | `QARANLIQDAN AÇIL:` |
+| Fade out | `FADE OUT.` | `QARANLIĞA SOLUR.` |
+| Voice-over | `(V.O.)` | `(SƏS ARXASI)` |
+| Off-screen | `(O.S.)` / `(O.C.)` | `(KADRDAN KƏNAR)` |
+| Time of day separator | ` - ` | ` — ` (em-dash) |
+
+Tam AZ Fountain nümunəsi (`İNT./EKS.` + AZ transition + AZ parenthetical):
+
+```fountain
+QARANLIQDAN AÇIL:
+
+İNT. AYTACIN YATAQ OTAĞI — SÜBHDƏN ƏVVƏL
+
+Qaranlıq otaq. Telefonun mavi parıltısı. AYTAC (28) çarpayının kənarında oturur.
+
+                    AYTAC (SƏS ARXASI)
+                    (sakit, intim)
+              Bəzi səhərlər ağırdır.
+
+> KƏSİK:
+
+EKS. PARK YOLU — SÜBH
+
+Soyuq mavi işıq. Aytac qaçır. Nəfəs görünür.
+
+QARANLIĞA SOLUR.
+```
+
+**Parser qeydi:** auto-extraction üçün parser həm `INT./EXT.` həm də `İNT./EKS.` prefikslərini tanımalıdır. Layihə default-u — AZ-native.
+
+## Common mistakes
+
+- Forgetting INT./EXT. prefix
+- Missing time of day after ` - `
+- Lowercase character names (must be ALL CAPS)
+- Mixing dialogue and action in same paragraph
+
+## Conversion from natural prose
+
+If user writes plain prose, system uses Claude to convert to Fountain. Claude will:
+1. Identify scene breaks → add INT./EXT. headings
+2. Identify dialogue → CAPS character names + lines
+3. Identify action → keep as paragraph
+4. Add transitions where appropriate