@azerogluemin/ai-bootstrap 0.2.1

package/templates/skills/composer/knowledge/genres/persian-classical.md

@@ -0,0 +1,104 @@
+# Persian Classical — Genre 🇮🇷
+
+> Iranian classical music. Dastgah modal system. Sufi tradition. Highly ornamented.
+
+## Defining elements
+
+- Dastgah system (12 main modes — similar to mugham)
+- Improvisational ornamentation
+- Vocal central (often)
+- Microtonal intervals
+- Free time often (rubato)
+- Sufi / mystical content
+
+## The dastgahs (12 main modes)
+
+1. **Shur** — melancholic (most common)
+2. **Mahur** — joyful
+3. **Homayoun** — philosophical
+4. **Segah** — emotional
+5. **Chahargah** — dramatic
+6. **Nava** — peaceful
+7. **Rast-Panjgah** — celebratory
+And 5 derived (avaz) modes.
+
+Note: Many overlap with Azerbaijani mugham (Şur, Segah, Çahargah common to both).
+
+## Typical instrumentation
+
+- **Tar** — long-necked lute (also in Azerbaijani tradition)
+- **Setar** — smaller lute
+- **Santur** — hammered dulcimer
+- **Kamancheh** — bowed string (also Azerbaijani)
+- **Ney** — flute (Sufi tradition)
+- **Tombak** — Persian drum
+- **Daf** — frame drum
+- Vocal — solo with extensive ornamentation
+
+## Vocal style
+
+- Highly ornamented (tahrir — vocal trills)
+- Microtonal pitch bends
+- Long sustained emotional notes
+- Mystical / spiritual delivery
+- Master-apprentice tradition (radif system)
+
+## Lyrics tradition
+
+- Classical Persian poetry: Hafez, Rumi, Saadi, Omar Khayyam
+- Sufi mystical themes
+- Wine, the beloved (often divine metaphor)
+- Nightingale and rose imagery
+- Divine love
+
+## Production characteristics
+
+- Acoustic recording
+- Minimal processing
+- Concert hall or traditional setting
+- Live performance feel
+
+## For Suno
+
+```
+[Style: traditional Persian classical, free rhythm (rubato), Shur dastgah, 
+tar + setar + santur + ney + tombak with male vocal in Persian classical 
+style with extensive ornamentation (tahrir) and microtonal bends, sung in 
+Persian language, mystical Sufi atmosphere, traditional acoustic ensemble]
+```
+
+## Examples (masters)
+
+- **Mohammad Reza Shajarian** — global master
+- **Hossein Alizadeh** — modern composer
+- **Kayhan Kalhor** — kamancheh master
+- **Shahram Nazeri** — Sufi master
+- **Mohammad-Reza Lotfi** — tar master
+
+## Modern fusion
+
+- Persian classical + jazz
+- Persian classical + cinematic
+- Examples: Kayhan Kalhor + Yo-Yo Ma collaborations
+
+## Connection to Azerbaijani mugham
+
+Both share:
+- Modal system (dastgah / mugham)
+- Some same modes (Shur/Şur, Segah, Çahargah)
+- Tar + kamancheh instruments
+- Vocal ornamentation tradition
+
+Differences:
+- Persian uses Persian language
+- Azerbaijani uses Azerbaijani
+- Slight melodic variations
+- Different cultural contexts
+
+## Avoid
+
+- 4-on-the-floor beat
+- Auto-tune
+- Western chord progressions
+- Generic "Eastern" feel
+- Mixing with Arabic music (Persian classical is distinct)

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

