@azerogluemin/ai-bootstrap 0.2.1

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

@@ -0,0 +1,63 @@
+# House — Genre
+
+> Chicago-origin dance music. 4-on-the-floor, soulful, club-oriented.
+
+## Defining elements
+
+- 4-on-the-floor kick drum
+- 120-130 BPM
+- Soulful or disco roots
+- Synth bass
+- Vocal samples (often)
+- Long mixes (5-10 min)
+
+## Sub-types
+
+- **Classic / Chicago house** — origins (Frankie Knuckles, Larry Heard)
+- **Deep house** — soulful, atmospheric (Dixon, Solomun)
+- **Tech house** — minimal techno crossover
+- **Progressive house** — long builds (Eric Prydz, Sasha)
+- **Tropical house** — see EDM (Kygo)
+- **Future house** — modern (Don Diablo, Tchami)
+- **Afro house** — African influences (Black Coffee)
+
+## Typical instrumentation
+
+Drum machine (Roland TR-909 classic) + synth bass + chord stabs + vocal samples + percussion + occasional pianos
+
+## Production characteristics
+
+- Steady kick essential
+- Hi-hat patterns key
+- Bassline grooves
+- Repetition + variation
+- Long mixes designed for DJ play
+
+## Lyrics direction (when vocal)
+
+- "Lift you up" themes
+- Dancing, freedom, love
+- Often soulful diva vocals
+- Repetitive hooks
+- Spiritual / uplifting often
+
+## For Suno
+
+```
+[Style: deep house, 122 BPM, G minor, 4-on-the-floor kick + classic drum 
+machine percussion + synth bass groove + atmospheric pads + female soul 
+vocal sample chopped, club-ready, hypnotic groove]
+```
+
+## Examples
+
+- Frankie Knuckles, Larry Heard (deep house pioneer)
+- Modern: Disclosure, Black Coffee, Solomun, Dixon
+- Vocal house: David Guetta + various vocalists
+
+## Avoid
+
+- Slow tempo
+- Sparse without groove
+- No 4-on-the-floor
+- Live drums

package/templates/skills/composer/knowledge/genres/indie-folk.md

@@ -0,0 +1,63 @@
+# Indie Folk — Genre
+
+> Acoustic-driven indie music. Storytelling vocals, intimate production.
+
+## Defining elements
+
+- Acoustic guitar / piano central
+- Storytelling vocals
+- Mid tempo (75-110 BPM)
+- Folk roots + indie sensibility
+- Often introspective
+- Layered harmonies
+
+## Sub-types
+
+- **Indie folk classic** — Sufjan Stevens, Bon Iver
+- **Folk rock indie** — Mumford & Sons, The Lumineers
+- **Anti-folk** — quirky alternative
+- **Chamber folk** — orchestral elements
+- **Modern indie folk** — Hozier, Phoebe Bridgers, Big Thief
+
+## Typical instrumentation
+
+Acoustic guitar + bass + soft drums + piano + occasional strings / horns + lead vocal + harmonies
+
+## Production characteristics
+
+- Warm, intimate
+- Reverb on vocals
+- Less compression than pop
+- Live band feel often
+- Acoustic instruments forward
+
+## Lyrics direction
+
+- Storytelling
+- Personal, vulnerable
+- Specific imagery (places, people)
+- Memory, time
+- Nature
+- Modern life
+
+## For Suno
+
+```
+[Style: indie folk, 90 BPM, D major with minor 7 chords, fingerpicked 
+acoustic guitar + bass + soft drums + piano + occasional violin + female 
+mezzo lead vocal vulnerable + male harmonies, warm intimate production]
+```
+
+## Examples
+
+- Bon Iver, Sufjan Stevens, Phoebe Bridgers, Big Thief, Hozier
+- Mumford & Sons, The Lumineers, Of Monsters and Men
+- Iron & Wine, José González
+
+## Avoid
+
+- Heavy distortion
+- Auto-tune
+- EDM elements
+- Aggressive vocals
+- Cold modern production

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

