@azerogluemin/ai-bootstrap 0.2.1

package/templates/skills/composer/knowledge/cultural-traditions.md

@@ -0,0 +1,193 @@
+# Cultural Music Traditions — Music Knowledge
+
+> Music has deep cultural roots. Understanding traditions matters for authentic generation.
+
+## Why this matters
+
+- Avoid stereotyping
+- Authentic representation
+- Cultural respect
+- Better AI music output (specifying tradition helps)
+
+## Major world music traditions
+
+### Western classical
+- 17th-19th century European
+- Notated tradition
+- Orchestral, chamber, vocal
+- Bach, Mozart, Beethoven, etc.
+
+### Jazz (American)
+- Early 20th century African-American origins
+- Improvisation central
+- Blues roots
+- Swing, bebop, fusion sub-traditions
+
+### Blues (African-American)
+- Late 19th-early 20th century
+- 12-bar form common
+- Pentatonic / blues scale
+- Foundation for rock, R&B
+
+### Rock and roll
+- 1950s American
+- Blues + country fusion
+- Electric instrumentation
+- Global cultural impact
+
+### Hip-hop (African-American)
+- 1970s NYC origin
+- Sampling tradition
+- DJ + MC + breaking + graffiti culture
+- Now global
+
+### Electronic / EDM
+- Late 20th century
+- Synthesizer + sequencer
+- Dance club culture
+- Global subgenres
+
+## Middle Eastern / Caucasian traditions
+
+### Azerbaijani mugham
+- Classical Azerbaijani art music
+- 7 main mughams: Rast, Şur, Segah, Çahargah, Bayatı-Şiraz, Şüştər, Humayun
+- Traditional instruments: Tar, Kamancha, Daf
+- Vocal-led, ornamented
+- UNESCO Intangible Heritage
+- Masters: Alim Qasimov, Aygün Bayramova
+
+### Azerbaijani aşıq tradition
+- Folk poet-musicians
+- Saz (string instrument) accompanied
+- Improvised poetry
+- Oral tradition
+- Aşıq Ələsgər master example
+
+### Meykhana (Azerbaijani)
+- Improvised poetic battle / freestyle
+- Pre-rap tradition
+- Comedy + social commentary
+- Foundation for modern Azerbaijani rap
+
+### Turkish folk + arabesk
+- Saz tradition (similar to Azerbaijani)
+- Arabesk: fusion of Turkish + Arabic + Western
+- Sezen Aksu modern era
+- Aşık tradition (Aşık Veysel)
+
+### Persian classical
+- Dastgah system (similar to mugham)
+- Tar, setar, ney instruments
+- Sufi poetry connections
+- Master: Mohammad Reza Shajarian
+
+### Arab classical
+- Maqam system
+- Oud, qanun, ney
+- Vocal central
+- Umm Kulthum legendary singer
+
+## Asian traditions
+
+### Indian classical
+- Raga system (modes)
+- Sitar, tabla, sarod
+- Improvisation
+- Master: Ravi Shankar
+
+### Chinese classical
+- Pentatonic scales often
+- Erhu, guqin, pipa
+- Refined elegance
+
+### Japanese traditional
+- Shakuhachi, koto, shamisen
+- Pentatonic / hexatonic scales
+- Minimalism
+
+### Korean / K-pop
+- Modern K-pop is global
+- Traditional: gugak (Korean classical)
+
+## African traditions
+
+### West African
+- Drum traditions (djembe, talking drum)
+- Polyrhythmic
+- Foundation for jazz, blues
+
+### South African
+- Mbube (Lion Sleeps Tonight tradition)
+- Ladysmith Black Mambazo
+- Modern: amapiano
+
+### Modern African pop
+- Afrobeats (Nigerian, Ghanaian)
+- Major global influence currently
+
+## Latin American
+
+### Cuban
+- Son, salsa, mambo, cha-cha
+- Clave rhythm central
+- Buena Vista Social Club
+
+### Brazilian
+- Samba, bossa nova, MPB
+- Tropicália movement
+- Caetano Veloso, Gilberto Gil
+
+### Mexican
+- Mariachi, ranchera, banda
+- Norteño influences
+- Regional Mexican modern era
+
+### Argentinian
+- Tango (Astor Piazzolla)
+- Folk: chacarera, zamba
+
+## European folk
+
+### Celtic (Irish, Scottish)
+- Fiddle, tin whistle, bodhrán
+- Jigs, reels, ballads
+- Modern: Loreena McKennitt
+
+### Eastern European
+- Balkan brass
+- Romanian folk
+- Bulgarian voices
+
+### Spanish flamenco
+- Palmas (clapping), guitar
+- Cante (singing)
+- Andalusian roots
+
+## For AI music (Suno)
+
+Specify tradition explicitly:
+```
+[Style: traditional Azerbaijani mugham, Şur mode, Tar + Kamancha + Daf, 
+vocal in Azerbaijani, ornamented, free time]
+```
+
+Suno can attempt cultural traditions but quality varies. Be specific.
+
+## Cultural respect
+
+When using cultural traditions:
+- Research authenticity
+- Don't appropriate without context
+- Credit tradition
+- Avoid stereotypes
+- Hire cultural consultants for serious work
+
+## Common cultural music mistakes
+
+- Stereotyping (all "Asian music" sounds same)
+- Mixing incompatible traditions
+- Wrong instruments for tradition
+- Western beat under non-Western melody
+- Missing key tradition elements
+- Cultural appropriation without acknowledgment

