@azerogluemin/ai-bootstrap 0.2.1

package/templates/skills/composer/knowledge/lyrics-by-language.md

@@ -0,0 +1,79 @@
+# Lyrics By Language — Music Knowledge
+
+> Each language has unique lyric considerations. Critical for authentic multilingual songwriting.
+
+## Azerbaijani (AZ) ⭐ DEEP COVERAGE
+
+**See:** `lyrics/azerbaijani/` for comprehensive Azerbaijani lyrics knowledge.
+
+Key principles:
+- Heca vəzni (syllabic meter) — counts syllables strictly
+- Əruz vəzni (Arabic-Persian meter) — for classical forms
+- Rich tradition: classical (Füzuli, Nəsimi), modern (Vahabzadə), new gen (Aqşin Yenisey, Salam Sarvan), rap (HOST, Miri Yusif)
+- Vowel harmony — important for natural flow
+- Soft sounds dominant — flowing, melodic
+
+## English (EN)
+
+- Iambic patterns common (unstressed-stressed)
+- Verse-chorus-verse standard
+- Direct emotional expression accepted
+- Slang appropriate to genre
+- Short words punchier
+- Internal rhymes valued in rap/hip-hop
+
+## Russian (RU)
+
+- Tonic-syllabic verse traditional
+- Rich vowels suit melodic lines
+- Diminutives common ("моя любимая")
+- Long compound words present challenges
+- Strong tradition in авторская песня (Высоцкий tradition)
+
+## Turkish (TR)
+
+- Closely related to Azerbaijani — heca vəzni works similarly
+- Vowel harmony important
+- Suffix-heavy (allows rich rhyming)
+- Traditional aşık tradition (similar to Azerbaijani aşıq)
+- Modern pop: Sezen Aksu tradition
+
+## Other languages (lighter coverage)
+
+- Spanish: rich vowels, romance language tradition
+- French: nasal sounds, smooth liaison
+- German: compound words, harsh consonants
+- Korean: K-pop conventions, English mixed
+- Arabic: classical traditions, rich morphology
+
+## Cross-language considerations
+
+### Translation vs adaptation
+- Don't literal-translate lyrics
+- Adapt to target language meter and rhythm
+- Cultural references may need substitution
+
+### Code-switching (mixed languages)
+- Common in modern pop
+- Hook in one language, verse in another
+- Cultural authenticity matters
+
+### Syllable count varies
+- "Karavan" = 3 syllables in AZ (Ka-ra-van)
+- "Coffee" = 2 in EN
+- Same word, different rhythm needs
+
+## For Suno specifically
+
+Suno handles many languages but with varying quality:
+- English: best
+- Spanish, Portuguese, French: good
+- Russian, Japanese, Korean: decent
+- Azerbaijani, Turkish: improving (mention language explicitly in prompt)
+
+For best Azerbaijani results in Suno:
+```
+[Style: Azerbaijani folk, sung in Azerbaijani language]
+```
+
+Be explicit about language in prompt.

package/templates/skills/composer/knowledge/lyrics-craft.md

