@azerogluemin/ai-bootstrap 0.2.1

package/templates/skills/composer/knowledge/genres/turkish-arabesque.md

@@ -0,0 +1,87 @@
+# Turkish Arabesque (Arabesk) — Genre 🇹🇷
+
+> Turkish popular music with Arabic and Turkish folk influences. Emotional, melancholic, dramatic.
+
+## Defining elements
+
+- Heavy emotional content (melancholy, suffering)
+- Arabic-influenced melodies (microtonal sometimes)
+- Turkish folk + Arabic + Western pop fusion
+- Strings prominent (often saz + Western strings)
+- Dramatic vocal delivery
+- Slow to mid tempo
+
+## History
+
+Emerged in Turkey 1960s-70s. Originally working-class music. Rural-to-urban migration brought rural emotional expression to city pop. Mass appeal across Turkish-speaking world. Influence on Azerbaijani modern music.
+
+## Sub-types
+
+- **Classic arabesk** — Orhan Gencebay (founder), Ferdi Tayfur
+- **Modern arabesk** — Ibrahim Tatlıses (icon)
+- **Arabesk-fantezi** — fusion
+- **Modern arabesk-pop** — Mahsun Kırmızıgül
+
+## Typical instrumentation
+
+- Bağlama (saz) — Turkish long-necked lute
+- Strings (Western orchestra)
+- Oud
+- Darbuka (Middle Eastern drum)
+- Synth (modern)
+- Vocal (highly emotional)
+
+## Production characteristics
+
+- Lush strings often
+- Vocal forward and dramatic
+- Mix of acoustic + electronic
+- Modern polish
+- Reverb on vocals
+
+## Vocal style
+
+- Highly emotional
+- Sustained dramatic notes
+- Melismatic ornamentation
+- Often male tenor / baritone
+- Sob in voice characteristic
+
+## Lyrics direction
+
+- Suffering, fate
+- Love and loss (intense)
+- Working class struggles
+- "Kara sevda" (dark love)
+- Fate, kismet
+- Tragic narratives
+- Cultural specificity (Turkish village to city)
+
+## For Suno
+
+```
+[Style: Turkish arabesk, 80 BPM, A minor with microtonal touches, 
+bağlama (saz) + Western string section + darbuka percussion + male tenor 
+vocal Turkish language highly emotional with sustained melismatic notes, 
+dramatic atmosphere, slow build to emotional climax]
+```
+
+## Examples
+
+- **Orhan Gencebay** — founder of arabesk
+- **İbrahim Tatlıses** — most famous arabesk singer
+- **Müslüm Gürses** — known as "Müslüm Baba"
+- **Ferdi Tayfur** — classic
+- **Mahsun Kırmızıgül** — modern crossover
+
+## Influence
+
+Arabesk influenced Azerbaijani pop heavily — especially the emotional vocal delivery and lyrical themes.
+
+## Avoid
+
+- Happy / upbeat vibe (arabesk is melancholic)
+- Major keys typically
+- Fast tempo
+- Cold modern production
+- Generic Middle Eastern (must be specifically Turkish)

package/templates/skills/composer/knowledge/genres/world-music.md

