| name | arrangement-coach |
|---|---|
| description | Use when the user has a Session-view loop and wants to promote it to a full Arrangement, build sections (intro/verse/drop/break/outro), or extend a 4-bar idea into a 3-minute track. Examples - "turn this loop into a full song", "build me a 2-minute arrangement from this", "promote session to arrangement". |
Promote a Session-view loop into a structured Arrangement, or extend a short idea into a full-length track. The user owns the musical content; you handle structural decisions.
get_session_info— confirm session vs arrangement stateget_track_infofor each track — collect all clips currently in Session view- Identify the loop length (most likely 4 or 8 bars) and the BPM
Ask the user once: "Which structure?"
| Template | Length | Sections |
|---|---|---|
| Pop | ~3 min | Intro 8 → V1 16 → Pre 8 → Chorus 16 → V2 16 → Pre 8 → Chorus 16 → Bridge 8 → Chorus 16 → Outro 8 |
| EDM | ~4 min | Intro 16 → Build 16 → Drop 32 → Break 32 → Build 16 → Drop 32 → Outro 16 |
| Lo-fi | 2-3 min | Intro 4 → Loop A x4 → Variation x2 → Loop A x2 → Tail 4 |
| Cinematic | varies | Stmt → Dev → Climax → Resolution. Use rubato; bar count flexible. |
| Hip-hop | 2-3 min | Intro 4 → V1 16 → Hook 8 → V2 16 → Hook 8 → Bridge/V3 16 → Hook 8 → Outro 4 |
For each section in the template:
- Identify which Session clips fit (most loops can serve multiple sections by muting/unmuting tracks)
- Use
create_arrangement_clip(or equivalent) to drop clips at the right bars on the right tracks - Mute tracks that shouldn't play in that section (intro = drums + bass only; chorus = everything; bridge = strip back)
- Risers before drops (if EDM/pop) — white noise sweep, snare roll, reverse cymbal
- Drum fills at section boundaries — tom roll into the chorus
- Filter automation — high-pass sweep into a build, low-pass into a break
- Reverb tail throw — send the last hit of a section through the delay/reverb return
- -1 to -3 dB dip in breakdowns
- Slight push (+0.5 dB) into final chorus
- Don't ride more than 3 dB; let the mix do the work
Before applying, summarize: "I'll build a 2:48 EDM structure: intro 16, build 16, drop 32, break 32, build 16, drop 32, outro 16. Drum fills at every section boundary, filter sweep into builds, master fader -2 dB in break. Apply?"
- Don't rewrite the user's musical content — only arrange existing clips.
- Don't add sections the user didn't ask for ("I added a key change in the bridge").
- Don't apply heavy automation to the master without explicit ask.
- Don't quantize or modify clip contents — that's
midi-cleanup's job.
User: "I have a 4-bar lo-fi loop, give me a full 2-minute track"
Steps:
- Read session — 4 tracks (drums, bass, keys, pad), 4-bar loops on all
- Apply lo-fi template: 2:00 = ~50 bars at 90 BPM
- Drop clips: intro 4 (just keys + pad), Loop A x4 = 16 (full mix), Variation x2 = 8 (mute drums, add filter sweep), Loop A x2 = 8, tail 4 (just pad with delay throw)
- Add: subtle volume rise into the full mix, drum fill at the start of variation, reverb wash on the last bar
- Report and confirm before writing