@@ -0,0 +1,60 @@
+# Indie Rock — Genre
+
+> Independent rock. Alternative aesthetic, less polished, distinctive voice.
+
+## Defining elements
+
+- Guitar-driven but less heavy than mainstream rock
+- DIY / authentic feel
+- Distinctive vocalists
+- Often jangly clean guitars
+- Mid tempo
+- Album-oriented (vs single-driven)
+
+## Sub-types
+
+- **Indie pop rock** — accessible (Vampire Weekend, Two Door Cinema Club)
+- **Garage rock** — raw (The Strokes, The White Stripes)
+- **Math rock** — complex (Foals, American Football)
+- **Indie folk-rock** — acoustic-leaning (Mumford & Sons, Lumineers)
+- **Lo-fi indie** — bedroom production (Mac DeMarco, Clairo)
+
+## Typical instrumentation
+
+Clean / lightly distorted electric guitar + bass + drums + vocal + occasional keys/strings
+
+## Production characteristics
+
+- Less polished than mainstream
+- Authentic / live feel
+- Distinctive vocal character
+- Reverb usage
+- Vintage equipment often
+
+## Lyrics direction
+
+- Personal, observational
+- Often quirky
+- Relationship complexity
+- Modern life
+- Distinctive vocabulary
+
+## For Suno
+
+```
+[Style: indie rock, 115 BPM, D major, clean electric guitar + bass + 
+drums + male tenor vocals with character, slightly lo-fi production, 
+reverb-heavy, authentic feel]
+```
+
+## Examples
+
+- Arctic Monkeys, The Strokes, Vampire Weekend, Tame Impala
+- Mac DeMarco, Mitski, Phoebe Bridgers, The 1975
+
+## Avoid
+
+- Heavy distortion (too rock)
+- Over-polished production
+- Auto-tune
+- Generic radio sound

package/templates/skills/composer/knowledge/genres/jazz-fusion.md

@@ -0,0 +1,60 @@
+# Jazz Fusion — Genre
+
+> Jazz + rock + electronic + world music. Complex, virtuosic, electric.
+
+## Defining elements
+
+- Jazz harmony + rock rhythm section
+- Electric instruments
+- Complex time signatures
+- Virtuoso musicianship
+- Extended improvisation
+- Mixed influences (Latin, Indian, electronic)
+
+## Sub-types
+
+- **Classic fusion** — 70s (Weather Report, Return to Forever, Mahavishnu Orchestra)
+- **Smooth fusion** — accessible (Spyro Gyra, Yellowjackets)
+- **Modern fusion** — contemporary (Snarky Puppy, Hiromi)
+- **Acid jazz** — UK 90s (Jamiroquai, Brand New Heavies)
+
+## Typical instrumentation
+
+Electric guitar + electric bass + drums + electric keyboards / synthesizer + saxophone / trumpet
+
+## Production characteristics
+
+- Studio polish
+- Layered arrangements
+- Complex compositions
+- Long-form pieces (5-10+ min)
+- Live band foundation
+
+## Lyrics direction
+
+When vocal:
+- Sophisticated themes
+- Often instrumental focus
+- Complex melodies for voice
+
+## For Suno
+
+```
+[Style: jazz fusion, 105 BPM, F# minor with extended chords + modulations, 
+electric guitar + electric bass + drums + Rhodes electric piano + 
+saxophone solo, virtuosic playing, complex but accessible, instrumental 
+focus]
+```
+
+## Examples
+
+- Weather Report, Return to Forever, Mahavishnu Orchestra
+- Snarky Puppy, Hiromi, Robert Glasper
+- Vocal fusion: Steely Dan, Jamiroquai
+
+## Avoid
+
+- Simplistic chord progressions
+- Quantized rhythm
+- Pop song structure
+- Auto-tune

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

@@ -0,0 +1,66 @@
+# Jazz — Genre
+
+> Improvisational music. African-American origin. Sophisticated harmony, swing rhythm.
+
+## Defining elements
+
+- Swing rhythm (triplet feel) traditionally
+- Improvisation central
+- Complex harmony (extended chords: 7th, 9th, 11th, 13th)
+- Walking bass lines
+- Brass and woodwinds prominent
+- Variable tempo
+
+## Sub-types
+
+- **Swing / Big Band** — 30s-40s (Duke Ellington, Count Basie)
+- **Bebop** — 40s-50s, fast complex (Charlie Parker, Dizzy Gillespie)
+- **Cool jazz** — 50s relaxed (Miles Davis "Birth of the Cool")
+- **Hard bop** — 50s-60s soul-influenced (Art Blakey)
+- **Modal jazz** — 60s (Miles Davis "Kind of Blue")
+- **Free jazz** — avant-garde (Ornette Coleman)
+- **Fusion** — jazz + rock (Weather Report, Mahavishnu)
+- **Smooth jazz** — radio-friendly (Kenny G — controversial)
+- **Contemporary jazz** — modern (Robert Glasper, Snarky Puppy)
+
+## Typical instrumentation
+
+Saxophone / trumpet / trombone (lead) + piano + bass (upright traditionally) + drums + vocal (sometimes)
+
+## Production characteristics
+
+- Live band feel
+- Acoustic instruments
+- Room ambience
+- Less production processing
+- Improvisation captured
+
+## Lyrics direction (when vocal)
+
+- Standards (American Songbook)
+- Romantic
+- Wistful
+- Sophisticated wordplay
+- Often classic Tin Pan Alley
+
+## For Suno
+
+```
+[Style: classic jazz combo, 120 BPM swing feel, F major with extended 
+chords (7ths, 9ths), tenor saxophone lead + piano + upright bass walking + 
+drums with brushes + occasional female alto vocal, smoky club atmosphere, 
+improvisational feel]
+```
+
+## Examples
+
+- Miles Davis, John Coltrane, Charlie Parker, Bill Evans
+- Vocalists: Ella Fitzgerald, Frank Sinatra, Sarah Vaughan
+- Modern: Esperanza Spalding, Robert Glasper, Kamasi Washington
+
+## Avoid
+
+- Auto-tune
+- Quantized rhythm (kills swing)
+- Simple chord progressions
+- Modern pop production

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