@@ -0,0 +1,84 @@
+# World Music — Genre
+
+> Music from non-Western traditions, or fusion thereof. Catch-all category.
+
+## Defining elements
+
+- Non-Western or hybrid origins
+- Traditional instruments often
+- Cultural specificity
+- Variable structure (not Western pop format)
+- Often modal / non-major-minor
+
+## Major regional traditions
+
+### African
+- West African (Fela Kuti, Tinariwen)
+- South African (Ladysmith Black Mambazo)
+- Modern: Afrobeats (see afrobeats.md)
+
+### Latin American
+- Cuban (Buena Vista Social Club)
+- Brazilian (Caetano Veloso, Bossa Nova)
+- Mexican (mariachi, ranchera)
+
+### Middle Eastern
+- Arab classical (Umm Kulthum)
+- Sufi (Nusrat Fateh Ali Khan)
+- Azerbaijani mugham (see azerbaijani-mugham.md)
+- Turkish arabesque (see turkish-arabesque.md)
+
+### Asian
+- Indian classical (Ravi Shankar, Anoushka Shankar)
+- Chinese traditional
+- Japanese traditional + modern
+- Korean (gugak + K-pop)
+
+### European folk
+- Celtic (The Chieftains, Loreena McKennitt)
+- Balkan (Goran Bregović)
+- Spanish flamenco (Paco de Lucía)
+
+## Typical instrumentation (varies by tradition)
+
+- African: djembe, talking drum, kora
+- Latin: guitar, percussion, accordion
+- Middle Eastern: oud, qanun, ney, daf
+- Asian: sitar, tabla, shakuhachi, koto
+- Celtic: fiddle, bodhrán, tin whistle, bagpipes
+
+## Production characteristics
+
+- Acoustic instruments often
+- Live ensemble
+- Less Western production processing
+- Cultural authenticity matters
+
+## For Suno
+
+Specify tradition explicitly:
+```
+[Style: traditional Indian classical, 80 BPM (rubato), Raga Yaman, 
+sitar + tabla + tanpura drone + male vocal in classical Indian style, 
+acoustic ensemble, meditative]
+```
+
+## Examples
+
+- Fela Kuti, Caetano Veloso, Ravi Shankar, Umm Kulthum
+- Modern fusion: Anoushka Shankar, Ibrahim Maalouf
+
+## Cultural respect
+
+Always:
+- Research authenticity
+- Don't appropriate
+- Credit tradition
+- Hire cultural consultants for serious work
+
+## Avoid
+
+- Stereotyping (all "Eastern" same)
+- Western beat under non-Western melody
+- Wrong instruments for tradition
+- Cultural appropriation

package/templates/skills/composer/knowledge/harmony-basics.md

@@ -0,0 +1,105 @@
+# Harmony Basics — Music Knowledge
+
+> Chord theory simplified for songwriting and prompt engineering.
+
+## What is harmony
+
+Harmony = multiple notes played simultaneously. Chord = 3+ notes together.
+
+## Chord types
+
+### Major
+Bright, happy, stable. C-E-G in C major.
+
+### Minor
+Sad, melancholic, introspective. C-Eb-G in C minor.
+
+### 7th chords
+Add tension. Common in jazz, R&B, soul.
+- Major 7 (e.g., Cmaj7) — dreamy, jazzy
+- Minor 7 (e.g., Cm7) — soulful, mellow
+- Dominant 7 (e.g., C7) — bluesy, tense
+
+### Suspended (sus)
+Floating, unresolved. Often resolves to major.
+
+### Augmented / Diminished
+Tense, unstable. Used for dramatic moments.
+
+## Diatonic chords (in a key)
+
+In C major:
+- I = C major (tonic, home)
+- ii = D minor
+- iii = E minor
+- IV = F major (subdominant, lift)
+- V = G major (dominant, tension)
+- vi = A minor (relative minor, sad)
+- vii° = B diminished (rare)
+
+## Common progressions
+
+### I-V-vi-IV (the "magic" progression)
+Used in countless pop hits.
+Examples: "Let It Be", "Don't Stop Believin'", "With or Without You"
+
+### vi-IV-I-V
+Same chords, reordered. Sadder opening.
+
+### I-IV-V (blues, rock)
+Three-chord foundation.
+
+### ii-V-I (jazz)
+Walking through key.
+
+### Andalusian (i-VII-VI-V in minor)
+Spanish/Middle Eastern feel.
+
+## Key choice = mood
+
+| Key | Common mood |
+|-----|-------------|
+| C major | Pure, simple, happy |
+| G major | Open, hopeful |
+| D major | Triumphant, bright |
+| A major | Joyful, energetic |
+| F major | Pastoral, calm |
+| Bb major | Warm, romantic |
+| C minor | Tragic, dark |
+| A minor | Melancholic, contemplative |
+| E minor | Sad, longing |
+| F minor | Deeply sad, mournful |
+| D minor | Serious, tragic |
+
+(See key-signature-mood.md for full guide.)
+
+## Chord substitutions (advanced)
+
+### Borrowed chords
+Borrow from parallel mode. C major borrowing iv (Fm) for color.
+
+### Secondary dominants
+Use V/V (D major in C key) to set up V (G).
+
+### Chromatic mediants
+Unrelated keys juxtaposed for surprise.
+
+## For AI music (Suno)
+
+Specify chord progression in prompt if you want specific:
+```
+[Style: indie folk, key F minor, chord progression Fm-Db-Ab-Eb]
+```
+
+Or just specify mood + genre and Suno picks appropriate harmony:
+```
+[Style: melancholic indie folk, F minor]
+```
+
+## Common harmony mistakes
+
+- Always same progression
+- Wrong key for vocal range
+- No progression (just one chord)
+- Too complex (overwhelming for genre)
+- Bridge same chords as verse (no contrast)

