@azerogluemin/ai-bootstrap 0.2.1

package/templates/skills/screenwriter/knowledge/categories/music-video/formats/performance-mv.md

@@ -0,0 +1,169 @@
+# Performance Music Video — Format
+
+> Artist performing the song. Concert-feel or stylized performance. Direct musical focus.
+
+## Format basics
+
+- Length: 3-5 min (song length)
+- Aspect: 16:9
+- Artist performing
+- Cinematic stylized concert
+- Multi-camera typically
+- Visual focus on artist
+
+## Structure
+
+```
+0-15s    OPENING
+         Establish performance space
+         Artist introduced (if not known)
+         Music intro
+
+15s-1min VERSE 1
+         Artist performing
+         Visual establishment
+
+1-1:30min CHORUS 1
+         Energy builds
+         More dynamic shots
+
+1:30-2:15min VERSE 2
+         Variation in shots
+         Story-of-performance hinted
+
+2:15-2:45min CHORUS 2
+         Bigger energy
+
+2:45-3:15min BRIDGE
+         Quieter or building
+         Different visual approach
+
+3:15-3:45min FINAL CHORUS
+         Peak energy
+         Climactic visuals
+
+3:45-4min OUTRO
+         Fade out
+         Final image
+```
+
+## Sample performance MV concept
+
+```
+TITLE: Performance Video for "Atlas Bee" by Ayla
+
+GENRE: Pop
+LENGTH: 3:30
+SETTING: Stylized warehouse with neon lighting
+
+CONCEPT:
+Single location, multiple looks. Artist (AYLA) performs in different
+sections of a converted warehouse. Each section has distinct lighting
+and aesthetic.
+
+SECTION 1: Industrial concrete with cool blue lighting
+- Verse 1 here
+- Wide and close-up shots
+- Dynamic camera movement
+
+SECTION 2: A hidden room with red velvet
+- Chorus 1
+- More intimate, slower camera
+- Beauty shots
+
+SECTION 3: Open space with smoke and neon
+- Verse 2
+- Background dancers (sparse, geometric)
+- Wide energetic
+
+SECTION 4: Pure white space (empty)
+- Bridge
+- Just artist, single light
+- Vulnerability moment
+
+SECTION 5: All sections combined (maybe split-screen)
+- Final chorus
+- Maximum energy
+- Climax
+
+OUTRO: Pull back to wide of full warehouse, all spaces visible.
+Artist standing in center.
+
+VISUAL ELEMENTS:
+- Wardrobe changes per section
+- Color grading distinct per section
+- Camera movements vary by section
+- Cuts on beat throughout
+```
+
+## Key principles
+
+### Artist as focus
+- Beauty shots
+- Charisma showcased
+- Outfit / styling matters
+- Energy matches song
+
+### Multiple looks / settings
+- Variety prevents boredom
+- Wardrobe changes
+- Lighting changes
+- Background changes
+
+### Cuts on beat
+- Editing matches music
+- Energy in editing
+- Match cuts dynamic
+
+### Production value
+- Lighting elevated
+- Set design considered
+- Cinematography quality
+- Look intentional
+
+### Visual hooks
+- Memorable shots
+- Iconic imagery
+- Tableau moments
+
+## Sub-types
+
+### Concert-style
+- Performance to audience
+- Live energy
+- Documentary feel
+
+### Stylized studio
+- Controlled set
+- Multiple looks
+- Cinematic
+
+### Location performance
+- Specific real place
+- Artist + place integration
+
+### Dance performance
+- Choreography central
+- Dancers + artist
+- Movement focus
+
+### Stripped/acoustic
+- Intimate setting
+- Single instrument + voice
+- Vulnerability
+
+## When to use
+
+- Strong vocal performance to showcase
+- New artist (face-establishing)
+- Album promotion (multiple looks)
+- Charisma-driven artist
+- Lower-budget option (single location)
+
+## Common mistakes
+
+- Boring single shot
+- No variety
+- Cuts not on beat
+- Artist lifeless
+- Generic warehouse aesthetic (overdone)

package/templates/skills/screenwriter/knowledge/categories/music-video/personas/hype-williams.md

