@azerogluemin/ai-bootstrap 0.2.1

package/templates/skills/screenwriter/knowledge/categories/film/formats/feature-film.md

@@ -0,0 +1,241 @@
+# Feature Film — Format
+
+> Full-length narrative film. 75-180 min. Theatrical or streaming distribution.
+
+## Format basics
+
+- Length: 75-180 min (sweet spot 95-130 min)
+- Page count: 90-130 (1 page ≈ 1 min)
+- Self-contained narrative
+- Multiple subplots
+- Full character arcs
+- Theatrical or streaming distribution
+
+## Structure (Save the Cat / Hollywood standard)
+
+```
+PAGE  ACT  BEAT
+1     1    Opening Image (mood, theme suggested)
+1-5   1    Setup (status quo, character flaw)
+5     1    Theme stated (often by minor character)
+10    1    Catalyst (inciting incident)
+12-15 1    Debate (will protagonist accept?)
+20-25 1    Break into Act 2 (commits to journey)
+
+25-30 2A   B Story (subplot/love story begins)
+30-55 2A   Fun and Games (promise of premise)
+55    2    Midpoint (false victory or false defeat)
+
+55-75 2B   Bad Guys Close In (rising obstacles)
+75    2B   All Is Lost (lowest point)
+75-85 2B   Dark Night of Soul
+
+85    3    Break into Act 3
+85-110 3   Finale (5 finale points)
+110   3    Final Image (echo of opening)
+```
+
+## Save the Cat 5-finale points
+
+1. Gathering the team
+2. Executing the plan
+3. High tower surprise (twist)
+4. Dig deep down
+5. Execution of new plan
+
+## Key principles
+
+### Multiple subplots
+Feature length supports:
+- A story (main plot)
+- B story (often love or thematic)
+- C story (subplot for support)
+
+All connect at climax.
+
+### Character development across runtime
+- Establish flaw early
+- Test it through middle
+- Force change at crisis
+- Demonstrate change at end
+
+### Theme woven, not stated
+Theme emerges from:
+- Character choices
+- Repeated motifs
+- Visual symbols
+- Final image
+
+### Pacing varies by genre
+- Action: faster, set pieces every 15-20 min
+- Drama: slower, character-driven
+- Comedy: joke density
+- Horror: tension cycles
+
+## Genre-specific runtime
+
+| Genre | Typical |
+|-------|---------|
+| Action | 100-130 min |
+| Comedy | 90-100 min |
+| Drama | 95-130 min |
+| Horror | 85-110 min |
+| Thriller | 95-120 min |
+| Sci-fi/Fantasy | 110-160 min |
+| Romance | 90-110 min |
+| Epic / War | 130-180 min |
+| Animated | 80-100 min |
+
+## Sample feature beat sheet (110 min)
+
+```
+0:00    OPENING IMAGE
+        Establish theme visually
+        World introduced
+
+0:01-05 SETUP
+        Protagonist in normal life
+        Flaw demonstrated
+
+0:05    THEME STATED
+        Often by minor character
+        Audience hears it, protagonist doesn't (yet)
+
+0:10    CATALYST
+        Disrupting event
+        Call to adventure
+
+0:12-15 DEBATE
+        Should they accept?
+        Cost considered
+
+0:25    BREAK INTO 2
+        Commit to journey
+        New world entered
+
+0:25-30 B STORY
+        Subplot begins
+        Often love interest or mentor
+
+0:30-55 FUN AND GAMES
+        Promise of premise delivered
+        Trailer moments
+        Audience entertained
+
+0:55    MIDPOINT
+        Major reversal
+        False victory OR false defeat
+        Stakes raised
+
+0:55-75 BAD GUYS CLOSE IN
+        Antagonist gains
+        Subplots threaten
+        Internal doubts
+
+1:15    ALL IS LOST
+        Lowest point
+        Mentor death often
+        Whiff of death
+
+1:15-25 DARK NIGHT OF SOUL
+        Wallow / plan
+        Realize change needed
+
+1:25    BREAK INTO 3
+        New plan
+        Transformed protagonist
+
+1:25-50 FINALE
+        Gather team
+        Execute plan
+        Twist
+        Dig deep
+        Triumph (or tragic fall)
+
+1:50    FINAL IMAGE
+        Echo opening
+        Show transformation
+```
+
+## Sample feature concept
+
+```
+TITLE: "Bakı Sahili" (Baku Coast)
+GENRE: Drama
+LENGTH: 105 minutes
+LOGLINE: A widowed fisherman in Baku must teach his estranged
+adult son the family trade before selling their boat to pay for
+his wife's medical debts.
+
+OPENING IMAGE: Empty boat at dawn, gentle waves. The Caspian Sea.
+
+SETUP: ASIF (62) lives alone, fishes alone. His wife died six
+months ago. Medical debts stack on the table.
+
+THEME STATED: A neighbor: "Some things you can't do alone."
+
+CATALYST: Bank notice. Sell the boat or lose the house.
+
+DEBATE: Asif could call his son in Moscow, who left after fighting
+with him 8 years ago. He doesn't.
+
+BREAK INTO 2: His son ELDAR (35) arrives unexpectedly. Heard from
+neighbor.
+
+[and so on through full beat sheet]
+
+FINAL IMAGE: Two men in the boat at dawn. Working together. Eldar
+casting nets like his father taught him. Asif watching, peaceful.
+```
+
+## Best practices
+
+### Hook in first 5 minutes
+- Audience commits to 2 hours
+- First impression critical
+- Setup what payoffs to come
+
+### Active protagonist
+- Things happen BECAUSE of them, not TO them
+- Choices drive plot
+- Agency throughout
+
+### Antagonist with reason
+- Best villains have logic
+- Even sympathetic motivations
+- Mirror to protagonist
+
+### Subplot integration
+- All subplots resolve at/before climax
+- Don't introduce new plots in Act 3
+- Connect thematically
+
+### Visual storytelling
+- Cinema is visual
+- Less dialogue than TV
+- Trust image
+
+## Common mistakes
+
+- Saggy middle (Act 2 boring)
+- Rushed climax
+- New characters in Act 3
+- Subplot abandoned
+- Theme on-the-nose
+- Generic protagonist
+- Predictable arc
+
+## Production realities
+
+| Tier | Budget | Notes |
+|------|--------|-------|
+| Microbudget | <$500K | Festival, indie |
+| Indie | $500K-5M | Festival + streaming |
+| Studio mid | $5M-50M | Wide release |
+| Studio big | $50M-200M | Tentpole |
+| Blockbuster | $200M+ | Franchise |
+
+Script length impacts feasibility:
+- 120 pages = ~$50K-200K just to shoot
+- Each location = day rate
+- Each cast member = compensation

