@azerogluemin/ai-bootstrap 0.2.1

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

@@ -0,0 +1,84 @@
+# Documentary — Category
+
+> Non-fiction films / series. Real subjects, real events. Investigative or observational.
+
+## What documentary is
+
+Non-fiction filmmaking. Real subjects (people, events, places). Distinguished from narrative film (fictional) by truth claim.
+
+## Universal documentary principles
+
+### 1. Truth-telling
+- Facts must be accurate
+- Edits must not deceive
+- Subjects represented fairly
+
+### 2. Perspective acknowledged
+- All docs have POV
+- Acknowledge bias
+- Audience trusts honesty
+
+### 3. Subject ethics
+- Consent matters
+- Privacy considered
+- Power dynamics aware
+
+### 4. Reality vs reality-show
+- Documentary = pursuit of truth
+- Reality show = manufactured drama
+- Distinction matters
+
+### 5. Filmmaker presence
+- First-person sometimes
+- Observational sometimes
+- Both valid
+
+## Documentary vs reality TV
+
+| Aspect | Documentary | Reality TV |
+|--------|-------------|------------|
+| Subject | Real people | Cast members |
+| Editing | Truth-respecting | Drama-manufacturing |
+| Length | Variable | Episodic seasons |
+| Goal | Truth-telling | Entertainment |
+| Format | Films / limited series | Series |
+
+## Length
+
+- Short doc: 5-30 min
+- Feature doc: 60-120+ min
+- Series: 4-10 episodes typical
+
+## Sub-formats
+
+- Interview-driven
+- Vérité (observational)
+- Essay documentary
+- Personal documentary
+- Investigative documentary
+
+## Voice / approach
+
+- Documentary cinematography
+- Often natural lighting
+- Talking head interviews
+- B-roll footage
+- Archive footage (when applicable)
+- Narrator (sometimes) or subjects' voices
+
+## Compose with
+
+- Sub-format (above)
+- Persona (documentary director style)
+- Subject matter
+- Length
+
+## Common pitfalls
+
+- Manipulation of subjects
+- Sensationalism
+- Hidden bias
+- Inadequate research
+- Privacy violations
+- Misleading edits
+- Padding

package/templates/skills/screenwriter/knowledge/categories/documentary/formats/essay-doc.md

@@ -0,0 +1,172 @@
+# Essay Documentary — Format
+
+> Voiceover-narrated documentary. Argument-driven. Personal POV. Often archive footage based.
+
+## Format basics
+
+- Length: 60-120+ min
+- Voiceover narration central
+- Argument structure
+- Personal POV explicit
+- Archive footage often
+- Researched / cited
+
+## Structure
+
+```
+OPENING (5-10 min)
+- Hook
+- Thesis hinted
+
+ACT 1 (10-30 min)
+- Context
+- Background
+- Position established
+
+ACT 2 (30-75 min)
+- Argument develops
+- Evidence presented
+- Multiple angles
+
+ACT 3 (75-100 min)
+- Synthesis
+- Conclusion
+- Implications
+
+OUTRO (100-110 min)
+- Personal reflection
+- Where audience stands
+- Call to thought
+```
+
+## Famous essay documentaries
+
+- "The Look of Silence" / "The Act of Killing" (Joshua Oppenheimer)
+- "Sans Soleil" (Chris Marker)
+- "F for Fake" (Orson Welles)
+- "Bowling for Columbine" (Michael Moore)
+- "An Inconvenient Truth" (Davis Guggenheim)
+- "The Story of Film" (Mark Cousins)
+- "13th" (Ava DuVernay)
+
+## Sample essay documentary concept
+
+```
+TITLE: "What We Carry: A Coffee Story"
+
+LENGTH: 90 minutes
+APPROACH: Personal essay documentary
+
+THESIS: Coffee is not a commodity. It is a story of empire,
+labor, climate, and human connection across continents. Examining
+coffee teaches us about everything.
+
+NARRATOR: Filmmaker (first-person voice, Azerbaijani-British accent)
+
+STRUCTURE:
+
+OPENING (0-7 min):
+- Filmmaker's hand pouring coffee
+- Voiceover: "I've been drinking coffee for thirty years. I never
+thought about where it came from. Until I did. And then I couldn't
+stop."
+
+ACT 1 — HISTORY (7-30 min):
+- Coffee origins (Ethiopia/Yemen)
+- Archive footage / paintings
+- Spread to Arab world, Europe, Americas
+- Colonial expansion
+- Economic engine of empires
+- Voiceover argument: "Coffee built modernity. And modernity built
+the coffee trade."
+
+ACT 2 — TODAY (30-60 min):
+- Filmmaker travels to producer countries
+- Interviews farmers (limited use of interview format)
+- Returns to her own city
+- Compares prices and conditions
+- Voiceover argument: "What I pay for a cup is not what the farmer
+receives. The gap is the system."
+
+ACT 3 — CLIMATE + FUTURE (60-85 min):
+- Coffee zones shrinking
+- Climate impact
+- Adaptation efforts
+- Implications
+- Voiceover: "What happens when there's no more coffee?"
+
+OUTRO (85-90 min):
+- Filmmaker pours another coffee in her own kitchen
+- Looks at it
+- Drinks it
+- Voiceover: "I still drink coffee. But I drink it differently now.
+I think about who picked it. And what it cost. Maybe that's what
+all of us should do — about everything."
+
+(Citations and sources in end credits.)
+```
+
+## Key principles
+
+### Strong thesis
+- Clear argument
+- Worth defending
+- Personal stake
+
+### Evidence-based
+- Research thorough
+- Sources cited
+- Multiple types of evidence
+
+### Personal voice
+- Filmmaker's POV explicit
+- Vulnerability welcomed
+- Authority through engagement
+
+### Visual support
+- Don't only talk
+- Archive footage
+- Original cinematography
+- Maps, charts, animations
+
+### Counterarguments
+- Address objections
+- Strengthen credibility
+
+## Sub-types
+
+### Historical essay
+- Past examined
+- Lessons drawn
+- Archive heavy
+
+### Personal essay
+- Filmmaker's journey
+- Subjective
+- Vulnerability
+
+### Issue essay
+- Specific problem
+- Argument-driven
+- Activism-adjacent
+
+### Cultural essay
+- Cultural phenomenon analyzed
+- Significance examined
+
+## When to use
+
+- Subject requires argument structure
+- Filmmaker has POV
+- Festival / awards aspiration
+- Streaming opportunity
+- Cultural / political moment
+
+## Common mistakes
+
+- Weak thesis
+- Insufficient research
+- Manipulating evidence
+- Hiding bias
+- Too long
+- No counter-arguments