@@ -0,0 +1,131 @@
+# Hype Williams (MV Director) — Persona
+
+> Hip-hop music video legend. Fashion-forward. Bright colors / fish-eye. Maximum maximalism. 90s-2000s era defining.
+
+## Style Signatures
+
+- Fashion-forward aesthetic
+- Bright saturated colors
+- Fish-eye lens (signature)
+- Hip-hop maximalism
+- Luxury / wealth display
+- Wide shots + extreme close-ups
+- Glamorous lighting
+- Iconic imagery
+
+## Famous music videos
+
+- "Belly" (also feature director)
+- Many for: Missy Elliott, Busta Rhymes, Jay-Z, Beyoncé, Kanye West
+- "California Love" — 2Pac
+- "Big Pimpin'" — Jay-Z
+- "Get Ur Freak On" — Missy Elliott
+
+## Common Devices
+
+- Fish-eye lens
+- Extreme color saturation
+- Custom sets / installations
+- Wardrobe spectacle
+- Wealth imagery (cars, jewelry, mansions)
+- Multiple wardrobe changes
+- Grand scale
+- Performance + glamour hybrid
+
+## When Writing as Hype Williams
+
+- Bright saturated colors
+- Fish-eye lens specified
+- Fashion-forward wardrobe
+- Multiple wardrobe changes
+- Big scale (sets, locations)
+- Performance + visual spectacle
+- Luxury / wealth aesthetic (if appropriate)
+- Music video as event
+
+## Sample Approach
+
+```
+MUSIC VIDEO: For "Karavan Gold" by Ayla (hip-hop / pop crossover)
+
+CONCEPT: Multi-look performance video celebrating success. Artist
+in three distinct settings, each more elaborate than last.
+
+VISUAL APPROACH:
+- Saturated color palette
+- Fish-eye lens for key shots
+- Wardrobe-as-character
+- Wealth/glamour imagery
+
+LOCATION 1 (intro / verse 1): Neon-lit Baku rooftop
+- Artist in metallic gold outfit
+- City skyline behind
+- Drone shots
+- Fish-eye on close-ups
+
+LOCATION 2 (chorus 1): Inside a luxury vehicle
+- Sliding through Baku at night
+- Multiple background dancers visible at intersections
+- Color shifts to deep red and gold
+- Wardrobe: black with gold accents
+
+LOCATION 3 (verse 2): Karavan Coffee headquarters (the brand
+building lit in deep gold and amber)
+- Artist as the boss walking through
+- Employees as background dancers
+- Wardrobe: structured suit
+- Aspirational
+
+LOCATION 4 (chorus 2): Studio with infinity mirror
+- Multiplied reflections
+- Fish-eye distortion
+- High energy
+- Wardrobe: shimmering
+
+LOCATION 5 (bridge): Quieter — artist alone with single coffee cup
+- Reflection of all previous looks visible
+- Pre-final-chorus pause
+
+LOCATION 6 (final chorus): All locations combined / split-screen
+- Maximum visual density
+- Artist multiplied
+- Spectacle peak
+
+OUTRO: Artist with single coffee cup. Steam rising. Looks at camera.
+Smiles. Cut.
+
+WARDROBE:
+6+ outfit changes. Each iconic. Designed for screenshots.
+
+VISUAL SIGNATURE:
+- Fish-eye for character close-ups
+- Deep saturated colors throughout
+- Luxury imagery
+- Spectacle scale
+```
+
+## Avoid
+
+- Restraint
+- Indie / lo-fi aesthetic
+- Subtle wardrobe
+- Single location
+- Naturalistic lighting
+- Documentary feel
+
+## Best for
+
+- Hip-hop / pop
+- Luxury / aspirational artists
+- Established artists with budget
+- Fashion-aware artists
+- Big-budget productions
+- Visual spectacle aspirations
+
+## Avoid pairing with
+
+- Indie folk / acoustic
+- Stripped-down production
+- Concept videos
+- Documentary aesthetic
+- Low-budget projects

package/templates/skills/screenwriter/knowledge/categories/music-video/personas/michel-gondry.md

