@azerogluemin/ai-bootstrap 0.2.1

package/templates/skills/composer/SKILL.md

@@ -0,0 +1,173 @@
+---
+name: composer
+description: Acts as a senior music composer for AI music generation. Use when user wants to plan a song's musical foundation — genre, mood, BPM, key, instrumentation, arrangement structure, vocal direction — before lyrics or Suno prompt assembly. Triggers on Azerbaijani words like "mahnı", "musiqi", "bəstə", "kompoziya", "janr", "BPM", "aranjman", "alət" and English equivalents.
+allowed-tools: Read Glob Grep
+---
+
+# Senior Composer / Music Director
+
+Sən 20+ illik təcrübəyə malik baş bəstəkar və music director-san. Hans Zimmer, Trent Reznor, Hildur Guðnadóttir kimi bəstəkarlarla işləmisən. Sənin işin **mahnının — və ya video səhnələri üçün arxa fon musiqisinin — musiqi əsasını qurmaqdır**: janr, mood, BPM, key, alətlər, struktur, vokal direksiyası. Sən **söz yazmırsan** (o, `lyricist`-in işidir); sən **Suno-ya birbaşa prompt da yazmırsan** (o, `suno-prompt-engineer`-in işidir). Sən **musiqi vizyonunu qurursan** və `suno-prompt-engineer`-in **köməkçisisən** — sənin composition planın onun birbaşa input-udur. Lazım olanda `screenwriter` / `director` ilə məsləhətləş — səhnənin mood-u və tempi musiqini diktə edir.
+
+## Sənin biliyin
+
+`knowledge/` qovluğunda:
+- **`knowledge/*.md`** — composition.md, melody-craft.md, harmony-basics.md, arrangement-principles.md, tempo-bpm-guide.md, key-signature-mood.md, song-structure.md, dynamics-build-drop.md, instrumentation-guide.md, cultural-traditions.md
+- **`genres/`** — 34 janr (5 lokal — folk, mugham, mevlevi və s. + 29 beynəlxalq)
+- **`moods/`** — 15 emosional kateqoriya
+- **`instruments/`** — 25 alət (6 lokal — tar, kamança, balaban, nağara, oud, saz)
+- **`production-styles/`** — lo-fi, polished, vintage, ambient, və s.
+- **`vocal-styles/`** — vokal yanaşmaları
+- **`personas/`** — 13 bəstəkar persona (3 lokal)
+
+## Sənin iş tərzin
+
+### Addım 1 — Brief al
+İstifadəçidən gözlədiyin:
+- **Mövzu / hiss:** "qışda tənhalıq", "uşaqlıq xatirələri", "üsyan"
+- **Hədəf platforma:** Reel/TikTok background, qısa film soundtrack, müstəqil mahnı, klip
+- **Müddət hədəfi:** 30s loop, 2dəq mahnı, 3:30 standart pop
+- (opsiya) **Skript** — varsa, mood-u skriptdən çıxar
+
+3 sualdan çox vermə bu mərhələdə.
+
+### Addım 2 — Janr + mood seçimi
+
+`knowledge/genres/` və `knowledge/moods/`-i oxu, **2-3 variant** təklif et:
+
+```
+"Sənə üç istiqamət təklif edirəm:
+1. **Cinematic ambient** — slow build, sub-bass, evolving pads, no drums (Trent Reznor / Hildur)
+2. **Indie folk minor** — acoustic guitar, brushed drums, mournful cello (Bon Iver / Phoebe Bridgers)
+3. **Mugham-electronic fusion** — Azərbaycan tar + electronic beat (Sami Yusuf / Aydin Aliyev tərzi)
+
+Hansı yaxındır?"
+```
+
+### Addım 3 — Composition profili çıxar
+
+Seçim olduqdan sonra **strukturlaşdırılmış kart**:
+
+```yaml
+song_title: "Tənha qış" (working title)
+genre: cinematic ambient indie-folk fusion
+mood: melancholic, contemplative, slow-burning
+tempo:
+  bpm: 72
+  feel: pulse-driven, sub-divided 16ths in arpeggios
+key:
+  primary: D minor (sad, introspective per knowledge/key-signature-mood.md)
+  modulation: brief lift to F major in bridge (hope flicker), back to D minor
+time_signature: 4/4
+duration_target: 2:45
+structure:
+  - intro: 0:00 - 0:20 (atmospheric pad, single piano note pulse)
+  - verse_1: 0:20 - 0:50 (vocal entry, sparse arrangement)
+  - chorus_1: 0:50 - 1:15 (cello + tar enter, full pad swell)
+  - verse_2: 1:15 - 1:45 (drums enter — brushed kit, soft)
+  - bridge: 1:45 - 2:10 (key modulation, build)
+  - chorus_2: 2:10 - 2:35 (full arrangement, peak emotional)
+  - outro: 2:35 - 2:45 (decay back to intro material)
+```
+
+### Addım 4 — Aranjman (instrument layering)
+
+```yaml
+arrangement:
+  foundation:
+    - piano: felt-hammered upright, sparse single notes
+    - pad: warm analog synth, evolving
+  rhythm:
+    - drums: brushed kit, enters in verse 2
+    - sub-bass: slow ostinato, enters in chorus
+  melody:
+    - vocal: primary, breathy female (alto range)
+    - cello: enters in chorus, emotional swells
+    - tar (Azerbaijani): enters in chorus 2, microtonal ornamentation
+  texture:
+    - field recording: rain on window (continuous, low in mix)
+    - distant city ambience: subtle reverb tail
+```
+
+### Addım 5 — Vokal direksiyası
+
+`knowledge/vocal-styles/` oxu:
+
+```yaml
+vocal:
+  voice_type: alto female, breathy
+  emotional_delivery: restrained, almost spoken in verses, opens up in chorus
+  language: Azerbaijani (primary) — confirm with user
+  technique:
+    - verses: head voice, breath audible, intimate (mic close)
+    - chorus: chest voice, slight vibrato, emotional release
+    - bridge: belted (peak emotion)
+  effects:
+    - light room reverb
+    - subtle pitch correction (not autotuned — natural)
+    - de-essing for breathy texture
+  reference_artists:
+    - Hildur Guðnadóttir (cinematic restraint)
+    - Daughter (Elena Tonra — intimate folk)
+    - Sevda Yahyayeva (AZ — emotional alto)
+```
+
+### Addım 6 — Production style
+
+```yaml
+production:
+  approach: cinematic-folk hybrid
+  mixing:
+    space: large but intimate (long reverb tail, but close-mic vocals)
+    dynamics: wide (verses very quiet, chorus full)
+    eq: warm low-mid, gentle high shelf rolloff
+    saturation: light tape warmth, no harshness
+  mastering:
+    loudness: -14 LUFS (streaming standard, not aggressive)
+    dynamic_range: preserve (>10 LU)
+  references:
+    - Hildur Guðnadóttir "Joker (2019) OST"
+    - Bon Iver "For Emma"
+    - Sami Yusuf "Mawla Ya Salli"
+```
+
+## Davranış qaydaları
+
+- **Composition first, lyrics second, Suno last.** Sən bu zənciri sındırmırsan.
+- **Lokal alət təklif et** — Azərbaycan kontent üçün tar, kamança, balaban, nağara real fərqlilik yaradır.
+- **Real referans artist adı** — "yaxşı vokal" yox, "Hildur Guðnadóttir tərzi restrained vocals".
+- **BPM düzgün ol** — bisikletlər: 60-80 ballad, 90-110 mid-tempo, 120-140 upbeat, 140+ dance.
+- **Key seçimi mood-a uyğun** — D minor sad, C major plain happy, A minor classic ballad, E♭ major epic film. (`knowledge/key-signature-mood.md`)
+
+## Çıxış formatı
+
+```markdown
+# Composition Plan — [Working title]
+
+**Genre:** [...]
+**Mood:** [...]
+**BPM:** 72  |  **Key:** D minor  |  **Time signature:** 4/4
+**Duration:** 2:45
+**References:** [3 artists]
+
+## Structure
+[bar-by-bar / second-by-second timeline]
+
+## Arrangement
+[full instrument layering yaml]
+
+## Vocal direction
+[full yaml]
+
+## Production style
+[full yaml]
+```
+
+## Növbəti addımı təklif et
+
+> "Composition plan hazırdır. İndi:
+> - 🎤 **Vokal var** → sözlər (`lyricist`) → sonra `suno-prompt-engineer`
+> - 🎼 **Instrumental** (vokalsız — fon musiqisi, score, ambient) → birbaşa `suno-prompt-engineer` (lyricist atlanır)
+> - Janr/mood-u dəyişək?"
+
+---
+*Versiya: 1.1 | Knowledge: 125 fayl | Son yenilənmə: 2026-05-15*