package/templates/skills/composer/knowledge/dynamics-build-drop.md

@@ -0,0 +1,148 @@
+# Dynamics — Build & Drop — Music Knowledge
+
+> How songs build energy and release it. Critical for emotional engagement.
+
+## What dynamics are
+
+Dynamics = volume / intensity / energy variation throughout song.
+
+Constant dynamics = boring.
+Well-crafted dynamics = emotional journey.
+
+## Dynamic markings (musical)
+
+| Marking | Meaning |
+|---------|---------|
+| pp (pianissimo) | Very quiet |
+| p (piano) | Quiet |
+| mp (mezzo piano) | Medium quiet |
+| mf (mezzo forte) | Medium loud |
+| f (forte) | Loud |
+| ff (fortissimo) | Very loud |
+| crescendo | Getting louder |
+| decrescendo | Getting quieter |
+
+## Pop song dynamic structure (typical)
+
+```
+Intro       — quiet (mp)
+Verse 1     — quiet (mp)
+Pre-Chorus  — building (mp → mf)
+Chorus 1    — loud (f)
+Verse 2     — quiet (mp), maybe slightly louder than V1
+Pre-Chorus  — building (mp → mf)
+Chorus 2    — loud (f), maybe with extra harmonies
+Bridge      — varies (often quiet drop or building)
+Final Chorus — loudest (ff), all elements
+Outro       — fade or stripped back
+```
+
+## Build types
+
+### Add layers
+Each section adds an instrument:
+- V1: just guitar + voice
+- Pre-chorus: + bass
+- Chorus: + drums + harmonies
+
+### Increase intensity
+Same instruments but louder/more aggressive:
+- Verse: gentle strumming
+- Chorus: power chords
+
+### Frequency expansion
+Add high or low frequencies:
+- Verse: midrange only
+- Chorus: + bass + cymbals (full range)
+
+### Rhythm intensity
+- Verse: simple beat
+- Chorus: driving beat
+
+## "Drop" (in EDM and modern production)
+
+The "drop" = climactic moment after build:
+- Beat hits hard
+- Bass drops
+- Energy peaks
+
+Common in:
+- EDM (the bass drop)
+- Modern pop
+- Dubstep
+- Trap (the beat drop)
+
+### Drop placement
+- Usually after pre-chorus / build
+- Or after long quiet section
+- Maximum contrast = maximum impact
+
+## Bridge dynamics
+
+### Quiet bridge (most common)
+- Strip back to vocals + piano
+- Audience catches breath
+- Sets up final chorus impact
+
+### Loud bridge
+- Continuous build
+- Bridge is climactic moment
+- Final chorus matches intensity
+
+### Stop / silence
+- Brief silence before final chorus
+- Maximum drama
+- Audience anticipates
+
+## Final chorus elaboration
+
+Make final chorus distinct:
+- Modulate up (key change)
+- Add new harmonies
+- Add new instrument (e.g., choir entering)
+- Riff or improvisation
+- Double the chorus length
+- Hold a note
+
+## Outro dynamics
+
+### Fade out
+- Most common
+- Producer fades volume gradually
+- Less common in modern pop
+
+### Hard stop
+- Last chord, silence
+- Dramatic
+- Often used in rock
+
+### Stripped back
+- Return to intro arrangement
+- Echoes opening
+- Sense of completion
+
+### Solo / vamp
+- Instrumental section over chorus chords
+- Lead guitar / sax solo
+- Until fade
+
+## For AI music (Suno)
+
+Describe dynamics in prompt:
+```
+[Verse: sparse, intimate, just piano + voice]
+[Chorus: full dynamic, drums + bass + strings + harmonies]
+[Bridge: quiet drop — voice + single piano]
+[Final Chorus: maximum intensity, modulated up a step, choir entering]
+```
+
+Suno responds to dynamic descriptions.
+
+## Common dynamics mistakes
+
+- No build (everything same intensity)
+- Too much build (can't sustain)
+- Bridge same as chorus (no contrast)
+- Final chorus = first chorus (no escalation)
+- Outro abrupt without sense
+- Dynamic shifts unmotivated

package/templates/skills/composer/knowledge/genres/afrobeats.md

@@ -0,0 +1,73 @@
+# Afrobeats — Genre
+
+> West African pop genre. Globally popular. Rhythmic, danceable, melodic.
+
+## Defining elements
+
+- West African rhythmic foundation
+- Mid-fast tempo (95-120 BPM)
+- Pidgin English + local languages (Yoruba, etc.) + English
+- Danceable groove
+- Live instrumentation hybrid with electronic
+- Catchy hooks
+
+## Sub-types / Related
+
+- **Afrobeats (modern)** — Wizkid, Burna Boy, Davido
+- **Afrobeat (classic — Fela Kuti)** — different, jazz-funk-political
+- **Amapiano** — South African house-influenced (Tyla, modern)
+- **Afro-fusion** — mixing with R&B, pop
+- **Highlife** — Ghanaian roots
+- **Afroswing** — UK African diaspora
+
+## Distinctive elements
+
+- Talking drum or its electronic equivalent
+- Polyrhythmic percussion
+- Melodic bass lines
+- Call-and-response vocals
+- Specific dance beats
+
+## Typical instrumentation
+
+Drum machine + percussion (congas, shakers) + bass (melodic) + electric guitar (sometimes funk-style) + synth pads + vocal + horns (sometimes)
+
+## Production characteristics
+
+- Layered percussion
+- Bass groove forward
+- Vocal forward
+- Modern polished production
+- Hybrid acoustic-electronic
+
+## Lyrics direction
+
+- Love (modern)
+- Celebration
+- Dancing
+- Cultural pride
+- Multi-language code-switching
+- Specific local cultural references
+
+## For Suno
+
+```
+[Style: modern Afrobeats, 105 BPM, A major, drum machine + layered 
+percussion (congas, shakers) + melodic bass + electric guitar + synth 
+pads + male vocal with Pidgin English and Yoruba mix, polished hybrid 
+production, danceable groove]
+```
+
+## Examples
+
+- Wizkid, Burna Boy, Davido (Nigerian icons)
+- Modern: Tems, Asake, Rema, Tyla (Amapiano)
+- Diaspora: Skepta (UK), Drake collaborations
+- Classic: Fela Kuti (foundational)
+
+## Avoid
+
+- Single vocal (often features)
+- No percussion (groove essential)
+- Slow ballad pacing
+- Generic "African" (too vague — be specific)

package/templates/skills/composer/knowledge/genres/ambient.md

@@ -0,0 +1,62 @@
+# Ambient — Genre
+
+> Atmospheric music. Texture over melody. Background or focused listening.
+
+## Defining elements
+
+- Texture-based (not melody-driven)
+- No traditional song structure
+- Long pieces (often 5-30+ min)
+- Slow tempo or no tempo
+- Sustained sounds
+- Field recordings often
+
+## Sub-types
+
+- **Classic ambient** — Brian Eno tradition (Music for Airports)
+- **Dark ambient** — eerie atmosphere (Lustmord, Atrium Carceri)
+- **Drone** — sustained tones (Sunn O))), William Basinski)
+- **New age ambient** — meditative (Steven Halpern)
+- **Nature ambient** — environmental sounds
+- **Ambient electronic** — Boards of Canada, Aphex Twin (Selected Ambient)
+
+## Typical instrumentation
+
+Synth pads + processed strings + field recordings + subtle percussion (or none) + occasional piano
+
+## Production characteristics
+
+- Heavy reverb
+- Long sustained sounds
+- Spatial design
+- No drums often
+- Layered textures
+
+## Lyrics direction (when vocal)
+
+- Often wordless ("aaah" / "oooh")
+- Whisper-quiet if any words
+- Repeated phrases
+- Mantra-like
+
+## For Suno
+
+```
+[Style: classic ambient, 60 BPM (or no defined tempo), C major (modal), 
+heavy reverb sustained synth pads + processed string textures + field 
+recording (rain), no drums, no clear melody, atmospheric texture-based, 
+calming]
+```
+
+## Examples
+
+- Brian Eno (genre founder), Aphex Twin (Selected Ambient), Boards of Canada
+- William Basinski, Stars of the Lid, Tim Hecker
+
+## Avoid
+
+- Strong drums
+- Clear song structure
+- Hook-driven
+- Vocal-led
+- Fast tempo

