@azerogluemin/ai-bootstrap 0.2.1

package/templates/skills/composer/knowledge/production-styles/vintage-analog.md

@@ -0,0 +1,67 @@
+# Vintage Analog — Production Style
+
+> 60s-70s analog recording aesthetic. Warm tube saturation. Wide dynamics.
+
+## Defining elements
+
+- Recorded on tape (or emulated)
+- Tube preamps / compressors
+- Less loudness compression
+- Wider dynamic range
+- Mono or simple stereo (period accurate)
+- Era-appropriate equipment
+
+## Sound character
+- Warm
+- Round (less harsh treble)
+- Dynamic (peaks and quiet preserved)
+- "Three-dimensional" feel
+- Period-accurate
+
+## Genre fit
+- Classic rock revivals
+- Soul / funk
+- Vintage R&B
+- Indie folk (Father John Misty)
+- Period film score
+- Jazz revival
+
+## Production techniques
+- Tape emulation (Studer, Ampex)
+- Tube preamp emulation (Neve, API)
+- Compression: 1176, LA-2A, Distressor
+- Vintage reverb (plate, spring)
+- Less aggressive limiting
+- Period-accurate panning (often more centered)
+
+## When to use
+- 60s-70s aesthetic intended
+- Classic genres revival
+- Warm rich production desired
+- Less compressed dynamics
+
+## Famous vintage analog records
+- Beatles "Sgt. Pepper's"
+- Pink Floyd "Dark Side of the Moon"
+- Stevie Wonder "Songs in the Key of Life"
+- Marvin Gaye "What's Going On"
+- Modern recreations: Father John Misty, Leon Bridges
+
+## For Suno
+```
+[Production: vintage analog 70s aesthetic, tape saturation, tube preamp 
+warmth, plate reverb, less loud mastering with full dynamic range, 
+period-accurate]
+```
+
+## Modern artists using vintage analog
+- Leon Bridges (60s soul recreation)
+- Father John Misty (70s singer-songwriter)
+- Black Pumas (modern soul vintage)
+- St. Vincent (selectively)
+
+## Avoid pairing with
+- Modern EDM
+- Trap / modern hip-hop
+- Synthpop
+- Modern pop loudness

package/templates/skills/composer/knowledge/song-structure.md