@@ -0,0 +1,89 @@
+# Lyrics Craft — Music Knowledge
+
+> Universal lyric writing principles. Apply to all languages and genres.
+
+## The 4 jobs of lyrics
+
+Every line should do at least 2:
+1. Tell a story / advance narrative
+2. Express emotion
+3. Create memorable hook (chorus especially)
+4. Sound singable (rhythm, vowels, consonants)
+
+## Universal principles
+
+### Specificity over generality
+- BAD: "I miss you so much"
+- GOOD: "I still kept your coffee mug"
+
+Specific details create universal feeling.
+
+### Show, don't tell
+- BAD: "I am sad"
+- GOOD: "Empty bed, cold coffee, your jacket still on the chair"
+
+### Singable structure
+- Strong vowels on accented beats
+- Consonants on weak beats
+- Avoid tongue-twisters in fast sections
+
+### Repetition with purpose
+- Chorus repeats — that's its job
+- Pre-chorus often builds with repetition
+- Verses should NOT repeat exact phrases (unless deliberate)
+
+### Hook recognition
+The chorus must:
+- Be memorable after one listen
+- Sing-along friendly
+- Repeat key phrase (the "hook")
+
+## Section-by-section approach
+
+### Verse
+- Story / narrative
+- Sets up the emotion
+- Different content per verse (V1 ≠ V2)
+- Personal / specific details
+
+### Pre-Chorus
+- Builds tension
+- Often shorter than verse
+- Leads to chorus emotionally
+
+### Chorus
+- Emotional core
+- Memorable hook
+- Repeats (usually 2-4 times in song)
+- Singable
+
+### Bridge
+- Contrast (different chord progression often)
+- New perspective
+- Often emotional peak
+- 8-16 bars typically
+
+## Singability checklist
+
+- Read the lyrics aloud
+- Can you sing them?
+- Are vowels on long notes?
+- Are consonants natural?
+- Do phrases breathe (singer needs breath spots)?
+
+## Common mistakes
+
+- Forced rhymes (changing meaning to rhyme)
+- Too many syllables per line
+- Cliché phrases ("baby, baby")
+- No emotional core
+- Same content in V1 and V2
+- Forgettable chorus
+- No clear hook
+
+## For Suno specifically
+
+Lyrics formatted clearly with section tags. Suno will sing them as written. Be precise:
+- Clear punctuation
+- Consistent meter within sections
+- Sing-friendly word choices

package/templates/skills/composer/knowledge/melody-craft.md

@@ -0,0 +1,126 @@
+# Melody Craft — Music Knowledge
+
+> The art of melodic line. What makes a memorable, singable melody.
+
+## What makes a good melody
+
+### Memorability
+- Hook that sticks after one listen
+- Often based on simple intervals
+- Rhythmic pattern recognizable
+
+### Singability
+- Within vocal range (typically 1.5 octaves max)
+- Avoids extreme leaps (small steps preferred)
+- Vowels on long notes
+- Consonants on short notes
+
+### Emotional truth
+- Melody matches lyrical emotion
+- Sad lyrics = descending lines often
+- Happy lyrics = ascending or stable
+- Tense moments = repeated notes or dissonance
+
+### Shape
+- Arc — rises and falls
+- Climax — highest note often at chorus peak
+- Resolution — returns to tonic at end
+
+## Melodic intervals
+
+### Steps (close together)
+- Most common
+- Singable
+- Smooth feel
+
+### Leaps (jumps)
+- Use sparingly
+- Create drama
+- Resolve back to step
+
+### Octave jumps
+- Powerful moments
+- Often at chorus
+- Don't overuse
+
+## Melodic patterns
+
+### Sequence
+Same shape, different starting note. Builds momentum.
+
+### Repetition
+Same notes. Drives home a phrase.
+
+### Variation
+Same idea, slightly altered. Keeps interest.
+
+### Call and response
+Two melodic phrases that "answer" each other.
+
+## Verse vs chorus melody
+
+### Verse
+- Lower range usually
+- More speech-like
+- Rhythmically varied
+- Allows lyrical variety
+
+### Chorus
+- Higher range typically
+- More melodic (less speech)
+- Anchored by hook phrase
+- Repeats with same words
+
+### Bridge
+- Different pattern entirely
+- Often modulates (key change)
+- Builds to final chorus
+
+## Genre-specific melody
+
+### Pop
+- Hook-driven
+- Memorable chorus
+- Often follows chord tones
+
+### Folk
+- Storytelling melody
+- Subtle range
+- Often modal
+
+### Hip-hop
+- Speech-based (rap)
+- Hooks more melodic
+- Auto-tune sometimes
+
+### R&B
+- Melismatic (many notes per syllable)
+- Wide range
+- Improvisational feel
+
+### Rock
+- Riff-based often
+- Power notes
+- Anthem-like choruses
+
+## For AI music (Suno)
+
+Suno generates melodies based on:
+- Genre conventions
+- Mood you specify
+- BPM/key
+- Vocal style requested
+
+You don't write melody for Suno — but you specify what KIND of melody:
+```
+[Vocal: emotional alto, melismatic chorus, restrained verse]
+```
+
+## Common melody mistakes
+
+- Out of singable range
+- Too many leaps
+- Forgettable chorus
+- Same melody V1 and V2 (boring — vary)
+- No clear hook
+- Doesn't match lyrical emotion