@@ -0,0 +1,81 @@
+# K-Pop — Genre
+
+> Korean popular music. Highly produced, multi-genre fusion, idol group culture.
+
+## Defining elements
+
+- Highly polished production
+- Multi-genre within one song often (pop + hip-hop + R&B + EDM)
+- Group-based (BTS, BLACKPINK, etc.) typically
+- Korean + English mix lyrics
+- Visual + dance integration
+- Hook-heavy
+
+## Sub-types
+
+- **Idol K-pop** — group format (BTS, BLACKPINK, NewJeans, TWICE)
+- **K-R&B** — solo R&B style (DEAN, Crush)
+- **K-rap** — hip-hop (Zico, Epik High)
+- **K-ballad** — emotional ballads
+- **K-rock** — rock (Day6)
+- **K-indie** — indie (Hyukoh)
+
+## Typical instrumentation
+
+Synth pads + drum machine + electric piano + bass + occasional live drums + vocals (multiple members) + rap parts often
+
+## Production characteristics
+
+- Maximum polish
+- Multiple genre shifts within song (verse pop, chorus EDM, bridge ballad)
+- Vocal layering complex
+- Auto-tune used carefully
+- High production value
+
+## Song structure (K-pop specific)
+
+```
+Intro (often instrumental hook)
+Verse 1 (member A)
+Pre-chorus (member B)
+Chorus (group together)
+Verse 2 (different member)
+Pre-chorus (different)
+Chorus
+Rap verse (rapper)
+Bridge (powerhouse vocalist)
+Final chorus (often modulated, dance break)
+Outro
+```
+
+## Lyrics direction
+
+- Love (idealized)
+- Empowerment
+- Confidence
+- Mix of Korean + English
+- Modern themes (mental health newer)
+
+## For Suno
+
+```
+[Style: modern K-pop, 120 BPM, F# minor, mixed genres - pop verse + 
+EDM chorus + rap bridge, synth pads + drum machine + bass + electric 
+piano, multiple vocal parts (lead + harmonies + rap section), highly 
+polished production, Korean + English lyrics]
+```
+
+## Examples
+
+- BTS, BLACKPINK, TWICE, NewJeans, IVE, Stray Kids
+- Solo: Taeyeon, IU
+- Pioneers: H.O.T., S.E.S, BoA, Big Bang
+- K-R&B: DEAN, Crush, Heize
+
+## Avoid
+
+- Lo-fi production
+- Single genre throughout
+- Solo vocal (K-pop is group-based often)
+- Acoustic only
+- Slow tempo throughout

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

