@azerogluemin/ai-bootstrap 0.2.1

package/templates/skills/screenwriter/knowledge/platforms/streaming-netflix-style.md

@@ -0,0 +1,118 @@
+# Streaming (Netflix-style) — Platform
+
+> Algorithm-driven streaming platforms with binge-watching model. Netflix, Amazon Prime, Apple TV+ (commercial side).
+
+## Defining characteristics
+
+- No ad breaks (Netflix originals)
+- Binge-able (full season drops)
+- Algorithm-recommended
+- High production value
+- International reach
+- Variable episode length (no fixed time slot)
+
+## Format conventions
+
+### Episode length flexibility
+- Drama: 45-65 min (no fixed slot)
+- Comedy: 25-35 min
+- Limited series: episodes can vary widely (30-90 min)
+
+### Cold open
+Strong opening hook to prevent autoplay-skip:
+- Hook within first 30 seconds
+- Visual + tension
+- Question planted
+
+### Binge structure
+Episodes designed to flow into next:
+- Cliffhanger endings (autoplay continues)
+- Question carries to next episode
+- Season-long mystery boxes
+
+## Writing for binge
+
+### Episodic + season balance
+Each episode should:
+- Have self-contained beats (satisfying alone)
+- Advance season-long narrative
+- End on hook for next
+
+### Algorithm awareness
+- Strong opening images (thumbnails)
+- Title cards may be skipped (info on screen)
+- Captions friendly (international audience reads subs)
+
+### Pacing
+Faster than broadcast:
+- Less repetition (no ad breaks to remind)
+- Tight scenes
+- Trim setup
+
+## Content freedoms
+
+- Profanity allowed
+- Sexuality acceptable
+- Graphic violence possible
+- Mature themes welcome
+
+But still curated for streaming brand.
+
+## Genre conventions
+
+### Limited series (8-10 episodes)
+- Mini-feature feel
+- Each episode: act-of-feature
+- Total = single story
+
+### Multi-season drama
+- Season-long arc
+- Episode mini-arcs
+- Character development across years
+
+### Half-hour comedy
+- Single-camera
+- Cinematic look
+- Character-driven
+
+## Sample episode opening (streaming drama)
+
+```
+COLD OPEN (3-5 min)
+- Strong visual hook
+- Mystery / tension
+- May not feature regulars
+- Sets episode question
+
+[Title card — brief, may be skipped by viewer]
+
+ACT 1 (10-15 min)
+- Regular characters introduced/returned
+- Episode-specific problem
+- Connect to season arc
+```
+
+## Regional considerations
+
+Netflix produces content for global audience:
+- Local language originals (Korean, Spanish, etc.)
+- Universal themes
+- Subtitle-friendly dialogue (avoid wordplay-only humor)
+
+## When to write for Netflix-style streaming
+
+- Modern audiences expecting binge
+- Mature content fits
+- High production budget anticipated
+- International appeal desired
+
+## Differs from broadcast
+
+| Aspect | Broadcast | Netflix |
+|--------|-----------|---------|
+| Length | Fixed slots | Flexible |
+| Ad breaks | Required | None |
+| Endings | Cliffhangers for ads | Cliffhangers for binge |
+| Pacing | Slower | Faster |
+| Content | Restricted | Freer |
+| Discovery | Schedule | Algorithm |

package/templates/skills/screenwriter/knowledge/platforms/tiktok-vertical.md

