@azerogluemin/ai-bootstrap 0.2.1

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

@@ -0,0 +1,75 @@
+# Saz / Bağlama — Instrument 🇹🇷
+
+> Turkish long-necked lute. Aşık tradition. Folk music foundation.
+
+## Type
+Plucked string instrument. Long neck (like tar). Multiple strings.
+
+## Origin
+Turkish / Anatolian tradition. Related instruments throughout Central Asia and Caucasus.
+
+## Names by region
+- **Saz** — Azerbaijani aşıq tradition (often)
+- **Bağlama** — Turkish modern term
+- **Tambura** — variations
+
+## Construction
+- Pear-shaped body
+- Long neck (microtonal frets)
+- 6-7 strings (in 3 courses)
+- Plectrum (mızrap)
+- Frets allow microtones (different from Western)
+
+## Range
+~3 octaves.
+
+## Sound character
+- Bright, ringing
+- Microtonal capability
+- Melodic + chordal
+- Folk authenticity
+
+## Playing styles
+### Aşıq tradition
+- Folk poet-musicians (Aşık Veysel, Aşıq Ələsgər)
+- Improvised poetry + saz
+- Storytelling music
+
+### Turkish folk
+- Halk müziği (people's music)
+- Regional variations
+
+### Modern Turkish music
+- Folk-pop fusion (Sezen Aksu uses)
+- Arabesk (sometimes)
+
+### Azerbaijani aşıq
+- Traditional saz playing
+- Often instrumental introductions to sung verses
+
+## Genre fit
+- Turkish folk (essential)
+- Azerbaijani aşıq (essential)
+- Modern Turkish pop (folk touch)
+- Regional folk
+- World music
+
+## Famous saz players
+- **Aşık Veysel** (Turkish, blind master)
+- **Aşıq Ələsgər** (Azerbaijani master)
+- **Neşet Ertaş** (Turkish)
+- **Arif Sağ** (Turkish modern)
+
+## For Suno
+```
+[Saz: Turkish long-necked lute (bağlama), bright plectrum attack, 
+microtonal melody, folk Anatolian style, traditional acoustic]
+```
+
+```
+[Saz: Azerbaijani aşıq tradition, instrumental introduction with 
+storytelling vocal, traditional folk]
+```
+
+## When to use
+Turkish / Azerbaijani aşıq folk music. Cultural authenticity. Folk-pop fusion. Wedding music. Storytelling traditions.

package/templates/skills/composer/knowledge/instruments/strings-orchestra.md

@@ -0,0 +1,68 @@
+# Strings (Orchestra Section) — Instrument
+
+> Full string section: violins, violas, cellos, double basses. Cinematic, lush, emotional.
+
+## Type
+Orchestral string ensemble. Multiple players per part.
+
+## Standard sizes
+- **Full orchestra**: 60+ string players
+- **Chamber strings**: 12-20
+- **String quartet**: 4 (2 violins, viola, cello)
+- **String quintet**: 5 (string quartet + double bass)
+
+## Components
+- 1st violins (highest)
+- 2nd violins
+- Violas (middle)
+- Cellos (low)
+- Double bass (lowest)
+
+## Playing styles
+### Bowed (arco)
+- Default playing style
+- Sustained notes
+- Wide range of dynamics
+
+### Pizzicato
+- Plucked
+- Light, percussive
+- Used for accents
+
+### Tremolo
+- Rapid bow strokes
+- Tension building (cinematic)
+
+### Sul ponticello
+- Bow near bridge
+- Eerie, glassy sound
+
+### Harmonics
+- Touch lightly on string
+- Bell-like overtones
+
+## Genre fit
+- Classical / orchestral (essential)
+- Film score (foundational)
+- Pop (lush arrangements)
+- R&B (smooth strings)
+- Cinematic (build emotion)
+
+## Production
+- Recorded in concert hall (acoustic space)
+- Spot mics + room mics
+- Wide dynamic range
+- Section blends naturally
+
+## For Suno
+```
+[Strings: full orchestral string section, lush bowed sustained notes, 
+emotional swell, cinematic]
+```
+
+```
+[Strings: tense tremolo, building energy, thriller cinematic]
+```
+
+## When to use
+Whenever cinematic emotion, lush arrangement, or orchestral feel needed. Layer over piano for ballads. Build energy in choruses.

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

@@ -0,0 +1,55 @@
+# Synth Bass — Instrument
+
+> Synthesized bass sound. Electronic, modern, precise. Replaces or augments traditional bass.
+
+## Type
+Synthesizer producing bass frequencies.
+
+## Sub-types
+- **Sub-bass** — pure low sine wave
+- **Analog synth bass** — Moog warmth (classic)
+- **Wobble bass** — dubstep (LFO modulated)
+- **FM bass** — DX7 style (80s pop)
+- **Reese bass** — drum and bass (multiple detuned saws)
+- **Pluck synth bass** — short attack
+- **Acid bass** — TB-303 squelchy
+
+## Famous synth basses
+- Moog Minimoog (analog warm)
+- Roland TB-303 (acid)
+- Yamaha DX7 (FM 80s)
+- Modern: serum, massive (software)
+
+## Sound character
+- Precise (machine-tight)
+- Sub-frequencies often
+- Variable (any character possible)
+- Doesn't decay naturally (controlled)
+
+## Playing styles
+- Sustained sub-bass notes
+- Funky synth bass lines
+- Wobble (dubstep)
+- Acid 16th notes (TB-303)
+- Melodic bass
+
+## Genre fit
+- Electronic (essential)
+- EDM
+- Modern pop
+- Hip-hop (alongside 808)
+- Synthwave (analog feel)
+- Modern R&B
+- Funk (synth bass)
+
+## For Suno
+```
+[Synth bass: warm analog Moog-style bass, sustained notes, 80s pop feel]
+```
+
+```
+[Synth bass: TB-303 acid style, squelchy 16th note pattern, electronic dance]
+```
+
+## When to use
+Electronic / pop / hip-hop / EDM contexts. When precision needed. Modern sound. Avoid in folk / acoustic / classical.

package/templates/skills/composer/knowledge/instruments/synth-lead.md

@@ -0,0 +1,70 @@
+# Synth Lead — Instrument
+
+> Synthesizer playing lead melody. Electronic / pop / EDM essential.
+
+## Type
+Synthesizer producing melodic lead lines.
+
+## Sub-types
+- **Saw lead** — bright, cutting (EDM)
+- **Square lead** — hollow, retro (chiptune)
+- **Sine lead** — pure, smooth
+- **FM lead** — DX7 metallic (80s)
+- **Pluck lead** — short attack
+- **Supersaw** — multiple saws (trance)
+- **Sync lead** — aggressive (modern EDM)
+
+## Famous synth leads
+- Vintage: Moog, Oberheim, Korg M1
+- 80s: Yamaha DX7
+- Modern: Serum, Massive, Sylenth1
+
+## Sound character
+- Variable (any timbre)
+- Cuts through mix
+- Modern / electronic feel
+- Often modulated (LFO, envelope)
+
+## Playing styles
+### EDM lead
+- Big melodic hooks
+- Often "supersaw" style
+- Drop melody
+
+### Synthwave / 80s
+- Catchy retro melodies
+- Pluck or saw
+
+### Modern pop
+- Subtle synth hooks
+- Often layered with vocals
+
+### Trap
+- Atmospheric leads (less melodic)
+- Pads more than leads
+
+## Effects on lead
+- Reverb (atmosphere)
+- Delay (echo)
+- Distortion (aggressive)
+- Sidechain compression (pumping)
+
+## Genre fit
+- EDM (essential)
+- Electronic
+- Synthwave (defining)
+- Modern pop
+- 80s retro
+- Modern hip-hop (atmospheric)
+
+## For Suno
+```
+[Synth lead: bright saw lead with reverb and delay, big EDM hook melody]
+```
+
+```
+[Synth lead: vintage Moog-style pluck lead, 80s synthwave melody]
+```
+
+## When to use
+Electronic genres. Hook moments in pop. Drop melodies in EDM. Avoid in acoustic / folk / classical.

package/templates/skills/composer/knowledge/instruments/synth-pad.md

@@ -0,0 +1,61 @@
+# Synth Pad — Instrument
+
+> Sustained atmospheric synthesizer. Provides texture, warmth, atmosphere. Background element.
+
+## Type
+Sustained synthesizer sound (pads). Often slow attack and release.
+
+## Sub-types
+- **Warm pad** — analog warmth (vintage)
+- **String pad** — synthesized strings
+- **Bell pad** — bell-like overtones
+- **Choir pad** — synthesized choir
+- **Atmospheric pad** — abstract textures
+- **Granular pad** — modern granular synthesis
+
+## Sound character
+- Sustained (slow attack)
+- Atmospheric
+- Background (rarely lead)
+- Wide stereo image
+- Lush
+
+## Function in arrangement
+- Fills harmonic space
+- Provides emotional bed
+- Adds atmosphere
+- Supports vocals
+- Builds tension (with filter sweeps)
+
+## Playing styles
+- Sustained chords (whole notes / longer)
+- Slow chord changes
+- Filter sweeps (open/close over time)
+- Subtle modulation
+
+## Genre fit
+- Electronic (essential)
+- Ambient (foundational)
+- Modern pop (atmosphere)
+- Cinematic (mood)
+- R&B (smooth bed)
+- Modern hip-hop (atmospheric)
+
+## Effects
+- Heavy reverb
+- Delay
+- Chorus (lush)
+- Filter sweeps
+
+## For Suno
+```
+[Synth pad: warm analog pad, sustained chords, atmospheric background, 
+heavy reverb, lush atmosphere]
+```
+
+```
+[Synth pad: ethereal choir pad, slow attack, cinematic mood, builds emotion]
+```
+
+## When to use
+Atmospheric moments. Behind vocals (subtle). Building tension. Cinematic mood. Almost any electronic context.

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

@@ -0,0 +1,67 @@
+# Tar — Instrument 🇦🇿
+
+> Long-necked lute. Signature instrument of Azerbaijani mugham. Persian-Caucasian classical tradition.
+
+## Type
+Plucked string instrument. Long neck, double-bowl body.
+
+## Origin
+Azerbaijani / Persian classical tradition. UNESCO Intangible Cultural Heritage.
+
+## Construction
+- Body: two joined bowls (mulberry wood traditional)
+- Neck: long
+- Strings: 6 (in 3 double courses) traditionally, modern variants more
+- Frets: movable (allow microtones)
+- Plectrum: brass
+
+## Range
+~3 octaves.
+
+## Sound character
+- Bright, ringing
+- Microtonal capability (essential for mugham)
+- Plectrum attack distinct
+- Can be lyrical or rhythmic
+
+## Playing styles
+### Mugham accompaniment
+- Classic Azerbaijani art music
+- Microtonal ornaments
+- Vocal accompaniment + interludes
+
+### Solo tar
+- Virtuoso showcases
+- Improvisation in mugham modes
+
+### Modern
+- Fusion with jazz, rock, electronic
+- Aziza Mustafa Zadeh fusion
+- Modern Azerbaijani pop with tar
+
+## Genre fit
+- Azerbaijani mugham (essential)
+- Persian classical (also called tar there)
+- Modern Azerbaijani pop (cultural touch)
+- World music fusion
+- Cinematic (Middle Eastern feel)
+
+## Famous tar players
+- Bahram Mansurov (master)
+- Ramiz Quliyev
+- Ali Asgar Mammadov
+- Modern: Sahib Pashazade
+
+## For Suno
+```
+[Tar: Azerbaijani long-necked lute, bright plectrum attack, microtonal 
+ornaments, mugham style melody in Şur mode, traditional Caucasian]
+```
+
+```
+[Tar: solo tar improvisation, Persian classical, virtuoso ornaments, 
+acoustic recording]
+```
+
+## When to use
+Azerbaijani / Persian / Caucasian cultural music. Mugham contexts. Cultural authenticity in modern fusion.

package/templates/skills/composer/knowledge/instruments/trap-hihat.md

@@ -0,0 +1,50 @@
+# Trap Hi-Hat — Instrument
+
+> Rapid hi-hat patterns characteristic of trap music. Triplet rolls and bursts.
+
+## Type
+Programmed hi-hat sound (closed, sometimes open).
+
+## Sound character
+- Tight, crisp
+- Short decay
+- Often layered
+- Rapid sequences possible
+
+## Patterns
+### Standard trap
+- 8th notes basic
+- Add 16th notes for energy
+- Triplet rolls (signature trap sound)
+- 32nd note bursts (rare, dramatic)
+
+### Triplet rolls (signature)
+Three notes per beat, faster section. Creates "rolling" sound.
+
+### Hi-hat opens
+Open hi-hats on off-beats (rare in trap, for variation).
+
+## Genre fit
+- Trap (essential)
+- Modern hip-hop (since ~2010)
+- Drill (slightly different patterns)
+- Modern R&B
+- Sometimes pop
+
+## Programming notes
+- Quantize tightly (machine-perfect)
+- Velocity variations for groove
+- Reverb minimal (dry sound)
+- Layer multiple hi-hats sometimes
+
+## For Suno
+```
+[Trap hi-hats: rapid 16th note pattern with triplet rolls, tight programming]
+```
+
+```
+[Trap hi-hats: standard 8ths with occasional 32nd note bursts, modern trap]
+```
+
+## When to use
+Trap and modern hip-hop. Defining element. Avoid in acoustic / live drum contexts.

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

@@ -0,0 +1,63 @@
+# Trumpet — Instrument
+
+> Brass instrument. Bright, powerful, declarative. Jazz and orchestral standard.
+
+## Type
+Brass instrument. Lip-buzzed.
+
+## Range
+F#3 to D6 (standard B-flat trumpet).
+
+## Sound character
+- Bright, brilliant
+- Powerful, declarative
+- Can be aggressive or warm
+- Cuts through mix
+
+## Playing styles
+### Classical
+- Lyrical melodies
+- Fanfares
+- Orchestral parts
+
+### Jazz
+- Improvised solos
+- Bebop runs
+- Lyrical ballads
+- Muted (Miles Davis style)
+
+### Latin
+- Mariachi (often pairs)
+- Salsa (section)
+
+### Soul / Funk
+- Section punches
+- Brass hits
+
+### Hip-hop
+- Sample source (often)
+
+## Mutes
+- Cup mute (warm, soft)
+- Harmon mute (Miles Davis cool)
+- Plunger mute (jazz expressive)
+
+## Genre fit
+- Classical / orchestral
+- Jazz (essential)
+- Latin (mariachi, salsa)
+- Soul / funk (sections)
+- Film score (heroic)
+- Cinematic moments
+
+## For Suno
+```
+[Trumpet: lyrical jazz solo, muted Miles Davis style, smoky atmosphere]
+```
+
+```
+[Trumpet: heroic fanfare, brass section, orchestral cinematic]
+```
+
+## When to use
+Heroic / triumphant moments (orchestral). Jazz character. Latin authenticity. Brass section accents.

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

@@ -0,0 +1,51 @@
+# Violin (Solo) — Instrument
+
+> Solo violin. Most expressive of string family. Wide emotional range.
+
+## Type
+Bowed string instrument. Solo (vs section).
+
+## Range
+G3 to E7+ (over 4 octaves).
+
+## Playing styles
+- Lyrical melodies (singing-style)
+- Fast passages (virtuoso)
+- Pizzicato (plucked)
+- Double stops (two notes)
+- Folk fiddle style (rhythmic, dance)
+- Klezmer (Eastern European)
+
+## Genre fit
+- Classical (concertos, sonatas)
+- Folk (fiddle in country, Celtic, Eastern European)
+- Indie folk (Owen Pallett, Andrew Bird)
+- Film score (emotional moments)
+- Jazz (rare, but exists)
+
+## Sound character
+- Singing voice quality
+- Emotional, expressive
+- Can be tender or aggressive
+- Classical: refined
+- Fiddle: rhythmic, danceable
+
+## Sub-styles
+- Classical violin
+- Country fiddle
+- Celtic fiddle
+- Bluegrass fiddle
+- Klezmer violin
+- Jazz violin (rare)
+
+## For Suno
+```
+[Violin solo: lyrical melodic line, emotional, classical style with vibrato]
+```
+
+```
+[Fiddle: rhythmic country style, dance feel, double stops]
+```
+
+## When to use
+Solo emotional moments. Folk authenticity. Cinematic emotional peaks. Replace lead vocal occasionally.

package/templates/skills/composer/knowledge/key-signature-mood.md

@@ -0,0 +1,128 @@
+# Key Signature & Mood — Music Knowledge
+
+> Key signature defines emotional palette. Critical compositional choice.
+
+## Major keys (generally bright)
+
+| Key | Mood / character |
+|-----|-----------------|
+| C major | Pure, simple, innocent, accessible |
+| G major | Open, hopeful, pastoral, country |
+| D major | Triumphant, bright, anthem |
+| A major | Joyful, energetic, confident |
+| E major | Brilliant, exciting, royal |
+| B major | Powerful, virtuosic |
+| F major | Pastoral, calm, comforting |
+| Bb major | Warm, romantic, lush |
+| Eb major | Heroic, noble, "love" key |
+| Ab major | Dreamy, contemplative |
+| Db major | Rich, warm, intimate |
+
+## Minor keys (generally darker)
+
+| Key | Mood / character |
+|-----|-----------------|
+| A minor | Melancholic, contemplative, neutral sad |
+| E minor | Sad, longing, yearning, feminine sad |
+| D minor | Serious, tragic, "saddest of all keys" (Spinal Tap joke aside) |
+| G minor | Brooding, dramatic, dignified sad |
+| C minor | Tragic, dark, deeply sad, classical sorrow |
+| F minor | Mournful, weeping, deeply sad |
+| Bb minor | Funereal, dark beyond sad |
+| Eb minor | Cruel, anxious, deeply troubled |
+| F# minor | Restless, agitated |
+| C# minor | Mournful, romantic darkness |
+
+## Picking key by mood
+
+### Want: bright, happy, anthem
+→ D major, A major, E major
+
+### Want: pastoral, calm, comforting
+→ F major, G major
+
+### Want: warm, romantic
+→ Bb major, Eb major, Ab major
+
+### Want: melancholic but not too dark
+→ A minor, E minor
+
+### Want: tragic, sad
+→ D minor, G minor, C minor
+
+### Want: deeply sad / mournful
+→ F minor, Bb minor
+
+### Want: dark / brooding
+→ G minor, C minor, F# minor
+
+## Pick key by vocal range
+
+### Female alto (E3-F5)
+Best keys: A, B, C, D, E, F, G major or minor
+
+### Female mezzo (A3-A5)
+Best keys: C, D, E, F, G, A major or minor
+
+### Female soprano (C4-C6)
+Best keys: D, E, F, G, A, Bb major or minor (higher)
+
+### Male tenor (C3-C5)
+Best keys: A, B, C, D, E major or minor
+
+### Male baritone (G2-G4)
+Best keys: F, G, A, Bb major or minor
+
+### Male bass (E2-E4)
+Best keys: D, E, F, G major or minor (lower)
+
+## Key changes (modulation)
+
+### Up a step (most common)
+Final chorus modulates up a whole or half step. Adds energy.
+Example: C → D, or C → C#
+
+### Up a 4th
+Common in classic pop.
+Example: C → F
+
+### Parallel minor/major
+Switches between same letter major/minor for mood shift.
+Example: C major verse → C minor bridge
+
+## Cultural / regional considerations
+
+### Azerbaijani mugham modes
+Mugham uses different scales (modes):
+- Rast — major-like, joyful
+- Şur — pentatonic-like, melancholic
+- Çahargah — mixed, dramatic
+- Bayatı-Şiraz — sad, longing
+- Segah — tragic, deeply emotional
+
+For Azerbaijani-style music, mention the mugham mode if applicable:
+```
+[Style: mugham, Şur mode, melancholic]
+```
+
+### Other modal music
+- Phrygian mode — Spanish, Middle Eastern
+- Dorian mode — Celtic, jazz
+- Mixolydian — folk, blues
+
+## For AI music (Suno)
+
+Specify key in prompt:
+```
+[Style: indie folk, 75 BPM, key F minor, melancholic]
+```
+
+Suno respects key specifications.
+
+## Common key mistakes
+
+- Key outside vocal range
+- Wrong mood for content
+- Random key with no purpose
+- No key specified (Suno picks randomly)
+- Modulation that doesn't fit context