livepilot-arrangement

Category: Tools & Productivity | Uploader: dreamrec | Downloads: 0 | Version: v1.0（Latest）
This skill should be used when the user asks to "arrange", "structure a song", "add an intro", "build a verse", "create sections", "scene to arrangement", "cue points", "record to arrangement", or wants to organize song structure in Ableton Live.
Changelog: Source: GitHub https://github.com/dreamrec/LivePilot
Directory Structure

Current level: tree/main/livepilot/skills/livepilot-arrangement/
📄 SKILL.md 7.3 KB
SKILL.md

---
name: livepilot-arrangement
description: This skill should be used when the user asks to "arrange", "structure a song", "add an intro", "build a verse", "create sections", "scene to arrangement", "cue points", "record to arrangement", or wants to organize song structure in Ableton Live.
---

# Arrangement — Song Structure and Session Organization

Organize clips into scenes, build arrangements on the timeline, navigate with cue points, and record performances in Ableton Live.

## Session View vs Arrangement View

Ableton has two complementary views:

- **Session view** — a grid of clip slots organized by track (columns) and scene (rows). Clips loop independently. Fire scenes to trigger rows of clips simultaneously. Use for jamming, live performance, and building ideas.
- **Arrangement view** — a linear timeline where clips play in sequence from left to right. Use for final song structure, recording automation, and export.

Use `back_to_arranger` to switch from session playback to arrangement playback. When session clips are playing, they override arrangement content on their tracks.

## Scene Workflow

Scenes are horizontal rows in session view. Each scene can trigger all its clips at once.

### Creating and Managing Scenes

- `create_scene(index)` — insert a new scene at the given position
- `set_scene_name(scene_index, name)` — name scenes after song sections: "Intro", "Verse 1", "Chorus", "Bridge", "Drop", "Outro"
- `set_scene_color(scene_index, color_index)` — color-code sections (0-69 palette). Use consistent colors: green for verses, red for choruses, blue for bridges.
- `set_scene_tempo(scene_index, tempo)` — set a per-scene tempo change (triggers when scene fires)
- `duplicate_scene(scene_index)` — copy a scene for variations. Duplicate, rename, then modify clips in the copy.
- `delete_scene(scene_index)` — remove a scene

### Firing and Monitoring

- `fire_scene(scene_index)` — launch all clips in a scene simultaneously
- `fire_scene_clips(scene_index)` — launch only the clips that exist in a scene (skips empty slots)
- `stop_all_clips` — stop everything in session view
- `get_playing_clips` — see which clips are currently playing across all tracks

### Scene Inspection

- `get_scenes_info` — list all scenes with names, tempos, and colors
- `get_scene_matrix` — see which clips exist in which slots across the entire session grid. Returns a track-by-scene matrix showing clip presence, names, and states.

## Arrangement View

Build linear song structures on the timeline.

### Creating Arrangement Clips

- `create_arrangement_clip(track_index, start_time, length)` — place a new clip on the timeline at a specific beat position
- `set_arrangement_clip_name(track_index, clip_index, name)` — name arrangement clips for clarity

### Arrangement Notes

- `add_arrangement_notes(track_index, clip_index, notes)` — write MIDI notes into an arrangement clip
- `get_arrangement_notes(track_index, clip_index)` — read notes from an arrangement clip
- `remove_arrangement_notes(track_index, clip_index, start_time, duration, pitch_start, pitch_end)` — clear notes in a region
- `remove_arrangement_notes_by_id(track_index, clip_index, note_ids)` — surgical deletion
- `modify_arrangement_notes(track_index, clip_index, modifications)` — update existing notes by ID
- `duplicate_arrangement_notes(track_index, clip_index, time_offset)` — copy notes forward
- `transpose_arrangement_notes(track_index, clip_index, semitones, start_time, duration)` — pitch shift a region

### Arrangement Clips Inspection

- `get_arrangement_clips(track_index)` — list all clips on a track's arrangement timeline with positions, lengths, and names

### Arrangement Automation

- `set_arrangement_automation(track_index, parameter_name, points)` — write automation on the arrangement timeline. Points are `[{time, value}, ...]` pairs at absolute beat positions.

## Navigation

### Transport Position

- `jump_to_time(beat_time)` — move the playback cursor to a specific beat position on the timeline
- `start_playback` / `stop_playback` / `continue_playback` — basic transport control

### Cue Points

Cue points are markers on the arrangement timeline for quick navigation.

- `toggle_cue_point` — add or remove a cue point at the current playback position
- `get_cue_points` — list all cue points with their beat positions and names
- `jump_to_cue(cue_index)` — jump to a specific cue point by index

Use cue points to mark section boundaries: place one at beat 0 (Intro), beat 16 (Verse), beat 48 (Chorus), etc. This makes navigation fast during arrangement.

## Recording

### Live Recording

- `start_recording` — begin recording into the arrangement or session (depends on which view is active and which tracks are armed)
- `stop_recording` — stop recording
- `capture_midi` — retroactive MIDI capture. Grabs whatever was played on armed MIDI tracks even if recording was not active. Live 12 keeps a buffer of recent MIDI input.

### Recording Workflow

1. Arm tracks with `set_track_arm(track_index, arm=true)`
2. Optionally set input monitoring with `set_track_input_monitoring(track_index, mode)`
3. `start_recording` — records into arrangement if in arrangement view, into session slots if in session view
4. Play or trigger clips
5. `stop_recording` — finalize the take

For retroactive capture: if the user just played something without recording, call `capture_midi` immediately to grab it.

## Section Analysis

- `get_section_graph` — infer song structure from scene names and clip arrangement. Returns a graph of sections with their relationships, durations, and transitions.
- `analyze_composition` — deeper structural analysis including phrase lengths, repetition patterns, and harmonic arcs
- `get_phrase_grid` — see how phrases align across tracks

Use `get_section_graph` to understand the current form before adding new sections. It helps identify what is missing (e.g., no bridge, no outro, chorus only appears once).

## Common Song Structures

When building arrangements, use these as starting templates:

- **Pop:** Intro - Verse - Chorus - Verse - Chorus - Bridge - Chorus - Outro
- **EDM/Dance:** Intro (16 bars) - Build - Drop (16) - Break (8) - Build - Drop (16) - Outro (8)
- **Hip-hop:** Intro - Verse (16 bars) - Hook (8) - Verse (16) - Hook (8) - Bridge - Hook - Outro
- **Lo-fi:** Intro (4) - A (8) - B (8) - A (8) - B variation (8) - Outro (4)

Adapt these to the user's needs. Use `plan_arrangement` from the planner domain for algorithmic structure suggestions, and `transform_section` to create variations of existing sections.

## Composition Engine

For deeper compositional analysis beyond basic arrangement:

- `plan_gesture(type, parameters)` — plan a musical gesture (build, release, tension, resolution)
- `apply_gesture_template(track_index, gesture)` — apply a gesture pattern to a track
- `evaluate_composition_move(proposed_change)` — score a proposed structural change before making it
- `get_harmony_field(section)` — see the harmonic landscape of a section
- `get_transition_analysis(from_section, to_section)` — analyze how two sections connect

## Reference

Supporting references live in the `livepilot-core` skill's `references/` directory:
- `livepilot-core/references/ableton-workflow-patterns.md` — session/arrangement workflows, song structures by genre, follow actions, clip launch modes, export settings
Comments 0
Latest | Hot
Please login before commenting.
Loading comments...
livepilot-arrangement

Directory Structure

SKILL.md

Report

Notice