@@ -0,0 +1,60 @@
+# Pop — Genre
+
+> Mainstream popular music. Hook-driven, accessible, radio-friendly.
+
+## Defining elements
+
+- Catchy hooks (chorus memorable on first listen)
+- 3-4 minute songs
+- Verse-chorus-verse structure
+- Mid tempo (95-130 BPM typical)
+- Major key dominant
+- Wide audience appeal
+
+## Sub-types
+
+- **Pop rock** — pop with rock instruments (Taylor Swift, Coldplay)
+- **Synthpop** — synth-driven (The Weeknd, Carly Rae Jepsen)
+- **Electropop** — electronic + pop (Lady Gaga, Robyn)
+- **Dance pop** — danceable (Dua Lipa, Madonna)
+- **Indie pop** — alternative leaning (Lorde, Billie Eilish)
+- **Adult contemporary** — softer (John Mayer, Sara Bareilles)
+
+## Typical instrumentation
+
+Drums + bass + electric guitar + keys/synths + lead vocals + backing harmonies
+
+## Production characteristics
+
+- Polished mix
+- Vocal forward
+- Strong hook in chorus
+- Build-up and drop dynamics
+- Modern compression / loudness
+
+## Lyrics direction
+
+- Universal themes (love, loss, empowerment)
+- Personal but relatable
+- Singable phrases
+- Hook repetition
+
+## For Suno
+
+```
+[Style: modern pop, 110 BPM, A major, drums + bass + electric guitar + 
+synth pads + female mezzo lead with stacked harmonies, polished radio-
+friendly production, big chorus]
+```
+
+## Examples
+
+- Taylor Swift, The Weeknd, Dua Lipa, Billie Eilish, Harry Styles
+- Azerbaijani: Aygün Kazımova, Roya, Brilliant Dadaşova
+
+## Avoid
+
+- Overly complex structure
+- Inaccessible vocals
+- Too long (>4 min)
+- Generic emotion

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

@@ -0,0 +1,65 @@
+# Reggae — Genre
+
+> Jamaican-origin music. Off-beat rhythm, social messages, distinctive groove.
+
+## Defining elements
+
+- Off-beat (skank) rhythm on guitar
+- Bass line prominent (often melodic)
+- Drums with distinctive pattern (rim shots, etc.)
+- 4/4 time
+- Mid tempo (70-90 BPM)
+- Jamaican English / patois
+
+## Sub-types
+
+- **Roots reggae** — classic (Bob Marley, Burning Spear)
+- **Dub** — instrumental remix (King Tubby, Lee "Scratch" Perry)
+- **Dancehall** — modern faster (Sean Paul, Vybz Kartel)
+- **Lovers rock** — romantic (Maxi Priest, Janet Kay)
+- **Reggaeton** — Latin reggae fusion (Bad Bunny, J Balvin)
+- **Nyabinghi** — drumming + chanting (Rastafarian)
+
+## Typical instrumentation
+
+Drums (Jamaican style) + bass (melodic) + electric guitar (skanking off-beat) + organ (Hammond) + horns + vocal
+
+## Production characteristics
+
+- Bass forward (felt physically)
+- Off-beat guitar essential
+- Lots of reverb / delay (especially dub)
+- Vintage analog gear
+- Live band feel
+
+## Lyrics direction
+
+- Social justice
+- Rastafarian themes (Roots)
+- Love (Lovers rock)
+- Party (Dancehall)
+- Spiritual / Jah
+- Specific Jamaican references
+
+## For Suno
+
+```
+[Style: classic roots reggae, 75 BPM, A minor, off-beat skanking electric 
+guitar + melodic bass line forward + reggae drums with rim shots + Hammond 
+organ + male vocal Jamaican accent, vintage warm production, social/
+spiritual message]
+```
+
+## Examples
+
+- Bob Marley (icon), Peter Tosh, Burning Spear, Toots and the Maytals
+- Modern: Damian Marley, Chronixx, Protoje
+- Dancehall: Sean Paul, Shaggy, Beenie Man
+
+## Avoid
+
+- 4-on-the-floor kick
+- Heavy distortion
+- Synth-only production
+- Wrong rhythm (must be off-beat)
+- Generic vocals (Jamaican feel essential)

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

