@azerogluemin/ai-bootstrap 0.2.1

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

@@ -0,0 +1,146 @@
+# Concept Music Video — Format
+
+> Abstract or symbolic visual. Not narrative or performance. Pure visual interpretation of song mood.
+
+## Format basics
+
+- Length: 3-5 min (song length)
+- Aspect: 16:9 (often artistic)
+- Abstract visuals
+- Mood / theme over story
+- Artist may or may not appear
+- Visual experimental ambition
+
+## Structure
+
+Less rigid than narrative or performance. Often free-form. But typically:
+
+```
+0-15s    OPENING IMAGE
+         Establish visual world
+         Set tone
+
+15s-2min DEVELOPMENT
+         Visual exploration
+         Mood building
+         Imagery cascade
+
+2-3min   PEAK
+         Visual climax
+         Most striking imagery
+
+3-4min   RESOLUTION
+         Visual completion
+         Return to opening or transformation
+
+4-5min   OUTRO
+         Final image
+         Lingering effect
+```
+
+## Sample concept MV
+
+```
+TITLE: Concept Video for "Karavan" by Ayla
+
+GENRE: Electronic / ambient
+LENGTH: 4:30
+CONCEPT: Coffee transforms throughout the song. Single coffee cup
+in the center of the frame. Around it, the world changes.
+
+VISUAL CONCEPT:
+Locked-down camera, fixed framing. A single white ceramic cup in
+center. Around it, time and space shift.
+
+SCENE 1: Empty room. Cup empty. White walls. Quiet.
+SCENE 2: Steam rises. Coffee being poured (no hand visible).
+SCENE 3: Sun moves across walls (time-lapse, several days).
+SCENE 4: Walls become forest. Trees grow up around cup.
+SCENE 5: Snow falls in the forest. Cup remains.
+SCENE 6: Stars and night sky replace ceiling.
+SCENE 7: Coffee glows from within (subtle special effect).
+SCENE 8: Walls return. Cup is now full. Steam rises.
+SCENE 9: A hand reaches in. Lifts the cup. Gone.
+SCENE 10: Empty cup returns. Empty room. Sun rises again.
+
+ARTIST APPEARANCE:
+Brief moments — artist seen reflected in the coffee surface, or as
+silhouette through the steam, or hands holding cup at very end.
+
+CUTS:
+On beat throughout. Each scene transition matches musical movement.
+
+PURPOSE:
+Coffee as metaphor for time, memory, presence. Concept echoes song
+themes.
+```
+
+## Key principles
+
+### Visual concept central
+- ONE strong concept
+- Carried throughout
+- Not narrative-driven
+
+### Imagery cascade
+- Striking visuals throughout
+- Each beat memorable
+- Tableau-quality
+
+### Symbolic / abstract
+- Open interpretation
+- Audience finds meaning
+- Mood over plot
+
+### Music drives editing
+- Cuts match beats
+- Visual rhythm = song rhythm
+- Build matches song build
+
+### Artist optional
+- Can be entirely without artist
+- Or artist as element
+- Or artist briefly
+
+## Sub-types
+
+### Visual symbolism
+- Symbolic objects/scenes
+- Open interpretation
+- Art-house feel
+
+### Pure visual aesthetic
+- Beautiful imagery
+- No real "concept"
+- Mood-driven
+
+### Animation / mixed media
+- Animated elements
+- Mixed with live action
+- Artistic ambition
+
+### Tableau / static
+- Locked frames
+- Minimal movement
+- Painterly quality
+
+### Surreal
+- Dream-logic
+- Impossible imagery
+- Lynch-style
+
+## When to use
+
+- Abstract / electronic / ambient music
+- Director with strong vision
+- Festival / awards aspiration
+- Artist comfortable with non-traditional MV
+- Brand artist as conceptual
+
+## Common mistakes
+
+- No clear concept (just random pretty)
+- Too literal (defeats abstract)
+- Concept doesn't sustain
+- Boring middle
+- Forgetting music structure (cuts random)

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

