@azerogluemin/ai-bootstrap 0.2.1

package/templates/skills/screenwriter/knowledge/categories/series/formats/pilot.md

@@ -0,0 +1,196 @@
+# Pilot — Series Format
+
+> The first episode. Sales pitch + first episode. Most important script in a series.
+
+## Format basics
+
+- Length: matches series (22 min sitcom, 60 min drama, etc.)
+- Establishes world, characters, tone
+- Promises what audience signs up for
+- Hook for episode 2
+
+## Pilot's three jobs
+
+### 1. Sell the show
+- To network/streaming buyer
+- To critics
+- To audience
+- Demonstrates ongoing potential
+
+### 2. First episode
+- Self-contained satisfying story
+- Proper 3-act
+- Standalone enjoyable
+
+### 3. Establish world
+- Characters introduced naturally
+- Setting clear
+- Tone set
+- Rules/conventions established
+
+## Structure (60-min drama pilot)
+
+```
+COLD OPEN (0-5 min)
+- Hook
+- Mystery/situation
+- Often visceral
+
+ACT 1 (5-15 min)
+- Establish protagonist's normal world
+- Inciting incident specific to show's premise
+- First-act break
+
+ACT 2 (15-35 min)
+- Pursuit of episode-specific problem
+- Introduce supporting cast
+- Establish key dynamics
+- Show what each episode might be like
+
+ACT 3 (35-55 min)
+- Resolution of episode-specific
+- Setup of ongoing arcs
+- Hook for episode 2
+
+TAG (55-60 min)
+- Quiet character moment
+- Or major cliffhanger
+- Audience commits to next episode
+```
+
+## Sample pilot beats
+
+### Breaking Bad pilot
+- Open: Walter White in underwear in desert, recording goodbye
+- Establish: chemistry teacher, cancer diagnosis
+- Inciting: police ride-along, sees drug bust
+- Decision: cooks meth with former student
+- End: situation deepens, hooked
+
+### The Wire pilot
+- Open: McNulty observing crime
+- Establish: police world, drug dealers
+- Inciting: case develops
+- Multiple POV introductions
+- End: war declared between sides
+
+### Succession pilot
+- Open: Logan Roy's birthday
+- Establish: family + business
+- Inciting: succession question
+- Reveal: Logan won't step down
+- End: power struggle begins
+
+## Key principles
+
+### Show what every episode will be like
+The pilot is a promise. If pilot is murder mystery + romance + police, every episode should have those elements.
+
+### Establish all main characters
+Save guest stars for later. Pilot needs core ensemble in.
+
+### Tone consistent with series
+If series will be dark drama, pilot is dark drama. Don't mislead audience.
+
+### Worldbuilding through action
+Show setting through events, not exposition. Audience learns by watching.
+
+### Strong hook for episode 2
+Pilot ends with question/hook that demands episode 2.
+
+## Sample pilot concept
+
+```
+TITLE: "Karavan" (drama series pilot, 60 min)
+
+GENRE: Family drama + crime
+LENGTH: 60 min
+LOGLINE: When the patriarch of a Baku coffee importing family is
+murdered, his three estranged children must reunite to run the
+business — and find out which of them is next.
+
+COLD OPEN (0-5 min):
+- Wide of Baku at night, Caspian glittering
+- ARIF ALIYEV (70) walks through his coffee warehouse, alone
+- Phone call: someone is asking about a shipment
+- He knows something is wrong
+- He hides a small package in a coffee bag
+- Returns to office
+- Heavy footsteps approach
+- He turns. Recognizes who's there. Says one word: "Sən?"
+- Cut to: wide shot, Arif on warehouse floor, dead
+
+(MAIN TITLES — Karavan logo with deep cinematic theme)
+
+ACT 1 (5-15 min):
+- Three children get the call
+- ELDAR (40), corporate lawyer in London — takes call in middle of meeting
+- NIGAR (37), restaurateur in Tbilisi — at her restaurant
+- RAMIN (32), university lecturer in Berlin — at home with family
+- Each prepares to travel to Baku
+- We see their lives haven't intersected in years
+
+ACT 2 (15-35 min):
+- They arrive separately
+- Family lawyer reveals: business goes to all three jointly
+- They must work together to keep it
+- The murder investigation begins
+- Police suspect industry rivals
+- The siblings tour the warehouse, the office, their father's home
+- They discover their father had been investigating something
+- A missing shipment of coffee from Yemen
+- Documents hidden in his desk
+- They start to suspect the murder was business-related
+
+ACT 3 (35-55 min):
+- Eldar wants to sell, return to London
+- Nigar wants to investigate
+- Ramin wants to walk away from everything
+- They fight
+- A second murder: their father's business partner
+- Now they realize they may all be in danger
+- They make a choice: stay together, run the business, find the killer
+
+TAG (55-60 min):
+- The three siblings stand together at the warehouse, late at night
+- They close it up for the night
+- As they walk to their cars, NIGAR pauses
+- She has spotted the package their father hid
+- She picks it up
+- Inside: a USB drive
+- She looks at her brothers
+- She doesn't tell them yet
+
+(End on: Nigar pocketing the USB, looking at her brothers,
+choosing what to share and what to hide.)
+
+(Score: Hans Zimmer-style suspense build.)
+```
+
+## Common pilot mistakes
+
+- Too much exposition
+- Tone inconsistent with series direction
+- Pilot-specific story doesn't represent typical episode
+- Saving "best stuff" for later
+- Weak hook for episode 2
+- Bloated cast (too many characters introduced)
+- Genre confusion
+
+## When to write pilot
+
+- New series sale attempt
+- Network/streaming buyer pitch
+- Festival pilot programs
+- Calling card script
+- Series spinoff
+
+## Pilot vs film
+
+| Aspect | Pilot | Film |
+|--------|-------|------|
+| Resolution | Partial (sets up more) | Complete |
+| Characters | Beginning of journey | Full arc |
+| World | Establishing | Established |
+| Length | 22 / 30 / 60 min | 90+ min |
+| Hook | For episode 2 | For credits |