@@ -0,0 +1,62 @@
+# R&B (Rhythm and Blues) — Genre
+
+> Soulful vocal music. Emotional, sensual, smooth. Modern R&B incorporates hip-hop production.
+
+## Defining elements
+
+- Vocal-focused (often lead with melismatic singing)
+- Smooth grooves
+- Mid tempo (70-100 BPM)
+- Major and minor with 7th chords
+- Sensual / emotional content
+- Production polish
+
+## Sub-types
+
+- **Classic R&B** — 60s-80s (Stevie Wonder, Marvin Gaye)
+- **Contemporary R&B** — 90s-2000s (Usher, Beyoncé)
+- **Alt R&B / PBR&B** — modern atmospheric (Frank Ocean, The Weeknd)
+- **Neo-soul** — 90s revival (D'Angelo, Erykah Badu)
+- **R&B-trap fusion** — modern (Bryson Tiller)
+
+## Typical instrumentation
+
+Electric piano (Rhodes, Wurlitzer) + bass (often funky) + drums (programmed or live) + lead vocal + harmonies + occasional strings/horns
+
+## Production characteristics
+
+- Vocal forward
+- Reverb on vocals
+- Bass groove essential
+- Smooth (not aggressive)
+- Modern: more synthetic
+- Classic: more live instruments
+
+## Lyrics direction
+
+- Love (modern interpretations)
+- Sensuality
+- Heartbreak / longing
+- Vulnerability
+- Specific romantic moments
+- Sometimes social commentary
+
+## For Suno
+
+```
+[Style: contemporary R&B, 85 BPM, F# minor, electric piano + bass + 
+soft drums + atmospheric synth pads + male falsetto lead vocal with 
+melismatic phrasing + female backing harmonies, smooth and sensual]
+```
+
+## Examples
+
+- Frank Ocean, The Weeknd, SZA, H.E.R., Daniel Caesar
+- Classic: Stevie Wonder, Marvin Gaye, Aretha Franklin
+
+## Avoid
+
+- Aggressive distortion
+- Fast tempo
+- Generic emotion
+- Lifeless vocal

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

@@ -0,0 +1,61 @@
+# Rock — Genre
+
+> Guitar-driven music with energy and attitude. Wide spectrum from soft to hard.
+
+## Defining elements
+
+- Electric guitar central
+- Drums + bass foundation
+- Distortion (variable amount)
+- 4/4 time signature mostly
+- Power chord progressions
+- Vocal range: melodic to gritty
+
+## Sub-types
+
+- **Classic rock** — 60s-70s (Led Zeppelin, Queen)
+- **Hard rock** — heavier (AC/DC, Aerosmith)
+- **Alternative rock** — 90s+ (Foo Fighters, Nirvana)
+- **Modern rock** — 2000s+ (Imagine Dragons, Twenty One Pilots)
+- **Soft rock** — gentler (Fleetwood Mac, Eagles)
+- **Progressive rock** — complex (Pink Floyd, Yes)
+- **Garage rock** — raw (The White Stripes)
+
+## Typical instrumentation
+
+Lead electric guitar + rhythm electric guitar + bass + drums + lead vocal
+
+## Production characteristics
+
+- Guitar tones essential (clean to distorted)
+- Drums prominent
+- Vocal often double-tracked
+- Compression on drums and vocals
+
+## Lyrics direction
+
+- Rebellion, freedom
+- Love (often passionate)
+- Social commentary
+- Personal struggle / triumph
+- Storytelling
+
+## For Suno
+
+```
+[Style: modern rock, 120 BPM, E major, distorted electric guitars + 
+bass + drums + male tenor vocals powerful, anthemic chorus with 
+harmonies, energetic and driving]
+```
+
+## Examples
+
+- Foo Fighters, Imagine Dragons, Royal Blood, Arctic Monkeys
+- Classic: Queen, Led Zeppelin, The Rolling Stones
+
+## Avoid
+
+- No guitars (defeats genre)
+- Auto-tune
+- Electronic-only production
+- Whisper vocals throughout

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

@@ -0,0 +1,63 @@
+# Soul — Genre
+
+> Emotional vocal music. African-American gospel + R&B roots. Powerful, expressive.
+
+## Defining elements
+
+- Powerful vocals (often gospel-influenced)
+- Mid tempo (75-110 BPM)
+- Major and minor with 7th chords
+- Live instrumentation traditionally
+- Emotional delivery
+- Call-and-response often
+
+## Sub-types
+
+- **Classic soul** — 60s-70s (Aretha Franklin, Otis Redding, Stax)
+- **Motown** — Detroit sound (Stevie Wonder, Marvin Gaye)
+- **Northern soul** — UK collector culture
+- **Neo-soul** — 90s revival (D'Angelo, Erykah Badu, Lauryn Hill)
+- **Modern soul** — current (Adele, Sam Smith, Leon Bridges)
+
+## Typical instrumentation
+
+Hammond organ + electric piano + bass (rich) + drums + horns + lead vocal + backing vocals
+
+## Production characteristics
+
+- Live band feel
+- Hammond organ signature
+- Brass section accents
+- Vocal at center
+- Compression but warm
+- Vintage equipment often
+
+## Lyrics direction
+
+- Love (deeply expressed)
+- Heartbreak (deeply felt)
+- Faith
+- Empowerment
+- Social justice (Marvin Gaye "What's Going On")
+- Vulnerability + power
+
+## For Suno
+
+```
+[Style: classic soul, 90 BPM, Bb major with 7th chords, Hammond organ + 
+electric piano + bass + drums + horn section + female alto lead vocal 
+powerful with melisma + male backing harmonies, vintage warm production]
+```
+
+## Examples
+
+- Aretha Franklin, Otis Redding, Sam Cooke, Marvin Gaye
+- Modern: Adele, Sam Smith, Leon Bridges, Brittany Howard
+
+## Avoid
+
+- Auto-tune
+- Synthetic instruments dominant
+- Whisper vocals
+- Lifeless delivery
+- Cold modern production

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

@@ -0,0 +1,92 @@
+# Symphonic Mugham — Genre 🇦🇿
+
+> The official Azerbaijani national orchestral classical genre. Founded by Fikrət Əmirov in 1948. Internationally recognized.
+
+## What it IS
+
+Symphonic Mugham (Azerbaijani: *Simfonik muğam*) is a single-movement symphonic suite that combines **traditional Azerbaijani mugham modal structure** with **Western symphonic form**. It is NOT a fusion or experiment — it is an established classical genre with a 75+ year tradition, performed worldwide by major orchestras.
+
+## What it ISN'T (Suno disambiguation)
+
+- ❌ Middle Eastern / Arabic music
+- ❌ Persian classical
+- ❌ Sufi / religious vocalise
+- ❌ Generic "world music" fusion
+- ❌ Chinese erhu / Indian raga (Suno's common misreads)
+
+## Founding works (use as Suno reference anchors)
+
+1. **Fikrət Əmirov — "Şur" simfonik muğamı (1948)** — the founding work
+2. **Fikrət Əmirov — "Kürd Ovşarı" simfonik muğamı (1948)** — second founding work
+3. **Fikrət Əmirov — "Gülüstan Bayatı-Şiraz" (1968)**
+4. **Niyazi — "Rast" simfonik muğamı** — world-repertoire piece
+5. **Tofiq Bakıxanov** — several works in this style
+6. **Üzeyir Hacıbəyli — "Koroğlu" uvertürası (1937)** — proto-symphonic mugham (predates the genre name); became unofficial anthem of AZ independence movement in late 1980s
+
+## International credibility
+
+- **Leopold Stokowski** conducted Əmirov's "Kürd Ovşarı" with Houston Symphony, March 16, 1959
+- Niyazi's "Rast" is in repertoire of major world orchestras
+- Recorded by Moscow Symphony Orchestra under Antonio De Almeida (ASV Ltd. 1998)
+
+## Defining elements
+
+- **Tam Qərb simfonik orkestri** (full Western symphony orchestra) — strings, brass, woodwinds, percussion
+- **+ Azerbaijani folk instruments integrated:**
+  - **Tar** (long-necked lute) — melodic lead
+  - **Kamancha** (spike fiddle) — answering/lyric lines
+  - **Gaval / Qaval** (frame drum) — pulse and accents
+  - Optional: **Balaban** (double reed), **Zurna** (loud double reed)
+- **Mugham modal structure** (one of 7 main modes — Şur, Rast, Segah, Çahargah, Bayatı-Şiraz, Şüştər, Humayun)
+- **Single-movement symphonic suite form**
+- **Alternating sections:** improvisational (mugham proper) + composed metric (təsnif) + dance (rəng)
+- Heroic brass and percussion underscoring dramatic motifs
+
+## The 7 mughams — emotional usage map
+
+| Mugham | Mood | Best for |
+|---|---|---|
+| Rast | Joyful, celebratory, "father of mughams" | Triumph, national pride, victory |
+| **Şur** | **Melancholic, contemplative, deeply dramatic** | **Historical drama, grief + hope, national epic** ← most films |
+| Segah | Tragic, deeply emotional | Loss, lament, devastation |
+| Çahargah | Dramatic, fiery | Conflict, climax, action |
+| Bayatı-Şiraz | Sad, longing | Nostalgia, exile, separation |
+| Şüştər | Peaceful, contemplative | Reflection, intimate moments |
+| Humayun | Philosophical, profound | Meditation, deep thought |
+
+## Suno prompt tag formula
+
+```
+symphonic mugham, Azerbaijani national orchestral epic, in the style of 
+Fikret Amirov Shur and Kurd Ovshari symphonic mughams 1948 and Niyazi 
+Rast symphonic mugham and Uzeyir Hajibeyov Koroglu overture, single-
+movement symphonic suite, full Western symphony orchestra augmented with 
+Azerbaijani tar long-necked lute and kamancha spike fiddle and gaval 
+frame drum integrated in ensemble, mugham modal melodies in Western 
+symphonic framework, heroic brass and percussion, alternating 
+improvisational and rhythmical sections, instrumental no vocals no 
+choir, [BPM] building dynamically, authentic Azerbaijani genre founded 
+by Amirov 1948 performed by Leopold Stokowski Houston Symphony 1959, 
+NOT generic Middle Eastern NOT Arabic NOT Chinese NOT Hollywood
+```
+
+## Reality check — Suno limitations
+
+Even with this formula, Suno may not reliably produce authentic symphonic mugham — the model's training data on Azerbaijani classical music is limited. Always offer the user a **fallback Plan B**: use real recordings of these works (Hacıbəyli Koroğlu overture is in Public Domain since 2018; others may need fair-use justification for diaspora community events).
+
+## Public Domain / licensing status (as of 2026)
+
+| Composer | Death | PD status |
+|---|---|---|
+| Üzeyir Hacıbəyli | 1948 | ✅ PD since 2018 (AZ + EU + most jurisdictions) |
+| Fikrət Əmirov | 1984 | ⚠️ © until 2054 |
+| Niyazi | 1984 | ⚠️ © until 2054 |
+| Qara Qarayev | 1982 | ⚠️ © until 2052 |
+| Vasif Adıgözəlov | 2006 | ⚠️ © until 2076 |
+| AZ Dövlət Himni (anthem) | Hacıbəyli 1919 | ✅ PD; state work, attribution required |
+
+## Cross-references
+
+- `azerbaijani-mugham.md` — the traditional non-symphonic ancestor genre
+- `orchestral.md` — the Western host genre
+- `film-score.md` — for documentary applications

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

@@ -0,0 +1,63 @@
+# Techno — Genre
+
+> Detroit-origin electronic music. Mechanical, futuristic, hypnotic.
+
+## Defining elements
+
+- 4-on-the-floor kick (often more aggressive than house)
+- 125-150 BPM (some genres faster)
+- Repetitive, hypnotic
+- Synth-heavy
+- Less vocal than house
+- Industrial / mechanical feel
+
+## Sub-types
+
+- **Detroit techno** — origins (Juan Atkins, Derrick May)
+- **Berlin techno** — minimal, dark (Ben Klock, Marcel Dettmann)
+- **Acid techno** — TB-303 squelch
+- **Industrial techno** — harsh (Surgeon, Perc)
+- **Melodic techno** — accessible (Stephan Bodzin, Tale of Us)
+- **Hard techno** — aggressive 140+ BPM
+- **Minimal techno** — sparse (Richie Hawtin)
+
+## Typical instrumentation
+
+Drum machine (TR-909 / TR-808) + synth bass + lead synth + atmospheric pads + occasional vocal samples
+
+## Production characteristics
+
+- Strong kick prominent
+- Repetition with subtle variation
+- Heavy reverb on synths
+- Industrial sound design
+- Long mixes (8-15 min DJ-style)
+
+## Lyrics direction (when vocal)
+
+- Often spoken word / robotic
+- Repetitive phrases
+- Often no vocals at all
+- Sound design over melody
+
+## For Suno
+
+```
+[Style: minimal techno, 130 BPM, A minor, hard kick drum + synth bass 
+loop + sparse percussion + reverb-heavy synth stab + occasional vocal 
+sample, hypnotic and mechanical, dark industrial atmosphere]
+```
+
+## Examples
+
+- Detroit pioneers: Juan Atkins, Derrick May, Carl Craig
+- Berlin: Ben Klock, Marcel Dettmann, Len Faki
+- Modern: Charlotte de Witte, Amelie Lens, ANNA
+
+## Avoid
+
+- Live instruments
+- Vocal-heavy structure
+- Pop song format
+- Bright major keys
+- Acoustic feel

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

@@ -0,0 +1,61 @@
+# Trap — Genre
+
+> Modern southern hip-hop subgenre. 808s, hi-hats, atmospheric.
+
+## Defining elements
+
+- 808 sub-bass + drum machine
+- Rapid hi-hats (often triplet rolls)
+- Mid-tempo (130-150 BPM with doubled feel)
+- Atmospheric synths / pads
+- Auto-tune singing common
+- 4/4 time
+
+## Sub-types
+
+- **Atlanta trap** — origin (Future, Migos, Young Thug)
+- **Pop trap** — radio-friendly (Travis Scott, Post Malone)
+- **Drill trap** — aggressive (Pop Smoke)
+- **Cloud trap** — atmospheric (Travis Scott, Drake)
+- **Latin trap** — Spanish (Bad Bunny, Anuel AA)
+
+## Typical instrumentation
+
+808 sub-bass + drum machine (kick, snare, hi-hats) + atmospheric synth pads + vocal (rap or sung)
+
+## Production characteristics
+
+- 808 prominent (felt physically)
+- Hi-hat rolls (16th notes, 32nd notes)
+- Reverb-heavy atmosphere
+- Auto-tune on vocals
+- Sparse arrangement
+
+## Lyrics direction
+
+- Lifestyle, success
+- Specific brands
+- Romance / heartbreak (modern trap)
+- Repetitive hooks
+- Often less narrative than classic rap
+- Flow over deep lyrics
+
+## For Suno
+
+```
+[Style: modern trap, 140 BPM (with doubled hi-hat feel), G minor, 
+808 sub bass + drum machine + rapid hi-hat rolls + atmospheric synth pad + 
+male auto-tuned vocals, dark atmosphere]
+```
+
+## Examples
+
+- Travis Scott, Future, Drake, Post Malone, Lil Baby
+- Pioneers: Gucci Mane, Young Jeezy
+
+## Avoid
+
+- Live drums (use programmed)
+- No 808 (defeats genre)
+- Bright major key
+- Live instrumentation throughout