@@ -0,0 +1,136 @@
+# Hybrid Music Video — Format
+
+> Performance + narrative. Artist performs AND story unfolds. Most common modern MV.
+
+## Format basics
+
+- Length: 3-5 min (song length)
+- Aspect: 16:9 typical
+- Combines performance + story
+- Most common modern format
+- Versatile
+
+## Structure
+
+```
+0-15s    OPENING
+         Story setup OR performance hook
+
+15s-1min VERSE 1 + STORY ACT 1
+         Story begins
+         Artist may perform interspersed
+
+1-1:30min CHORUS 1 + STORY BEAT
+         Performance moment
+         Story emotional beat
+
+1:30-2:15min VERSE 2 + STORY ACT 2
+         Complication
+         Performance + story interweave
+
+2:15-2:45min CHORUS 2 + CLIMAX HINT
+         Building
+
+2:45-3:15min BRIDGE + STORY TURNING POINT
+         Story transformation
+         Often quieter performance
+
+3:15-3:45min FINAL CHORUS + STORY RESOLUTION
+         Peak performance + climactic story moment
+
+3:45-4min OUTRO + STORY EPILOGUE
+         Resolution image
+         Final performance shot
+```
+
+## Sample hybrid MV concept
+
+```
+TITLE: Hybrid MV for "Karavan" by Ayla
+
+GENRE: Pop / R&B
+LENGTH: 4:00
+SETTING: Modern Baku, multiple locations
+
+DUAL THREADS:
+
+PERFORMANCE THREAD:
+Artist performs in a stylized abandoned cafe setting. Beautiful
+lighting. She is alone, singing to camera and to no one.
+
+STORY THREAD:
+A woman (could be the artist or a separate actor) experiences a
+relationship's beginning, middle, and end across the city.
+
+INTERWEAVE:
+0-30s: Performance opening — artist enters empty cafe, sits at
+piano. Begins.
+
+30s-1min: Story begins — couple meets, cute moment in different cafe
+
+1-1:30min: Chorus — back to performance, then story moments
+intercut: them dating, happy, in love
+
+1:30-2:15min: Story conflict — argument, distance, growing apart.
+Performance: artist more emotional now.
+
+2:15-2:45min: Chorus — story shows breakup, artist performs through
+emotion
+
+2:45-3:15min: Bridge — artist walks through the cafe alone, story
+shows characters apart, alone in their own spaces
+
+3:15-3:45min: Final chorus — both threads peak. Story: woman walks
+into the same cafe artist is in. They sit at adjacent tables. Don't
+acknowledge each other but are sharing the same space. Performance:
+artist gives most powerful vocal.
+
+3:45-4min: Outro — artist finishes song, looks toward woman at next
+table. Woman looks back. Brief connection. Artist exits. Woman sits
+with her coffee. Camera pulls back. Both visible. End.
+
+(The implication: the artist is the future-self of the woman in the
+story, looking back.)
+```
+
+## Key principles
+
+### Two threads weave
+- Performance gives musical pleasure
+- Story gives emotional engagement
+- Both mutually reinforce
+
+### Match emotional beats
+- Story crisis = chorus emotional peak
+- Story quiet = performance intimate
+- Story resolution = song outro
+
+### Artist in both
+- Performs in performance thread
+- Optional in story thread (as character or observer)
+
+### Visual coherence
+- Color palettes consistent or intentionally contrasted
+- Lighting unified
+- Style single
+
+### Cut transitions
+- Match cuts between threads
+- Visual rhymes
+- Movement carries between
+
+## When to use
+
+- Modern pop / R&B / hip-hop
+- Artist comfortable with both
+- Higher budget
+- Story-rich song
+- Visual director with vision
+
+## Common mistakes
+
+- Threads disconnected
+- Story too complex (gets lost)
+- Performance dull
+- Imbalance (too much one thread)
+- No emotional payoff at end

package/templates/skills/screenwriter/knowledge/categories/music-video/formats/lyric-driven.md