package/templates/skills/screenwriter/knowledge/categories/film/formats/short-film-1-5min.md

@@ -0,0 +1,165 @@
+# Short Film 1-5 min — Format
+
+> Ultra-short narrative cinema. Single idea, single moment, often no dialogue.
+
+## Format basics
+
+- Length: 60s - 5 min
+- Single story arc
+- Festival circuit (1-3 min often special category)
+- Often experimental
+- Limited resources
+
+## Structure (compressed)
+
+```
+0-30s    SETUP
+         Character + world established quickly
+         Visual storytelling
+
+30-180s  CONFRONTATION
+         Single conflict
+         Turn or twist
+         No subplot
+
+180-300s RESOLUTION
+         Climax
+         Final image
+         Emotional close
+```
+
+## Compressed 3-act in 5 min
+
+| Act | Time | Beat |
+|-----|------|------|
+| 1 | 0-1 min | Setup + inciting incident |
+| 2 | 1-3:30 min | Confrontation + crisis |
+| 3 | 3:30-5 min | Climax + resolution |
+
+## Key principles
+
+### Single core idea
+- ONE concept fully explored
+- Don't try multiple subplots
+- Theme through one situation
+
+### Visual-first
+- Often dialogue-light or wordless
+- Image carries meaning
+- Body language, glance, gesture
+
+### Strong ending image
+- Last shot crucial
+- Audience leaves with this
+- Resonates beyond runtime
+
+### Compressed character
+- Type + 1 specific trait = enough
+- No extensive backstory
+- Show through action
+
+## Sub-types
+
+### Single-shot films
+- One continuous take
+- 1-3 minutes typical
+- Technical achievement
+
+### Wordless films
+- No dialogue
+- Pure visual storytelling
+- International appeal (no translation)
+
+### Single-location
+- One setting
+- Maximizes location detail
+- Production-friendly
+
+### Concept films
+- Single idea explored
+- Often sci-fi or fantasy
+- "What if..." premise
+
+## Sample 3-min short concept
+
+```
+TITLE: "Last Bus"
+
+EXT. EMPTY BUS STOP - NIGHT (0-30s)
+
+A WOMAN (30s) waits alone. The last bus is late. She checks her
+phone. Nothing.
+
+EXT. SAME (30-90s)
+
+A MAN (60s) arrives. Silent. He sits at the other end of the bench.
+They don't speak. The wind picks up.
+
+EXT. SAME (90-150s)
+
+The man pulls out a thermos. Pours. Offers her the cup. She hesitates.
+Takes it. Their hands touch briefly.
+
+EXT. SAME (150-180s)
+
+The bus arrives. They board. Sit on opposite sides. As the bus pulls
+away, she returns the empty cup to him with a nod.
+
+FADE OUT.
+```
+
+## Best practices
+
+### Open IN action
+- Don't waste time on setup
+- Audience figures it out
+- First image = mood + question
+
+### One protagonist
+- Multiple characters confuse
+- Single POV
+- Audience identifies fast
+
+### Cut everything possible
+- Each frame must justify
+- No filler
+- Cut beats that aren't essential
+
+### Endings hit hardest
+- Spend time on ending
+- Final image lingers
+- Resonates beyond runtime
+
+## Production fit
+
+- Single director
+- Tiny crew
+- Few locations
+- Minimal equipment
+- Festival submission ready
+- Low budget achievable
+
+## Awards / festivals
+
+- Cannes Short Film Palme d'Or
+- Sundance Short Film Jury
+- Vimeo Staff Picks
+- YouTube short film features
+
+## Common mistakes
+
+- Trying to tell feature-length story
+- Multiple characters confused
+- Setup too long
+- Dialogue exposition
+- Ending unearned
+- Generic concept
+- Forgetting ending image
+
+## When to write
+
+- Festival submission
+- Director showcase / portfolio
+- Concept proof-of-concept
+- Visual experiment
+- Limited resources

