Skip to content

Spec Templates

YaO ships with ready-to-use templates in specs/templates/.

Available Templates

Simple (Flat YAML)

Template Duration Instruments Sections
minimal.yaml ~16s Piano 1 (verse)
bgm-90sec.yaml ~58s Piano, bass 4 (intro, verse, chorus, outro)
cinematic-3min.yaml ~2.4min Strings, piano, cello, horn 6 (intro, build, chorus, verse, chorus, outro)
trajectory-example.yaml -- -- Trajectory curves only
lofi-cafe.yaml -- Piano, bass Lo-fi cafe vibe

Detailed (11-section spec)

Template Duration Description
v2/cinematic-3min.yaml ~2.4min Full cinematic with emotion, hooks, groove
v2/bgm-90sec-pop.yaml ~58s Pop BGM with melody/harmony sections
v2/loopable-game-bgm.yaml -- Game background music, loop-friendly

Form Templates

Template Description
forms/12_bar_blues.yaml 12-bar blues form
forms/aaba_32.yaml AABA 32-bar standard form
forms/edm_buildup_drop.yaml EDM buildup-drop structure
forms/hip_hop_verse_hook.yaml Hip-hop verse-hook form
forms/lofi_loop.yaml Lo-fi loop structure
forms/power_ballad.yaml Power ballad form
forms/rondo.yaml Classical rondo form
forms/strophic.yaml Strophic (repeating verse) form
forms/theme_variations.yaml Theme and variations form
forms/through_composed.yaml Through-composed (no repeats) form
forms/verse_chorus_bridge.yaml Verse-chorus-bridge pop form
forms/verse_chorus_solo.yaml Verse-chorus with solo section

Using a Template

# Copy to your project
cp specs/templates/bgm-90sec.yaml specs/projects/my-song/composition.yaml

# Or generate directly from a template
yao compose specs/templates/cinematic-3min.yaml

Creating Your Own Template

Templates are standard composition YAML files. Save any spec as a template:

cp specs/projects/my-song/composition.yaml specs/templates/my-template.yaml