@@ -0,0 +1,169 @@
+# Lyric-Driven Music Video — Format
+
+> Lyrics displayed throughout. Visual interpretation of words. Often kinetic typography.
+
+## Format basics
+
+- Length: 3-5 min (song length)
+- Aspect: 16:9 typically
+- Lyrics on screen
+- Visual interpretation of words
+- Often typography-focused
+- Lower budget option (no actors needed)
+
+## Sub-types
+
+### Kinetic typography
+- Lyrics animated
+- Typography styled
+- Music + word visual integration
+
+### Lyrics with imagery
+- Lyrics + relevant images/footage
+- Each line illustrated
+
+### Hybrid (lyrics + performance)
+- Lyrics shown
+- Plus artist performing or scenes
+
+### Hand-written lyrics
+- Lyrics literally written by hand on camera
+- Visual personal feel
+
+### Object-based lyrics
+- Words spelled out by objects
+- Stop-motion possible
+
+## Structure
+
+```
+0-15s    OPENING
+         Establish lyric style
+         Music intro
+         Title card maybe
+
+15s-3min LYRIC PROGRESSION
+         Each line displayed
+         Visual interpretation
+         Cuts to beat
+
+3-3:30min CHORUS REPETITION
+         Visual escalation on repeats
+         Variety in display
+
+3:30-4min OUTRO
+         Final lyric / message
+         Visual close
+```
+
+## Sample lyric-driven MV
+
+```
+TITLE: Lyric Video for "Yağışlı Axşam" by Ayla
+
+GENRE: Indie folk
+LENGTH: 3:45
+STYLE: Kinetic typography on cinematic backgrounds
+
+VISUAL APPROACH:
+
+BACKGROUND: Cinematic footage of rainy Baku night — wide shots of
+streets, neon, cars passing, water on glass. Beautiful. Atmospheric.
+
+TYPOGRAPHY: Lyrics appear over the footage in elegant typeface.
+Each line animates with the music — fading in, sliding, building.
+
+EXAMPLE BEAT:
+
+0:15 — Music intro. Wide shot of empty rainy Baku street.
+0:30 — First lyric appears: "Sən gedirsən axşam yağışında" (You
+walk away in the evening rain). Letters fade in slowly, one by one,
+matching the slow song pace.
+
+0:45 — Second line: "Mən baxıram pəncərədən" (I watch from the
+window). Letters appear as if written by rain on the screen.
+
+1:00 — CHORUS — typography becomes larger, more dynamic. Multiple
+lines layer over each other.
+
+1:30 — Verse 2 — return to slower display style.
+
+2:00 — CHORUS 2 — even more dynamic. Letters break apart.
+
+2:30 — BRIDGE — slowest moment. Single line stays on screen for
+20 seconds. Background goes intimate (close-up of rain on glass).
+
+3:00 — FINAL CHORUS — peak typography energy.
+
+3:30 — OUTRO — single final line. Holds.
+
+3:45 — End on title: "Yağışlı Axşam" by Ayla.
+
+(Multilingual option: lyrics in Azerbaijani with English subtitle
+below.)
+```
+
+## Key principles
+
+### Lyric clarity
+- Easy to read
+- Long enough to read
+- Match song pacing
+
+### Typography matters
+- Choose font reflecting song mood
+- Animation style match genre
+- Color palette intentional
+
+### Background supports lyrics
+- Doesn't distract
+- Sets mood
+- Cinematic
+
+### Cuts on beat
+- Lyrics appear/transition on beats
+- Visual rhythm = song rhythm
+
+### Multilingual option
+- Original + translation
+- Audience accessibility
+- Particularly for non-English songs
+
+## Sub-types
+
+### Pure kinetic typography
+- Just lyrics moving
+- Backgrounds simple/abstract
+- Typography is the show
+
+### Lyrics + footage
+- B-roll behind lyrics
+- Cinematic combinations
+
+### Lyrics + animation
+- Animated illustrations
+- Each line illustrated
+
+### Hand-written reveal
+- Pen writes lyrics on paper
+- Stop-motion or live
+
+### Object lyrics
+- Real objects form letters
+- Stop-motion ambitious
+
+## When to use
+
+- Lower budget option
+- Lyrics-heavy song
+- Multi-language audience (subtitles built in)
+- Album launch (multiple lyric videos for tracks)
+- Artist not comfortable on camera
+
+## Common mistakes
+
+- Lyrics too small or fast (unreadable)
+- Background distracting
+- Typography ugly
+- No cuts to beat
+- Generic look (could be any song)

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