package/templates/skills/screenwriter/knowledge/categories/film/formats/short-film-5-15min.md

@@ -0,0 +1,198 @@
+# Short Film 5-15 min — Format
+
+> Standard short film length. Full 3-act story with developed character. Festival staple.
+
+## Format basics
+
+- Length: 5-15 min (sweet spot 8-12 min)
+- Self-contained narrative
+- Main festival category
+- Director showcase
+- Bridge to feature work
+
+## Structure (3-act standard)
+
+```
+0-2 min     ACT 1 — Setup
+            World, character, problem
+            Inciting incident at ~1.5 min
+            First act break at ~2 min
+
+2-10 min    ACT 2 — Confrontation
+            Try / fail cycles
+            Rising stakes
+            Midpoint reversal at ~6 min
+            Crisis at ~9 min
+
+10-15 min   ACT 3 — Resolution
+            Final attempt
+            Climax at ~12 min
+            Resolution at ~14 min
+            Final image at ~15 min
+```
+
+## Key principles
+
+### Full character arc
+Unlike 1-5 min shorts, 5-15 min allows:
+- Character flaw established
+- Multiple challenges
+- Real change (positive or negative arc)
+- Earned ending
+
+### Subplot light
+- Main plot focused
+- One supporting character with own micro-arc
+- Don't try multiple full subplots
+
+### Genre conventions ok
+- Audience knows you're playing in genre sandbox
+- Use conventions strategically
+- Subvert when smart
+
+### Production manageable
+- 2-5 locations max
+- 3-8 cast typical
+- 3-7 day shoot
+- Mid-budget feasible
+
+## Sample structure: 10-min short
+
+```
+0-1:30      ACT 1
+            Establish protagonist in normal life
+            Show their flaw through small choice
+            Inciting incident: something disrupts normal
+
+1:30-2:00   First act break
+            Protagonist commits to action
+
+2:00-5:30   ACT 2A
+            First attempt — fails
+            New approach
+            Subplot character introduced
+            Stakes raised
+
+5:30-6:00   MIDPOINT
+            Reversal: thing they thought wrong is right
+            (or vice versa)
+
+6:00-8:30   ACT 2B
+            New obstacles
+            Reaching breaking point
+            Subplot resolved or escalated
+
+8:30-9:00   CRISIS / All-is-lost
+            Lowest point
+            Old approach fully fails
+
+9:00-9:30   Choice
+            Protagonist commits to new way
+
+9:30-10:00  ACT 3 / RESOLUTION
+            Final attempt
+            Climax
+            New normal
+            Final image echoes opening
+```
+
+## Sample concept (8-min short)
+
+```
+TITLE: "The Coffee Shop"
+
+GENRE: Drama, magical realism
+LENGTH: 8 minutes
+LOGLINE: A barista who has stopped speaking finds her voice again
+when an old man visits the cafe every day for one week.
+
+ACT 1 (0-1:30):
+SARAH (28), barista, hasn't spoken to anyone in months since her
+mother died. The cafe is quiet, her routine mechanical. An OLD MAN
+(70) arrives, orders coffee with a smile but doesn't speak either.
+
+ACT 2A (1:30-4:00):
+Each day for a week, the old man returns. Same time. Orders the
+same coffee. Smiles. Sits. Reads. Leaves.
+
+Sarah begins anticipating his arrival. Notices small things. He
+always tips exactly the same. He never finishes the coffee.
+
+ACT 2 MIDPOINT (4:00-5:00):
+On day five, she notices he's reading the same book her mother
+used to read. She nearly speaks. Doesn't.
+
+ACT 2B (5:00-6:30):
+On day six, he doesn't come. Sarah feels the loss. The cafe feels
+emptier without him.
+
+CRISIS (6:30-7:00):
+Sarah realizes she may never see him again. She leaves the cafe
+mid-shift, runs through the streets.
+
+ACT 3 (7:00-8:00):
+She finds him at a park bench, the same book in his hands. She
+sits beside him. Takes a breath.
+
+SARAH
+(barely a whisper)
+That was my mother's favorite book.
+
+The old man looks up. Smiles.
+
+OLD MAN
+Mine too.
+
+Final image: They sit together in companionable silence as the
+park comes alive around them.
+```
+
+## Best practices
+
+### Open with intrigue
+- Don't lead with backstory
+- Drop audience into a moment
+- Question planted
+
+### Show character through detail
+- Specific habit
+- Specific object
+- Specific expression
+- Don't tell us, show us
+
+### Earn the ending
+- Setup what pays off
+- Don't introduce new elements in Act 3
+- Final image earned by all that came
+
+### Visual storytelling
+- Less dialogue than feature
+- Trust the image
+- One key visual moment per act
+
+## Common mistakes
+
+- Trying to fit feature plot into short form
+- Too much exposition in Act 1
+- Multiple subplots competing
+- Ending too rushed
+- Adding scenes that don't serve arc
+- Dialogue when image would work
+- Generic protagonist
+
+## Production typical
+
+- Director + small crew (10-20)
+- 5-7 day shoot
+- 3-5 locations
+- 5-10 page script
+- $5K-50K budget (low end)
+- Festival circuit aim
+
+## Awards / festivals
+
+- Sundance, Cannes, Toronto, Tribeca shorts
+- Oscar Live Action Short qualifier
+- BAFTA Short Film
+- Berlinale Shorts
+- Online: Vimeo, YouTube short film