package/templates/skills/composer/knowledge/moods/aggressive.md

@@ -0,0 +1,98 @@
+# Aggressive — Mood
+
+> Intense, hard, confrontational. Distortion, power, anger.
+
+## Defining elements
+
+- Minor key or modal
+- Fast tempo (120-180+ BPM)
+- Heavy distortion
+- Powerful drums
+- Aggressive vocals
+
+## Sub-types
+
+### Metal aggressive
+- Distorted guitars + double bass
+- Growl / scream vocals
+- Examples: Slipknot, Lamb of God
+
+### Hardcore punk
+- Fast aggressive
+- Shouted vocals
+- Examples: Black Flag, Bad Religion
+
+### Aggressive hip-hop
+- Trap aggressive, drill
+- 808s + hi-hats
+- Confrontational lyrics
+- Examples: Kendrick "DNA", Pop Smoke
+
+### Industrial
+- Aggressive electronic
+- Distorted everything
+- Examples: Nine Inch Nails, Ministry
+
+### Aggressive rock
+- Distorted guitars
+- Powerful vocals (not screamed necessarily)
+- Examples: Rage Against the Machine
+
+## Instrumentation suggestions
+
+- Distorted electric guitars (down-tuned often)
+- Heavy bass (distorted sometimes)
+- Drums (double bass kick, snare hits)
+- Aggressive synths (industrial)
+- 808s (hip-hop aggressive)
+
+## Vocal style
+
+- Shouted, screamed (metal/hardcore)
+- Aggressive rap delivery
+- Powerful belted (rock)
+- Spoken aggressive (hip-hop)
+- Growled (extreme metal)
+
+## Lyrics direction
+
+- Anger, frustration
+- Rebellion, defiance
+- Confrontation
+- Social criticism
+- Personal demons
+- Power, dominance
+
+## For Suno
+
+```
+[Style: aggressive metal, 150 BPM, D minor (drop D tuning), 
+distorted electric guitars + heavy bass + double bass kick drums + 
+aggressive screamed vocals, intense and confrontational]
+```
+
+## Avoid
+
+- Slow tempo
+- Sparse arrangement
+- Major keys (unless ironic)
+- Soft vocals
+- Generic anger (need specificity)
+
+## Examples (reference)
+
+- "Killing in the Name" — Rage Against the Machine
+- "Master of Puppets" — Metallica
+- "Bulls on Parade" — Rage Against the Machine
+- "DNA." — Kendrick Lamar
+- "Closer" — Nine Inch Nails (aggressive ending)
+- "Down with the Sickness" — Disturbed
+- HOST group rap (Azerbaijani hip-hop with aggressive social themes)
+
+## Cultural variants
+
+- Western metal: distortion + drums
+- Japanese metal: technical + melodic
+- Latin aggressive: reggaeton with edge
+- Azerbaijani aggressive: HOST-style social hip-hop
+- Russian aggressive: hardcore + rap

package/templates/skills/composer/knowledge/moods/bittersweet.md