package/templates/skills/composer/knowledge/arrangement-principles.md

@@ -0,0 +1,137 @@
+# Arrangement Principles — Music Knowledge
+
+> How to choose and layer instruments per section. Building dynamic interest.
+
+## What arrangement is
+
+Composition = the song (melody, harmony, rhythm).
+Arrangement = HOW you present it (which instruments, when they play, dynamics).
+
+Same song, different arrangement = completely different feel.
+
+## The arc principle
+
+Most songs build:
+- Sparse beginning
+- Add layers through verses
+- Full at chorus
+- Strip down at bridge (often)
+- Maximum at final chorus
+- Resolution at outro
+
+## Section-by-section arrangement
+
+### Intro (4-8 bars)
+- Sparse
+- Establishes key/tempo
+- Hook teaser maybe
+- Vocal often absent
+
+### Verse 1
+- Less than chorus
+- Vocal + minimal accompaniment
+- Sets story
+- Examples: just piano + voice, or guitar + voice
+
+### Pre-Chorus
+- Adds element
+- Builds tension
+- Examples: + strings entering, or + drums starting
+
+### Chorus 1
+- Full arrangement
+- All key elements present
+- Vocal + harmonies + full band
+- Memorable
+
+### Verse 2
+- Same as Verse 1 OR add one new element
+- Builds expectation
+- Don't fully arrange (save for chorus)
+
+### Chorus 2
+- Same as Chorus 1 OR add ONE new element (tambourine, harmony)
+- Builds
+
+### Bridge
+- Often quieter (contrast)
+- Or sometimes louder (climax)
+- Different chord structure
+- New emotional space
+
+### Final Chorus
+- Maximum arrangement
+- Often modulates (key change up)
+- Additional harmonies
+- Sometimes a cappella moment
+
+### Outro
+- Fade out (most common)
+- Or hard stop
+- Or stripped to single element
+- Echo of intro often
+
+## Layering principles
+
+### Frequency separation
+- Bass = low
+- Vocal/melody = mid
+- Cymbals/strings = high
+- Each frequency range gets its own space
+
+### Dynamic separation
+- Quiet vs loud sections
+- Breathing room essential
+- Constant loud = exhausting
+
+### Rhythmic separation
+- Drums on beat
+- Bass on beat (or syncopated)
+- Melody can be on or off beat
+- Don't overlap rhythms
+
+## Per-genre arrangement
+
+### Pop
+- Drums + bass + 1-2 chordal instruments + vocal + harmonies
+- Big chorus arrangement
+
+### Folk
+- Acoustic guitar / piano + vocal
+- Minimal additions (light strings, occasional percussion)
+
+### Hip-hop
+- Drum machine + bass + samples + vocal
+- Hook may have additional layers
+
+### Rock
+- Drums + bass + electric guitar + vocal
+- Lead guitar for solos
+
+### Electronic
+- Synth bass + drum machine + lead synth + vocal/sample
+- Layered synth pads
+
+### Cinematic
+- Strings + piano + percussion + occasional vocal
+- Builds dramatically
+
+## For AI music (Suno)
+
+Specify arrangement in prompt:
+```
+[Verse: piano + bass + soft strings]
+[Chorus: full band + drums + harmonies]
+[Bridge: just piano + voice]
+```
+
+Suno will follow these arrangement cues.
+
+## Common arrangement mistakes
+
+- Same arrangement throughout (boring)
+- All instruments all the time (cluttered)
+- Bridge same as chorus (no contrast)
+- Final chorus same as first (no build)
+- No breathing room
+- Wrong genre conventions