package/templates/skills/screenwriter/knowledge/categories/documentary/formats/interview-driven.md

@@ -0,0 +1,140 @@
+# Interview-Driven Documentary — Format
+
+> Documentary primarily based on talking-head interviews. Multiple subjects' voices.
+
+## Format basics
+
+- Length: 30 min - 120+ min
+- Talking-head interviews dominant
+- Multiple subjects
+- B-roll supports interviews
+- Archive footage if applicable
+
+## Structure
+
+```
+COLD OPEN (3-5 min)
+- Hook (compelling moment)
+- Question/mystery established
+
+ACT 1 (10-25 min)
+- Subjects introduced
+- Background context
+- Setup
+
+ACT 2 (25-75 min)
+- Multiple POVs
+- Investigation / story development
+- Different voices
+- Turning points
+
+ACT 3 (75-100 min)
+- Climactic revelations
+- Resolution
+
+OUTRO (100-110 min)
+- Where things stand
+- Subjects today
+- Reflection
+```
+
+## Sample interview-driven documentary
+
+```
+TITLE: "The Last Yemen Coffee Farmer"
+
+CONCEPT: Series of interviews with one Yemeni coffee farmer, his
+family, his community, and international buyers — exploring why
+his ancestral farm may be the last of its kind.
+
+LENGTH: 90 minutes
+
+STRUCTURE:
+
+OPENING (5 min):
+- Wide shots of his farm at dawn
+- Subject (KARIM, 65) at work
+- His voice in voiceover (interview audio): "My grandfather planted
+these trees. My grandfather's grandfather. Now, only mine."
+
+ACT 1 (5-25 min):
+- Karim formally interviewed
+- His sons (3) interviewed
+- Why they may not continue
+- Cousin (in Saudi Arabia) interviewed about leaving
+
+ACT 2 (25-65 min):
+- The challenges
+- War impact (interviews with neighbors)
+- Climate impact (interview with agronomist)
+- Market access (interviews with international buyers)
+- Karim's wife on family decisions
+
+ACT 3 (65-85 min):
+- A buyer commits to long-term contract
+- Karim's youngest son returns from city
+- Hope but realistic
+
+OUTRO (85-90 min):
+- Karim's voice over wide shots: "Maybe. Maybe."
+- Where they all are now (text on screen)
+```
+
+## Key principles
+
+### Subject access
+- Multiple interviews per subject
+- Build trust over time
+- Specific moments captured
+
+### Question quality
+- Open-ended ("Tell me about...")
+- Follow-up real
+- Don't lead
+
+### Visual variety
+- Talking head + B-roll mix
+- Don't dwell on talking head only
+- Cinematic B-roll
+
+### Interview cinematography
+- Eye-line to camera or interviewer
+- Soft natural lighting
+- Real environment
+
+### Edit fairly
+- Don't twist meaning
+- Subject's intent preserved
+- Show before-and-after for major edits
+
+## Common interview-driven sub-types
+
+### Single subject deep dive
+- One person's story
+- Multiple sittings
+- Comprehensive
+
+### Multiple POV
+- Different voices on same subject
+- Comparison + contrast
+- Synthesis
+
+### Reflection / retrospective
+- Subjects looking back at past event
+- Memory + meaning
+
+## When to use
+
+- Subject has stories to tell
+- Multiple POVs needed
+- Lower budget option (vs verite which needs long shooting)
+- Focused subject matter
+
+## Common mistakes
+
+- Generic questions
+- Bad lighting / audio
+- Too many talking head, no B-roll
+- Subject manipulation
+- Hidden agenda
+- Insufficient research

