@azerogluemin/ai-bootstrap 0.2.1

package/templates/skills/composer/knowledge/instruments/cello-solo.md

@@ -0,0 +1,53 @@
+# Cello (Solo) — Instrument
+
+> Solo cello. Deep, resonant, emotional. Often called "voice closest to human."
+
+## Type
+Bowed string instrument (low register).
+
+## Range
+C2 to A5+ (4+ octaves).
+
+## Playing styles
+- Lyrical melodies (singing line)
+- Deep bass lines (fundamental)
+- Pizzicato (plucked)
+- Double stops
+- Spiccato (bouncy bow)
+- Sul ponticello (eerie)
+
+## Sound character
+- Deep, warm
+- Rich overtones
+- Highly emotional
+- "Singing" quality
+- Can be tender or powerful
+
+## Genre fit
+- Classical (Bach Suites essential)
+- Film score (emotional core)
+- Indie folk (warm low end)
+- Pop ballads (cinematic)
+- Modern composition
+
+## Famous cellists
+- Pablo Casals (classical)
+- Yo-Yo Ma (modern classical)
+- Hauser (popular modern)
+- Cellists in pop: 2Cellos, Apocalyptica
+
+## Mood pairings
+- Melancholic, romantic, contemplative, somber, beautiful
+
+## For Suno
+```
+[Cello solo: warm deep melodic line, emotional sustained notes with vibrato, 
+classical style, intimate and contemplative]
+```
+
+```
+[Cello solo: pizzicato accompaniment, rhythmic indie folk style]
+```
+
+## When to use
+Emotional depth needed. Cinematic moments. Indie folk warmth. Replace bass occasionally with melodic lead.

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

@@ -0,0 +1,67 @@
+# Choir — Instrument
+
+> Multiple singers as ensemble. Powerful collective sound. Sacred or secular.
+
+## Type
+Vocal ensemble (typically 16-100+ singers).
+
+## Voice parts (SATB)
+- Soprano (highest female)
+- Alto (lower female)
+- Tenor (higher male)
+- Bass (lowest male)
+
+## Sub-types
+- Sacred choir (church, religious)
+- Secular choir (concert)
+- Gospel choir (call-and-response)
+- A cappella ensemble (no instruments)
+- Modern pop choir (background)
+
+## Sound character
+- Powerful when full
+- Lush harmonies
+- Layered voices
+- Reverb-friendly
+- Can be ethereal or grand
+
+## Playing styles
+### Sustained chordal
+- Whole notes
+- Choral pads
+- Background atmosphere
+
+### Active polyphonic
+- Multiple melodic lines
+- Counterpoint
+
+### Gospel-style
+- Call-and-response
+- Hand claps + body
+- Spirit-driven
+
+### Classical
+- Composed, refined
+- Wide dynamics
+
+## Genre fit
+- Classical / sacred (essential)
+- Gospel
+- Pop ballads (background lift)
+- Cinematic / film score
+- Modern pop (atmospheric)
+- Choral works (specifically)
+
+## For Suno
+```
+[Choir: SATB classical choir, sustained chords, sacred reverent atmosphere, 
+heavy concert hall reverb]
+```
+
+```
+[Choir: gospel choir with hand claps, joyful call-and-response, 
+energetic spiritual]
+```
+
+## When to use
+Cinematic peaks. Final chorus lift. Sacred / religious moments. Atmospheric ethereal moments. Gospel context.

package/templates/skills/composer/knowledge/instruments/drum-machine.md

@@ -0,0 +1,49 @@
+# Drum Machine — Instrument
+
+> Electronic drum sounds. Programmed beats. Hip-hop/electronic foundation.
+
+## Type
+Electronic percussion synthesizer / sampler.
+
+## Famous drum machines
+- **Roland TR-808** — iconic boomy kick (hip-hop, R&B)
+- **Roland TR-909** — house/techno staple
+- **Linn Drum** — 80s pop classic
+- **Akai MPC** — sample-based (hip-hop production)
+- **Modern: Native Instruments Maschine, Ableton Drum Rack**
+
+## Sound character
+- Synthetic (vs acoustic)
+- Programmable (any pattern)
+- Punchy and consistent
+- Sub-bass kick possible (808)
+
+## Playing styles
+- Programmed grids (4/4 typical)
+- Hip-hop boom-bap (kick + snare)
+- 4-on-the-floor (house, EDM)
+- Trap rolls (hi-hat triplets)
+- Glitch / chopped patterns
+
+## Genre fit
+- Hip-hop (essential)
+- Electronic (all sub-genres)
+- Modern pop
+- R&B
+- Trap (specifically 808 + hi-hats)
+
+## Sub-elements often specified separately
+- 808 (see 808.md)
+- Trap hi-hats (see trap-hihat.md)
+
+## For Suno
+```
+[Drum machine: TR-808 kick + clap snare + hi-hats, hip-hop boom-bap pattern]
+```
+
+```
+[Drum machine: TR-909 4-on-the-floor, house style]
+```
+
+## When to use
+Modern productions, electronic genres, hip-hop. Replace acoustic drums for synthetic feel.

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

