@azerogluemin/ai-bootstrap 0.2.1

package/templates/skills/screenwriter/knowledge/categories/youtube-long/formats/commentary.md

@@ -0,0 +1,159 @@
+# Commentary — YouTube Long Format
+
+> Reaction + analysis of cultural events, content, news. 10-30 min typical. Personal voice.
+
+## Format basics
+
+- Length: 10-30 min typical
+- Aspect: 16:9
+- Reaction + analysis
+- Cultural commentary
+- Personal voice / opinion
+- Often topical (responding to news/event)
+
+## Structure
+
+```
+0-1min    HOOK
+          What you're commenting on
+          Why now
+
+1-3min    CONTEXT
+          What happened
+          Background needed
+
+3-15min   REACTION + ANALYSIS
+          Your take
+          Specific moments examined
+          Patterns identified
+
+15-25min  DEEPER COMMENTARY
+          Implications
+          Broader patterns
+          Personal POV
+
+25-28min  CONCLUSION
+          Final take
+          Where things go from here
+
+28-30min  CTA
+          Subscribe
+          Discussion in comments
+```
+
+## Sample 15-min commentary
+
+```
+"What [Major Coffee Brand]'s New Strategy Says About the Industry"
+
+0-1min: HOOK
+- "Last week, [major brand] announced they're moving to direct-trade
+coffee. Here's why this is bigger than coffee."
+- Quick visual: their announcement
+
+1-3min: CONTEXT
+- Brand's history (mass market)
+- The announcement details
+- The industry context
+
+3-8min: REACTION
+- "Here's why I think this matters."
+- Specific aspects of announcement
+- What's good
+- What's marketing speak
+- What's actually new
+
+8-12min: ANALYSIS
+- Industry trend analysis
+- Other brands following
+- Consumer behavior shifts
+- Direct trade explained
+
+12-14min: DEEPER COMMENTARY
+- What this means for small roasters
+- Customer expectations changing
+- Next 5 years prediction
+
+14-15min: CONCLUSION + CTA
+- "Coffee industry is changing. This is how."
+- "Comment your take below"
+- "Subscribe for more industry commentary"
+```
+
+## Key principles
+
+### Personal voice
+- Your take matters
+- Don't be neutral observer
+- Have opinion
+
+### Substantive analysis
+- Not just reaction
+- Patterns identified
+- Implications drawn
+
+### Specific evidence
+- Quote sources
+- Show clips/screenshots
+- Specific examples
+
+### Engagement-driven
+- Provoke discussion
+- Invite comments
+- Be willing to be wrong
+
+### Timely
+- React to recent events
+- Algorithm rewards timeliness
+- Audience comes for current take
+
+## Sub-types
+
+### Industry commentary
+- Trends in your field
+- Insider perspective
+- Authority-building
+
+### Cultural commentary
+- Social trends
+- Internet culture
+- Generational analysis
+
+### Political commentary
+- Current events
+- Policy analysis
+- Personal political views
+
+### Tech commentary
+- New releases
+- Industry shifts
+- Future predictions
+
+### Sports commentary
+- Game analysis
+- Trade reactions
+- Career evaluations
+
+## When to use
+
+- Building authority in field
+- Audience-building (engagement)
+- Discussion-driven content
+- Patreon / Substack audience
+- Newsletter companion content
+
+## Common mistakes
+
+- All reaction, no analysis
+- Generic takes (anyone could say)
+- Late to topic (algorithm doesn't reward)
+- Personal attacks
+- Echo-chamber feel
+
+## Voice style
+
+- Confident
+- Conversational
+- Direct camera engagement
+- Specific examples
+- Personal story occasionally

package/templates/skills/screenwriter/knowledge/categories/youtube-long/formats/documentary-style.md

@@ -0,0 +1,180 @@
+# Documentary-Style — YouTube Long Format
+
+> Documentary aesthetic on YouTube. Investigative or observational. 20-60+ min.
+
+## Format basics
+
+- Length: 20-60+ min
+- Documentary cinematography
+- Talking-head interviews
+- B-roll heavy
+- Investigative or observational
+- Real subjects/events
+
+## Structure
+
+```
+0-3min   HOOK
+         Compelling moment
+         Question/mystery established
+
+3-10min  SETUP
+         Subject introduced
+         Stakes clarified
+         Multiple voices begin
+
+10-40min INVESTIGATION / EXPLORATION
+         Multiple POVs
+         Evidence gathered
+         Reveals throughout
+
+40-55min CLIMAX / TURNING POINT
+         Major revelation
+         Or narrative peak
+
+55-60min RESOLUTION / REFLECTION
+         What it means
+         Where things stand
+         Filmmaker reflection
+```
+
+## Sample 45-min documentary-style YouTube video
+
+```
+"Inside the Yemen Coffee Trade: A 6-Month Investigation"
+
+0-3min: HOOK
+- Striking imagery: coffee farm at sunrise
+- Voice (filmmaker, intimate): "Six months ago, I went to Yemen
+to find out why the world's best coffee comes from a country at war."
+
+3-10min: SETUP
+- Filmmaker arrival in Sana'a
+- First interview: a coffee farmer
+- His farm has been in family 4 generations
+- Currently impossible to export
+- War, sanctions, infrastructure
+
+10-25min: EXPANSION
+- Visit multiple farms
+- Different farmers
+- Showing the bean quality
+- The processing
+- The supply chain breakdown
+- Interview: international buyers
+- The frustration
+
+25-40min: COMPLICATION
+- Discovery: an underground network keeping coffee flowing
+- Risk: filmmaker may be in danger documenting this
+- Interviews with smugglers (faces obscured)
+- Moral complexity
+
+40-50min: CLIMAX
+- Specific farmer's coffee makes it to market
+- He receives payment for first time in 2 years
+- Emotional reunion
+- The bigger picture revealed
+
+50-55min: REFLECTION
+- Filmmaker on what they learned
+- The cup of coffee context now changed
+- Next steps for these farmers
+
+55-60min: WRAP + CTA
+- Where these farmers are now
+- How viewers can help
+- Subscribe + share
+- Cite sources, organizations
+```
+
+## Key principles
+
+### Real subjects
+- People matter
+- Trust earned through respect
+- Privacy considered
+
+### Multiple POVs
+- Different voices
+- Complexity honored
+- Truth = layered
+
+### Cinematography matters
+- Documentary look
+- Real locations
+- Lighting carefully
+
+### Investigative rigor
+- Sources verified
+- Claims supported
+- Ethics maintained
+
+### Filmmaker presence
+- First-person sometimes
+- Or observational
+- Audience trusts perspective
+
+## Sub-types
+
+### Investigative
+- Uncovering truth
+- Following leads
+- Building case
+
+### Observational
+- Watching subjects live
+- Minimal intervention
+- Patience-based
+
+### Issue-based
+- Specific problem examined
+- Solutions explored
+- Activism-adjacent
+
+### Personal documentary
+- Filmmaker's own journey
+- Subjective lens
+- Vulnerability welcomed
+
+## Famous YouTube documentary creators
+
+- Johnny Harris (geopolitical)
+- Yes Theory (immersive experiences)
+- Veritasium (science)
+- Tom Scott (places, history)
+- Corridor Crew (VFX/film breakdown)
+
+## When to use
+
+- Subject deserves long-form treatment
+- Investigative journalism
+- Audience trust building
+- Awards / recognition
+- Patreon / Substack audience
+
+## Common mistakes
+
+- Manipulating subjects
+- Sensationalism over substance
+- Padding (could be shorter)
+- Unfair to subjects
+- Missing context
+- Hidden filmmaker bias
+
+## Ethics
+
+- Subject consent
+- Accurate representation
+- Don't harm sources
+- Truth-telling
+- Fair compensation when possible
+
+## Production
+
+- Significant time (months to years)
+- Travel often required
+- Permissions and releases
+- Multiple shoots
+- Heavy editing
+- Original music or licensing

package/templates/skills/screenwriter/knowledge/categories/youtube-long/formats/interview-podcast.md

@@ -0,0 +1,187 @@
+# Interview / Podcast — YouTube Long Format
+
+> Long-form interview. 30-180 min. Conversation-driven. Two or more participants.
+
+## Format basics
+
+- Length: 30-180 min
+- Aspect: 16:9 (often multi-cam setup)
+- Conversation between host + guest(s)
+- Long-form audience attention
+- Often available as audio podcast also
+
+## Structure
+
+```
+0-2min    INTRO
+          Host introduces guest
+          Why this conversation matters
+          Quick context
+
+2-5min    OPENING
+          Easy questions to warm up
+          Guest establishes presence
+
+5-150min  CONVERSATION
+          Deep questions
+          Stories
+          Tangents
+          Real exchange
+
+150-160min REFLECTIONS
+          Recap moments
+          Final thoughts
+
+160-180min CLOSING + CTA
+          Where to find guest
+          Subscribe
+          Next episode tease
+```
+
+## Sample 90-min podcast structure
+
+```
+"Karavan Coffee Founder — How I Built a Brand from Zero"
+
+GUEST: Founder of Karavan Coffee (fictional)
+
+0-3min: INTRO
+- Host introduces guest
+- Brief bio
+- Why this conversation
+
+3-15min: ORIGIN STORY
+- "Tell me about growing up..."
+- Family, education
+- First exposure to coffee
+- The moment they decided
+
+15-35min: BUILDING THE BUSINESS
+- Early days
+- Specific decisions
+- Mistakes made
+- Learning curve
+
+35-55min: GROWTH
+- Scaling
+- Team building
+- Maintaining quality
+- The critical pivots
+
+55-75min: PHILOSOPHY
+- Why coffee specifically
+- Values that drive decisions
+- What success means
+- Cultural responsibility
+
+75-85min: CHALLENGES + LESSONS
+- Hardest moments
+- What almost broke them
+- What they'd do differently
+
+85-88min: ADVICE
+- For listeners considering similar path
+- Specific actionable wisdom
+
+88-90min: CLOSING
+- Where to find Karavan
+- Where to find guest personally
+- Subscribe + next episode
+```
+
+## Key principles
+
+### Real conversation
+- Not just Q&A
+- Build on answers
+- Follow tangents
+- Be present
+
+### Prepared but not scripted
+- Research the guest
+- Have key questions ready
+- Be willing to deviate
+- Listen actively
+
+### Trust the long form
+- 90 min is fine
+- Don't rush
+- Let stories breathe
+- Audience signed up for length
+
+### Strong intro
+- Hook even for long-form
+- Why this conversation
+- Why this guest
+- Why now
+
+### Production basics
+- Multi-camera helps
+- Good audio essential
+- Comfortable setting
+- Minimal distractions
+
+## Sub-types
+
+### Joe Rogan style
+- 2-3 hour conversations
+- Wide-ranging
+- Casual setting
+- Intimate
+
+### Lex Fridman style
+- Deep technical / philosophical
+- Single camera (often)
+- Long pauses respected
+- Serious tone
+
+### Tim Ferriss style
+- Tactical advice
+- "What's your morning routine?"
+- Productivity-focused
+- Useful for listeners
+
+### Diary of a CEO style
+- Vulnerable conversations
+- Business + personal
+- Production value high
+- Story-arc structured
+
+### Smartless style
+- Multiple hosts
+- Casual + funny
+- Celebrity guests
+- Light tone
+
+## When to use
+
+- Long-form audience (Patreon, premium)
+- Building authority in field
+- Network building
+- Long-term content strategy
+- Cross-platform (audio + video)
+
+## Common mistakes
+
+- Over-scripted (feels stiff)
+- Too many questions, not enough listening
+- Bad audio quality
+- Boring guest (research first)
+- No clear hook or theme
+- Going off topic without purpose
+
+## Production setup
+
+- Multi-camera (2-3) for visual variety
+- Good audio (each person's mic)
+- Comfortable setting (chairs, lighting)
+- Long shoot (90+ min)
+- Edit for highlights versions (Shorts/clips)
+
+## Modern podcast economics
+
+- Patreon for premium content
+- Ads / sponsorships
+- Live shows for top podcasts
+- Cross-promotion network
+- Long-term audience growth

package/templates/skills/screenwriter/knowledge/categories/youtube-long/formats/personal-story.md

@@ -0,0 +1,186 @@
+# Personal Story — YouTube Long Format
+
+> Long-form personal narrative. Vulnerable. Emotional. 10-30 min.
+
+## Format basics
+
+- Length: 10-30 min
+- Aspect: 16:9
+- First-person narrative
+- Vulnerability central
+- Emotional arc
+- Direct camera + b-roll
+
+## Structure
+
+```
+0-1min    HOOK
+          The "what happened"
+          Or current state
+
+1-3min    SETUP
+          Who I am, then
+          Stakes / context
+
+3-20min   THE STORY
+          Chronological journey
+          Major beats
+          Emotional moments
+
+20-25min  REFLECTION
+          What I learned
+          What I'd tell my past self
+          Where I am now
+
+25-28min  TAKEAWAY
+          For audience
+          What this means
+
+28-30min  CTA
+          Subscribe
+          Comment your story
+```
+
+## Sample 20-min personal story
+
+```
+"How I Lost Everything and Built My Coffee Shop"
+
+0-1min: HOOK
+- B-roll: my coffee shop today, busy and beautiful
+- Voiceover: "Three years ago I had nothing. Today I run this.
+Here's how I got from there to here."
+
+1-3min: SETUP
+- Who I was 3 years ago
+- Job at a corporate firm
+- Comfortable life
+- But...
+
+3-6min: THE BREAKING POINT
+- The day I quit
+- Why I had to
+- The risk I took
+- People who said I was crazy
+
+6-10min: THE STRUGGLE
+- First year on my own
+- The savings depletion
+- The first business idea (failed)
+- The doubt
+
+10-13min: THE COFFEE EPIPHANY
+- A specific moment that changed direction
+- Why coffee
+- Learning the trade
+
+13-17min: BUILDING THE SHOP
+- Finding the location
+- The financing struggles
+- Day one (we made $43)
+- Slow growth
+
+17-20min: TODAY
+- Where I am now
+- The team
+- The community I've built
+- The shop full of customers
+
+20-23min: REFLECTION
+- What I learned
+- What I'd do differently
+- What I'd tell 3-years-ago me
+
+23-25min: TAKEAWAY
+- "If you're considering a leap..."
+- Honest advice
+- It's not for everyone
+
+25-26min: CTA
+- "Subscribe to follow what we're building"
+- "Comment your story below"
+- "Next week: a behind-the-scenes shop tour"
+```
+
+## Key principles
+
+### Real vulnerability
+- Share the hard parts
+- Don't sanitize
+- Audience connects to truth
+
+### Chronological clarity
+- Beginning → middle → end
+- Easy to follow
+- Time markers
+
+### Specific details
+- Specific dates, numbers, places
+- Specific moments
+- Universal through specific
+
+### Honest learnings
+- Don't oversell
+- Acknowledge luck
+- Don't be guru-y
+
+### Connection
+- Audience feels with you
+- Direct address moments
+- Inviting comment / community
+
+## Sub-types
+
+### Career change
+- "How I left my job for ___"
+- The leap, the struggle, the result
+
+### Health journey
+- Physical, mental health
+- Recovery / progress
+- Vulnerability central
+
+### Relationship story
+- Marriage, divorce, dating
+- Privacy considered
+- Lessons learned
+
+### Travel / life change
+- Moving abroad
+- Drastic life shift
+- The transformation
+
+### Failure story
+- "When I lost everything"
+- Recovery journey
+- Wisdom from failure
+
+### Identity / coming out
+- Personal identity
+- Vulnerability + community
+- Importance of representation
+
+## When to use
+
+- Building creator personal brand
+- Audience emotional connection
+- Patreon / community building
+- Authority through experience
+- Long-term audience growth
+
+## Common mistakes
+
+- Fake vulnerability
+- Self-aggrandizing
+- "Look how amazing I am"
+- Missing the audience angle
+- Slow pacing without payoff
+- Missing details
+
+## Voice style
+
+- Conversational
+- Vulnerable
+- Reflective
+- Sometimes humorous about hard times
+- Earned wisdom