@azerogluemin/ai-bootstrap 0.2.1

package/templates/skills/screenwriter/knowledge/categories/documentary/personas/herzog.md

@@ -0,0 +1,148 @@
+# Werner Herzog — Persona
+
+> German director, philosophical voiceover. Extreme subjects. Existential observations. Calm authority.
+
+## Style Signatures
+
+- Philosophical voiceover (his iconic German-accented English)
+- Extreme subjects (nature, isolation, obsession)
+- Existential observations
+- Patient cinematography
+- Long takes
+- Subject + nature integration
+- Calm authority
+- "The Conquest of the Useless"
+
+## Famous documentaries
+
+- "Grizzly Man"
+- "Encounters at the End of the World"
+- "Cave of Forgotten Dreams"
+- "Into the Inferno"
+- "The Wild Blue Yonder"
+
+## Common Devices
+
+- Voiceover throughout
+- Existential questions ("What is the meaning of...")
+- Nature as antagonist or character
+- Unique characters / outsiders
+- Long contemplative shots
+- Direct camera engagement (with subjects)
+- Sometimes himself appears (rarely)
+
+## Voice Style
+
+Calm, German-accented, philosophical, slightly fatalistic. Unique cadence.
+
+```
+"What haunts me is..."
+"There is no nobility in the wilderness, only the indifference
+of nature."
+"The world is in the grip of obscene madness."
+"I would like to imagine..."
+```
+
+## When Writing as Herzog
+
+- Subject extreme or unique
+- Voiceover central
+- Philosophical / existential angle
+- Long contemplative moments
+- Patient cinematography
+- Nature as significant element
+- Direct interview engagement
+- "What is the meaning of this?" questions
+
+## Sample Approach
+
+```
+TITLE: "The Last Coffee Farmer of Yemen"
+
+LENGTH: 90 min
+APPROACH: Herzog-style philosophical documentary
+
+CONCEPT: Examining a single farmer's life as meditation on
+human persistence, futility, beauty, nature's indifference.
+
+VOICEOVER (Herzog-style, throughout):
+"In a valley in Yemen, where war has emptied the surrounding land,
+one man tends to coffee trees that have been in his family for
+twelve generations. I went to ask him why."
+
+OPENING:
+- Wide shot of arid valley
+- Single coffee farm visible, green against red earth
+- Voiceover: "There is no logic to this farm's existence. The world
+has forgotten this place. And yet — life persists."
+
+ACT 1:
+- Karim tends his trees
+- Slow movements
+- Patient camera
+- Voiceover examines: "Karim is sixty-five years old. He has out-
+lived most of his neighbors. He has out-lived his country, in some
+sense. The country is gone. He remains."
+
+INTERVIEW SECTIONS:
+- Direct engagement with Karim
+- Karim's voice
+- Translated subtitles
+- Herzog asks (via translator): "Why do you stay?"
+- Karim's answer (long, philosophical)
+- Herzog's voiceover comments after
+
+ACT 2:
+- The farm's daily rhythm
+- The beauty of the cherries ripening
+- The threats (war, climate, isolation)
+- A son who left, returns briefly
+- Mother who passed
+- Voiceover: "This is the human condition in microcosm. We persist
+in our small kingdoms even as the world withdraws from us."
+
+ACT 3:
+- A particularly bountiful harvest
+- A buyer's contract miraculously arrives
+- Hope flickers
+- Voiceover: "But hope is not the meaning. The meaning was always
+the work. The work continues regardless of outcomes."
+
+OUTRO:
+- Karim alone with his trees at sunset
+- Long held shot
+- Voiceover: "What I learned from Karim is what we already knew
+but cannot bear: that meaning resides in the act, not in its
+reception. He is making his coffee not for the world. He is making
+it because that is what one does, when one is here. The trees do
+not need him. He does not need the trees. They share this place,
+and that is enough."
+
+End on the farm at twilight. Music: slow, meditative.
+```
+
+## Avoid
+
+- Quick cutting
+- Sentimentality
+- Hopeful resolution (Herzog is fatalistic)
+- Cheerful tone
+- Avoiding extreme subjects
+- Documentary-as-news
+
+## Best for
+
+- Extreme subjects
+- Philosophical documentary
+- Festival prestige
+- Personal vision
+- Awards aspiration
+- Patient audience
+
+## Avoid pairing with
+
+- News-style journalism
+- Sensational subjects
+- Quick-pacing format
+- Mass audience commercial
+- Family-friendly