@@ -0,0 +1,113 @@
+# Michel Gondry (MV Director) — Persona
+
+> French music video master. Practical effects. DIY aesthetic. Dream-logic. "How did they do that?" magic.
+
+## Style Signatures
+
+- Practical / tactile effects (no CGI when possible)
+- DIY aesthetic
+- Dream-logic
+- Mind-bending visual tricks
+- "How did they do that?" technique
+- Stop-motion sometimes
+- Clever in-camera magic
+- Emotional grounding
+
+## Famous music videos
+
+- "Around the World" — Daft Punk (geometric character dance)
+- "Star Guitar" — The Chemical Brothers (train sync)
+- "Sugar Water" — Cibo Matto (split-screen reverse)
+- "Knives Out" — Radiohead
+- "Drugs" — Lily Allen
+
+## Common Devices
+
+- Practical visual tricks revealed slowly
+- Stop-motion sequences
+- Reversed footage / mirrored sequences
+- Geometric / repetitive movement
+- Real construction (not effects)
+- Single concept executed thoroughly
+- Quirky charm
+
+## When Writing as Michel Gondry
+
+- ONE clear visual trick / concept
+- Practical effects only (or look practical)
+- Stop-motion possible
+- DIY feel
+- Reveal technique slowly
+- Emotional core beneath quirk
+- Music + visual sync exact
+
+## Sample Approach
+
+```
+MUSIC VIDEO: For "Karavan" by Ayla
+
+CONCEPT: A coffee shop where time runs in reverse (visually). The
+artist sits in a corner. Around her, customers leave their drinks
+empty, then they fill back up as if poured backward, then customers
+"un-drink" them, then leave the shop walking backward.
+
+VISUAL APPROACH:
+- Shoot all action in real time forward
+- Reverse all footage
+- Artist is the only thing that's normal — she sits, sings, doesn't
+move backward
+
+EXECUTION:
+- Customers walk in (will appear to walk out backward)
+- Order at counter, pay (will appear to receive payment, give back drink)
+- Sit, drink coffee (will appear to "un-drink" it)
+- Get up, leave (will appear to enter)
+
+ARTIST POV:
+- Artist sits in corner
+- She's singing forward
+- Around her, the world reverses
+- Implication: she experiences time differently. Or she remembers
+backward. Or it's a meditation on time and presence.
+
+SHOTS:
+- Wide of cafe with backward action
+- Close-up of cup filling itself
+- Coffee returning to bag from cup
+- Artist tight, singing normally
+
+DETAILS:
+- Practical reverse (no CGI)
+- Music plays normally
+- Slowly reveals concept (audience figures out)
+- One sequence might be normal time (or revealed at end)
+
+EMOTIONAL CORE:
+Memory, time, what we hold onto. Coffee as time-marker. The artist
+as still point in turning world.
+```
+
+## Avoid
+
+- CGI
+- Studio polish
+- Generic looks
+- Easy effects
+- Forgetting the magic moment
+- Concepts that don't sustain
+
+## Best for
+
+- Indie / alternative music
+- Music videos with unusual concepts
+- Lower-budget but ambitious
+- Artistic festival aspirations
+- Quirky charm songs
+
+## Avoid pairing with
+
+- Hip-hop / rap (different aesthetic)
+- Pure performance
+- Fashion / dance focus
+- Generic pop
+- Heavy commercial

package/templates/skills/screenwriter/knowledge/categories/music-video/personas/neutral-mv-director.md

@@ -0,0 +1,124 @@
+# Neutral Music Video Director — Persona
+
+> Default professional MV director. No particular voice. Industry-standard music video craft.
+
+## When to use
+
+- No specific persona requested
+- Genre + budget dictates
+- Standard MV needs
+- Need clean professional output
+
+## Style Signatures
+
+- Professional craft
+- Genre-appropriate
+- Clean structure
+- Audience-friendly
+- Reliable execution
+
+## Common Devices
+
+- Standard MV structure
+- Music + visual sync
+- Genre conventions followed
+- Clean cinematography
+- Cuts on beat
+- Artist appropriately featured
+
+## Voice Style
+
+Adapts to project. Genre-appropriate.
+
+## When Writing as Neutral
+
+- Follow brief precisely
+- Use proven MV structures
+- Match genre conventions
+- Clean execution
+- No surprises
+
+## Sample Approach
+
+For a standard pop performance MV, neutral approach:
+
+```
+MUSIC VIDEO: For "Karavan" by Ayla (pop)
+
+LENGTH: 3:30
+STRUCTURE: Performance video with visual variety
+
+LOCATION 1 (verse 1, chorus 1): Modern minimalist studio
+- Artist solo
+- Clean white background
+- Beauty shots
+- Outfit 1
+
+LOCATION 2 (verse 2, chorus 2): Outdoor location at golden hour
+- Artist + 2 background dancers
+- Cinematic
+- Outfit 2
+
+LOCATION 3 (bridge): Intimate setting
+- Artist with instrument
+- Single light
+- Vulnerability
+
+LOCATION 4 (final chorus): All elements combined
+- Cuts between locations
+- Maximum energy
+- Outfit 3 (combination)
+
+OUTRO: Final shot — artist returning to opening composition
+
+EDITING: Cuts on beat throughout
+```
+
+## When neutral is right
+
+- Brief is detailed
+- Mainstream music
+- Standard format
+- Quick turnaround
+- Genre-typical
+
+## Strengths
+
+- Reliable
+- Genre-appropriate
+- Audience-friendly
+- Easy to brief
+- Predictable
+
+## Limitations
+
+- No memorable distinct voice
+- Won't break through
+- Forgettable
+- Doesn't elevate
+
+## How to write neutral
+
+- Standard MV structure
+- Genre conventions
+- Clean cinematography
+- Cuts on beat
+- Artist features
+- Industry standard
+
+## When to upgrade
+
+- Distinctive vision desired
+- Festival / awards aim
+- Artist brand-building
+- Iconic moments needed
+
+→ Move to Spike Jonze, Michel Gondry, Hype Williams style
+
+## Default behavior
+
+When no persona specified:
+- Solid craft
+- Genre-appropriate
+- Audience-friendly
+- Reliable execution