@@ -0,0 +1,57 @@
+# Drums (Acoustic Kit) — Instrument
+
+> Foundation rhythm instrument. Live drum kit. Rock/jazz/pop/funk.
+
+## Type
+Acoustic percussion ensemble.
+
+## Components
+- Kick drum (bass drum)
+- Snare drum
+- Hi-hat (cymbals)
+- Toms (rack tom, floor tom)
+- Crash cymbal
+- Ride cymbal
+
+## Playing styles
+### Rock
+- 4/4 backbeat (kick on 1+3, snare on 2+4)
+- Powerful
+
+### Jazz
+- Brushes often
+- Swing pattern
+- Walking ride cymbal
+
+### Funk
+- Syncopated kick patterns
+- Tight snare (often with rim)
+- Hi-hat opens / closes
+
+### Latin
+- Specific clave patterns
+- Polyrhythmic
+
+### Punk
+- Fast straight beats
+- Hard hits
+
+## Genre fit
+- Rock (essential)
+- Jazz (brushes or sticks)
+- Pop (ofen layered with electronic)
+- Funk
+- Country
+- Blues
+
+## For Suno
+```
+[Drums: classic rock kit, 4/4 backbeat, powerful kick and snare]
+```
+
+```
+[Drums: jazz drums with brushes, swing feel, light]
+```
+
+## When to use
+Acoustic / live music contexts. Foundation for most band-based genres.

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

@@ -0,0 +1,57 @@
+# Electric Guitar — Instrument
+
+> Amplified guitar with pickups. Rock foundation. Wide tonal range from clean to distorted.
+
+## Type
+Electric chordophone. Pickups + amp.
+
+## Range
+~4 octaves (with effects, more).
+
+## Sub-types
+- Stratocaster — bright, twangy (Hendrix, Clapton)
+- Telecaster — country/rock twang
+- Les Paul — warm, thick (rock, blues)
+- SG — aggressive (AC/DC)
+- Hollow body — jazz tone
+- 7/8-string — extended range metal
+
+## Playing styles
+### Clean tones
+- Jazz (smooth)
+- Country (twangy)
+- Indie (jangly)
+
+### Distorted tones
+- Rock (medium drive)
+- Metal (heavy distortion)
+- Punk (raw)
+- Shoegaze (washed)
+
+## Effects
+- Distortion / overdrive
+- Delay
+- Reverb
+- Wah-wah
+- Chorus
+- Phaser / flanger
+
+## Genre fit
+- Rock (all sub-genres)
+- Blues
+- Jazz (clean)
+- Country (twangy)
+- Funk (clean rhythmic)
+- Indie
+
+## For Suno
+```
+[Electric guitar: clean Telecaster tone, jangly rhythm chords, indie style]
+```
+
+```
+[Electric guitar: distorted Les Paul, power chords, rock]
+```
+
+## When to use
+Whenever rock energy or specific guitar character needed.

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

@@ -0,0 +1,56 @@
+# Flute — Instrument
+
+> Woodwind instrument. Pure tone. Light, ethereal, peaceful.
+
+## Type
+Aerophone. Edge-blown (not reed).
+
+## Sub-types
+- Concert flute (Western classical)
+- Piccolo (smaller, higher)
+- Alto flute (lower, mellower)
+- Bass flute (very low)
+- World flutes: Ney (Persian/Sufi), Bansuri (Indian), Shakuhachi (Japanese)
+
+## Range
+C4 to D7 (concert flute).
+
+## Sound character
+- Pure, clear tone
+- Light, airy
+- Can be ethereal or playful
+- Wide dynamic range
+
+## Playing styles
+- Lyrical melodies
+- Rapid passages (virtuoso)
+- Trills, ornaments
+- Long sustained notes
+- Folk styles (regional)
+
+## Genre fit
+- Classical (orchestral + solo)
+- Folk (regional)
+- Jazz (rare lead, common backing)
+- World music (specific cultural flutes)
+- Film score (peaceful, ethereal)
+- Celtic music (tin whistle adjacent)
+
+## World flutes
+- **Ney** — Persian/Sufi (mystical, meditative)
+- **Bansuri** — Indian (spiritual, raga)
+- **Shakuhachi** — Japanese (Zen, contemplative)
+- **Pan flute** — South American
+- **Native American flute** — meditative
+
+## For Suno
+```
+[Flute: solo concert flute, lyrical melody, peaceful pastoral feel, classical]
+```
+
+```
+[Ney: Persian flute, mystical Sufi meditation, sustained breathy tones]
+```
+
+## When to use
+Peaceful moments. Pastoral feel. Cultural music (specific world flutes). Cinematic ethereal moments.

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

