/arrangement-coach

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".

Arrangement Coach

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.

Workflow

1. Read what they have

• `get_session_info` — confirm session vs arrangement state
• `get_track_info` for each track — collect all clips currently in Session view
• Identify the loop length (most likely 4 or 8 bars) and the BPM

2. Choose a structural template

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 |

3. Promote loops to arrangement

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)

4. Add transitions

• **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

5. Master fader automation (subtle)

• -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

6. Confirm

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'ts

• 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.

Example

> User: "I have a 4-bar lo-fi loop, give me a full 2-minute track"

Steps: 1. Read session — 4 tracks (drums, bass, keys, pad), 4-bar loops on all 2. Apply lo-fi template: 2:00 = ~50 bars at 90 BPM 3. 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) 4. Add: subtle volume rise into the full mix, drum fill at the start of variation, reverb wash on the last bar 5. Report and confirm before writing