@@ -0,0 +1,166 @@
+# TikTok Vertical — Platform
+
+> Short-form vertical video. Algorithm-driven discovery. Sound-on by default.
+
+## Defining characteristics
+
+- Vertical 9:16 ONLY
+- Length: 7s - 10min (sweet spot 30-90s)
+- Sound-on default (sound design matters)
+- Algorithm: For You Page (FYP)
+- Trend-aware
+- Comment culture
+
+## Hook (first 1-3 seconds — CRITICAL)
+
+If viewers swipe past in first 3s, video is dead. Hook with:
+
+### Visual hook
+- Strong opening image
+- Movement
+- Color / contrast
+- Text overlay
+
+### Verbal hook
+- Question
+- Bold claim
+- "POV: ..."
+- "You won't believe..."
+
+### Emotional hook
+- Vulnerability
+- Strong reaction
+- Tension
+
+### Pattern hook
+- Familiar trend
+- Recognizable sound
+- Common format
+
+## Length sweet spots
+
+| Length | Use case |
+|--------|----------|
+| 7-15s | Quick joke, single moment |
+| 15-30s | Trend, simple story |
+| 30-60s | Storytime, tutorial, longer skit |
+| 60-90s | Deep storytime, educational |
+| 90-180s | Storytime with twists |
+| 3-10min | Educational deep dive (rare) |
+
+## Sound-on design
+
+### Music
+- Trending sounds boost reach
+- Music drives mood
+- Match cuts to beats
+- Original music for brands
+
+### Voice
+- Direct address to camera
+- Whisper for intimacy
+- Excited for energy
+
+### Sound effects
+- Punctuate moments
+- Native TikTok SFX library
+- Don't overuse
+
+## Captions / Text overlay
+
+ESSENTIAL for TikTok:
+- Many watch with sound off (initially)
+- Subtitles for accessibility
+- Text emphasis on key moments
+- Consistent style for brand
+
+Use TikTok native text styles for trend signals.
+
+## Trend integration
+
+### Riding trends
+- Use trending sound
+- Use trending format
+- Add unique twist (don't just copy)
+- Move fast (trends die in days)
+
+### Creating trends
+- Distinctive sound/format
+- Easily replicable
+- Hook other creators to use
+
+## Format templates
+
+### Storytime
+```
+0-3s: HOOK ("POV: ...", or shocking statement)
+3-10s: SETUP
+10-30s: ESCALATION
+30-50s: TWIST
+50-60s: PUNCHLINE / Cliffhanger
+```
+
+### Tutorial
+```
+0-3s: HOOK ("Here's how to...")
+3-15s: SETUP problem
+15-50s: STEPS
+50-60s: RESULT + CTA
+```
+
+### Skit
+```
+0-3s: SETUP visual
+3-10s: NORMAL
+10-20s: TURN
+20-30s: PAYOFF
+```
+
+### POV
+```
+0-3s: "POV: you're..."
+3-15s: SCENE BUILDS
+15-30s: PEAK
+```
+
+## Voice for TikTok
+
+- Casual, conversational
+- Personal, vulnerable
+- Direct (no buildup)
+- "You" focused
+- Native TikTok vocabulary
+
+## Pacing
+
+MAXIMUM pacing:
+- Cut every 1-3 seconds
+- No dead air
+- Audio + visual + text together
+- Information density
+
+## Cliffhangers / Series
+
+End on:
+- "Wait for part 2"
+- Unanswered question
+- Reveal teased
+
+Drives followers to bookmark / follow.
+
+## Pitfalls
+
+- Slow opening (3s = dead)
+- Generic hooks
+- Trend-late (movement-mover)
+- Polished feel (lacks authenticity)
+- Long talking-head openings
+- Forgetting captions
+
+## Comments engagement
+
+Write content that GENERATES comments:
+- Controversial claims (handle carefully)
+- Questions to audience
+- Relatable moments
+- Reaction-baiting moments

package/templates/skills/screenwriter/knowledge/platforms/tv-broadcast.md

@@ -0,0 +1,85 @@
+# TV Broadcast — Platform
+
+> Traditional television: scheduled programming, ad breaks, commercial network or public broadcast.
+
+## Defining characteristics
+
+- Time slots (30min, 60min)
+- Commercial breaks every 8-12 min
+- Family-viewing considerations
+- Standards & Practices (S&P) restrictions
+- Wider demographic reach
+
+## Format conventions
+
+### Half-hour show (22 min content + 8 min ads)
+- Cold open + Act 1 → ad break → Act 2 → ad break → Act 3 → tag
+
+### Hour-long show (44 min content + 16 min ads)
+- Teaser + Act 1 → break → Act 2 → break → Act 3 → break → Act 4 → break → Act 5
+
+## Writing for ad breaks
+
+Each act ends on cliffhanger or momentum to keep viewers through ads:
+- Question raised
+- Stakes elevated
+- Reveal moment
+- Tension peak
+
+## Content restrictions
+
+Network broadcast (US) restrictions:
+- Limited profanity
+- No nudity
+- Limited graphic violence
+- Topic sensitivities
+
+Cable / international vary.
+
+## Demographic awareness
+
+Broadcast TV reaches:
+- Older skew (50+)
+- Wider geography
+- Family viewing
+- Less tech-savvy audiences
+
+Adjust references, vocabulary, themes accordingly.
+
+## Pacing
+
+- Slower than streaming (audience patience)
+- Multi-camera sitcom: fast joke density (4-7 jokes per minute)
+- Single-camera: more cinematic pacing
+- Drama: balance dialogue and action
+
+## Sample structure: 22-min sitcom
+
+```
+COLD OPEN (1-2 min) — Quick scene establishing world/joke
+TITLE CARD
+ACT 1 (5-7 min) — Episode problem introduced
+[AD BREAK]
+ACT 2 (8-10 min) — Complication/escalation
+[AD BREAK]
+ACT 3 (3-5 min) — Resolution
+TAG (30s) — Final joke/button
+```
+
+## When to write for broadcast
+
+- Reaching mass audiences
+- Established networks (CBS, NBC, FOX, ABC, regional)
+- Working with showrunner conventions
+- Family or demo-specific content
+
+## Modern context (2026)
+
+Pure broadcast TV declining; most prestige content moved to streaming. Broadcast remains for:
+- Live sports
+- News
+- Daytime
+- Sitcoms (some)
+- Procedurals
+
+Specify "broadcast TV" only if format requires it.

package/templates/skills/screenwriter/knowledge/platforms/web-banner.md

@@ -0,0 +1,156 @@
+# Web Banner — Platform
+
+> Display ads on websites. Often muted, autoplay, brief, embedded in content.
+
+## Defining characteristics
+
+- Length: 5-15 seconds typical
+- Autoplay (often muted by default)
+- Embedded in webpage (alongside content)
+- Skippable after 5s (often)
+- Visual-first (sound-off design)
+- Click-through goal
+
+## Length conventions
+
+| Length | Use case |
+|--------|----------|
+| 5s | Pre-roll bumper, gut hit |
+| 6s | YouTube non-skippable bumper |
+| 10-15s | Standard display ad |
+| 15-30s | Pre-roll skippable |
+
+## Mute-friendly design
+
+Most viewers see web banners with sound off:
+- Visual must communicate
+- Captions/text overlays essential
+- Music optional, not relied on
+- Sound design = bonus, not primary
+
+## Hook (first 1-2 seconds)
+
+Web banner viewers are scanning, not focused:
+- Strong visual immediately
+- Brand or product visible early
+- Question or claim text overlay
+
+## Format conventions
+
+### 5-second bumper
+```
+0-1s: Brand visible
+1-3s: Single message
+3-5s: CTA / brand sign-off
+```
+
+### 15-second ad
+```
+0-2s: Hook visual
+2-8s: Product / message
+8-12s: Benefit / proof
+12-15s: CTA + brand
+```
+
+### 30-second skippable
+```
+0-5s: HOOK (must hold past skip)
+5-15s: Setup
+15-25s: Payoff
+25-30s: CTA
+```
+
+## Common formats
+
+### Product showcase
+- Hero shot of product
+- Quick benefit text
+- Brand + CTA
+
+### Lifestyle moment
+- Aspirational context
+- Product appears naturally
+- Emotion-driven
+
+### Comparison
+- Before / After
+- Us vs them
+- Quick visual
+
+### Discount / Deal
+- Bold offer text
+- Product visible
+- Urgency element
+- Strong CTA
+
+## Pacing
+
+Maximum density:
+- Multiple beats per second
+- Quick cuts
+- No dead air
+
+## Visual design priorities
+
+1. Brand recognition
+2. Product visibility
+3. Single clear message
+4. Visual hook
+5. CTA prominence
+
+## Text overlay rules
+
+- Large, readable
+- Brand-consistent typography
+- High contrast
+- Mobile-friendly sizes
+- Brief (3-7 words max per moment)
+
+## Aspect ratios
+
+- 16:9 — standard banner
+- 9:16 — vertical mobile
+- 1:1 — square
+- 4:5 — Instagram feed
+- 21:9 — leaderboard
+
+## Music / Sound (when on)
+
+- Brand sonic identity
+- Catchy / memorable
+- Appropriate to content viewer is engaged with
+- 5-second sting works
+
+## Click-through optimization
+
+- Clear CTA
+- Curiosity gap (don't reveal everything)
+- Easy to engage
+- Mobile-friendly destination
+
+## When to write for web banner
+
+- Display advertising campaigns
+- YouTube pre-roll
+- Social platform ads (Instagram, Facebook ads)
+- Retargeting
+- Programmatic buys
+
+## Pitfalls
+
+- Sound-dependent (mute viewers miss it)
+- Too much message (single point only)
+- Slow opening (skipped)
+- Unclear CTA
+- Brand invisible until end (viewers leave first)
+- Generic stock-feel (loses authenticity)
+
+## Modern context
+
+Web banners shifting toward:
+- Native integration (look like content)
+- Influencer-style authenticity
+- Vertical format
+- Sound-on (TikTok ad-style)
+
+Adapt accordingly per platform.

package/templates/skills/screenwriter/knowledge/platforms/youtube.md

@@ -0,0 +1,137 @@
+# YouTube — Platform
+
+> Long-form video platform. Algorithm-driven, retention-focused, creator-direct.
+
+## Defining characteristics
+
+- Variable length (3-60+ min)
+- Algorithm rewards retention + watch time
+- Direct creator-viewer relationship
+- Comments / community
+- Monetization via ads + memberships
+- SEO via title + thumbnail + description
+
+## Length conventions
+
+| Type | Length |
+|------|--------|
+| Shorts (separate) | 60s max |
+| Quick tutorial | 3-7 min |
+| Standard video | 8-15 min |
+| Deep dive / essay | 15-30 min |
+| Documentary / commentary | 30-60+ min |
+| Podcast / interview | 60-120 min |
+
+## Algorithm awareness
+
+### Hook (first 15 seconds)
+Critical for retention:
+- State what the video is about
+- Tease the payoff
+- Ask the question viewers came for
+- Visual hook (movement, edit)
+
+### Retention beats
+Spread engaging moments throughout:
+- "Stay tuned for..."
+- Visual variety
+- Pace changes
+- Peak moments mid-video
+
+### Pattern interrupts
+Break monotony every 60-90 seconds:
+- Cut to b-roll
+- Change of location
+- Visual element
+- Sound design
+
+### End screen
+Last 20s for engagement:
+- Subscribe ask
+- Next video tease
+- Comment prompt
+
+## Writing for YouTube
+
+### Title-first thinking
+- What would make someone click?
+- Title + thumbnail = promise
+- Video must DELIVER on promise
+- Don't bait-and-switch
+
+### Conversational tone
+- Direct address to camera
+- "You" language
+- Personal anecdotes welcome
+- First-person voice common
+
+### Information density
+- Pack information for engaged viewers
+- But don't overload
+- Visual aids reinforce
+
+### Structure templates
+
+#### How-To
+1. Hook ("This is how you...")
+2. Promise / why care
+3. Steps (numbered, visual)
+4. Result / proof
+5. CTA
+
+#### Essay/Commentary
+1. Hook (provocative claim)
+2. Setup context
+3. Argument with examples
+4. Counter-arguments addressed
+5. Conclusion / takeaway
+6. CTA
+
+#### Vlog
+1. Hook (where are we, what's happening)
+2. Day's events
+3. Highlights / moments
+4. Reflection / takeaway
+5. CTA
+
+#### Deep dive
+1. Hook (the mystery)
+2. Background
+3. Investigation
+4. Reveals
+5. Conclusion
+6. CTA
+
+## Pacing
+
+YouTube viewers more patient than TikTok but less than streaming TV:
+- Quick cuts in first 30s
+- Slow down for important info
+- Pattern interrupt every 60-90s
+- Don't overstay welcome
+
+## Voice and personality
+
+YouTube creators are PERSONALITIES:
+- Distinctive voice = subscriber loyalty
+- Authentic > polished
+- Show personality
+- Brand consistency
+
+## When to write for YouTube
+
+- Educational/informational content
+- Personality-driven content
+- Long-form storytelling that doesn't fit ads
+- Direct creator-audience relationship
+- SEO-discoverable topics
+
+## Differs from TikTok
+
+| Aspect | TikTok | YouTube |
+|--------|--------|---------|
+| Length | <60s | 3-60min |
+| Discovery | FYP algorithm | Search + recommended |
+| Pacing | Maximum | Moderate |
+| Voice | Trend-aware | Personality-driven |
+| Production | Lo-fi ok | Higher expected |