package/templates/skills/composer/knowledge/instrumentation-guide.md

@@ -0,0 +1,145 @@
+# Instrumentation Guide — Music Knowledge
+
+> Choosing the right instruments for genre, mood, and section.
+
+## Instrument families
+
+### Strings
+- Acoustic guitar — folk, pop, intimate
+- Electric guitar — rock, pop, punk
+- Bass guitar — pop, rock, funk, R&B
+- Violin (solo) — classical, folk, melancholic
+- Cello (solo) — emotional, deep
+- Strings section (ensemble) — cinematic, dramatic
+- Harp — ethereal, magical
+- Lokal: Tar, Kamancha, Saz (Azerbaijani classical)
+
+### Keyboards
+- Piano — versatile, emotional
+- Electric piano (Rhodes, Wurlitzer) — soul, R&B, jazz
+- Synth bass — electronic, pop
+- Synth lead — electronic, EDM
+- Synth pad — ambient, atmosphere
+- Organ (Hammond) — soul, gospel, rock
+- Harpsichord — baroque, period
+
+### Percussion
+- Acoustic drums — rock, jazz, folk
+- Drum machine (808) — hip-hop, trap, R&B
+- Conga / bongo — Latin
+- Tabla — Indian, world
+- Lokal: Nagara, Daf (Azerbaijani/regional)
+- Cymbals (ride, crash, hi-hat) — variety
+- Tambourine — folk, pop
+
+### Wind
+- Flute — folk, classical, peaceful
+- Saxophone — jazz, smooth, sensual
+- Trumpet — jazz, energetic
+- Brass section — funk, soul, big band
+- Lokal: Balaban, Zurna (Azerbaijani)
+- Harmonica — blues, folk
+- Bagpipes — Celtic, distinctive
+
+### Vocal as instrument
+- Lead vocal
+- Background harmonies
+- Choir
+- Vocoder/auto-tune (modern)
+
+### Electronic / Synthesized
+- Synth bass
+- Synth lead
+- Synth pad
+- 808
+- Trap hi-hats
+- Wobble bass (dubstep)
+- Sample-based loops
+
+## Genre-specific instrumentation
+
+### Pop (modern)
+Drums + bass + electric guitar + piano/keys + vocal + synth pads
+
+### Indie folk
+Acoustic guitar + bass + light percussion + vocal + occasional violin/cello
+
+### Hip-hop / trap
+808 + drum machine + sample/synth + vocal + ad-libs
+
+### R&B
+Electric piano + bass + drums + vocal + string pads
+
+### Rock
+Electric guitar + bass + drums + vocal + lead guitar
+
+### Electronic / EDM
+Synth bass + drum machine + synth lead + vocal sample + pad
+
+### Cinematic / film score
+Strings ensemble + piano + percussion + brass
+
+### Folk (acoustic)
+Acoustic guitar + vocal + occasional bass / fiddle / mandolin
+
+### Azerbaijani classical (mugham)
+Tar + Kamancha + Daf + Vocal (solo)
+
+### Reggae
+Drums (rim shots) + bass + electric guitar (skanks) + organ + vocal
+
+## Choosing instruments by mood
+
+### Melancholic
+- Piano
+- Cello
+- Acoustic guitar (fingerpicked)
+- Soft strings
+- Whisper vocals
+
+### Energetic
+- Drums (rock)
+- Electric guitar
+- Synth bass
+- Driving rhythm
+
+### Romantic
+- Piano
+- Strings
+- Soft acoustic guitar
+- Flute
+- Smooth vocals
+
+### Mysterious
+- Synth pads
+- Distant strings
+- Sparse percussion
+- Whisper or low vocal
+
+### Triumphant
+- Brass section
+- Full strings
+- Heavy drums
+- Choir
+
+## For AI music (Suno)
+
+List instruments in prompt:
+```
+[Instruments: acoustic guitar, soft piano, light strings, gentle percussion]
+```
+
+Or per section:
+```
+[Verse: piano + soft strings]
+[Chorus: full band — drums, electric guitar, bass, harmonies]
+[Bridge: solo cello]
+```
+
+## Common instrumentation mistakes
+
+- Wrong instrument for genre
+- Too many instruments (cluttered)
+- Same instruments throughout (boring)
+- Featured instrument disappears mid-song
+- Cultural mismatches (e.g., distorted electric guitar in Azerbaijani classical)