package/templates/skills/screenwriter/knowledge/categories/music-video/personas/spike-jonze.md

@@ -0,0 +1,117 @@
+# Spike Jonze (MV Director) — Persona
+
+> Music video pioneer who became feature director. Surreal premises grounded in emotion. Practical effects. Iconic videos for Beastie Boys, Björk, Weezer.
+
+## Style Signatures
+
+- Surreal premises played straight
+- Practical effects (vs. CGI)
+- Romantic melancholy beneath quirk
+- Long takes
+- Distinctive visual concepts
+- Emotion + concept hybrid
+- Music + image integration
+
+## Famous music videos
+
+- "Sabotage" — Beastie Boys (cop drama parody)
+- "It's Oh So Quiet" — Björk (musical fantasy)
+- "Buddy Holly" — Weezer (Happy Days integration)
+- "Praise You" — Fatboy Slim (street performance)
+- "Da Funk" — Daft Punk (dog-headed man wandering NYC)
+
+## Common Devices
+
+- One distinct concept per video
+- Real-feeling locations
+- Practical effects, costumes
+- Single character often
+- Character POV
+- Quirky-emotional balance
+- Sometimes parody (specific genre/era)
+
+## When Writing as Spike Jonze
+
+- ONE strong distinct concept
+- Practical effects over CGI
+- Emotional grounding
+- Single character or small ensemble
+- Quirky but real
+- Music + concept integration
+- Often comedy + emotion hybrid
+
+## Sample Approach
+
+```
+MUSIC VIDEO: For "Karavan" by Ayla (indie folk)
+
+CONCEPT: A coffee delivery man drives across Baku at night,
+delivering coffee to people who didn't order coffee. They are
+delighted, confused, or transformed by the gift.
+
+VISUAL APPROACH:
+- Single character (the delivery man) followed throughout
+- Real Baku locations at night (no studio)
+- Practical effects only
+- Sometimes magical realism (a child's toy moves slightly when
+the delivery happens)
+- Quirky-melancholic balance
+
+ARTIST: Appears in the delivery van's radio dashboard — visible
+through the dashboard like a hologram radio host. Sings the song.
+
+STORY:
+Verse 1: Delivery man drives. Stops at first house. Old man opens
+door. Confused. Accepts coffee. Cries.
+
+Chorus 1: Delivery continues. Multiple stops. Each person reacts
+differently. Some smile, some concerned, some join him for a sip.
+
+Verse 2: Stop at apartment. Young couple opens door, fighting.
+Coffee stops fight. They laugh.
+
+Bridge: Delivery man at last stop. Empty house. Pours himself coffee.
+Sits on the porch.
+
+Final chorus: Multi-character montage of everyone he delivered to.
+All drinking. Connected through coffee. Even the old man.
+
+Outro: Delivery van drives off into the dawn.
+
+ARTIST IN DASHBOARD: Sings throughout, occasionally smiles or nods
+at delivery man (who can see her? who knows).
+
+PRACTICAL EFFECTS:
+- Holographic singer in dashboard (using mirror/reflection trick)
+- Steam rising from coffee (real)
+- Dawn lighting (shoot at golden hour)
+- All real Baku locations
+
+EMOTIONAL CORE:
+Coffee as small grace. Connection through impractical kindness.
+Loneliness and its quiet remedies.
+```
+
+## Avoid
+
+- CGI-heavy
+- Cool detached tone
+- Generic locations
+- Dance / fashion only
+- Performance-only
+- Forgetting emotion
+
+## Best for
+
+- Indie folk / pop / alternative
+- Singer-songwriters
+- Cinematic music videos
+- Festival aspirations
+- Quirky-emotional songs
+
+## Avoid pairing with
+
+- Hip-hop performance MV
+- Pure dance MV
+- Heavy fashion MV
+- Generic pop performance