@@ -0,0 +1,88 @@
+# Latin — Genre
+
+> Music from Latin American traditions. Rhythmic, passionate, varied subgenres.
+
+## Defining elements
+
+- Latin rhythm (varies by country)
+- Spanish or Portuguese (Brazil) language often
+- Acoustic instruments (guitar central)
+- Percussion-rich
+- Variable tempo
+- Emotional vocal delivery
+
+## Sub-types
+
+### Cuban / Caribbean
+- **Salsa** — fast, complex (Celia Cruz, Marc Anthony)
+- **Son cubano** — Cuban traditional (Buena Vista Social Club)
+- **Bolero** — slow romantic
+- **Mambo** — danceable big band
+- **Cha-cha-cha** — Cuban dance
+
+### Brazilian
+- **Bossa nova** — soft, jazzy (João Gilberto, Astrud Gilberto)
+- **Samba** — percussion-rich (Brazilian carnival)
+- **MPB (Música Popular Brasileira)** — broad pop (Caetano Veloso, Gilberto Gil)
+
+### Mexican
+- **Mariachi** — trumpets + guitars + voice
+- **Ranchera** — country-style
+- **Banda** — brass-heavy
+- **Norteño** — accordion-driven
+
+### Modern Latin pop
+- **Reggaeton** — see reggae.md (Latin dance)
+- **Latin trap** — modern (Bad Bunny, Anuel AA)
+- **Latin pop** — Shakira, Enrique Iglesias
+
+### Argentinian
+- **Tango** — passionate, accordion (Astor Piazzolla)
+
+## Typical instrumentation (varies by sub-type)
+
+- Spanish guitar (classical, flamenco)
+- Latin percussion (congas, bongos, maracas, claves)
+- Trumpet (mariachi, salsa)
+- Accordion (norteño, tango)
+- Piano (salsa, jazz Latin)
+- Voice (passionate, emotional)
+
+## Production characteristics
+
+- Live band feel
+- Acoustic instruments primary
+- Percussion forward
+- Vocal emotional
+- Less compression than pop
+
+## Lyrics direction
+
+- Love (passionate)
+- Heartbreak (deep)
+- Cultural / national pride
+- Social themes
+- Family
+- Often poetic / metaphorical
+
+## For Suno
+
+```
+[Style: salsa, 105 BPM, F major, congas + bongos + claves + bass + 
+piano montuno + trumpet section + male tenor vocal passionate Spanish 
+language, live band feel, danceable groove]
+```
+
+## Examples
+
+- Salsa: Celia Cruz, Héctor Lavoe, Marc Anthony
+- Bossa: João Gilberto, Stan Getz
+- Tango: Astor Piazzolla
+- Modern: Bad Bunny, Shakira, Rosalía
+
+## Avoid
+
+- Generic "Latin" (specify sub-type)
+- Wrong percussion for sub-type
+- Cold production
+- Generic Spanish lyrics

package/templates/skills/composer/knowledge/genres/lo-fi.md

@@ -0,0 +1,64 @@
+# Lo-Fi — Genre
+
+> "Low fidelity" production aesthetic. Vintage feel, vinyl crackle, warm imperfection.
+
+## Defining elements
+
+- Deliberately less polished production
+- Tape saturation / vinyl crackle
+- Mid tempo (70-100 BPM)
+- Jazz / soul samples often
+- Hip-hop influence
+- Bedroom production aesthetic
+
+## Sub-types
+
+- **Lo-fi hip-hop** — chillhop (J Dilla legacy, Nujabes)
+- **Lo-fi indie** — bedroom indie (Mac DeMarco, Clairo, Rex Orange County)
+- **Lo-fi jazz** — chill instrumental
+- **Vaporwave** — slowed nostalgic (lo-fi adjacent)
+- **Bedroom pop** — modern lo-fi pop
+
+## Typical instrumentation
+
+Sample-based beat (often jazz/soul samples) + drum machine + bass + occasional live instruments + lo-fi vocals (sometimes)
+
+## Production characteristics
+
+- Tape saturation
+- Vinyl crackle (intentional)
+- Sidechained compression (subtle)
+- Less compression overall
+- Reverb / delay
+- Imperfect quality (intentional)
+
+## Lyrics direction (when vocal)
+
+- Casual, conversational
+- Bedroom relatable
+- Modern life
+- Often sparse vocal use
+- Sometimes wordless
+
+## For Suno
+
+```
+[Style: lo-fi hip-hop, 80 BPM, F major with 7th chords, jazz piano sample 
+loop + soft drum machine + bass + vinyl crackle + tape saturation, no 
+vocals (instrumental), warm vintage chill atmosphere]
+```
+
+## Examples
+
+- J Dilla (pioneer), Nujabes (Japanese lo-fi pioneer)
+- Modern: Joey Pecoraro, Idealism, Saib
+- Lo-fi indie: Mac DeMarco, Clairo, Boy Pablo
+- Lo-fi YouTube channels (study music)
+
+## Avoid
+
+- High polish modern production
+- Auto-tune
+- Big radio sound
+- Crisp digital cleanliness
+- Aggressive dynamics

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