package/templates/skills/screenwriter/knowledge/categories/documentary/formats/investigative.md

@@ -0,0 +1,187 @@
+# Investigative Documentary — Format
+
+> Journalism + filmmaking. Following truth across resistance. Often crime, politics, business malfeasance.
+
+## Format basics
+
+- Length: 60-120+ min (often longer for series)
+- Investigative journalism methods
+- Multiple sources
+- Documents, evidence
+- Often legal stakes
+- Subjects may be hostile
+
+## Structure
+
+```
+OPENING (5-10 min)
+- The crime / problem
+- Stakes established
+
+ACT 1 (10-30 min)
+- Setup
+- Initial investigation
+- Resistance encountered
+
+ACT 2 (30-75 min)
+- Following leads
+- Multiple sources
+- Reveals
+- Roadblocks
+- Major break
+
+ACT 3 (75-100 min)
+- Confrontation
+- Truth uncovered
+- Consequences
+
+OUTRO (100-110 min)
+- Aftermath
+- Subjects today
+- Larger implications
+```
+
+## Famous investigative documentaries
+
+- "The Thin Blue Line" (Errol Morris)
+- "Citizenfour" (Laura Poitras)
+- "Making a Murderer" (Netflix series)
+- "Tiger King" (Netflix series)
+- "The Case Against Adnan Syed"
+- "Going Clear" (Alex Gibney)
+- "Where to Invade Next" (Michael Moore)
+
+## Sample investigative documentary concept
+
+```
+TITLE: "The Yemen Coffee Conspiracy"
+
+CONCEPT: Investigation into a multinational corporation's exploitation
+of Yemeni coffee farmers and laundering of war-era profits through
+legitimate trade channels.
+
+LENGTH: 90 min
+
+STRUCTURE:
+
+OPENING (5 min):
+- Quick visual: stacks of coffee bags being loaded onto ships
+- Voiceover: "The most expensive coffee in the world comes from
+Yemen. And it's being stolen."
+- A whistleblower's silhouette: "I know what they did."
+
+ACT 1 (5-25 min):
+- The setup: Filmmaker discovers price discrepancy
+- Initial research
+- Companies involved
+- Reaches out to farmers in Yemen
+- Long-distance contact via secured channels
+- Establishes scope
+
+ACT 2 (25-65 min):
+- Travel to Yemen (filmmaker risks)
+- Farmer interviews
+- Documents obtained from inside company
+- Whistleblower fully revealed (with protection)
+- Money trail traced
+- Company refuses comment
+- Other journalists join investigation
+- Major reveal: government cooperation suspected
+
+ACT 3 (65-85 min):
+- Confrontation: filmmaker tries to interview CEO
+- Refused
+- Documents go to investigative partners (newspapers)
+- Story breaks
+- Company response (legal threats)
+- Government investigation begins
+
+OUTRO (85-90 min):
+- Where things stand today
+- The whistleblower's status
+- The farmers' status (some helped, situation continues)
+- "The story is bigger than this. There are other commodities,
+other systems, other crimes hidden in plain sight."
+- Final shot: a coffee cup on a desk.
+```
+
+## Key principles
+
+### Journalism rigor
+- Sources verified
+- Documents authenticated
+- Claims supported
+- Cross-referenced
+
+### Subject safety
+- Whistleblowers protected
+- Sources confidential when needed
+- Filmmaker safety considered
+
+### Legal awareness
+- Defamation laws
+- Right of reply
+- Editorial fairness
+
+### Pacing through investigation
+- Building case
+- Each clue advances
+- Audience invested in pursuit
+
+### Truth over sensationalism
+- Report accurately
+- Don't manufacture drama
+- Trust facts to be compelling
+
+## Sub-types
+
+### Crime investigation
+- True crime
+- Police work paralleled
+- Justice questions
+
+### Political investigation
+- Government corruption
+- Power abuses
+- Accountability journalism
+
+### Corporate investigation
+- Business malfeasance
+- Worker exploitation
+- Environmental harm
+
+### Religious / cult investigation
+- Power abuses
+- Closed systems
+- Survivors' stories
+
+### Historical investigation
+- Past crimes uncovered
+- Cold case style
+
+## When to use
+
+- Story requires investigation
+- Public interest stake
+- Sources accessible
+- Legal counsel available
+- Distribution plan (festival, streaming)
+
+## Common mistakes
+
+- Insufficient sources
+- Hidden bias
+- Sensationalism
+- Subject manipulation
+- Endangering sources
+- Legal recklessness
+- Padding investigation
+
+## Production realities
+
+- Long timelines (years)
+- Significant research
+- Travel often required
+- Legal counsel
+- Source protection
+- Sometimes physical risk