@@ -0,0 +1,66 @@
+# Kamancha — Instrument 🇦🇿
+
+> Bowed string instrument. Azerbaijani / Persian / Caucasian classical. Vocal-like expressive sound.
+
+## Type
+Bowed spike fiddle. Ancestor of Western violin.
+
+## Origin
+Persian-Caucasian classical tradition. Used in Azerbaijani mugham, Persian classical (kamancheh), Armenian music.
+
+## Construction
+- Spherical body (often coconut-shell or wood)
+- Long neck
+- 4 strings (modern Azerbaijani)
+- Spike at base (rests on player's knee)
+- Bow held differently than Western
+
+## Range
+~3 octaves.
+
+## Sound character
+- Vocal-like (sings)
+- Expressive
+- Can be soulful or dramatic
+- Microtonal capable
+- Sustained notes with vibrato
+
+## Playing styles
+### Mugham
+- Vocal-instrumental dialogue
+- Improvised ornaments
+- Bowing creates "singing" line
+
+### Solo
+- Virtuoso improvisation
+- Mugham modal exploration
+
+### Ensemble
+- Part of mugham trio (with tar + daf)
+- Folk ensembles
+
+## Genre fit
+- Azerbaijani mugham (essential, in trio with tar)
+- Persian classical (called kamancheh)
+- Caucasian folk
+- World music fusion
+- Cinematic Middle Eastern
+
+## Famous kamancha players
+- Habil Aliyev (master)
+- Imamyar Hasanov
+- Modern: Kayhan Kalhor (Iranian, world fusion)
+
+## For Suno
+```
+[Kamancha: Azerbaijani bowed spike fiddle, vocal-like expressive line, 
+microtonal ornaments, mugham style accompanying tar, traditional]
+```
+
+```
+[Kamancha: Persian classical kamancheh solo, slow Sufi mystical, 
+sustained emotional notes]
+```
+
+## When to use
+Azerbaijani / Persian / Caucasian classical. Mugham contexts. Cultural music. Replaces violin for cultural authenticity.

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

@@ -0,0 +1,68 @@
+# Nagara — Instrument 🇦🇿
+
+> Azerbaijani / Caucasian / Persian percussion. Drum pair. Folk celebration.
+
+## Type
+Drum pair. Different sized drums struck with sticks.
+
+## Origin
+Caucasian / Persian / Central Asian tradition.
+
+## Construction
+- Two drums (different sizes)
+- Cylindrical or barrel-shaped
+- Wood / metal body
+- Animal skin head traditionally
+- Played with sticks
+
+## Sound character
+- Punchy, declarative
+- Two pitches (low + high)
+- Loud, celebratory
+- Ceremonial feel
+
+## Playing styles
+### Folk celebration
+- Wedding music
+- Cultural festivals
+- Driving rhythm
+- Often paired with zurna (loud reed)
+
+### Folk dance
+- Yallı dance accompaniment
+- Strong rhythm
+
+### Modern fusion
+- Rock with cultural percussion
+- World music
+
+## Genre fit
+- Azerbaijani folk (essential)
+- Caucasian folk
+- Persian folk
+- World music
+- Modern fusion (cultural touch)
+
+## Cultural significance
+- Wedding music (paired with zurna)
+- Folk dance accompaniment
+- Cultural celebration
+- "Davul-zurna" tradition (drum + reed)
+
+## For Suno
+```
+[Nagara: Azerbaijani drum pair, punchy alternating low and high hits, 
+yallı dance rhythm, celebratory, paired with zurna (loud reed)]
+```
+
+```
+[Nagara: cultural percussion, wedding music style, driving folk rhythm]
+```
+
+## When to use
+Azerbaijani folk celebrations. Wedding music. Cultural authenticity. Folk dance contexts.
+
+## Related instruments
+- **Davul** (Turkish) — similar tradition
+- **Tabla** (Indian) — related (drum pair concept)
+- **Daf** (Azerbaijani frame drum) — different but complementary

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

@@ -0,0 +1,70 @@
+# Oud — Instrument 🌍
+
+> Middle Eastern fretless lute. Ancestor of European lute. Foundation of Arabic / Turkish music.
+
+## Type
+Fretless plucked string instrument. Pear-shaped body.
+
+## Origin
+Middle Eastern. Used in Arabic, Turkish, Greek, Armenian, Persian music. Egypt, Syria, Iraq, Turkey, Lebanon traditions.
+
+## Construction
+- Pear-shaped body
+- Short neck (compared to tar)
+- Fretless (allows microtones)
+- 11 strings (5 double courses + 1 single bass)
+- Plectrum (risha — eagle feather traditionally)
+
+## Range
+~3 octaves.
+
+## Sound character
+- Warm, mellow
+- Microtonal capability
+- Lyrical
+- Less bright than Western lute
+- Soulful
+
+## Playing styles
+### Classical Arabic
+- Maqam improvisation (similar to mugham/dastgah modes)
+- Vocal accompaniment
+
+### Solo oud
+- Taqasim (improvisation)
+- Virtuoso showcases
+
+### Modern fusion
+- Oud + jazz (Anouar Brahem)
+- Oud + Western strings
+- Modern Arabic pop
+
+## Genre fit
+- Arabic classical (essential)
+- Turkish classical
+- Persian (less common — tar more common)
+- Greek (laouto variant)
+- World music fusion
+- Cinematic Middle Eastern
+
+## Famous oud players
+- Munir Bashir (Iraqi master)
+- Marcel Khalife (Lebanese)
+- Anouar Brahem (Tunisian, jazz fusion)
+- Naseer Shamma (Iraqi modern)
+
+## For Suno
+```
+[Oud: Arabic classical oud, lyrical maqam melody, microtonal ornaments, 
+warm mellow tone, traditional acoustic]
+```
+
+```
+[Oud: modern fusion oud + Western strings, atmospheric, world music]
+```
+
+## When to use
+Middle Eastern cultural music. Arabic / Turkish authenticity. Cinematic Middle Eastern atmosphere. Fusion world music.
+
+## Related to mugham/dastgah
+Maqam system (Arabic) shares roots with dastgah (Persian) and mugham (Azerbaijani). Oud works in similar modal contexts.

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

@@ -0,0 +1,42 @@
+# Piano — Instrument
+
+> Most versatile keyboard instrument. Works in nearly every genre.
+
+## Type
+Acoustic keyboard. Hammers strike strings.
+
+## Range
+~7 octaves (88 keys standard).
+
+## Genre fit
+- Classical (foundational)
+- Pop (chord accompaniment + melody)
+- Jazz (essential)
+- R&B / Soul
+- Singer-songwriter
+- Film score
+- Indie / folk
+
+## Sub-types
+- Grand piano (concert hall)
+- Upright piano (intimate)
+- Honky-tonk (vintage saloon)
+- Prepared piano (experimental)
+
+## Playing styles
+- Block chords
+- Arpeggios
+- Melody lead
+- Bass + chords (jazz left hand)
+- Rolling figures (classical)
+
+## Mood pairings
+- Romantic, melancholic, contemplative, triumphant, peaceful
+
+## For Suno
+```
+[Piano: solo grand piano, sustain pedal, gentle arpeggios, intimate]
+```
+
+## When to use
+Almost any song benefits from piano. Default keyboard choice.

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

@@ -0,0 +1,66 @@
+# Saxophone — Instrument
+
+> Reed instrument. Smooth, sensual, jazzy. Multiple sizes.
+
+## Type
+Single-reed woodwind. Brass body (despite woodwind classification).
+
+## Sub-types
+- **Soprano sax** — highest, lyrical (Kenny G, classical)
+- **Alto sax** — bright, jazz standard (Charlie Parker)
+- **Tenor sax** — most common, warm (John Coltrane)
+- **Baritone sax** — low, deep (jazz, ska)
+
+## Range
+Each saxophone has ~2.5 octaves. Together they cover wide range.
+
+## Sound character
+- Smooth, expressive
+- Vocal-like
+- Can be sensual or aggressive
+- Smoky / sultry quality
+
+## Playing styles
+### Jazz
+- Improvisation central
+- Swing or straight
+- Long melodic lines
+- Bebop fast lines
+
+### Smooth jazz
+- Sensual ballads
+- Long sustained notes
+- Romantic
+
+### Soul / R&B
+- Solo lines
+- Punctuating accents
+
+### Rock
+- Bruce Springsteen "Born to Run" style
+- Punctuating moments
+
+### Funk
+- Tight rhythmic punches
+- Section play
+
+## Genre fit
+- Jazz (essential)
+- R&B / Soul
+- Funk
+- Smooth jazz
+- Rock (occasional)
+- Film score (smoky moments)
+
+## For Suno
+```
+[Saxophone: tenor sax solo, smooth jazz style, melodic improvisation, 
+warm and sensual]
+```
+
+```
+[Saxophone: alto sax bebop, fast melodic runs, jazz combo]
+```
+
+## When to use
+Jazz contexts. Smooth romantic moments. Soul/R&B authenticity. Saxophone solo for emotional peak.