@azerogluemin/ai-bootstrap 0.2.1

package/templates/skills/screenwriter/knowledge/core/general-storytelling.md

@@ -0,0 +1,117 @@
+# General Storytelling — Script Core
+
+> Universal principles that apply to ALL script types regardless of category. Loaded with every script generation.
+
+## The fundamental contract
+
+A story = **a character with a problem who tries to solve it**.
+
+Every script, regardless of length or format, needs:
+1. A protagonist (someone we follow)
+2. A goal (what they want)
+3. An obstacle (why it's hard)
+4. A change (what's different at end)
+
+## 3-Act structure (universal)
+
+### Act 1 — Setup (25%)
+- Establish protagonist's normal world
+- Introduce problem / inciting incident
+- Protagonist commits to action
+
+### Act 2 — Confrontation (50%)
+- Obstacles increase
+- Protagonist tries and fails
+- Stakes raise
+- Midpoint reversal (things change direction)
+- Crisis (lowest point)
+
+### Act 3 — Resolution (25%)
+- Final attempt
+- Climax
+- Resolution / new normal
+
+## Fundamental rules
+
+### 1. Show, don't tell
+- Characters reveal themselves through action, not exposition
+- Visual storytelling > dialogue explanation
+- Trust the audience
+
+### 2. Conflict drives story
+- No conflict = no drama
+- Internal conflict (within character) + external conflict (with world)
+- Conflict can be subtle (silence, glance) or extreme (fight)
+
+### 3. Specificity creates universality
+- "She drank coffee" is generic
+- "She wrapped both hands around the chipped Karavan mug, her grandmother's mug" — universal feeling, specific detail
+
+### 4. Want vs Need
+- What the protagonist WANTS (their conscious goal)
+- What they NEED (what would actually fulfill them)
+- Best stories: they get the need, not always the want
+
+### 5. Cause and effect
+- Each scene caused by previous, causing the next
+- "Therefore" or "But" — never "And then"
+- Bad: A happens, AND THEN B happens
+- Good: A happens, BUT B intervenes; THEREFORE C results
+
+### 6. Stakes
+- Why does this matter?
+- What does the character lose if they fail?
+- Make stakes specific and personal
+
+## Scene anatomy
+
+Every scene has:
+- **Goal**: what does protagonist want in THIS scene
+- **Conflict**: what stops them
+- **Outcome**: do they succeed (Yes), fail (No), or partial (Yes But / No But)
+
+If a scene has no goal/conflict/outcome — it's not a scene, it's exposition. Cut it.
+
+## Dialogue purpose
+
+Every line of dialogue should do at least 2 of these:
+1. Reveal character
+2. Advance plot
+3. Provide subtext (what's NOT being said)
+4. Create conflict
+
+If a line does only 1, consider cutting.
+
+## Subtext
+
+Characters rarely say what they mean.
+- Two people talking about the weather might really be talking about their relationship
+- A father commenting on his son's tie might really be expressing pride
+- Subtext is what makes scenes resonate
+
+## Pacing principles
+
+- Open scene late (in the middle of action)
+- Close scene early (before resolution explained)
+- Cut anything that isn't essential
+- Let tension breathe before payoffs
+
+## Character motivation
+
+Every character (even minor) wants something. They have:
+- A worldview (how they see things)
+- A wound (what hurt them in the past)
+- A want (what they're chasing)
+- A need (what they actually need)
+
+These shape every line they speak.
+
+## Universal pitfalls
+
+- Exposition dumps ("As you know, Bob...")
+- On-the-nose dialogue (saying exactly what you mean)
+- Convenient coincidences (in Act 2 or 3)
+- Passive protagonist (things happen TO them, not BY them)
+- No stakes / no urgency
+- Telling instead of showing
+- Generic characters (no specific traits)

package/templates/skills/screenwriter/knowledge/core/pacing.md

@@ -0,0 +1,143 @@
+# Pacing — Script Core
+
+> How fast or slow a story moves. Critical for holding audience attention across all formats.
+
+## What pacing is
+
+The rate at which:
+- Information is revealed
+- Emotional beats land
+- Plot advances
+- Stakes change
+
+Wrong pacing = audience disengagement, regardless of how good content is.
+
+## Format-specific pacing baselines
+
+| Format | Pace |
+|--------|------|
+| TikTok / Reel | Hook in 3s, payoff in 30s |
+| YouTube short | Hook in 5s, structure in 60s |
+| 30s ad | Hook 0-3s, problem 3-15s, solution 15-25s, CTA 25-30s |
+| Brand film 60-90s | Slow buildup, emotional peak |
+| Music video | Beat-driven, varies |
+| YouTube long-form | Hook 0-15s, slow burn ok |
+| Short film 5-15min | Setup-Confrontation-Resolution within minutes |
+| Series episode | Cold open + 4-act structure (~22-50min) |
+| Feature film | 90-120min, classic 3-act |
+| Documentary | Subject-driven, longer setups ok |
+
+## Universal pacing principles
+
+### Open late, close early
+- Start scenes IN action, not setup
+- End scenes BEFORE full resolution
+
+```
+BAD:
+Two characters enter cafe.
+They order coffee.
+They sit.
+They start the difficult conversation.
+
+GOOD:
+Mid-conversation already happening.
+"You can't be serious."
+Resolution implied, scene ends on look.
+```
+
+### Vary scene length
+- Short scenes = tension, pace
+- Long scenes = character, depth
+- Alternate for rhythm
+
+### Information drip
+- Don't dump backstory in Act 1
+- Reveal info as needed
+- Save reveals for impact moments
+
+### Build to peaks
+- Each act ends at higher tension than it began
+- Climax should feel inevitable yet surprising
+
+## Pacing tools
+
+### Quick cuts (fast pacing)
+- Many scenes, short
+- Crosscutting between locations
+- Dialogue overlaps
+
+### Long takes (slow pacing)
+- Single scene unfolds
+- Real-time feel
+- Builds tension or atmosphere
+
+### Time jumps
+- Skip the boring parts
+- "3 days later" or visual cues
+- Reader/viewer fills gaps
+
+### Montage
+- Compress time
+- Show progression
+- Emotional/musical beat
+
+## Pacing pitfalls
+
+### Saggy middle (Act 2)
+Most scripts lose steam in Act 2. Solutions:
+- Add a midpoint reversal
+- Introduce new obstacle
+- Raise stakes
+- Subplot crossover
+
+### Rushed Act 3
+Climax should breathe. Don't rush:
+- Build to climax with set-pieces
+- Let resolution moments land
+- Don't immediately wrap up
+
+### Slow opening
+Modern audiences won't wait. Solutions:
+- Open mid-scene
+- In medias res (start in middle of action)
+- Hook first, exposition later
+
+## Per-format pacing rules
+
+### TikTok / Reel (sub-60s)
+- 0-3s: HOOK (visual + question)
+- 3-15s: ESCALATION
+- 15-45s: REVEAL
+- 45-60s: PAYOFF + CTA
+
+### Brand 30s ad
+- 0-3s: HOOK
+- 3-12s: PROBLEM
+- 12-22s: PRODUCT introduction
+- 22-28s: SOLUTION/transformation
+- 28-30s: CTA / brand
+
+### Short film 10min
+- 0-1min: Setup (world + character)
+- 1-3min: Inciting incident
+- 3-6min: Confrontation
+- 6-7min: Crisis
+- 7-9min: Climax
+- 9-10min: Resolution
+
+### Sitcom episode (22min)
+- 0-2min: Cold open (setup)
+- 2-7min: Act 1 (problem introduced)
+- 7-15min: Act 2 (escalation)
+- 15-22min: Act 3 (resolution + button)
+
+## Subjective vs objective pacing
+
+- **Objective** = clock time
+- **Subjective** = how time FEELS to viewer
+
+A 5-minute scene with tension feels short.
+A 30-second scene with no stakes feels long.
+
+Pacing is about emotional engagement, not just clock.

package/templates/skills/screenwriter/knowledge/platforms/cinema-theatrical.md

@@ -0,0 +1,156 @@
+# Cinema Theatrical — Platform
+
+> Big screen theatrical release. The traditional cinema experience.
+
+## Defining characteristics
+
+- Big screen (theater)
+- No interruptions / breaks
+- Captive audience (paid for ticket)
+- Premium production value expected
+- Cinematic aspect ratios (1.85:1, 2.39:1)
+- Surround sound design
+- Long-form (90-180 min typical)
+
+## Format conventions
+
+### Length
+- Short film festival: 1-30 min
+- Indie feature: 75-100 min
+- Mainstream feature: 100-150 min
+- Epic / prestige: 150-210 min
+
+### Aspect ratios
+- 1.85:1 — standard widescreen
+- 2.39:1 — anamorphic / cinemascope
+- 1.66:1 — European art-house
+- 1.43:1 — IMAX (rare)
+- Aspect impacts framing fundamentally
+
+### Pacing
+- Patient (audience can't skip)
+- Long takes welcome
+- Silence has weight
+- Build to crescendo
+
+## Writing for cinema
+
+### Visual storytelling first
+- Trust the image
+- Less dialogue, more action/expression
+- Cinematic shots designed for big screen
+- Spectacle moments (vista, scale)
+
+### Sound design
+- Surround dimensionality
+- Silence vs. sound contrast
+- Music score as character
+
+### Theatrical experience
+- Audiences experience together
+- Communal laughter, gasps
+- Build for these moments
+- Don't talk DOWN to audience
+
+### Major studio vs indie
+
+**Major studio (Hollywood)**
+- 90-130 min commercial
+- Conventional structure
+- Genre adherence
+- Star vehicles
+- Marketable hooks
+
+**Indie / Festival**
+- Length flexible
+- Experimental structure ok
+- Auteur voice
+- Character-driven
+- Theme over plot
+
+**Art house / International**
+- Slow cinema acceptable
+- Long takes
+- Foreign language
+- Subversive narrative
+- Limited release expected
+
+## Genre considerations
+
+### Action / Spectacle
+- Set pieces every 15-20 min
+- Big screen-worthy visuals
+- Practical effects ideal
+
+### Drama
+- Character peaks at 30, 60, 90 min
+- Emotional crescendos
+- Long performance moments
+
+### Comedy
+- Audience reaction breaks
+- Allow laughter to land
+- Bigger gestures
+
+### Horror
+- Theater dark = jumps land harder
+- Sound design crucial
+- Patience for tension
+
+### Animation
+- Visual feast
+- Character clarity (back row reads)
+- All ages awareness
+
+## Sample structure: 110-min feature
+
+```
+ACT 1 (0-25 min)
+- Setup world, character
+- Inciting incident around 10-15 min
+- First-act break around 25 min
+
+ACT 2A (25-55 min)
+- Confrontation
+- New world/journey
+- Subplots introduced
+
+MIDPOINT (55 min)
+- Major reversal
+- Rules change
+- Stakes raised
+
+ACT 2B (55-85 min)
+- Continued struggle
+- Crisis builds
+- All-is-lost moment around 80 min
+
+ACT 3 (85-110 min)
+- Final attempt
+- Climax around 95-100 min
+- Resolution / new normal
+```
+
+## Pitfalls
+
+- TV pacing (too fast for big screen)
+- Streaming-optimized hooks (cinema audience already invested)
+- Dialogue-heavy when visual would work
+- Forgetting cinema sound (silent moments waste)
+- Aspect ratio mismatch
+
+## When to write for cinema
+
+- Theatrical release planned
+- Festival submission
+- Premium production
+- Long-form story requiring big screen
+- Visual scale that needs theater
+
+## Modern context (2026)
+
+Cinema-only content rare; most has streaming destination too. But cinema-FIRST writing:
+- Spectacle
+- Communal experience moments
+- Long-form character investment
+- Not optimized for second-screen viewing

package/templates/skills/screenwriter/knowledge/platforms/instagram-reel.md

@@ -0,0 +1,145 @@
+# Instagram Reel — Platform
+
+> Short-form vertical video on Instagram. Similar to TikTok but with brand-aware audience.
+
+## Defining characteristics
+
+- Vertical 9:16
+- Length: 15s - 90s (sweet spot 30-60s)
+- Sound-on by default
+- More polished than TikTok (audience expectation)
+- Brand-aware viewers
+- Connected to feed/story ecosystem
+
+## Differences from TikTok
+
+| Aspect | TikTok | Instagram Reel |
+|--------|--------|----------------|
+| Audience age | Younger (Gen Z) | Mixed (Millennials prominent) |
+| Polish level | Lo-fi ok | More polished expected |
+| Brand presence | Disruptive | Welcomed |
+| Trends | Move fast | Slower adoption |
+| Length sweet spot | 30-90s | 30-60s |
+| Hook urgency | 1-3s | 3-5s (slightly more patience) |
+| Music library | Native + custom | Instagram + custom |
+
+## Aesthetic expectations
+
+### Reel viewers expect
+- Cleaner visuals
+- Better composition
+- Considered color
+- "Aspirational" feel often
+- Brand-friendly polish
+
+### Less of TikTok's
+- Raw / unedited
+- Lo-fi authenticity
+- Maximum chaos energy
+
+## Hook (first 3-5 seconds)
+
+Slightly more patience than TikTok but still critical:
+- Strong visual
+- Clear premise
+- Hook to scroll
+
+## Format conventions
+
+### Storytime
+- Personal narrative
+- Polished delivery
+- Clean visuals throughout
+
+### Tutorial
+- Clear steps
+- Visual demonstrations
+- Brand-friendly products
+
+### Aesthetic / Lifestyle
+- Mood pieces
+- Travel / food / fashion
+- Music-driven
+
+### Behind-the-scenes
+- Brand or creator process
+- Polished but authentic
+- Trust-building
+
+### Reel for brand
+- Product in context
+- Lifestyle integration
+- CTA via swipe-up or bio link
+
+## Music
+
+- Trending sounds boost reach
+- Original audio for brand identity
+- Music genre matches mood
+- Cuts to beat
+
+## Captions / Text
+
+- Required for accessibility
+- Use Instagram's native text tools
+- Clean, brand-consistent style
+- Don't over-stuff
+
+## Pacing
+
+Slightly slower than TikTok:
+- Cuts every 2-4 seconds
+- Allow visual moments to breathe
+- Build tension/anticipation
+- Strong endings
+
+## Brand integration
+
+Reel viewers MORE accepting of brands than TikTok:
+- Native product placement
+- Aspirational lifestyle
+- Brand storytelling
+- Professional creators welcomed
+
+## Cross-posting consideration
+
+Many creators post same content to TikTok + Reels. To optimize for Reels specifically:
+- Slightly higher polish
+- Less TikTok-trend-specific references
+- Brand-friendly elements
+
+## Connection to Instagram ecosystem
+
+Reels live within Instagram:
+- Bio link CTA
+- Story pinning
+- Highlight integration
+- Direct message engagement
+
+Use these connections.
+
+## Length recommendations by goal
+
+| Goal | Length |
+|------|--------|
+| Reach (algorithm) | 30-60s |
+| Engagement | 15-30s |
+| Information | 60-90s |
+| Brand awareness | 15-30s |
+| Sales / conversion | 30-60s + CTA |
+
+## Voice
+
+- Polished but personal
+- Direct
+- Aspirational often
+- Brand-aware
+- Less raw than TikTok
+
+## Pitfalls
+
+- Too lo-fi (loses Reel audience)
+- Overly polished (loses authenticity)
+- TikTok-only references (Instagram audience may miss)
+- Weak hook
+- No clear CTA

package/templates/skills/screenwriter/knowledge/platforms/streaming-hbo-prestige.md

@@ -0,0 +1,134 @@
+# Streaming (HBO Prestige) — Platform
+
+> Premium prestige content. HBO, MAX, Apple TV+ (premium side), AMC+, FX. Slow-burn character-driven storytelling.
+
+## Defining characteristics
+
+- "Prestige" branding (artistic intent)
+- Slower pace than commercial streaming
+- Auteur-driven (director/writer voice)
+- Limited episodes per season (6-10)
+- Higher per-episode budget
+- Critical acclaim focus
+- Complex characters
+
+## Format conventions
+
+### Episode length
+- 50-80 minutes typical
+- Some up to 90 min (treated as mini-features)
+- Pilot can be feature-length
+
+### Pacing
+- Slower than commercial streaming
+- More silence, breath
+- Long takes welcome
+- Character focus over plot
+
+### Tone
+- Adult, complex, often dark
+- Moral ambiguity
+- Anti-hero protagonists common
+- Themes over plot
+
+## Writing for prestige
+
+### Character first
+- Plot serves character revelation
+- Internal world prioritized
+- Every character has interiority
+
+### Subtext heavy
+- Dialogue meanings layered
+- What's NOT said matters
+- Patient audience
+
+### Visual storytelling
+- Trust the image
+- Long takes
+- Silence as language
+- Cinematic compositions
+
+### Theme integration
+- Story has something to say
+- Themes woven through
+- Not didactic
+
+## Examples of prestige
+
+- The Wire — institutions, working class
+- Succession — wealth, power, family
+- White Lotus — class, privilege
+- Fleabag — grief, intimacy
+- Mad Men — ambition, identity
+- Mare of Easttown — community, loss
+- Breaking Bad — morality, ego
+- Severance — work, identity
+
+## Sample opening
+
+```
+COLD OPEN (3-7 min)
+- May have no dialogue
+- Atmospheric, character moment
+- Sometimes seemingly unrelated to plot
+- Mood/theme establishment
+
+CREDITS (often elaborate)
+
+ACT 1 (10-15 min)
+- Multiple character introductions
+- Slow build
+- Subtle plot threads
+```
+
+## Content freedoms
+
+- Full freedom (premium)
+- Adult content
+- Violence, sexuality, profanity
+- Complex moral territory
+
+Use freedom in service of theme, not gratuitously.
+
+## Pacing comparison
+
+| Element | Commercial streaming | HBO prestige |
+|---------|---------------------|--------------|
+| Hook timing | First 30s | First 5 min |
+| Scene length | 2-4 min | 4-8 min |
+| Dialogue density | High | Medium-low |
+| Action density | Variable | Low |
+| Resolution speed | Episode | Season |
+
+## When to write for prestige
+
+- Character-driven story
+- Adult themes
+- Auteur sensibility
+- Critical aspirations
+- Slower audience patience expected
+
+## Differs from commercial streaming
+
+Commercial streaming (Netflix typical) prioritizes:
+- Hook, retention metrics
+- Wider audience
+- Faster pace
+
+Prestige (HBO typical) prioritizes:
+- Critical acclaim
+- Artistic vision
+- Slower deliberate pace
+- Smaller dedicated audience
+
+## Specific sub-styles
+
+### British prestige
+Slower still, more dialogue-driven (Fleabag, Black Mirror, Sherlock)
+
+### Scandinavian prestige
+Sparse, atmospheric (The Bridge, Borgen)
+
+### Korean prestige
+Visual-driven, melodrama elements (Kingdom, Squid Game)