package/templates/skills/screenwriter/knowledge/categories/documentary/personas/ken-burns.md

@@ -0,0 +1,141 @@
+# Ken Burns — Persona
+
+> American historical documentary master. Archive footage + photographs. Slow zooms ("Ken Burns Effect"). Extensive multi-part series.
+
+## Style Signatures
+
+- Historical American subjects
+- Archive footage + photographs
+- Slow zooms / pans on photos (the "Ken Burns Effect")
+- Multi-part long-form series (8-20 hours)
+- Voiceover narration (often celebrity)
+- Primary source quotes (read by actors)
+- Period music
+- Calm authoritative pacing
+
+## Famous documentaries
+
+- "The Civil War" (11 hours)
+- "Baseball" (18 hours)
+- "Jazz" (19 hours)
+- "The Vietnam War" (18 hours)
+- "Country Music" (16 hours)
+- "Prohibition"
+- "The Roosevelts"
+
+## Common Devices
+
+- Slow zoom on photographs
+- Multiple historians interviewed
+- Letters / documents read aloud (actor voices)
+- Period music (era-specific)
+- Time-spanning narratives (decades to centuries)
+- American historical themes
+- Multi-episode structure
+- Single voice narration (Peter Coyote often)
+
+## Voice Style
+
+Calm, authoritative, American. Historical respect.
+
+```
+"In 1861, the United States was on the brink of disaster..."
+"What no one could have known then..."
+"This is the story of..."
+```
+
+## When Writing as Ken Burns
+
+- Historical subject
+- Archive-heavy
+- Multi-part / long-form
+- Slow pacing
+- Voiceover narration central
+- Multiple historians
+- Letters / documents
+- Period music
+- American (or analog) subject
+- Decades-spanning
+
+## Sample Approach
+
+```
+TITLE: "Coffee: A History" (8-part documentary series)
+
+LENGTH: 8 episodes × 90 min = 12 hours
+
+APPROACH: Ken Burns-style historical documentary
+
+EPISODE 1: "The Discovery" (1500-1700)
+
+OPENING (5 min):
+- Slow zoom on ancient Yemeni illustration of coffee tree
+- Music: oud + period instruments
+- Narrator (American voice, calm): "In the highlands of Yemen, a
+discovery would change the world. They called it qahwa."
+
+STRUCTURE:
+- Multiple historians introduced (talking heads)
+- Archive imagery (illustrations, paintings)
+- Letters from period (actors voicing primary sources)
+- Slow visual development
+- Music carries emotional through-line
+
+EPISODE 2: "The Trade" (1700-1850)
+- Coffee spreads
+- European empires
+- Plantations established
+- Slavery's role
+
+EPISODE 3-7: Various historical periods, themes
+
+EPISODE 8: "The Modern Era" (1990-Present)
+- Industrialization
+- Specialty coffee movement
+- Sustainability questions
+- Climate impact
+- Where coffee goes from here
+
+THROUGHOUT:
+- "Ken Burns Effect" on historical photos
+- Beautiful contemporary cinematography of coffee farms today
+- Archive footage of historical events related to coffee
+- Multiple expert historians
+- Long letters / documents read by actors
+- Period-specific music for each era
+- Contemporary music for modern segments
+
+CLOSING (each episode):
+- Final image
+- Quiet music
+- Setup for next episode
+
+(Score: original composition + period music throughout.)
+```
+
+## Avoid
+
+- Quick cuts
+- Modern editing rhythm
+- Single-voice (Burns uses many)
+- Short format (Burns goes long)
+- Casual tone
+- Pop culture without historical weight
+
+## Best for
+
+- Historical subjects
+- Multi-part documentary series
+- Educational / cultural projects
+- PBS-style production
+- Awards consideration
+- Long-form audience
+
+## Avoid pairing with
+
+- Quick-format
+- Casual tone
+- Single-episode short
+- Sensational subjects
+- Modern-only subjects (Burns benefits from historical depth)
+- TikTok format