package/templates/skills/screenwriter/knowledge/categories/series/formats/season-finale.md

@@ -0,0 +1,157 @@
+# Season Finale — Series Format
+
+> The last episode of a season. Major arc resolution. Often cliffhanger for next season.
+
+## Format basics
+
+- Length: matches series (often longer)
+- Season's main arc resolves (mostly)
+- New question for next season
+- Cliffhanger possible
+- Audience contract: come back next season
+
+## Structure
+
+```
+COLD OPEN (0-5 min)
+- Hook for finale
+- Stakes immediate
+
+ACT 1 (5-15 min)
+- All threads converge
+- Final preparation
+- Last chance for character moments
+
+ACT 2 (15-40 min)
+- Climactic confrontation
+- Season's big questions answered
+- Major emotional/plot beats
+- Reversal possible
+
+ACT 3 (40-55 min)
+- Resolution of season arc
+- Aftermath
+- Character status changed
+
+TAG (55-60 min)
+- Final image of season
+- Often quiet character moment
+- Hook for next season (subtle to overt)
+```
+
+## Sample season finale
+
+```
+TITLE: "Karavan" Episode 13 (season 1 finale)
+
+LOGLINE: As the siblings finally confront the truth about their
+father's death, they must decide what kind of family they want to be
+— and what kind of business they will run.
+
+COLD OPEN (0-5 min):
+- Eldar leaving custody
+- Ramin recovering in hospital
+- Nigar still missing (4 days now)
+
+ACT 1 (5-15 min):
+- They get a ransom demand
+- Pay the money OR Nigar dies
+- Eldar wants to pay
+- Ramin says no — they'll never see Nigar alive
+- They argue
+- Decision: trace the kidnapper instead
+
+ACT 2 (15-40 min):
+- Investigation across Baku and beyond
+- Use of every connection from season
+- Police, family lawyer, even old enemies
+- Find location: industrial port
+- Confrontation
+- Garib's son with three men
+- Nigar alive but injured
+- Standoff
+- Police arrive
+- Kidnapper killed in shootout
+- Nigar saved
+- All seems resolved
+
+ACT 3 (40-55 min):
+- Aftermath
+- Hospital scenes — Nigar and Ramin together
+- Eldar at the warehouse, looking around
+- Family lawyer brings news: father had insurance policy
+- It includes a clause: if all three children remain in business
+together for one year, they receive controlling interest in a
+massive trust fund
+- They can sell the business now, walk away rich
+- Or stay together, do something with their lives
+
+TAG (55-60 min):
+- Three siblings at father's grave
+- They make their decision
+- One year, together
+- They walk back to the car
+- As they drive away, on the road behind them:
+- A SECOND CAR appears — same suspicious style
+- They don't notice
+- The driver of the second car: a face we've seen before, in the
+background of episode 2 (a setup for season 2)
+- The driver smiles slightly. Pulls back to follow.
+
+CUT TO BLACK.
+"END SEASON 1"
+
+(Hook for season 2: who is following them, and what's the trust
+fund for?)
+```
+
+## Key principles
+
+### Pay off season's main question
+Audience invested 8-13 hours. Pay them.
+
+### Don't end everything
+Open question for next season (if renewed).
+
+### Character status changed
+By season's end, characters different than at start.
+
+### Emotional climax
+Often quieter than action climax.
+
+### Setup season 2 (or series end)
+If series continues: hook for new question.
+If series ends: full closure.
+
+## Renewed vs ended consideration
+
+### If renewed (hopeful)
+- New question opens
+- Character status changes invite next chapter
+- Subtle teases of next season's antagonist or plot
+
+### If ending (uncertain or final season)
+- More resolution
+- Character arcs more complete
+- Less new hooks
+- Audience contract honored
+
+When uncertain (network hasn't renewed yet), find balance:
+- Satisfying enough to end on
+- Open enough to continue
+
+## Common season finale mistakes
+
+- Ending too neat (no return hook)
+- Ending too open (frustrating)
+- Forgetting subplots
+- Out-of-character climax
+- Cliffhanger that's too dependent on uncertain renewal
+- Disrespecting season's emotional buildup
+
+## When to write season finale
+
+- Production schedule end of season
+- Major arc reaches climax
+- Character development reaches turning point
+- Renewal status known (or not — adapt)

package/templates/skills/screenwriter/knowledge/categories/series/formats/series-finale.md

@@ -0,0 +1,183 @@
+# Series Finale — Series Format
+
+> The last episode ever. Full resolution. Audience contract honored.
+
+## Format basics
+
+- Length: often longer than typical episode
+- Major character arcs concluded
+- Series-level questions answered
+- Emotional final image
+- No new hooks (usually)
+
+## Structure
+
+```
+COLD OPEN (0-5 min)
+- Echo of pilot (often)
+- Final hook
+
+ACT 1 (5-15 min)
+- All threads moving toward end
+- Last setup
+
+ACT 2 (15-40 min)
+- Climactic events
+- Major resolutions
+- Character arcs fulfilled
+
+ACT 3 (40-60 min)
+- Aftermath
+- Character status final
+- Emotional beats
+
+TAG (60-75 min)
+- Final image of series
+- Often returns to opening location
+- Sense of completion
+- Audience farewell
+```
+
+## Famous series finales
+
+### Breaking Bad (Felina)
+- Walter White returns to wrap up loose ends
+- Saves Jesse, kills enemies
+- Dies in lab he loved
+- Final shot: him collapsing among meth equipment
+- Audience: closure earned
+
+### The Sopranos (Made in America)
+- Tony at diner with family
+- Don't Stop Believin' on jukebox
+- Mysterious man enters bathroom
+- CUT TO BLACK
+- Audience: open interpretation, controversial but iconic
+
+### Mad Men (Person to Person)
+- Don in retreat, has revelation
+- Final shot: him meditating, then iconic Coca-Cola ad
+- Suggests he returns to advertising
+- Series ends as it began (advertising)
+
+### Lost (The End)
+- Characters reunite in afterlife
+- Resolution emotional
+- Mystery elements not all answered
+- Audience: divided
+
+## Key principles
+
+### Honor the audience contract
+Audience invested years. Honor that with resolution.
+
+### Echo the pilot
+- Visual callbacks
+- Locations revisited
+- Themes restated
+- Sense of full circle
+
+### Character arcs fulfilled
+Each main character reaches end of their journey:
+- Growth shown
+- Or tragic completion
+- Or accepted stasis
+
+### Major questions answered
+What was the show ABOUT? Show audience the answer.
+
+### Emotional > plot
+Final images often quiet, emotional, not action.
+
+## Sample series finale
+
+```
+TITLE: "Karavan" Series Finale (assuming 5-season run)
+
+LOGLINE: As the Aliyev coffee empire faces its greatest crisis,
+the three siblings — now united after years of estrangement — must
+choose between expansion, integrity, and what their father
+actually wanted for them.
+
+COLD OPEN (0-5 min):
+- Echo of pilot: night shot of Baku, the Caspian glittering
+- Voice-over from late father (Arif): "When I am gone, you will
+discover what I built. I hope you will discover what I wanted."
+- Cut to present: ELDAR (45 now), NIGAR (42), RAMIN (37) at the
+opening of Karavan's first international cafe in London
+
+ACT 1 (5-15 min):
+- Reception is glowing
+- They are international success
+- But: a major investor wants majority share
+- Buyout offer is $200M — life-changing
+- They must decide
+
+ACT 2 (15-40 min):
+- Each sibling considers what they want
+- Eldar (former London corporate lawyer) — used to want the deal,
+now hesitates
+- Nigar (former restaurateur) — has built this with her hands, wants
+to keep
+- Ramin (former academic) — has discovered he loves the work
+- Family lawyer reveals: their father set up an irrevocable
+provision — if they EVER sell majority share, the entire trust
+fund (now $50M) goes to a charity supporting Yemeni coffee farmers
+- Their father wanted the business kept independent
+- Even if it cost them money
+- They debate
+- Each tells their truth about what these years have meant
+- Conversation echoes the pilot — but they are different people now
+
+ACT 3 (40-60 min):
+- They decide to keep the business
+- Refuse the buyout
+- Donate the trust fund anyway to the Yemeni farmers
+- They have built enough for themselves now
+- Closing of the deal: they sign a partnership renewal
+- Each pledges another five years together
+
+TAG (60-75 min):
+- Three siblings at the Baku warehouse — where it all started
+- It is night
+- They walk through it
+- Memories visualized briefly: father walking these same aisles
+- They sit at the small office desk where their father died
+- ELDAR pours three cups of coffee — Karavan Atlas, the original blend
+- They drink in silence
+- NIGAR speaks: "He would be okay, I think."
+- ELDAR: "I think so."
+- RAMIN: "I think we are okay."
+- They sit. Drink coffee.
+
+FINAL IMAGE: Three siblings at the small desk in the warehouse,
+sharing coffee, the city of Baku glittering through the window
+behind them.
+
+(Score: full Hans Zimmer-equivalent emotional swell. End title
+appears: "KARAVAN. End of Series.")
+```
+
+## Common series finale mistakes
+
+- Ignoring questions audience cared about
+- Out-of-character resolutions
+- Tone shift from rest of series
+- Killing fan favorites without earning
+- Open-ended without prior setup
+- Rushing to wrap up
+- Adding new characters in finale
+
+## When to write series finale
+
+- Series intentionally ending
+- Final season planned ending
+- Cancellation requires wrap-up
+- Limited series ending
+
+## Tone considerations
+
+- Not necessarily happy
+- But emotionally resonant
+- Honors what made the series unique
+- Final feeling > final fact

package/templates/skills/screenwriter/knowledge/categories/series/personas/david-simon.md

@@ -0,0 +1,131 @@
+# David Simon — Persona
+
+> Creator of The Wire, Treme, The Plot Against America. Gritty institutional realism. Multi-strand narrative. Working class.
+
+## Style Signatures
+
+- Gritty institutional realism
+- Multi-strand parallel narrative (4-5 storylines per episode)
+- Working class focus
+- Vernacular dialogue (city-specific)
+- Complex moral landscape
+- Cops + criminals as humans
+- Long-form payoffs
+- Anti-Hollywood structure
+
+## Common Devices
+
+- Multiple storylines tracked simultaneously
+- Cops, criminals, journalists, politicians, etc.
+- Large ensemble cast
+- Years-spanning storylines
+- Real-feeling consequences
+- Profanity authentic
+- Local culture detailed
+- "The game is the game" worldview
+
+## Dialogue Style
+
+Vernacular, regional, profane. Each character has specific voice. Cops speak like cops. Drug dealers speak like drug dealers. Journalists, politicians — each authentic.
+
+```
+OMAR (The Wire)
+A man got to have a code.
+
+McNULTY
+What the f*** did I do?
+
+WALLACE
+We just talking about how things might could be different.
+```
+
+Simon trusts audience to keep up.
+
+## When Writing as Simon
+
+- Multiple storylines per episode
+- Institutional setting (police, schools, ports, journalism, politics)
+- Working class characters humanized
+- Vernacular dialogue
+- No simple villains
+- Slow burn payoffs
+- Audience patience required
+- Real-feeling consequences
+
+## Sample Approach
+
+```
+TITLE: "Karavan" (Simon-style version)
+
+PILOT — multiple parallel storylines
+
+STORYLINE A (Police)
+- Detective NIGAR (38), homicide, gets the Aliyev murder case
+- Bureaucratic obstacles
+- Political pressure to close fast
+- Wants to actually solve it
+
+STORYLINE B (Family)
+- Three siblings inherit
+- Each represents different class trajectory
+- Eldar (corporate elite), Nigar (entrepreneur middle class), Ramin (educated but underemployed)
+- Their conflicts mirror Baku's class structure
+
+STORYLINE C (Workers)
+- Karavan warehouse workers
+- Their lives, families, complaints
+- The labor dispute brewing
+- Real relationships
+
+STORYLINE D (Criminals)
+- Garib Bey's criminal organization
+- His son's rise to power
+- Internal politics
+- Why they killed Aliyev
+
+STORYLINE E (Journalism)
+- Local journalist investigating coffee imports
+- Corruption story breaking
+- Connects all storylines
+
+Episode 1 establishes all five. Audience must trust the structure
+will pay off.
+
+By season's end, all storylines weave together. Detective discovers
+truth. Siblings face moral choice. Workers organize. Criminals
+implode. Journalist publishes.
+
+Simon-style: no clean victory. Some justice, much loss.
+
+Final image of season 1: Detective at her desk, file closed. New
+file open. The work continues.
+```
+
+## Avoid
+
+- Heroes and villains (Simon writes humans)
+- Quick resolution
+- Single protagonist
+- Sentimentality
+- Easy explanations
+- Hollywood feel
+- Music over emotion (Simon uses music sparingly)
+
+## Best for
+
+- Premium cable / HBO-style
+- Multi-season ambition
+- Institutional drama
+- City-specific stories
+- Adult audience
+- Long-form patient viewers
+- Awards aspiration
+
+## Avoid pairing with
+
+- Comedy
+- Romance-romance
+- Family-friendly
+- Quick procedural
+- Standalone episodes only
+- TikTok format