package/templates/skills/composer/knowledge/genres/azerbaijani-mugham.md

@@ -0,0 +1,90 @@
+# Azerbaijani Mugham — Genre 🇦🇿
+
+> Classical Azerbaijani art music. UNESCO Intangible Cultural Heritage. Modal, ornamented, vocal-led.
+
+## Defining elements
+
+- Modal system (mugham modes)
+- Improvisational ornamentation
+- Vocal central (often unaccompanied moments)
+- Microtonal intervals (between Western half-steps)
+- Free time (rubato) often
+- Spiritual / philosophical content
+
+## The 7 main mughams
+
+1. **Rast** — joyful, celebratory, "father of mughams"
+2. **Şur** — melancholic, contemplative
+3. **Segah** — tragic, deeply emotional, most popular
+4. **Çahargah** — dramatic, fiery
+5. **Bayatı-Şiraz** — sad, longing
+6. **Şüştər** — peaceful, contemplative
+7. **Humayun** — philosophical, profound
+
+Each mugham has its own emotional register and traditional usage.
+
+## Typical instrumentation
+
+- **Tar** — long-necked lute (signature instrument)
+- **Kamancha** — bowed string instrument
+- **Daf** — frame drum
+- Vocal — solo vocalist with extensive ornamentation
+
+This is the classical "mugham trio" (Tar + Kamancha + Daf + voice).
+
+## Production characteristics
+
+- Acoustic recording (concert hall or traditional setting)
+- Minimal processing
+- Live performance feel
+- Wide dynamic range
+- Solo vocalist with subtle accompaniment
+
+## Vocal style
+
+- Highly ornamented
+- Microtonal pitch bends
+- Long sustained notes with vibrato
+- Emotional intensity
+- Master-apprentice tradition
+
+## Lyrics tradition
+
+- Often classical poetry: Füzuli, Nəsimi, Vahid
+- Ghazal form (qəzəl)
+- Sufi / mystical themes
+- Love (earthly + divine)
+- Philosophy / existence
+- See: lyrics/azerbaijani/classical-forms/ghazal.md
+
+## For Suno
+
+```
+[Style: traditional Azerbaijani mugham, free rhythm (rubato), Şur mode, 
+tar + kamancha + daf with male vocal in mugham style with extensive 
+ornamentation and microtonal pitch bends, sung in Azerbaijani language, 
+spiritual/contemplative atmosphere, traditional acoustic recording]
+```
+
+## Examples (masters)
+
+- **Alim Qasimov** — global mugham master (UNESCO Artist for Peace)
+- **Aygün Bayramova** — modern female mugham vocalist
+- **Bülbül** — classical Azerbaijani singer
+- **Rashid Behbudov** — fusion classical-pop
+- **Gochag Askarov** — modern mugham
+
+## Modern fusion
+
+- Mugham + jazz (Aziza Mustafa Zadeh)
+- Mugham + rock
+- Mugham + electronic (modern experimental)
+
+## Avoid
+
+- 4-on-the-floor beat
+- Auto-tune
+- Western pop chord progressions
+- Generic "Eastern" feel (mugham is specific)
+- Drum machine
+- Chord-based harmony (mugham is melodic-modal)