package/templates/skills/screenwriter/knowledge/categories/documentary/personas/louis-theroux.md

@@ -0,0 +1,140 @@
+# Louis Theroux — Persona
+
+> British observational documentary maker. Awkward observational style. Unflattering subjects. Understated narrator.
+
+## Style Signatures
+
+- Awkward observational
+- Unflattering subjects (cult leaders, fringe groups, criminals)
+- British understated narrator
+- Long observation periods
+- Personal involvement on camera
+- Building trust over time
+- Naive-seeming questions that reveal depth
+- Filmmaker visible (often awkwardly)
+
+## Famous documentaries
+
+- "Louis Theroux's Weird Weekends" (BBC series)
+- "When Louis Met..." (Jimmy Savile, etc.)
+- "Louis and the Brothel"
+- "Heroin Town"
+- "Dark States"
+
+## Common Devices
+
+- Filmmaker on camera throughout
+- Asking "naive" questions that get revelations
+- Long stays with subjects (weeks)
+- Subjects' real behavior captured
+- Awkward silences
+- British understatement
+- Following subjects in their world
+
+## Voice Style
+
+British, calm, slightly awkward, polite. Genuinely curious. Doesn't judge openly.
+
+```
+LOUIS:
+"Tell me what's going on here."
+"That's interesting. Why do you think that is?"
+"I don't know if I quite understand."
+"Is that... is that what you really believe?"
+```
+
+## When Writing as Louis Theroux
+
+- Filmmaker on camera (yourself)
+- Awkward observational style
+- Unflattering subjects (often)
+- Long stay with subjects
+- "Naive" questions that reveal
+- British understatement
+- Subjects' real behavior shown
+- Don't openly judge (let audience decide)
+
+## Sample Approach
+
+```
+TITLE: "Inside the Coffee Cult"
+
+LENGTH: 60 min
+APPROACH: Louis Theroux-style observational
+
+CONCEPT: Filmmaker spends 6 weeks inside an extreme specialty coffee
+community where members refuse to drink coffee that isn't from
+specific micro-lots, taste-test for hours daily, and hold rituals
+around brewing.
+
+OPENING (5 min):
+- Filmmaker walking into a "tasting temple"
+- Voiceover (British, understated): "I'm in Berlin, at what's
+described as one of the most exclusive specialty coffee groups in
+the world. They've invited me to spend six weeks observing their
+practice. They warned me: I might not understand."
+
+ACT 1 (5-20 min):
+- Filmmaker meets community
+- First tasting (he's awkward, asks basic questions)
+- Members serious about every aspect
+- Filmmaker: "When you say the cherry has to be 'depulped within
+two hours of picking,' how do you actually know that's possible?"
+- Member explains intensely
+- Filmmaker: "I see. That's... interesting."
+
+ACT 2 (20-45 min):
+- Deeper engagement
+- Filmmaker tries to participate
+- Awkward moments
+- He drinks coffee they consider "bad" — they react
+- He attends a tasting ritual
+- He interviews specific members in their homes
+- Asks naive questions about their lives
+- "Do you... do you have time for hobbies outside of coffee?"
+- Awkward silence
+
+ACT 3 (45-55 min):
+- A community conflict erupts
+- About sourcing ethics
+- Filmmaker observes
+- He doesn't take sides
+- Reveals more about each member
+
+OUTRO (55-60 min):
+- Filmmaker leaving
+- Final voiceover: "I came to find out what they were doing. I
+think I came away with more questions than answers. I do, however,
+notice that I'm now drinking my coffee differently. I'm not sure
+that's a good or bad thing. Perhaps it's both."
+- Final shot: him in his hotel room with a single cup of coffee
+- He sips. Considers it carefully. Smiles slightly.
+- "A bit too acidic, I think. I would have liked it more rounded."
+- End title.
+```
+
+## Avoid
+
+- Heavy judgment
+- Aggressive questioning
+- Quick cutting
+- Hiding the filmmaker
+- Sensationalism
+- Tabloid style
+
+## Best for
+
+- Subcultures / fringe communities
+- BBC-style production
+- Streaming documentary
+- Long-form (60+ min)
+- Subjects requiring trust
+- British / international audience
+
+## Avoid pairing with
+
+- Pure investigative (Louis is observational)
+- News-style
+- Quick format
+- Mass commercial
+- Sensational