package/templates/skills/composer/knowledge/instruments/808.md

@@ -0,0 +1,59 @@
+# 808 (Sub-Bass) — Instrument
+
+> Iconic sub-bass sound from Roland TR-808 drum machine. Defines modern hip-hop and trap.
+
+## Type
+Synthesized sub-bass drum sound. Originally from Roland TR-808 (1980).
+
+## Sound character
+- Deep sub-frequencies (felt physically)
+- Long sustain possible
+- Slidable pitch (the "drill slide")
+- Boomy
+- Synthetic but iconic
+
+## Variations
+- **Boomy 808** — long sustain (modern trap)
+- **Punchy 808** — short attack (cleaner)
+- **Distorted 808** — saturated (modern trap)
+- **Sliding 808** — pitch bend (drill signature)
+
+## Playing styles
+### Modern trap
+- Sustained 808s (held for bars)
+- Sub-bass drone
+- Pitch slides
+
+### Drill
+- Sliding 808s (the drill bass slide)
+- Distinctive movement
+
+### Classic hip-hop
+- 808 kick on beat 1
+- Punchier shorter version
+
+## Genre fit
+- Hip-hop (modern)
+- Trap (essential)
+- Drill (sliding signature)
+- Modern R&B
+- Electronic / EDM
+- Modern pop (subtle)
+
+## Production notes
+- Sub-bass needs proper mix (subwoofer audible)
+- Layer with higher kick for click
+- Ducks under kick (sidechain) sometimes
+- Defining element of modern productions
+
+## For Suno
+```
+[808: boomy sub-bass, sustained notes, modern trap style]
+```
+
+```
+[808: sliding drill bass, pitch bends down on each note]
+```
+
+## When to use
+Modern hip-hop / trap / R&B. Essential for that "modern" sound. Avoid in acoustic / classical / folk genres.

package/templates/skills/composer/knowledge/instruments/acoustic-guitar.md

@@ -0,0 +1,46 @@
+# Acoustic Guitar — Instrument
+
+> Steel-string or nylon-string acoustic. Singer-songwriter standard. Folk foundation.
+
+## Type
+Acoustic chordophone. Plucked or strummed.
+
+## Range
+~3-4 octaves.
+
+## Sub-types
+- Steel-string (folk, country, pop)
+- Nylon string / classical (Spanish, classical)
+- Dreadnought (full body, loud)
+- Parlor guitar (smaller, intimate)
+- 12-string (lush, jangly)
+
+## Playing styles
+- Strummed chords (folk, pop)
+- Fingerpicked (intimate, melodic)
+- Hybrid picking
+- Slide (blues, country)
+- Travis picking (country)
+
+## Genre fit
+- Folk, indie folk
+- Country
+- Singer-songwriter
+- Pop ballads
+- Spanish / Latin (nylon string)
+- Acoustic rock
+
+## Mood pairings
+- Intimate, romantic, melancholic, peaceful, nostalgic
+
+## For Suno
+```
+[Acoustic guitar: fingerpicked steel-string, warm tone, intimate]
+```
+
+```
+[Acoustic guitar: strummed dreadnought, folk feel, drive]
+```
+
+## When to use
+Default instrument for intimate / folk / singer-songwriter contexts.

package/templates/skills/composer/knowledge/instruments/balaban.md