@@ -0,0 +1,97 @@
+# Song Structure — Music Knowledge
+
+> Universal song structure principles. Loaded with every music generation request.
+
+## Standard structures
+
+### Pop / radio (most common)
+```
+Intro (4-8 bars)
+Verse 1 (16 bars)
+Pre-Chorus (8 bars, optional)
+Chorus (16 bars)
+Verse 2 (16 bars)
+Pre-Chorus (8 bars)
+Chorus (16 bars)
+Bridge (8-16 bars)
+Final Chorus (16 bars, often louder/elaborated)
+Outro (4-8 bars)
+```
+
+Total: ~3-3:30 min at 100-120 BPM.
+
+### Hip-hop / rap
+```
+Intro (4-8 bars)
+Verse 1 (16 bars)
+Hook/Chorus (8 bars)
+Verse 2 (16 bars)
+Hook (8 bars)
+Verse 3 or Bridge (8-16 bars)
+Hook (8 bars)
+Outro (4-8 bars)
+```
+
+### Electronic / EDM
+```
+Intro (8-16 bars)
+Build-up (8 bars)
+Drop (16-32 bars)
+Breakdown (8-16 bars)
+Build-up
+Drop
+Outro
+```
+
+### Folk / acoustic
+```
+Verse 1
+Chorus
+Verse 2
+Chorus
+Bridge
+Final Chorus (often a cappella or stripped)
+```
+
+## Section roles
+
+- **Intro** — sets tone, hooks listener
+- **Verse** — story / narrative content
+- **Pre-Chorus** — builds tension, leads to chorus
+- **Chorus** — emotional core, hook, repeated
+- **Bridge** — contrast, new perspective, peak
+- **Outro** — resolution, fadeout
+
+## Bar counting
+
+Standard pop: 16 bars per section common
+4/4 time signature: 4 beats per bar
+At 120 BPM: 16 bars = 32 seconds
+
+## Common mistakes
+
+- No clear chorus (audience can't sing along)
+- Bridge missing or unmemorable
+- Repetition without variation
+- Inconsistent section lengths
+- Intro too long
+- Outro abrupt
+
+## For Suno specifically
+
+Use section tags in prompt:
+```
+[Verse 1]
+lyrics here
+
+[Chorus]
+lyrics here
+
+[Verse 2]
+lyrics here
+
+[Bridge]
+lyrics here
+```
+
+Suno respects these structural markers.

package/templates/skills/composer/knowledge/tempo-bpm-guide.md

@@ -0,0 +1,141 @@
+# Tempo / BPM Guide — Music Knowledge
+
+> BPM (beats per minute) defines song's energy and pace. Critical first decision.
+
+## BPM ranges by feel
+
+| BPM | Feel | Use case |
+|-----|------|----------|
+| 40-60 | Very slow | Ballad, ambient, funeral |
+| 60-80 | Slow | Slow ballad, folk, R&B slow jam |
+| 80-100 | Moderate slow | Pop ballad, mid-tempo R&B, hip-hop |
+| 100-120 | Moderate | Pop, rock, indie, modern hip-hop |
+| 120-140 | Upbeat | Dance pop, rock, EDM intro |
+| 140-160 | Energetic | Drum and bass, fast rock, EDM |
+| 160-180 | Very fast | Hardcore, speed metal, jungle |
+| 180+ | Extreme | Speedcore, gabber |
+
+## BPM by genre
+
+### Slow (60-90 BPM)
+- Ballads (60-75)
+- Slow R&B (70-85)
+- Slow hip-hop (70-85)
+- Folk (75-95)
+- Ambient (60-90)
+
+### Mid (90-120 BPM)
+- Pop (95-115)
+- Rock (100-120)
+- Hip-hop (90-110)
+- Modern R&B (90-115)
+- Indie (95-115)
+- Country (95-115)
+
+### Fast (120-150 BPM)
+- Dance pop (120-130)
+- House (120-130)
+- Disco (115-130)
+- Punk (140-180)
+- Modern rock (110-140)
+
+### Very fast (140+ BPM)
+- EDM (128-140)
+- Drum and bass (160-180)
+- Trap (130-150 typical, but doubled feel)
+- Hardcore (150-180)
+
+## BPM and mood
+
+### Slow BPM
+- Reflective
+- Melancholic
+- Romantic
+- Sad
+- Atmospheric
+
+### Mid BPM
+- Conversational
+- Mid-energy emotional
+- Most pop / radio
+- Universal
+
+### Fast BPM
+- Energetic
+- Joyful
+- Aggressive (in metal)
+- Dancing
+- Excitement
+
+## Cultural BPM norms
+
+### Azerbaijani folk
+- Slow mugham: 60-80
+- Folk dance (yallı, vagzalı): 110-140
+- Modern Azerbaijani pop: 95-120
+
+### Hip-hop regional differences
+- Trap (Atlanta): 130-150 doubled
+- East Coast: 90-95
+- West Coast: 90-105
+
+### Dance subgenres
+- House: 120-130
+- Techno: 125-150
+- Trance: 130-145
+- Drum and bass: 160-180
+
+## How to pick BPM
+
+### Match the lyrics
+- Slow lyrics need slow BPM
+- Fast wordplay needs fast BPM (or doubled feel)
+
+### Match the mood
+- Sad → slow
+- Energetic → fast
+- Reflective → mid-slow
+
+### Match genre conventions
+Don't break genre BPM unless intentionally (e.g., slow trap for atmospheric)
+
+## "Doubled" feel
+
+Trap and drum-and-bass often have doubled feel:
+- Drums at 75 BPM
+- Hi-hats at 150 BPM (double)
+- Listener perceives both
+
+For Suno, specify:
+```
+[BPM: 75 with doubled hi-hat feel, trap style]
+```
+
+## For AI music (Suno)
+
+Always specify BPM in prompt:
+```
+[Style: indie folk, 75 BPM, F minor]
+```
+
+Suno will compose at that tempo. Don't omit BPM — it's foundational.
+
+## Tempo changes within song
+
+Most songs maintain consistent BPM. Exceptions:
+- Half-time bridge (suddenly 1/2 speed feel)
+- Double-time bridge (suddenly 2x speed)
+- Accelerando (gradually speeding up)
+- Ritardando (gradually slowing)
+
+Specify if used:
+```
+[Bridge: half-time feel for emotional emphasis]
+```
+
+## Common BPM mistakes
+
+- Mismatched BPM and lyric pacing
+- BPM outside genre conventions (without intention)
+- Too fast for vocal performance
+- Tempo unclear (Suno picks randomly)

package/templates/skills/composer/knowledge/time-signature.md

@@ -0,0 +1,124 @@
+# Time Signature — Music Knowledge
+
+> Time signature = how rhythm is organized. Affects feel fundamentally.
+
+## What is time signature
+
+Two numbers like 4/4:
+- Top number = beats per bar
+- Bottom number = note value getting one beat (4 = quarter note)
+
+## Common time signatures
+
+### 4/4 (common time) — DEFAULT
+- 4 beats per bar
+- Most popular music uses this
+- Pop, rock, hip-hop, R&B, country, EDM
+- "ONE-two-three-four ONE-two-three-four"
+
+### 3/4 (waltz time)
+- 3 beats per bar
+- Triple feel
+- Waltz, country ballads, some folk
+- "ONE-two-three ONE-two-three"
+
+### 6/8 (compound duple)
+- 6 beats per bar grouped into 2 (1-2-3, 4-5-6)
+- Flowing, lilting feel
+- Folk, blues, ballads, Celtic music
+- "ONE-two-three FOUR-five-six"
+
+### 12/8 (compound quadruple)
+- 12 beats per bar grouped into 4
+- Slow blues, gospel, swing ballads
+- Triplet feel
+- Common in slow R&B
+
+### 5/4 (asymmetric)
+- 5 beats per bar
+- Less common, distinctive
+- "Take Five" by Dave Brubeck
+- Used for unusual feel
+
+### 7/8 (asymmetric)
+- 7 beats per bar
+- Common in Eastern European folk, prog rock
+- Pink Floyd "Money" (7/4 actually)
+- Distinctive uneven feel
+
+### 9/8 (compound triple)
+- 9 beats per bar
+- Less common
+- Modal jazz, certain folk
+
+## Time signature by genre
+
+### 4/4
+- Pop, rock, hip-hop, R&B, country, electronic, jazz (most), most film score
+
+### 3/4
+- Waltz, country ballads, some folk, "Norwegian Wood" (Beatles)
+
+### 6/8
+- Slow blues, gospel ballads, Irish jigs, "House of the Rising Sun"
+
+### 12/8
+- Slow blues, gospel ballads, "Hey Jude" (chorus feel)
+
+### 5/4
+- "Take Five" (Brubeck), Mission Impossible theme
+
+### 7/8
+- Eastern European folk, progressive rock
+
+### Mixed time signatures (advanced)
+Progressive metal, prog rock. Changing within song.
+
+## Cultural time signatures
+
+### Azerbaijani folk
+- Yallı dance: often 6/8
+- Mugham: free time often (no strict signature)
+- Modern Azerbaijani pop: usually 4/4
+
+### Middle Eastern
+- 9/8 common (Bulgarian/Turkish folk)
+- 7/8 common
+- Asymmetric rhythms valued
+
+### Latin
+- 4/4 standard
+- Salsa, Cuban: clave rhythm in 4/4
+
+## How time signature affects mood
+
+### 4/4
+Driving, predictable, accessible. The default for a reason.
+
+### 3/4
+Romantic, flowing, dance-like. Lilting feel.
+
+### 6/8
+Gentle, flowing, often nostalgic. Lullaby feel.
+
+### 12/8
+Bluesy, gospel-like. Slow but with internal triplet motion.
+
+### Asymmetric (5/4, 7/8)
+Distinctive, unusual, sometimes anxious or off-balance feel.
+
+## For AI music (Suno)
+
+Specify if not 4/4:
+```
+[Style: folk ballad, 75 BPM, 6/8 time signature]
+```
+
+For 4/4 (default), no need to specify.
+
+## Common time signature mistakes
+
+- Wrong genre for time signature (e.g., 6/8 for trap)
+- Inconsistent within song (unintentional)
+- Asymmetric without purpose
+- Not specifying when non-4/4 (Suno defaults to 4/4)

package/templates/skills/composer/knowledge/vocal-direction.md

@@ -0,0 +1,118 @@
+# Vocal Direction — Music Knowledge
+
+> Vocal type, style, and per-section assignment. Critical for character of the song.
+
+## Vocal types
+
+### Male voices
+- **Bass** — lowest, deep, rare in pop. Use for: gospel, opera, dramatic
+- **Baritone** — male standard. Use for: most male pop, rock, country
+- **Tenor** — higher male. Use for: soul, classic rock, opera
+- **Falsetto** — male singing in head voice (above natural range). Use for: R&B (The Weeknd), modern pop
+
+### Female voices
+- **Alto** — lower female range. Use for: soul, jazz, indie
+- **Mezzo** — middle female. Use for: pop, country
+- **Soprano** — high female. Use for: pop, opera, ethereal
+
+### Other
+- **Spoken word** — talking, not singing
+- **Rap** — rhythmic spoken
+- **Whisper** — intimate, vulnerable
+- **Choir** — multiple voices
+
+## Vocal style descriptors
+
+### Performance type
+- Lead — main melody
+- Harmony — supporting voice
+- Background vocals — atmospheric
+- Doubled — same vocalist recorded twice for thickness
+- Call-and-response — vocal answers vocal
+
+### Delivery style
+- Smooth, controlled
+- Raspy, gritty
+- Whispered, intimate
+- Belted, powerful
+- Auto-tuned
+- Melismatic (multiple notes per syllable)
+- Rhythmic / staccato
+- Sustained / legato
+
+### Cultural styles
+- Mugham (Azerbaijani classical) — ornamented, emotional
+- Gospel — call-and-response, choir backing
+- Operatic — vibrato, full voice
+- Yodeling — switching head/chest voice
+- Throat singing — multiple tones simultaneously
+
+## Per-section vocal assignment
+
+Common patterns:
+
+### Single vocalist
+Verse, chorus, bridge — same person throughout.
+
+### Duet
+- Verse 1: Person A
+- Verse 2: Person B
+- Chorus: Both together
+- Bridge: Trade lines
+
+### Multi-vocal
+- Verse: Lead alone
+- Pre-chorus: Backing harmonies enter
+- Chorus: Full harmonies
+- Bridge: Maybe just lead, or all together
+
+### Lead + Choir
+- Lead vocalist throughout
+- Choir on chorus only (or bridge)
+
+## Vocal effects
+
+- Reverb (wet/dry) — adds space
+- Delay — echo
+- Auto-tune — pitch correction (subtle to extreme T-Pain)
+- Vocoder — robotic
+- Distortion — aggressive
+- Doubling — thickness
+- Octave doubling — power
+
+## Examples (artist references)
+
+- **Modern R&B** (The Weeknd) — male falsetto, smooth
+- **Indie folk** (Bon Iver) — male falsetto, layered harmonies
+- **Soul** (Adele) — female alto, powerful, melismatic
+- **Country** (Chris Stapleton) — male baritone, raspy, emotional
+- **Pop** (Taylor Swift) — female mezzo, conversational, clear
+- **Opera** (Pavarotti) — male tenor, full voice, vibrato
+- **Mugham** (Alim Qasimov) — male, ornamented, traditional
+- **Hip-hop** (Kendrick Lamar) — rap, rhythmic, varied flow
+
+## For AI music (Suno)
+
+Specify vocals clearly:
+```
+[Vocals: female alto, lead throughout, doubled with male tenor on chorus]
+```
+
+Or per section:
+```
+[Verse: male baritone, intimate]
+[Pre-Chorus: male falsetto, building]
+[Chorus: female alto lead + male harmonies, powerful]
+[Bridge: duet, trade lines]
+```
+
+Suno respects vocal direction tags.
+
+## Common vocal mistakes
+
+- Wrong vocal type for genre
+- Range outside singer's ability
+- All sections same vocal style (no variation)
+- Effects overdone (too much auto-tune)
+- Background vocals louder than lead
+- Cultural mismatches

package/templates/skills/composer/knowledge/vocal-styles/duet-male-female.md

@@ -0,0 +1,71 @@
+# Duet (Male-Female) — Vocal Style
+
+> Two voices (male + female) sharing song. Romantic, conversational, dynamic.
+
+## What it is
+Two singers (typically one male, one female) alternating verses, sharing chorus, or harmonizing.
+
+## Sub-types
+
+### Trade verses
+- Verse 1: female
+- Verse 2: male
+- Chorus: both together
+
+### Call and response
+- One sings phrase, other answers
+- Conversational
+- Examples: "I Got You Babe" — Sonny & Cher
+
+### Harmonizing throughout
+- Both sing together with harmony
+- One leads, one supports
+- Examples: Eagles, Fleetwood Mac
+
+### Bridge duet
+- Most of song one vocalist
+- Bridge introduces second vocalist
+- Examples: many ballads with featured artist
+
+### True conversation
+- Lyrics are dialogue between characters
+- Examples: "Don't You Want Me" — Human League, "Islands in the Stream" — Kenny Rogers + Dolly Parton
+
+## Famous duets
+- "Endless Love" — Diana Ross + Lionel Richie
+- "Don't Go Breaking My Heart" — Elton John + Kiki Dee
+- "Beauty and the Beast" — Celine Dion + Peabo Bryson
+- "Senorita" — Shawn Mendes + Camila Cabello
+- "Shallow" — Lady Gaga + Bradley Cooper
+- "Up Where We Belong" — Joe Cocker + Jennifer Warnes
+
+## When to use
+- Romantic songs (dialogue)
+- Country duets (long tradition)
+- Pop ballads (featured artist)
+- Folk storytelling
+- Wedding songs
+
+## Lyric considerations
+- Dialogue structure
+- Different perspectives
+- Romantic call-and-response
+- Sometimes argument-style
+- Both voices need character
+
+## For Suno
+```
+[Vocals: duet male tenor + female mezzo, romantic ballad with trade 
+verses and harmonized chorus, conversational style]
+```
+
+```
+[Vocals: duet male baritone + female alto, country style with 
+storytelling, both voices alternating]
+```
+
+## Production
+- Both vocals clear in mix
+- Stereo separation (one slightly L, one R sometimes)
+- Harmonies blend naturally
+- Lead alternates clearly

package/templates/skills/composer/knowledge/vocal-styles/falsetto-male.md

@@ -0,0 +1,49 @@
+# Falsetto Male — Vocal Style
+
+> Male voice singing above natural range using head voice. Modern R&B / indie staple.
+
+## What is falsetto
+Male voice produced in head voice (not chest), reaching female alto/soprano range.
+
+## Range
+Above natural male range — can reach C5-C6.
+
+## Voice character
+- Light, airy
+- Vulnerable
+- Modern intimate
+- Smooth
+
+## Famous falsetto singers
+- **R&B**: The Weeknd, Frank Ocean, Maxwell, Justin Timberlake
+- **Indie folk**: Bon Iver (Justin Vernon — falsetto throughout)
+- **Pop**: Mika, Sam Smith
+- **Classic**: Prince, Bee Gees, Marvin Gaye
+- **Rock**: Thom Yorke (Radiohead), Jeff Buckley
+
+## When to use
+- Modern R&B (essential)
+- Indie folk (Bon Iver style)
+- Vulnerable emotional moments
+- Romantic intimate songs
+- Modern pop (vulnerable male)
+
+## Lyric considerations
+- Vulnerable themes
+- Romance / heartbreak
+- Intimate lyrics
+- Falsetto suggests emotional openness
+
+## For Suno
+```
+[Vocals: male falsetto, smooth modern R&B style with reverb, 
+vulnerable emotional delivery, The Weeknd-inspired]
+```
+
+```
+[Vocals: male falsetto, indie folk Bon Iver style with multiple tracked 
+harmonies, ethereal layered]
+```
+
+## Modern pop trend
+Falsetto male vocal has become THE sound of modern R&B (post-2010). Defines a generation of male vulnerability in music.

package/templates/skills/composer/knowledge/vocal-styles/female-alto.md

@@ -0,0 +1,48 @@
+# Female Alto — Vocal Style
+
+> Lower female voice. F3 to F5 typically. Soulful, jazzy, distinctive.
+
+## Range
+F3 (low) to F5 (high). Lower than mezzo.
+
+## Voice character
+- Warm, deep (for female)
+- Soulful, jazzy
+- Husky quality often
+- Distinctive, less common
+- Powerful or intimate
+
+## Famous altos
+- **Soul / Jazz**: Aretha Franklin (true alto), Toni Braxton
+- **Jazz**: Ella Fitzgerald (often), Sarah Vaughan
+- **Pop**: Cher (deep alto), Annie Lennox, Sade
+- **Country**: Trisha Yearwood, Wynonna Judd
+- **R&B**: Anita Baker, India.Arie
+- **Indie**: Florence Welch (Florence + the Machine, deep range)
+
+## When to use
+- Soul / jazz / R&B (essential)
+- Distinctive female voice
+- Husky / sultry contexts
+- Power ballads
+- Indie distinctive vocalists
+
+## Lyric considerations
+- Authority / depth
+- Soulful expression
+- Lower range allows intimate delivery
+- Harmony layer (alto in choir)
+
+## For Suno
+```
+[Vocals: female alto, husky soulful jazz style, warm deep tone, 
+range F3-F5]
+```
+
+```
+[Vocals: female alto, R&B with melismatic phrasing, powerful and 
+distinctive]
+```
+
+## Choir context
+In SATB choir, alto is the lower female section. Provides harmony below soprano.