@@ -0,0 +1,97 @@
+# Bittersweet — Mood
+
+> Mix of joy and sadness. Beautiful but tinged with sorrow. Major-minor blend.
+
+## Defining elements
+
+- Major key with minor moments (or vice versa)
+- Mid tempo (80-110 BPM)
+- Beautiful melody with somber undertones
+- Often uses major 7 chords
+- Vocals warm but melancholy
+
+## Sub-types
+
+### Bittersweet pop
+- Modern singer-songwriter
+- Examples: Sara Bareilles, Adele
+- "Someone Like You" — joyful chord, sad lyric
+
+### Indie bittersweet
+- Folk + emotional
+- Examples: Sufjan Stevens, Phoebe Bridgers
+- Joy + melancholy intertwined
+
+### Bittersweet ballad
+- Big emotional moments
+- Mix of major + minor
+- Examples: "Rainbow" — Kacey Musgraves
+
+### Cinematic bittersweet
+- Film score moments
+- Examples: Joe Hisaishi sad-happy themes
+
+### Memory-based
+- Looking back fondly with sadness
+- Examples: "Time After Time" — Cyndi Lauper
+
+## Instrumentation suggestions
+
+- Piano (warm with minor 7 chords)
+- Acoustic guitar (fingerpicked)
+- Strings (subtle)
+- Soft drums (or none)
+- Cello (depth)
+- Vocal harmonies
+
+## Vocal style
+
+- Warm but emotional
+- Slight vulnerability
+- Both genders work
+- Restrained delivery
+- Sometimes voice cracks for emotion
+
+## Lyrics direction
+
+- Joy mixed with loss
+- Bittersweet memories
+- "I'm happy you're happy (without me)"
+- Acceptance with sadness
+- Beautiful endings
+- Letting go gracefully
+
+## For Suno
+
+```
+[Style: bittersweet indie folk, 90 BPM, F major with frequent minor 
+moments and major 7 chords, piano + acoustic guitar + soft strings + 
+subtle drums, female mezzo vocals warm but emotional with vulnerability, 
+nostalgic and beautiful atmosphere]
+```
+
+## Avoid
+
+- Pure happy or pure sad (must blend)
+- Aggressive tempo
+- Loud distortion
+- Generic emotion
+- Fast resolution
+
+## Examples (reference)
+
+- "Someone Like You" — Adele
+- "Rainbow" — Kacey Musgraves
+- "Time After Time" — Cyndi Lauper
+- "Photograph" — Ed Sheeran
+- "Yesterday" — The Beatles
+- "Skinny Love" — Bon Iver
+- "Saman Yolu" — Sezen Aksu (Turkish bittersweet)
+
+## Cultural variants
+
+- Western bittersweet: piano + warmth
+- Turkish bittersweet: arabesk
+- Russian bittersweet: bard tradition
+- Azerbaijani bittersweet: bayatı style
+- Latin bittersweet: bolero

package/templates/skills/composer/knowledge/moods/dreamy.md

@@ -0,0 +1,98 @@
+# Dreamy — Mood
+
+> Floating, ethereal, hazy. Atmospheric, reverb-heavy, otherworldly.
+
+## Defining elements
+
+- Major or modal key (often suspended chords)
+- Slow-mid tempo (60-100 BPM)
+- Heavy reverb / delay
+- Atmospheric pads
+- Floating melodies
+
+## Sub-types
+
+### Dream pop
+- Cocteau Twins / Beach House
+- Reverb-drenched
+- Ethereal vocals
+- Examples: Beach House, Cocteau Twins
+
+### Shoegaze
+- Wall of guitar
+- Vocals buried in mix
+- Examples: My Bloody Valentine, Slowdive
+
+### Ambient dreamy
+- No clear structure
+- Pure texture
+- Examples: Aphex Twin, Brian Eno
+
+### Modern dreamy pop
+- Mid-tempo dreamy
+- Examples: Mazzy Star, Lana Del Rey
+
+### Synthwave dreamy
+- Vintage synth + dreamy
+- Examples: Tycho
+
+## Instrumentation suggestions
+
+- Reverb-heavy electric guitar (clean)
+- Synth pads (long sustained)
+- Soft drums (often with reverb)
+- Bass (subtle)
+- Bells / glockenspiel
+- Ethereal female vocals
+- Field recordings
+
+## Vocal style
+
+- Floating, airy
+- Heavy reverb
+- Often female (soprano or mezzo)
+- Whisper-singing common
+- Multi-tracked harmonies (4-8 layers)
+
+## Lyrics direction
+
+- Dream imagery
+- Floating, weightlessness
+- Memory, time bending
+- Otherworldly experiences
+- Love at distance
+- Surreal moments
+
+## For Suno
+
+```
+[Style: dreamy dream-pop, 80 BPM, C major with suspended chords, 
+heavy reverb on all instruments, electric guitar + synth pads + soft 
+drums + glockenspiel, female soprano vocals layered with reverb, 
+ethereal floating atmosphere]
+```
+
+## Avoid
+
+- Sharp / dry production
+- Aggressive tempo
+- Heavy distortion (unless shoegaze)
+- Direct lyrics
+- Loud dynamics
+
+## Examples (reference)
+
+- "Fade Into You" — Mazzy Star
+- "Space Song" — Beach House
+- "Souvlaki Space Station" — Slowdive
+- "Cherry-coloured Funk" — Cocteau Twins
+- "Dreams" — Fleetwood Mac
+- "Pyramid Song" — Radiohead
+- "Sevdim" — Aygün Beyler dreamy moments
+
+## Cultural variants
+
+- Western dreamy: dream pop, shoegaze
+- Japanese dreamy: city pop influence
+- Korean dreamy: indie dream pop
+- Azerbaijani dreamy: extended mugham vocal lines