@@ -0,0 +1,74 @@
+# Balaban — Instrument 🇦🇿
+
+> Azerbaijani double-reed wind instrument. Soulful, melancholic. Folk tradition.
+
+## Type
+Double-reed cylindrical wind instrument.
+
+## Origin
+Azerbaijani / Caucasian / Central Asian. Similar to Armenian duduk and Turkish balaban.
+
+## Construction
+- Cylindrical body (apricot wood traditional)
+- Double reed
+- Finger holes
+- Limited range but expressive
+
+## Range
+~1 octave (limited but used melodically).
+
+## Sound character
+- Warm, soulful
+- Mournful capability
+- Vocal-like
+- Slow vibrato characteristic
+- Penetrating but not loud
+
+## Playing styles
+### Folk solo
+- Lament / lyrical melodies
+- Slow tempo
+- Long phrases
+
+### Ensemble
+- Folk ensemble
+- Wedding music
+- Cultural celebrations
+
+### Cinematic / dramatic
+- Sad film moments
+- Atmospheric
+
+## Genre fit
+- Azerbaijani folk (essential)
+- Caucasian folk
+- World music
+- Cinematic (sad moments — used in many film scores)
+- Modern fusion
+
+## Cultural significance
+- Often used at funerals (lament)
+- Wedding music (different mood)
+- Cultural identity instrument
+
+## Famous balaban players
+- Various traditional masters
+- Used by Hans Zimmer in film scores (atmospheric)
+
+## For Suno
+```
+[Balaban: Azerbaijani double-reed wind, mournful slow melody, vocal-like 
+expressive vibrato, traditional acoustic, soulful]
+```
+
+```
+[Balaban: cinematic sad moment, sustained emotional notes, atmospheric]
+```
+
+## When to use
+Azerbaijani folk contexts. Sad / mournful moments. Cultural authenticity. Cinematic Middle Eastern atmosphere.
+
+## Related instruments
+- **Duduk** (Armenian) — very similar, often substituted
+- **Mey** (Turkish) — related
+- **Suling** (Indonesian) — different but related family

package/templates/skills/composer/knowledge/instruments/bass.md

@@ -0,0 +1,50 @@
+# Bass — Instrument
+
+> Low-frequency foundation. Rhythm + harmony bridge. Essential for groove.
+
+## Type
+Bass guitar (electric) or upright (acoustic) or synth bass.
+
+## Range
+~2 octaves (typically).
+
+## Sub-types
+- Electric bass (most common modern)
+- Upright / double bass (jazz, classical, rockabilly)
+- Synth bass (electronic, pop)
+- Fretless bass (smooth slides)
+- 5-string / 6-string (extended low)
+
+## Playing styles
+- Root notes (simple holds)
+- Walking bass (jazz)
+- Slap and pop (funk)
+- Fingerstyle (most pop/rock)
+- Pick (punk, harder rock)
+- Sub-bass (electronic, modern)
+
+## Genre fit
+- Pop, rock (essential)
+- Jazz (upright walking bass)
+- Funk (slap bass essential)
+- R&B / Soul (groovy)
+- Electronic (synth bass / 808)
+- Hip-hop (808 sub-bass)
+
+## Sound character
+- Acoustic upright: warm, woody
+- Electric: depends on type/pickups
+- Synth bass: variable (sub, distorted, etc.)
+- 808: huge sub-bass (felt physically)
+
+## For Suno
+```
+[Bass: electric bass, fingerstyle groove, pocket]
+```
+
+```
+[Bass: 808 sub-bass, sliding modern hip-hop style]
+```
+
+## When to use
+Almost every modern song. Bass = backbone.

package/templates/skills/composer/knowledge/instruments/brass-section.md

@@ -0,0 +1,60 @@
+# Brass Section — Instrument
+
+> Multiple brass instruments together. Powerful, anthemic, orchestral or funk.
+
+## Type
+Section of brass instruments.
+
+## Standard composition
+- **Trumpets** (2-3) — high, bright
+- **French horns** (2-4) — middle, warm
+- **Trombones** (2-3) — middle-low
+- **Tuba** (1) — lowest
+
+## Section sizes
+- **Full orchestral**: 10-15 brass
+- **Big band**: 5 trumpets + 4 trombones
+- **Funk horn section**: 2-4 (trumpets + saxes + trombone)
+- **Mariachi**: 2 trumpets
+
+## Playing styles
+### Orchestral
+- Lush sustained chords
+- Heroic fanfares
+- Climactic moments
+- Sustained warmth
+
+### Big band
+- Jazz arrangements
+- Swing punches
+- Improvised solos
+
+### Funk / Soul
+- Tight rhythmic hits
+- Punctuating accents
+- "Stabs" on offbeats
+
+### Latin
+- Salsa montuno
+- Mariachi melodies
+
+## Genre fit
+- Orchestral (essential)
+- Jazz big band
+- Funk (essential — Tower of Power, Earth Wind & Fire)
+- Soul (Stax horn section)
+- Latin (salsa, mariachi)
+- Film score (heroic)
+
+## For Suno
+```
+[Brass section: trumpets + trombones + french horns, orchestral fanfare, 
+heroic and triumphant cinematic]
+```
+
+```
+[Brass section: tight funk horns, punchy accents, James Brown style]
+```
+
+## When to use
+Triumphant / heroic moments. Funk authenticity. Big band contexts. Climactic peaks.