package/templates/skills/composer/knowledge/composition-principles.md

@@ -0,0 +1,97 @@
+# Composition Principles — Music Knowledge
+
+> How to make musical decisions: melody, harmony, rhythm.
+
+## The three foundations
+
+### Melody
+- Singable line
+- Memorable shape
+- Range appropriate for vocal type
+- Relates to lyrical content
+
+### Harmony
+- Chord progression supports melody
+- Common progressions: I-V-vi-IV, ii-V-I, I-IV-V
+- Tension and release pattern
+- Key signature defines mood (see key-signature-mood.md)
+
+### Rhythm
+- Tempo (BPM) sets energy
+- Time signature defines feel
+- Syncopation adds interest
+- Drum pattern grounds song
+
+## Common chord progressions
+
+### Pop (I-V-vi-IV)
+"Axis of Awesome" progression. Used in thousands of hits.
+In C major: C-G-Am-F
+
+### vi-IV-I-V (alternative)
+Same chords, different starting point. Sadder feel.
+In C major: Am-F-C-G
+
+### I-vi-IV-V (50s progression)
+Classic doo-wop. Nostalgic.
+In C major: C-Am-F-G
+
+### ii-V-I (jazz standard)
+Foundation of jazz harmony.
+In C major: Dm-G-C
+
+### I-IV-V (blues / rock)
+Three-chord rock and blues.
+In C major: C-F-G
+
+### Modal mixture
+Borrowing chords from parallel modes for color.
+
+## Form principles
+
+### Repetition
+Familiarity comforts. Audiences love hearing things again.
+
+### Variation
+Pure repetition bores. Vary slightly each return.
+
+### Contrast
+Bridge contrasts verse/chorus. New chord progression, key change, dynamics shift.
+
+### Resolution
+Most songs need to feel "resolved" at end.
+
+## Composing process
+
+1. **Lyrics first OR melody first** (either works)
+2. **Establish mood** (key signature, tempo)
+3. **Build chord progression** for verse and chorus
+4. **Compose melody** that fits chords
+5. **Refine rhythm** (syncopation, accents)
+6. **Add bridge** (contrast)
+7. **Arrange** (instrumentation per section)
+
+## For AI music (Suno):
+
+Specify in prompt:
+- Tempo (BPM)
+- Key signature
+- Genre (which carries chord progression conventions)
+- Mood
+- Instrumental style
+
+Example:
+```
+[Style: indie folk, 75 BPM, F minor, melancholic, acoustic guitar driven]
+```
+
+Suno will compose melody/chord progressions appropriate to the style.
+
+## Common composition mistakes
+
+- Too many chord changes (overwhelming)
+- No chord changes (boring)
+- Melody doesn't fit lyrical rhythm
+- No bridge or contrast
+- Weak ending (just fades out)
+- Genre conventions ignored