package/templates/skills/composer/knowledge/moods/energetic.md

@@ -0,0 +1,101 @@
+# Energetic — Mood
+
+> High-energy, driving, motivating. Fast tempo, full instrumentation, dynamic.
+
+## Defining elements
+
+- Fast tempo (120-180 BPM)
+- Driving rhythm
+- Major or minor (both work)
+- Full arrangement
+- Powerful vocals
+
+## Sub-types
+
+### Anthemic energetic
+- Stadium rock energy
+- Sing-along choruses
+- Big production
+- Examples: Foo Fighters, Coldplay anthems
+
+### Dance energetic
+- EDM, house
+- Drop-driven
+- 4-on-the-floor beat
+- Examples: Calvin Harris, Avicii
+
+### Hip-hop energetic
+- Trap, drill
+- Heavy 808s
+- Rapid hi-hats
+- Examples: Travis Scott, Kendrick
+
+### Punk / hardcore
+- Fast aggressive
+- Distorted guitars
+- Shouted vocals
+- Examples: Bad Religion, Ramones
+
+### Electronic energetic
+- Synth-driven
+- Build-and-drop
+- Layered
+- Examples: M83, Justice
+
+## Instrumentation suggestions
+
+- Drums (powerful, driving)
+- Electric guitar (rhythmic)
+- Synth bass (heavy)
+- Lead synth or guitar
+- Vocals doubled / harmonized
+- Brass for emphasis (sometimes)
+
+## Vocal style
+
+- Powerful, projected
+- Could be belted, rapped, shouted
+- Energy throughout
+- Doubled for thickness
+- Energetic delivery
+
+## Lyrics direction
+
+- Action, motion
+- Determination
+- Celebration
+- Movement, dancing
+- Empowerment
+- Triumph over obstacles
+
+## For Suno
+
+```
+[Style: energetic indie rock, 130 BPM, A major, driving drums + 
+electric guitar + bass + synth pads, male vocals powerful, anthemic chorus]
+```
+
+## Avoid
+
+- Slow tempo
+- Sparse arrangement
+- Whisper vocals
+- Sad lyrics
+- Minor key brooding (unless aggressive)
+
+## Examples (reference)
+
+- "Lose Yourself" — Eminem
+- "Stronger" — Kanye West
+- "Don't Stop Me Now" — Queen
+- "Levels" — Avicii
+- "Pumped Up Kicks" — Foster the People
+- "Blinding Lights" — The Weeknd
+
+## Cultural variants
+
+- Rock energetic: guitars central
+- EDM energetic: synth + drop
+- Hip-hop energetic: trap drums + 808
+- Latin energetic: salsa, reggaeton
+- Azerbaijani energetic: yallı dance, fast tempo