@@ -0,0 +1,131 @@
+# Narrative Music Video — Format
+
+> Story-driven music video. Plot unfolds throughout song. Artist may or may not appear in story.
+
+## Format basics
+
+- Length: 3-5 min (song length)
+- Aspect: 16:9 (mostly), now also 9:16 versions
+- Story-driven structure
+- Visual narrative
+- Artist often appears
+- Music + story integration
+
+## Structure
+
+```
+0-15s    OPENING / HOOK
+         Visual establishes mood
+         Story setup begins
+         Music intro
+
+15s-1min ACT 1 (verse 1)
+         Character / situation introduced
+         Inciting incident hinted
+
+1-2min   ACT 2A (chorus + verse 2)
+         Tension builds
+         Subplot or complication
+
+2-3min   ACT 2B (chorus + bridge)
+         Climax / turning point
+         Big emotional beat
+
+3-4min   ACT 3 (final chorus)
+         Resolution
+         Final image
+         Often visual climax matches musical peak
+
+4-5min   OUTRO
+         Lingering image
+         Song fades
+         Title card / credits
+```
+
+## Sample narrative MV concept
+
+```
+TITLE: "Karavan" — Music Video for Song "Yağışlı Axşam"
+
+GENRE: Indie folk
+LENGTH: 4 minutes
+SETTING: Modern Baku, rainy night
+
+STORY:
+A young woman walks through Baku in the rain. She is going somewhere
+specific. We don't know where.
+
+VERSE 1 (0:15-1:00):
+She walks through neon-lit streets. Pauses at coffee shops. Looks
+inside. Continues.
+
+CHORUS 1 (1:00-1:30):
+Quick cuts of her walk + flashbacks to a man (her ex). They at a
+cafe. Smiling. Then arguing. Then her walking away.
+
+VERSE 2 (1:30-2:15):
+She approaches a specific cafe. Karavan Coffee. Looks inside the
+window.
+
+CHORUS 2 (2:15-2:45):
+Inside the cafe: he is there. The man. He doesn't see her yet.
+She watches him through the rain-streaked window.
+
+BRIDGE (2:45-3:15):
+She decides. Walks in. He looks up. Surprised.
+
+CHORUS 3 (3:15-3:45):
+She sits across from him. They look at each other. No words. Music
+swells.
+
+OUTRO (3:45-4:00):
+He pours her a coffee. She accepts. Final image: two cups on a small
+table, rain visible through window, song fades.
+
+(Artist may appear as singer in cafe corner, observing — meta touch.)
+```
+
+## Key principles
+
+### Story arc within song
+- Setup → conflict → resolution
+- Compressed to song length
+- Music shapes pacing
+
+### Music = pacing
+- Verse = building, exploring
+- Chorus = climax/payoff moments
+- Bridge = transformation
+- Match cuts to musical beats
+
+### Artist integration
+- Singing in scene
+- Or as character
+- Or watching/observing
+- Or absent (rare)
+
+### Visual emotional arc
+- Mood shifts
+- Color palette evolves
+- Lighting changes
+
+### Lyrical resonance
+- Story aligns with lyrics (loose)
+- Doesn't have to be literal
+- Emotional truth matches
+
+## When to use
+
+- Story-driven song
+- Artist comfortable with acting (or absent)
+- Cinematic ambition
+- Festival / awards (MV directors track)
+- Brand-elevating for artist
+
+## Common mistakes
+
+- Too literal lyric interpretation
+- Story disconnected from song mood
+- Forgetting artist
+- Cuts not on beat
+- Story too complex for 4 min