package/templates/skills/screenwriter/knowledge/categories/documentary/personas/neutral-documentarian.md

@@ -0,0 +1,130 @@
+# Neutral Documentarian — Persona
+
+> Default professional documentary maker. No particular auteur voice. Industry-standard documentary craft.
+
+## When to use
+
+- No specific persona requested
+- Format dictates more than auteur
+- Standard documentary need
+- Need clean professional output
+
+## Style Signatures
+
+- Professional documentary craft
+- Industry conventions
+- Clean structure
+- Subject-respecting
+- Audience-friendly
+- Reliable execution
+
+## Common Devices
+
+- Standard documentary structure
+- Talking-head interviews
+- B-roll
+- Voiceover (when needed)
+- Archive footage (when applicable)
+- Genre conventions
+
+## Voice Style
+
+Adapts to project. Subject and topic appropriate.
+
+## When Writing as Neutral Documentarian
+
+- Follow brief precisely
+- Use proven documentary structures
+- Match topic conventions
+- Clean execution
+- Subject-respecting
+- No surprises
+
+## Sample Approach
+
+For a standard 60-min documentary on a single subject:
+
+```
+TITLE: "Karavan: The Story Behind a Coffee Brand"
+
+LENGTH: 60 min
+APPROACH: Standard biographical documentary
+
+STRUCTURE:
+
+COLD OPEN (3 min):
+- Visual hook: busy Karavan shop
+- Quick teases of what's coming
+- Establish subject
+
+ACT 1 (3-20 min):
+- Subject (founder) introduced
+- Background, formative experiences
+- Why coffee
+- Mix of: interviews + archive + B-roll
+
+ACT 2 (20-45 min):
+- Building the company
+- Challenges
+- Multiple voices (employees, customers, family)
+- Specific stories
+
+ACT 3 (45-55 min):
+- Today's business
+- Future plans
+- Legacy questions
+
+OUTRO (55-60 min):
+- Where things stand
+- Closing reflection
+- Subject's final thoughts
+```
+
+## When neutral is right
+
+- Brief is detailed
+- Mainstream documentary
+- Standard subject
+- Quick turnaround
+- Audience-friendly aim
+
+## Strengths
+
+- Reliable
+- Subject-respecting
+- Audience-friendly
+- Easy to brief
+- Predictable execution
+
+## Limitations
+
+- No memorable voice
+- Won't break through
+- Forgettable
+- Doesn't elevate
+
+## How to write neutral documentary
+
+- Standard structure
+- Genre conventions
+- Clean cinematography
+- Multiple voices (interview format) or single voice (essay)
+- B-roll variety
+- Industry standard
+
+## When to upgrade
+
+- Distinctive vision desired
+- Festival aspiration
+- Awards goal
+- Cultural moment
+
+→ Move to Herzog, Errol Morris, Ken Burns, Louis Theroux, Asif Kapadia style
+
+## Default behavior
+
+When no persona specified:
+- Solid craft
+- Subject-appropriate
+- Audience-friendly
+- Reliable execution

package/templates/skills/screenwriter/knowledge/categories/documentary/personas/werner-herzog-writer.md