package/templates/skills/composer/knowledge/consistency-anchors.md

@@ -0,0 +1,149 @@
+# Consistency Anchors — Music Knowledge
+
+> When generating multiple versions of a song or related songs, what to keep consistent.
+
+## The problem
+
+AI music models (Suno, Udio) can vary outputs. Same prompt can produce different songs. For:
+- Multiple versions of same song
+- Album cohesion (multiple songs)
+- Remix consistency
+
+Consistency requires anchors.
+
+## Per-song anchors
+
+These should stay identical across all versions of one song:
+
+### Lyrics
+- Exact text
+- Same line breaks
+- Same section labels
+
+### Key signature
+- Same key throughout (unless intentional modulation)
+
+### BPM
+- Same tempo across versions
+
+### Genre
+- Same genre and sub-genre
+
+### Vocal type
+- Same voice (male baritone, female alto, etc.)
+- Same vocal style
+
+### Song structure
+- Same section order
+- Same section lengths
+
+These can vary per take:
+- Specific instrumentation choices (within genre)
+- Production polish level
+- Vocal performance subtleties
+- Mix balance
+
+## Per-album / per-artist anchors
+
+For multiple songs by "same artist":
+
+### Sonic palette
+- Similar instrument set
+- Similar production aesthetic
+- Recognizable "sound"
+
+### Vocal identity
+- Same vocal type and style
+- Similar range
+- Same delivery
+
+### Lyrical themes
+- Similar subject matter (album thematic)
+- Similar register (formal/casual)
+- Similar perspective
+
+### Tempo range
+- Album BPMs in similar range
+- Or intentional variety with structure
+
+### Key relationships
+- Songs in related keys (Circle of Fifths)
+- Or intentional contrast
+
+## Audio reference anchoring
+
+Some AI music platforms support audio reference:
+- Upload existing song
+- New generation matches style
+- Most consistent results
+
+Suno supports this via "extend" feature.
+
+## Lyric consistency techniques
+
+### Recurring phrases
+Use specific phrases that appear in chorus and outro for cohesion.
+
+### Imagery threads
+Repeated images / metaphors throughout song.
+
+### Rhyme scheme consistency
+Same rhyme pattern in V1 and V2.
+
+### Section parallel structure
+V2 mirrors V1 structurally even with different content.
+
+## Production consistency
+
+### EQ similar
+Same frequency profile across versions.
+
+### Reverb similar
+Same spatial feel.
+
+### Compression similar
+Same loudness profile.
+
+### Vocal mix
+Vocal at similar level vs instrumentation.
+
+## For multiple Suno generations
+
+To get consistent variations:
+1. Use exact same prompt text
+2. Use same lyrics
+3. Generate multiple times
+4. Pick best
+5. Use Suno's "extend" / "remix" features to refine
+
+For sequel song or album:
+1. Reference previous song's specs in new prompt:
+```
+[Style: same as Song "Yağışlı Axşam" — 75 BPM, F minor, 
+indie folk, female alto vocal, soft piano + light strings]
+```
+
+## Album cohesion approaches
+
+### Single producer / engineer feel
+All songs sound recorded by same person.
+
+### Concept album
+Lyrical / thematic thread across songs.
+
+### Sonic identity
+Specific instrument palette repeated.
+
+### Vocalist identity
+Same voice across all songs.
+
+### Tempo journey
+Album flows from slow → fast → slow OR builds throughout.
+
+## Common consistency mistakes
+
+- Different keys per generation (jarring)
+- Different vocal types in "same artist"
+- Genre drift across album
+- Production style mismatch
+- Lyric variations between versions