@@ -0,0 +1,95 @@
+# Meykhana — Genre 🇦🇿
+
+> Azerbaijani improvised poetic battle / freestyle. Pre-rap tradition. Spoken word over rhythm.
+
+## Defining elements
+
+- Improvised poetic verses
+- Comedic + social commentary
+- Battle format (multiple performers competing)
+- Rhythmic spoken delivery (proto-rap)
+- Often unaccompanied or simple percussion
+- Quick wit + clever wordplay
+
+## What makes it unique
+
+Meykhana is essentially Azerbaijani **freestyle rap before rap was invented**. Performers improvise verses on the spot, often in competition. Direct ancestor of modern Azerbaijani hip-hop.
+
+## Performance format
+
+### Solo meykhana
+- One performer
+- Improvised verses on chosen topic
+- Audience reactions
+
+### Battle meykhana
+- 2-4 performers
+- Trade verses
+- Topic chosen
+- Audience judges
+
+## Typical accompaniment
+
+- A cappella (most traditional)
+- Daf or simple percussion
+- Sometimes folk instruments
+- Modern: drum machine fusion possible
+
+## Vocal / delivery style
+
+- Rapid-fire delivery
+- Strong rhythm
+- Rhyme-heavy
+- Comedic timing
+- Direct audience engagement
+- Shouted / proclaimed
+
+## Lyrics direction
+
+- Social commentary
+- Comedy / satire
+- Personal stories
+- Topical issues
+- Specific local references
+- Insults (battle context)
+- Political (within limits)
+
+## Famous meykhana performers
+
+- **Vüqar Biləcərili** — modern meykhana master
+- **Reşad Dağlı** — modern
+- **Mənzərə (group)** — contemporary
+- Various traditional masters
+
+## For Suno
+
+```
+[Style: traditional meykhana, 130 BPM (rhythmic spoken), free key (rhythm-
+focused not melodic), daf percussion + occasional folk instruments, male 
+vocals in rapid Azerbaijani spoken style with strong rhythm and rhyme, 
+comedic and improvisational feel]
+```
+
+For modern fusion:
+```
+[Style: meykhana-rap fusion, 90 BPM, A minor, drum machine + 808 bass + 
+daf percussion + male rapid Azerbaijani spoken vocals in meykhana style 
+with hip-hop production, modern interpretation of traditional form]
+```
+
+## Connection to modern Azerbaijani hip-hop
+
+Modern Azerbaijani rappers (HOST group, Miri Yusif) draw from meykhana tradition:
+- Rapid delivery
+- Wordplay focus
+- Social commentary
+- Comedy + serious mix
+- Cultural specificity
+
+## Avoid
+
+- Singing (meykhana is spoken)
+- Slow tempo
+- Western chord progressions
+- Generic rap (must have meykhana feel)
+- Polished production (raw is better)

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

@@ -0,0 +1,69 @@
+# Orchestral — Genre
+
+> Large symphonic ensemble music. Modern usage spans classical to film score to pop.
+
+## Defining elements
+
+- Full orchestra (50+ musicians)
+- String, brass, woodwind, percussion sections
+- Wide dynamic range
+- Layered textures
+- Often instrumental
+- Concert hall acoustic
+
+## Sub-types
+
+- **Symphonic classical** — see classical.md
+- **Film score orchestral** — see film-score.md
+- **Modern orchestral** — Hans Zimmer, John Williams, Hildur Guðnadóttir
+- **Pop orchestral** — pop with orchestra (Adele "Skyfall")
+- **Rock orchestral** — Metallica with symphony
+- **Hybrid orchestral** — orchestra + electronic (modern film)
+
+## Typical instrumentation
+
+### Strings
+First violins (12-16) + Second violins (10-14) + Violas (8-12) + Cellos (8-12) + Double bass (6-8)
+
+### Woodwinds
+Flutes, oboes, clarinets, bassoons (2-3 each)
+
+### Brass
+Trumpets (3-4) + French horns (4-6) + Trombones (3) + Tuba (1)
+
+### Percussion
+Timpani + Cymbals + Snare + Bass drum + others as needed
+
+### Optional
+Piano, harp, choir
+
+## Production characteristics
+
+- Concert hall recording
+- Wide dynamic range (pp to ff)
+- Natural acoustics preferred
+- Spot mics for sections + room mics
+- Minimal compression
+
+## For Suno
+
+```
+[Style: orchestral cinematic, 95 BPM, D minor, full orchestra - strings 
+section + brass section + woodwinds + percussion + harp + occasional 
+choir, wide dynamic range, concert hall acoustic, cinematic and emotional]
+```
+
+## Examples
+
+- John Williams (Star Wars, Jurassic Park)
+- Hans Zimmer (Inception, Interstellar)
+- Hildur Guðnadóttir (Joker, Chernobyl)
+- Modern classical: Max Richter, Ólafur Arnalds (chamber + orchestra)
+
+## Avoid
+
+- Electronic dominant
+- Drum machine
+- Pop song structure
+- Compressed loudness
+- Auto-tune