@@ -0,0 +1,32 @@
+---
+name: Werner Herzog (screenwriter)
+role: screenwriter
+visual_style: [photoreal-documentary]
+most_famous: Grizzly Man, Cave of Forgotten Dreams, Encounters at the End of the World, Fitzcarraldo, Aguirre Wrath of God
+era: 1962–present
+---
+
+# Werner Herzog — Persona (screenwriter mode)
+
+> Philosophical narration + obsessive subjects + nature as antagonist.
+
+## Style Signatures
+
+- Philosophical voiceover narration (Herzog's own German-accented English)
+- Obsessive subjects (Grizzly Man Timothy Treadwell, Fitzcarraldo opera in jungle)
+- Nature as antagonist / indifferent force ("the jungle is hostile")
+- Long ssenari setup with personal essay tone
+- "Ecstatic truth" — fact subordinated to poetic truth
+- Dreamlike sequences
+
+## Common Devices
+
+- First-person Herzog narration
+- Long contemplative shot
+- Subject interview unfiltered
+- Nature footage with melancholic music
+- Provocation question to subject
+- "What do you dream of?" style question
+
+## Niyə uyğundur photoreal-documentary-yə
+Herzog documentary feature ssenari (script + narration) standartı — obsessive subject + philosophical voiceover kanonik.

package/templates/skills/screenwriter/knowledge/categories/film/_category.md

@@ -0,0 +1,130 @@
+# Film — Category
+
+> Narrative cinema. Self-contained stories told as films, regardless of distribution (theatrical, streaming, festival).
+
+## What film is
+
+A self-contained narrative work with a clear beginning, middle, and end. Distinct from series (continuing) or advertising (commercial purpose). Distinct from documentary (real subjects).
+
+## Universal film principles
+
+### 1. Self-contained
+A film tells one complete story. Even if part of a franchise, each film stands alone.
+
+### 2. Visual storytelling
+Cinema is fundamentally visual. The camera tells what dialogue cannot.
+
+### 3. Time compression
+A film compresses real time into runtime. Smart selection of which moments to show.
+
+### 4. Active audience experience
+Audiences watch films in focused settings (theater, attentive home viewing). Less divided attention than TV/social.
+
+### 5. Director-as-author
+Films often have strong authorial voice (auteur theory). Director's vision drives.
+
+## 3-act structure (universal in film)
+
+### Act 1 — Setup (25%)
+- Establish protagonist, world, normal
+- Inciting incident around 10-15% mark
+- First-act break: protagonist commits
+
+### Act 2 — Confrontation (50%)
+- Rising obstacles
+- Subplot integration
+- Midpoint reversal (50% mark)
+- Crisis / all-is-lost (75-80% mark)
+
+### Act 3 — Resolution (25%)
+- Final attempt
+- Climax
+- Resolution / new normal
+
+## Sub-formats
+
+### Short film (1-15 min)
+- Festival circuit
+- Single core idea
+- Limited cast
+- Visual experiment ok
+- Director showcase
+
+### Feature film (75-180 min)
+- Full theatrical/streaming release
+- Multiple subplots
+- Character development across runtime
+- Production complexity
+
+## Genre as flavor
+
+Genre = set of conventions audience expects:
+- Drama
+- Comedy
+- Horror
+- Thriller
+- Sci-fi
+- Fantasy
+- Romance
+- Action
+- Mystery
+- Crime / Noir
+- Western
+- War
+- Biographical
+- Experimental / Surreal
+- Magical realism
+
+Films can mix genres ("comedy-drama," "sci-fi thriller"). Each genre has expectations.
+
+## Production realities
+
+### Indie short
+- Festival aim
+- $1K-50K budget
+- Single location often
+- Crew of 5-10
+- Director-driven
+
+### Indie feature
+- $100K-5M budget
+- Festival + streaming aim
+- 3-5 main locations
+- Crew of 30-50
+
+### Studio feature
+- $5M-200M+ budget
+- Wide theatrical release
+- Multiple locations
+- Large crew (100+)
+
+## Universal craft principles
+
+### Open with a question
+- Set up something audience needs answered
+- Pull through engagement
+
+### Reward attention
+- Setup early, payoff later
+- Trust audience to remember
+- Layer detail
+
+### End with resonance
+- Final image matters
+- Visual + emotional close
+- Echo opening (often)
+
+### Theme through specifics
+- Don't state theme
+- Embody through character choices
+- Subtle, not didactic
+
+## Pitfalls
+
+- Trying to be every genre at once
+- Setup too long (audience leaves)
+- Climax rushed
+- Theme on-the-nose
+- Ending unearned
+- Generic protagonist
+- Saggy middle (Act 2)