package/templates/skills/composer/knowledge/genres/azerbaijani-pop.md

@@ -0,0 +1,104 @@
+# Azerbaijani Pop — Genre 🇦🇿
+
+> Modern Azerbaijani popular music. Western pop production with Azerbaijani vocals + cultural elements.
+
+## Defining elements
+
+- Western pop production foundation
+- Azerbaijani language vocals
+- Often hybrid: pop + traditional elements
+- Modern radio-friendly
+- Star vocalists
+- Mid tempo (95-120 BPM)
+
+## Eras
+
+### Soviet era pop
+- Rashid Behbudov (legendary)
+- Bul-bul-ogli
+- State-supported pop
+
+### Post-Soviet 1990s-2000s
+- Aygün Kazımova (icon)
+- Brilliant Dadaşova
+- Faik Agayev
+
+### Modern (2010s+)
+- Eldar Qasımov (Eurovision winner 2011)
+- Sabina Babayeva
+- Nigar Camal
+- Modern singer-songwriters
+
+## Typical instrumentation
+
+Drum machine + synth pads + bass + electric piano + occasional traditional instruments (tar, kamancha) + vocal + harmonies
+
+## Production characteristics
+
+- Modern polish
+- Vocal forward
+- Sometimes incorporates traditional instruments for cultural touch
+- Russian / Turkish production influences
+- Hybrid East-West
+
+## Vocal style
+
+- Often emotional / melismatic
+- Influenced by mugham tradition (ornaments)
+- Wide range expected
+- Both genders prominent
+
+## Lyrics direction
+
+- Love (passionate)
+- Heartbreak
+- Cultural pride
+- Modern life
+- Specific Azerbaijani references (places, foods, traditions)
+- Often poetic
+
+## For Suno
+
+```
+[Style: modern Azerbaijani pop, 110 BPM, F minor, drum machine + synth 
+pads + bass + electric piano + occasional tar accent + female alto vocal 
+in Azerbaijani language with melismatic ornamentation hinting at mugham 
+tradition + male backing harmonies, polished production with cultural 
+authenticity]
+```
+
+## Examples
+
+- **Aygün Kazımova** — pop icon, multiple decades
+- **Brilliant Dadaşova** — classic Azerbaijani pop
+- **Roya Ayxan** — international success
+- **Eldar Qasımov + Nigar Camal** — Eurovision 2011 winners
+- **Sevda Yahyayeva** — modern pop
+- **Aygün Beyler** — singer-songwriter
+- **Tofiq Quliyev** — composer (classic)
+
+## Sub-types
+
+### Pop ballad
+- Slower, emotional
+- Often about love
+
+### Pop dance
+- Faster, danceable
+- Modern Eurovision style
+
+### Pop folk fusion
+- Pop with traditional instruments
+- Cultural pride emphasized
+
+### Pop romantic
+- Duets common
+- Wedding music adjacent
+
+## Avoid
+
+- Generic Western pop (loses cultural identity)
+- Pure mugham (too traditional for pop)
+- English-only lyrics (Azerbaijani primary)
+- Heavy distortion
+- Aggressive production