livepilot 1.26.0 → 1.26.1

package/livepilot/skills/livepilot-core/references/overview.md

@@ -0,0 +1,300 @@
+# LivePilot v1.26.1 — Architecture & Tool Reference
+
+Agentic production system for Ableton Live 12. 465 tools across 56 domains. Device atlas (5264 devices, 120 enriched, 47 with aesthetic-tagged `signature_techniques`), spectral perception (M4L analyzer with 9-band FFT — sub_low / sub / low / low_mid / mid / high_mid / high / presence / air), technique memory, automation intelligence (16 curve types, 15 recipes), music theory (Krumhansl-Schmuckler, species counterpoint), generative algorithms (Euclidean rhythm, tintinnabuli, phase shift, additive process), neo-Riemannian harmony (PRL transforms, Tonnetz), MIDI file I/O, **LIVE Splice describe-a-sound + variations via captured GraphQL endpoints (v1.17)**, drum-rack pad-by-pad construction, live dead-device detection via meter sampling, role-aware Simpler defaults, session-record arrangement-automation workaround.
+
+**Concept surface (v1.17):** `artist-vocabularies.md` and `genre-vocabularies.md` in `references/` provide structured translation from the LLM's training (producers like Villalobos, Hawtin, Basic Channel, Gas, Basinski, Hecker, Aphex, Dilla, Burial, Henke; genres like microhouse, dub_techno, ambient, idm) into LivePilot's device surface. New MCP tools `atlas_describe_chain` (free-text → chain proposal) and `atlas_techniques_for_device` (reverse-lookup: 146 technique cross-references across 58 devices).
+
+**Pack-Atlas Phases C–E (v1.23.4):** Four new corpus-action tools backed by 104 demo .als sidecars + 3,813 preset sidecars. `atlas_macro_fingerprint` — "more like this" search by macro-state similarity. `atlas_transplant` — structural translation (BPM/scale/aesthetic adaptation with PRESERVE/SCALE/REMAP/REPLACE decisions). `atlas_demo_story` — track-by-track narrative + production-sequence inference + learning path for any of the 104 demos. `atlas_extract_chain` — dry-run device-chain extraction plan for any demo track (exact/approximate/structure-only fidelity modes).
+
+**Creative Director (v1.18):** new `livepilot-creative-director` skill enforces divergence on creative intent — three plans across distinct `move.family` values, critics deferred until after selection, `get_anti_preferences` read before generation. Concept packets become structured YAML (`references/concepts/artists/*.yaml`, `references/concepts/genres/*.yaml` — 28 artists + 14 genres). Device affordances added (`references/affordances/devices/*.yaml` — 20 devices with `subtle / moderate / aggressive` parameter ranges, chain `pairings`, and `remeasure` queues). Evaluation vocabulary extended with Family B artistic dimensions (style_fit, distinctiveness, motif_coherence, section_contrast, restraint) and a 5-verdict taxonomy (safe_win, bold_win, interesting_failure, identity_break, generic_fallback). Zero new Python.
+
+**Hybrid Knowledge Surface (v1.25.0):** three new atlas tools close the gap between "compose runs successfully" and "compose makes thoughtful production decisions". `atlas_explore` — per-role ranked candidate query callable mid-design, with corpus-deep ranking signals (tag/genre match, signature_techniques overlap, curated .adg boost, anti-repeat, avoid-list). `atlas_audition` — full sidecar dump for a single URI (character_tags, signature_techniques, producer macro names, curated .adg paths). `atlas_substitute` — anti-tag-driven swap for after analyze_sound_design or analyze_mix flags an issue (11-key inversion table: bright/harsh/aggressive/sparse/thin/muddy/clean/dark/warm/static/generic).
+
+**Compose framework rebuild (v1.25.0):** three modes share a shared Applier substrate (bridge handshake retry + monitoring=Auto postflight + back_to_arranger). `compose_fast_apply` — quick loop in session view, curated-.adg-first hunt order, drum-role pitch repair. `compose_full_apply` — full song form (intro/verse/hook/breakdown/outro), per-section MIDI variants, native arrangement clips via `create_native_arrangement_clip`, zombie-track cleanup. `develop_apply` — extends an existing 8-bar seed, introspects tracks by name+content, pulls references from prompt. `KnowledgePack` scaffolding: `event_lexicon` (42 events), `genre_context` (15 genres), `artist_context` (~25 producers). Known gap: `atlas_candidates_per_role` is an empty stub in v1.25.0 — device lookup still falls back to `search_browser` filename matching. Resolved in v1.25 (BUG-FULL-MODE-24).
+
+## Architecture
+
+```
+AI Client  ──MCP──►  FastMCP Server  ──TCP/9878──►  Remote Script (inside Ableton)
+                        (validates)                    (executes on main thread)
+                            │
+                            ├── Device Atlas (5264 devices, 120 enriched with sonic intelligence)
+                            ├── M4L Analyzer ──UDP/OSC──► LivePilot_Analyzer.amxd
+                            └── Technique Memory (~/.livepilot/memory/)
+```
+
+- **MCP Server** validates inputs (ranges, types) before sending
+- **Remote Script** runs inside Ableton's Python environment, executes on the main thread via `schedule_message`
+- **Device Atlas** provides structured knowledge of Ableton's device library — real names, real URIs, sonic descriptions
+- **M4L Analyzer** reads the master bus in real-time: 9-band spectrum (sub_low → air), RMS/peak, pitch tracking, Krumhansl-Schmuckler key detection
+- **Technique Memory** persists production decisions across sessions as typed, searchable, replayable data structures
+- **Protocol**: JSON over TCP, newline-delimited. Every command gets a response.
+- **Thread safety**: All Live Object Model (LOM) access happens on Ableton's main thread
+
+## The Agentic Difference
+
+A flat tool list lets the AI press buttons. LivePilot's three layers give it context:
+
+1. **Before loading a device** — the agent consults the atlas to find a real preset, not a hallucinated name
+2. **Before writing harmonic content** — the agent reads the detected key from the analyzer
+3. **Before making creative decisions** — the agent checks technique memory for the user's style preferences
+4. **After every mixing move** — the agent reads the spectrum to verify the result
+
+This turns "set EQ band 3 to -4 dB" into "cut 400 Hz by 4 dB, then read the spectrum to confirm the mud is actually reduced."
+
+## The 465 Tools — What Each One Does
+
+### Transport (12) — Playback, tempo, global state, diagnostics
+
+| Tool | What it does | Key params |
+|------|-------------|------------|
+| `get_session_info` | Returns tempo, time sig, playing state, track count, scene count, song length | — |
+| `set_tempo` | Changes BPM | `tempo` (20-999) |
+| `set_time_signature` | Changes time signature | `numerator` (1-99), `denominator` (1,2,4,8,16) |
+| `start_playback` | Starts from current position | — |
+| `stop_playback` | Stops playback | — |
+| `continue_playback` | Resumes from where it stopped | — |
+| `toggle_metronome` | Toggles click on/off | — |
+| `set_session_loop` | Sets loop region | `loop_start` (beats), `loop_length` (beats) |
+| `undo` | Undoes last action | — |
+| `redo` | Redoes last undone action | — |
+| `get_recent_actions` | Returns log of recent commands sent to Ableton (newest first) | `limit` (1-50, default 20) |
+| `get_session_diagnostics` | Analyzes session for issues: armed tracks, solo leftovers, unnamed tracks, empty clips | — |
+
+### Tracks (14) — Create, delete, configure, group tracks
+
+| Tool | What it does | Key params |
+|------|-------------|------------|
+| `get_track_info` | Returns clips, devices, mixer state, group/fold info for one track | `track_index` (0-based) |
+| `create_midi_track` | Creates a new MIDI track | `index` (-1=end), `name`, `color` (0-69) |
+| `create_audio_track` | Creates a new audio track | `index` (-1=end), `name`, `color` (0-69) |
+| `create_return_track` | Creates a new return track | — |
+| `delete_track` | Deletes a track | `track_index` |
+| `duplicate_track` | Duplicates track with all contents | `track_index` |
+| `set_track_name` | Renames a track | `track_index`, `name` |
+| `set_track_color` | Sets track color | `track_index`, `color_index` (0-69) |
+| `set_track_mute` | Mutes/unmutes | `track_index`, `muted` (bool) |
+| `set_track_solo` | Solos/unsolos | `track_index`, `soloed` (bool) |
+| `set_track_arm` | Arms/disarms for recording | `track_index`, `armed` (bool) |
+| `stop_track_clips` | Stops all playing clips on track | `track_index` |
+| `set_group_fold` | Folds/unfolds a group track | `track_index`, `folded` (bool) |
+| `set_track_input_monitoring` | Sets input monitoring state | `track_index`, `state` (0=In, 1=Auto, 2=Off) |
+
+### Clips (11) — Clip lifecycle, properties, warp
+
+| Tool | What it does | Key params |
+|------|-------------|------------|
+| `get_clip_info` | Returns clip name, length, loop settings, playing state, is_midi/is_audio, warp info | `track_index`, `clip_index` |
+| `create_clip` | Creates empty MIDI clip | `track_index`, `clip_index`, `length` (beats) |
+| `delete_clip` | Removes a clip from its slot | `track_index`, `clip_index` |
+| `duplicate_clip` | Copies clip to next slot | `track_index`, `clip_index` |
+| `fire_clip` | Launches a clip | `track_index`, `clip_index` |
+| `stop_clip` | Stops a playing clip | `track_index`, `clip_index` |
+| `set_clip_name` | Renames a clip | `track_index`, `clip_index`, `name` |
+| `set_clip_color` | Sets clip color | `track_index`, `clip_index`, `color_index` (0-69) |
+| `set_clip_loop` | Configures loop region | `track_index`, `clip_index`, `loop_start`, `loop_end`, `looping` |
+| `set_clip_launch` | Sets launch mode and quantization | `track_index`, `clip_index`, `launch_mode`, `quantization` |
+| `set_clip_warp_mode` | Sets warp mode for audio clips | `track_index`, `clip_index`, `mode` (0=Beats,1=Tones,2=Texture,3=Re-Pitch,4=Complex,6=Complex Pro) |
+
+### Notes (8) — MIDI note manipulation (Live 12 API)
+
+| Tool | What it does | Key params |
+|------|-------------|------------|
+| `add_notes` | Adds MIDI notes to a clip | `track_index`, `clip_index`, `notes` (array) |
+| `get_notes` | Reads all notes in a region | `track_index`, `clip_index`, `start_time`, `length` |
+| `remove_notes` | Removes notes in a region | `track_index`, `clip_index`, `start_time`, `pitch_start`, etc. |
+| `remove_notes_by_id` | Removes specific notes by ID | `track_index`, `clip_index`, `note_ids` |
+| `modify_notes` | Changes existing notes (pitch, time, velocity, probability) | `track_index`, `clip_index`, `modifications` |
+| `duplicate_notes` | Copies notes in a region | `track_index`, `clip_index`, region params |
+| `transpose_notes` | Shifts pitch of notes in a region | `track_index`, `clip_index`, `semitones`, region params |
+| `quantize_clip` | Snaps notes to grid | `track_index`, `clip_index`, `grid` (int 0-8: 0=None,1=1/4,2=1/8,5=1/16,8=1/32), `amount` (0-1) |
+
+**Note format** (for `add_notes`):
+```json
+{"pitch": 60, "start_time": 0.0, "duration": 0.5, "velocity": 100, "mute": false}
+```
+
+**Extended note fields** (returned by `get_notes`):
+- `note_id` — unique identifier for modify/remove operations
+- `probability` — 0.0-1.0, per-note trigger probability (Live 12)
+- `velocity_deviation` — -127.0 to 127.0
+- `release_velocity` — 0.0-127.0
+
+### Devices (15) — Instruments, effects, racks, 12.3+ device insertion
+
+| Tool | What it does | Key params |
+|------|-------------|------------|
+| `get_device_info` | Returns device name, class, active state, all parameters | `track_index`, `device_index` |
+| `get_device_parameters` | Lists all parameters with values, ranges, and `display_value` (12.2+) | `track_index`, `device_index` |
+| `set_device_parameter` | Sets a single parameter, returns `display_value` on 12.2+ | `track_index`, `device_index`, `parameter_index`, `value` |
+| `batch_set_parameters` | Sets multiple parameters at once | `track_index`, `device_index`, `parameters` (array) |
+| `toggle_device` | Enables/disables a device | `track_index`, `device_index` |
+| `delete_device` | Removes a device from the chain | `track_index`, `device_index` |
+| `load_device_by_uri` | Loads a device by browser URI | `track_index`, `uri` |
+| `find_and_load_device` | Searches browser and loads first match (uses `insert_device` fast path on 12.3+) | `track_index`, `name` |
+| `insert_device` | **12.3+** Insert native device by name — 10x faster than browser. Supports chain insertion for drum racks | `track_index`, `device_name`, `position`, `device_index`, `chain_index` |
+| `insert_rack_chain` | **12.3+** Add a chain to Instrument/Audio Effect/Drum Rack | `track_index`, `device_index`, `position` |
+| `set_drum_chain_note` | **12.3+** Assign MIDI note to a Drum Rack chain (C1=36 kick, D1=38 snare) | `track_index`, `device_index`, `chain_index`, `note` |
+| `get_rack_chains` | Lists chains in an Instrument/Effect Rack | `track_index`, `device_index` |
+| `set_simpler_playback_mode` | Switches Simpler mode (Classic/One-Shot/Slice) | `track_index`, `device_index`, `playback_mode` (0/1/2), `slice_by`, `sensitivity` |
+| `set_chain_volume` | Sets volume of a rack chain | `track_index`, `device_index`, `chain_index`, `volume` |
+| `get_device_presets` | Lists presets for a device (audio effects, instruments, MIDI effects) | `device_name` |
+
+### Scenes (8) — Scene management
+
+| Tool | What it does | Key params |
+|------|-------------|------------|
+| `get_scenes_info` | Lists all scenes with names, tempo, and color | — |
+| `create_scene` | Creates a new scene | `index` (-1=end) |
+| `delete_scene` | Deletes a scene | `scene_index` |
+| `duplicate_scene` | Duplicates a scene | `scene_index` |
+| `fire_scene` | Launches all clips in a scene | `scene_index` |
+| `set_scene_name` | Renames a scene | `scene_index`, `name` |
+| `set_scene_color` | Sets scene color | `scene_index`, `color_index` (0-69) |
+| `set_scene_tempo` | Sets tempo that triggers when scene fires | `scene_index`, `tempo` (20-999 BPM) |
+
+### Mixing (11) — Levels, panning, routing, metering
+
+| Tool | What it does | Key params |
+|------|-------------|------------|
+| `set_track_volume` | Sets track volume | `track_index`, `volume` (0.0-1.0, where 0.85≈0dB) |
+| `set_track_pan` | Sets stereo position | `track_index`, `pan` (-1.0 left to 1.0 right) |
+| `set_track_send` | Sets send level to return track | `track_index`, `send_index`, `value` (0.0-1.0) |
+| `get_return_tracks` | Lists all return tracks | — |
+| `get_master_track` | Returns master track info | — |
+| `set_master_volume` | Sets master output level | `volume` (0.0-1.0) |
+| `get_track_routing` | Returns input/output routing config | `track_index` |
+| `set_track_routing` | Configures input/output routing | `track_index`, routing params |
+| `get_track_meters` | Returns real-time output levels for a track | `track_index` |
+| `get_master_meters` | Returns real-time output levels for the master | — |
+| `get_mix_snapshot` | Returns all levels, panning, routing, mute/solo state for entire session | — |
+
+### Browser (4) — Finding and loading presets/devices
+
+| Tool | What it does | Key params |
+|------|-------------|------------|
+| `get_browser_tree` | Returns top-level browser categories | — |
+| `get_browser_items` | Lists items in a browser path | `path` |
+| `search_browser` | Searches the browser | `query` |
+| `load_browser_item` | Loads a browser item onto a track — **`uri` MUST come from `search_browser` results, NEVER invented** | `track_index`, `uri` |
+
+### Arrangement (20) — Timeline, recording, cue points, arrangement notes
+
+| Tool | What it does | Key params |
+|------|-------------|------------|
+| `get_arrangement_clips` | Lists clips in arrangement view | `track_index` |
+| `create_arrangement_clip` | Duplicates session clip into arrangement at a beat position | `track_index`, `clip_slot_index`, `start_time`, `length` |
+| `create_native_arrangement_clip` | **12.1.10+** Creates native arrangement clip with full automation envelope support | `track_index`, `start_time`, `length`, `name`, `color_index` |
+| `add_arrangement_notes` | Adds MIDI notes to an arrangement clip | `track_index`, `clip_index`, `notes` |
+| `get_arrangement_notes` | Reads notes from an arrangement clip | `track_index`, `clip_index`, region params |
+| `remove_arrangement_notes` | Removes notes in a region of an arrangement clip | `track_index`, `clip_index`, region params |
+| `remove_arrangement_notes_by_id` | Removes specific notes by ID | `track_index`, `clip_index`, `note_ids` |
+| `modify_arrangement_notes` | Modifies notes by ID (pitch, time, velocity, probability) | `track_index`, `clip_index`, `modifications` |
+| `duplicate_arrangement_notes` | Copies notes by ID with optional time offset | `track_index`, `clip_index`, `note_ids`, `time_offset` |
+| `transpose_arrangement_notes` | Transposes notes in an arrangement clip | `track_index`, `clip_index`, `semitones`, region params |
+| `set_arrangement_clip_name` | Renames an arrangement clip | `track_index`, `clip_index`, `name` |
+| `set_arrangement_automation` | Writes automation envelope to an arrangement clip | `track_index`, `clip_index`, `parameter_type`, `points` |
+| `back_to_arranger` | Switches playback from session back to arrangement | — |
+| `jump_to_time` | Moves playhead to a beat position | `beat_time` (beats) |
+| `capture_midi` | Captures recently played MIDI | — |
+| `start_recording` | Starts recording (session or arrangement) | `arrangement` (bool) |
+| `stop_recording` | Stops all recording | — |
+| `get_cue_points` | Lists all cue markers | — |
+| `jump_to_cue` | Jumps to a cue point by index | `cue_index` |
+| `toggle_cue_point` | Creates/removes cue point at current position | — |
+
+### Memory (8) — Technique library persistence
+
+| Tool | What it does | Key params |
+|------|-------------|------------|
+| `memory_learn` | Saves a technique with stylistic qualities | `name`, `type`, `qualities`, `payload`, `tags` |
+| `memory_recall` | Searches library by text and filters | `query`, `type`, `tags`, `limit` |
+| `memory_get` | Fetches full technique including payload | `technique_id` |
+| `memory_replay` | Returns technique with replay plan for agent | `technique_id`, `adapt` (bool) |
+| `memory_list` | Browses library with filtering/sorting | `type`, `tags`, `sort_by`, `limit` |
+| `memory_favorite` | Stars and/or rates a technique | `technique_id`, `favorite`, `rating` (0-5) |
+| `memory_update` | Updates name, tags, or qualities | `technique_id`, `name`, `tags`, `qualities` |
+| `memory_delete` | Removes technique (backs up first) | `technique_id` |
+
+### Analyzer (30) — Real-time DSP analysis (requires LivePilot Analyzer M4L device on master track)
+
+| Tool | What it does | Key params |
+|------|-------------|------------|
+| `get_master_spectrum` | 9-band spectral analysis (sub_low → air) of master output | `window_ms`, `sub_detail` |
+| `get_master_rms` | True RMS and peak amplitude levels | — |
+| `get_detected_key` | Detects musical key (Krumhansl-Schmuckler) | — |
+| `get_hidden_parameters` | All device parameters including hidden ones | `track_index`, `device_index` |
+| `get_automation_state` | Parameters with active automation | `track_index`, `device_index` |
+| `walk_device_tree` | Recursive device tree (racks, drum pads, 6 levels) | `track_index`, `device_index` |
+| `get_clip_file_path` | Audio file path on disk | `track_index`, `clip_index` |
+| `replace_simpler_sample` | Replace sample in Simpler | `track_index`, `device_index`, `file_path` |
+| `load_sample_to_simpler` | Bootstrap Simpler and load sample (full workflow) | `track_index`, `file_path` |
+| `get_simpler_slices` | Slice points from Simpler | `track_index`, `device_index` |
+| `crop_simpler` | Crop sample to active region | `track_index`, `device_index` |
+| `reverse_simpler` | Reverse sample | `track_index`, `device_index` |
+| `warp_simpler` | Warp sample to N beats | `track_index`, `device_index`, `beats` |
+| `get_warp_markers` | All warp markers (beat_time + sample_time) | `track_index`, `clip_index` |
+| `add_warp_marker` | Add warp marker | `track_index`, `clip_index`, `beat_time` |
+| `move_warp_marker` | Move warp marker | `track_index`, `clip_index`, `old_beat`, `new_beat` |
+| `remove_warp_marker` | Remove warp marker | `track_index`, `clip_index`, `beat_time` |
+| `scrub_clip` | Preview audio at position | `track_index`, `clip_index`, `beat_time` |
+| `stop_scrub` | Stop preview | `track_index`, `clip_index` |
+| `get_display_values` | Human-readable parameter values ("440 Hz", "-6 dB") | `track_index`, `device_index` |
+
+### Automation (8) — Clip automation CRUD + intelligent curve generation
+
+| Tool | What it does | Key params |
+|------|-------------|------------|
+| `get_clip_automation` | Lists all automation envelopes on a session clip | `track_index`, `clip_index` |
+| `set_clip_automation` | Writes automation points to a clip envelope | `track_index`, `clip_index`, `parameter_type`, `points` |
+| `clear_clip_automation` | Clears automation envelopes (specific or all) | `track_index`, `clip_index`, `parameter_type` (optional) |
+| `apply_automation_shape` | Generates and applies a curve to a clip in one call | `track_index`, `clip_index`, `parameter_type`, `curve_type`, `duration`, `density` |
+| `apply_automation_recipe` | Applies a named recipe (filter_sweep_up, dub_throw, etc.) | `track_index`, `clip_index`, `parameter_type`, `recipe`, `duration` |
+| `get_automation_recipes` | Lists all 15 recipes with descriptions and targets | — |
+| `generate_automation_curve` | Previews curve points without writing them | `curve_type`, `duration`, `density`, curve-specific params |
+| `analyze_for_automation` | Spectral analysis + device-aware automation suggestions | `track_index` |
+
+**16 curve types:** linear, exponential, logarithmic, s_curve, sine, sawtooth, spike, square, steps, perlin, brownian, spring, bezier, easing, euclidean, stochastic
+
+**15 recipes:** filter_sweep_up, filter_sweep_down, dub_throw, tape_stop, build_rise, sidechain_pump, fade_in, fade_out, tremolo, auto_pan, stutter, breathing, washout, vinyl_crackle, stereo_narrow
+
+### Theory (7) — Built-in music theory analysis (zero dependencies)
+
+| Tool | What it does | Key params |
+|------|-------------|------------|
+| `analyze_harmony` | Chord-by-chord Roman numeral analysis of a clip | `track_index`, `clip_index`, `key` (optional) |
+| `suggest_next_chord` | Suggests theory-valid chord continuations | `track_index`, `clip_index`, `style` (common_practice/jazz/modal/pop) |
+| `detect_theory_issues` | Finds parallel fifths/octaves, out-of-key notes, voice crossing | `track_index`, `clip_index`, `strict` (bool) |
+| `identify_scale` | Deep scale/mode identification with confidence ranking | `track_index`, `clip_index` |
+| `harmonize_melody` | Generates 2 or 4-voice SATB harmonization | `track_index`, `clip_index`, `voices` (2 or 4) |
+| `generate_countermelody` | Species counterpoint against a melody | `track_index`, `clip_index`, `species` (1 or 2) |
+| `transpose_smart` | Diatonic or chromatic transposition to a new key | `track_index`, `clip_index`, `target_key`, `mode` (diatonic/chromatic) |
+
+**Built-in** — zero external dependencies, works on every LivePilot install.
+
+## Units & Ranges Quick Reference
+
+| Concept | Unit/Range | Notes |
+|---------|-----------|-------|
+| Tempo | 20-999 BPM | — |
+| Volume | 0.0-1.0 | 0.85 ≈ 0dB, 0.0 = -inf |
+| Pan | -1.0 to 1.0 | -1 = full left, 0 = center |
+| Time/Position | Beats (float) | 1.0 = quarter note at any tempo |
+| Clip length | Beats (float) | 4.0 = 1 bar at 4/4 |
+| Pitch | 0-127 (MIDI) | 60 = C3 (middle C) |
+| Velocity | 1-127 | 1 = softest, 127 = loudest |
+| Probability | 0.0-1.0 | 1.0 = always triggers |
+| Color index | 0-69 | Ableton's fixed palette |
+| Track index | 0-based | Negative for return tracks (-1=A, -2=B), -1000 for master |
+| Grid (quantize) | Integer enum (0-8) | 0=None, 1=1/4, 2=1/8, 3=1/8T, 4=1/8+T, 5=1/16, 6=1/16T, 7=1/16+T, 8=1/32 |
+| Time signature | num/denom | denom must be power of 2 |
+
+## Common Patterns
+
+**"Read before write"** — Always `get_session_info` or `get_track_info` before making changes.
+
+**"Verify after write"** — Re-read state after mutations to confirm the change took effect.
+
+**"Undo is your safety net"** — The `undo` tool reverts the last operation. Mention it to users.
+
+**"One step at a time"** — Don't batch unrelated operations. Verify between steps.

package/livepilot/skills/livepilot-core/references/pack-knowledge.md

@@ -0,0 +1,319 @@
+# Pack Knowledge — 44 Installed Ableton Packs
+
+Machine-readable reference for all 44 packs installed in Live 12.4. Each entry has:
+- **Essence** — one-line summary
+- **Scores** — minimal / dub / cinematic (0-5)
+- **Top devices** — best items to reach for from this pack
+- **Aesthetic use** — when to open this pack, when to skip
+
+Scores sourced from `docs/research/2026-04-22-ableton-packs-deep-analysis.md`. Individual device details in `mcp_server/atlas/enrichments/` (grep by `pack:` field for pack-to-device mapping).
+
+---
+
+## Tier S — Essential for deep-minimal / microhouse / ambient
+
+### Granulator III (Robert Henke)
+- **Essence:** THE granular synth. Three modes (Classic/Loop/Cloud), MPE, built-in capture.
+- **Scores:** Minimal 5 / Dub 5 / Cinematic 5
+- **Top:** Cloud mode with 200-500ms grains on any sustained source.
+- **Use when:** need evolving texture, drone bed, vocal cloud, or to de-recognize a sample.
+- **Atlas entry:** [granulator_iii](mcp_server/atlas/enrichments/instruments/granulator_iii.yaml)
+
+### PitchLoop89 (Robert Henke)
+- **Essence:** Publison DHM 89 B2 emulation. Dual independent pitch-delay voices.
+- **Scores:** Minimal 5 / Dub 5 / Cinematic 5
+- **Top:** Dual detune (+5 / -7 cents) on stabs; infinite feedback on clicks for pitched cascades.
+- **Use when:** any sustained/pitched element that needs spatial character. Henke-canonical pair with Convolution Reverb.
+- **Atlas entry:** [pitchloop89](mcp_server/atlas/enrichments/audio_effects/pitchloop89.yaml)
+
+### Drone Lab
+- **Essence:** 600+ samples, 70+ racks, **Harmonic Drone Generator** (Expert Math, 8-voice synth, microtonal tunings: Pelog/Pythagorean/JI/Solfeggio/Indian/EQ).
+- **Scores:** Minimal 5 / Dub 5 / Cinematic 5
+- **Top:** Harmonic Drone Generator in Pelog/JI as sub-bed; bowed guitar samples through Granulator III Cloud mode.
+- **Use when:** need a sustained harmonic shadow under the track at -30 dB, or microtonal drone that equal-tempered synths cannot produce.
+- **Atlas entry:** [harmonic_drone_generator](mcp_server/atlas/enrichments/instruments/harmonic_drone_generator.yaml)
+
+### Convolution Reverb
+- **Essence:** 200+ IRs, Convolution Reverb Pro hybrid mode, IR Measurement Tool (sample your own rooms).
+- **Scores:** Minimal 5 / Dub 5 / Cinematic 5
+- **Top:** Farfisa Spring IR on percussion (Christian Kleine's set); Stocktronics RX-4000 on stabs; any long cathedral/warehouse IR on click tails.
+- **Use when:** the built-in Reverb is too digital. Always in the chain for minimal/dub.
+- **Atlas entry:** [convolution_reverb](mcp_server/atlas/enrichments/audio_effects/convolution_reverb.yaml), [convolution_reverb_pro](mcp_server/atlas/enrichments/audio_effects/convolution_reverb_pro.yaml)
+
+### Lost and Found
+- **Essence:** 28 foley/DIY multisampled instruments — music box, melodica, Capri fan organ, DIY plastic guitar, kazoo, metal xylophone. 7 Drum Racks built from everyday objects (steel water bottle, analog clock, submerged objects).
+- **Scores:** Minimal 5 / Dub 5 / Cinematic 5
+- **Top:** Capri fan organ as chord bed through long reverb; music box pitched down -24 semitones as hypnotic bass.
+- **Use when:** need found-sound character without recording your own. Villalobos-pack hiding in the library.
+
+### Inspired by Nature (Dillon Bastan)
+- **Essence:** 7 visual/generative M4L devices — Vector FM, Vector Grain, Vector Delay, Vector Map, Emit, Bouncy Notes, Tree Tone.
+- **Scores:** Minimal 5 / Dub 5 / Cinematic 5
+- **Top:** Bouncy Notes for asymmetric note cascades; Tree Tone for organic harmonic resonance; Vector Map for coupled multi-parameter modulation.
+- **Use when:** need never-the-same-twice generative behavior. The most under-utilized pack for microhouse.
+- **Atlas entries:** vector_fm, vector_grain, [vector_map](mcp_server/atlas/enrichments/utility/vector_map.yaml), vector_delay, emit, bouncy_notes, tree_tone (all in enrichments/).
+
+### Glitch and Wash
+- **Essence:** The closest official Ableton pack to the target aesthetic. Field recordings, bit-crushed clicks, resonant pads, drones.
+- **Scores:** Minimal 5 / Dub 5 / Cinematic 5
+- **Top:** Field-recording loops as-is; bit-crushed clicks as ghost hats; resonant drone pads at -25 dB.
+- **Use when:** first pack to raid in any minimal session.
+
+### Voice Box
+- **Essence:** 1100 vocal samples, 82 multisampled singers, 9 vocal-percussion Drum Racks, 47 vocal processing racks.
+- **Scores:** Minimal 5 / Dub 4 / Cinematic 5
+- **Top:** Breath/mouth samples as ghost hats; vocal-percussion drum racks as primary kit for "all-mouth" tracks; sustained vowels through Granulator III Cloud for vocal atmosphere beds.
+- **Use when:** Akufen-style micro-vocal aesthetic. Critical.
+
+### Latin Percussion
+- **Essence:** 107 multisampled hand percussion — cuica, congas, claves, shakers, guiro, pandeiro, bells.
+- **Scores:** Minimal 5 / Dub 3 / Cinematic 3
+- **Top:** Cuica (friction drum, low + high) as Villalobos signature; clave through reverb; guiro scrape as ghost-hat alternative.
+- **Use when:** traditional drum kit feels too rigid. Villalobos + Perlon-era minimal built on this.
+
+### Upright Piano (Spitfire Bechstein)
+- **Essence:** Single multisampled Bechstein Model 7 upright. Mechanical noise sampled separately.
+- **Scores:** Minimal 5 / Dub 5 / Cinematic 5
+- **Top:** Single sustained note pedal-down + slow-attack macro at 50% + Convolution Reverb = floating piano halo. Mechanical-noise-only passes as percussion.
+- **Use when:** single-note piano statements. Best piano for minimal house.
+
+---
+
+## Tier A — High-value specialist tools
+
+### Creative Extensions
+- **Essence:** 8 devices — Pitch Hack, Gated Delay, Colour Limiter, Re-Enveloper, Spectral Blur, Melodic Steps, Bass, Poli.
+- **Scores:** Minimal 4 / Dub 4 / Cinematic 4
+- **Top:** [pitch_hack](mcp_server/atlas/enrichments/audio_effects/pitch_hack.yaml) for Akufen stutter; [spectral_blur](mcp_server/atlas/enrichments/audio_effects/spectral_blur.yaml) for reverse-reverb alternatives; [re_enveloper](mcp_server/atlas/enrichments/audio_effects/re_enveloper.yaml) for per-band envelope reshaping.
+- **Use when:** need a creative FX that stock effects can't deliver.
+
+### MIDI Tools (Philip Meyer)
+- **Essence:** 5 clip-based MIDI generators/transformers — Polyrhythm, Phase Pattern, Stages, Retrigger, Slice Shuffler.
+- **Scores:** Minimal 5 / Dub 4 / Cinematic 3
+- **Top:** [phase_pattern](mcp_server/atlas/enrichments/midi_effects/phase_pattern.yaml) for organic timing; [polyrhythm](mcp_server/atlas/enrichments/midi_effects/polyrhythm.yaml) with Euclidean at asymmetric ratios; [slice_shuffler](mcp_server/atlas/enrichments/midi_effects/slice_shuffler.yaml) for one-bar reverse glitches.
+- **Use when:** need organic humanization or asymmetric pattern generation. Requires Live 12.1+.
+
+### Sequencers
+- **Essence:** 3 M4L sequencers — Step Arp, SQ Sequencer, Rhythmic Steps.
+- **Scores:** Minimal 4 / Dub 4 / Cinematic 3
+- **Top:** [sq_sequencer](mcp_server/atlas/enrichments/midi_effects/sq_sequencer.yaml) with asymmetric per-lane step lengths (16/15/11); Rhythmic Steps with probability per step; Step Arp with Chance < 80% for organic missing-note arpeggios.
+- **Use when:** need polymeric/polyrhythmic patterns that go beyond standard quantize.
+
+### Performance Pack (Iftah)
+- **Essence:** 4 live-performance tools — Performer, Variations, Arrangement Looper, Prearranger.
+- **Scores:** Minimal 4 / Dub 4 / Cinematic 3
+- **Top:** [variations](mcp_server/atlas/enrichments/utility/variations.yaml) is the studio gem — morph chord-stab effect chains across 8-16 bars without 50 automation lanes.
+- **Use when:** live performance, but Variations especially useful in studio for chord-is-different-every-time behavior.
+
+### CV Tools (Ableton)
+- **Essence:** 10 M4L devices for Eurorack bridging. 4 work standalone without modular gear.
+- **Scores:** Minimal 5 (w/ modular) / 3 (w/o) / Dub 5 / Cinematic 3
+- **Top w/o modular:** [cv_lfo](mcp_server/atlas/enrichments/utility/cv_lfo.yaml) for extra LFOs, [cv_envelope_follower](mcp_server/atlas/enrichments/utility/cv_envelope_follower.yaml) for audio-driven modulation, [rotating_rhythm_generator](mcp_server/atlas/enrichments/utility/rotating_rhythm_generator.yaml) for standalone polyrhythm, [cv_shaper](mcp_server/atlas/enrichments/utility/cv_shaper.yaml) for custom envelope shapes.
+- **Use when:** hybrid modular + DAW rig, OR when you need modulation options beyond what a synth exposes.
+
+### Generators by Iftah
+- **Essence:** Patterns (one-click drum generator) + Sting (acid-line performance tool).
+- **Scores:** Minimal 4 / Dub 3 / Cinematic 2
+- **Top:** [patterns_iftah](mcp_server/atlas/enrichments/midi_effects/patterns_iftah.yaml) for sparse minimal-techno patterns; [sting_iftah](mcp_server/atlas/enrichments/instruments/sting_iftah.yaml) detuned + low as mutating sub-bass.
+- **Use when:** quick drum or bassline ideation.
+
+### Microtuner
+- **Essence:** Scala import, dual-deck scale blend, Lead/Follow MPE.
+- **Scores:** Minimal 4 / Dub 3 / Cinematic 5
+- **Top:** [microtuner](mcp_server/atlas/enrichments/midi_effects/microtuner.yaml) — 19-TET for minimal; Partch 43-tone for drones; automated Blend for harmonic drift.
+- **Use when:** standard equal temperament feels wrong.
+
+---
+
+## Tier B — Useful in specific contexts
+
+### Chop and Swing
+- **Essence:** 3000+ elements, 24 Drum Racks, 100+ instrument racks, 340+ loops, 212 Tonal MIDI clips. Sampled-soul pocket.
+- **Scores:** Minimal 4 / Dub 2 / Cinematic 3
+- **Top:** Tonal MIDI clips on dry Rhodes; dusty break loops → Simpler Slice → re-sequence into Akufen-style micro-patterns; vinyl crackle effect racks at -36 dB under the track.
+
+### Electric Keyboards
+- **Essence:** 3 multisampled E-pianos — Suitcase Piano (Rhodes Stage 73), Wurly Piano (Wurlitzer 200A), Tonewheel Organ.
+- **Scores:** Minimal 4 / Dub 5 / Cinematic 3
+- **Top:** Single-note hold through chorus + tape sat + Convolution Reverb = Raresh-style chord stab. Never play chords.
+
+### Drone Lab's Improvisation Sets
+- **Essence:** 4 prepopulated Live Sets using clips + Follow Actions + mixer as generative ambience engines.
+- **Scores:** Minimal 5 / Dub 4 / Cinematic 5
+- **Use:** Load the set, tweak, bring layers in and out. Autonomous ambient bed factory.
+
+### Building Max Devices
+- **Essence:** 92 example M4L devices — tutorial pack. Some unexpectedly good: Snipper, Bell Tower, Filler.
+- **Scores:** Minimal 3 / Dub 2 / Cinematic 2
+- **Top:** [snipper](mcp_server/atlas/enrichments/audio_effects/snipper.yaml) for micro-chop re-pitching; [bell_tower](mcp_server/atlas/enrichments/instruments/bell_tower.yaml) FM bell through Convolution Reverb; [filler](mcp_server/atlas/enrichments/midi_effects/filler.yaml) for free MIDI drum generation.
+
+### Chop and Swing's vinyl racks
+- **Scores:** Minimal 4 / Dub 2 / Cinematic 3
+- **Use:** Vinyl crackle effect racks at -36 dB under the track. Texture subtext.
+
+### Golden Era Hip-Hop Drums (Sound Oracle)
+- **Essence:** 20 dusty boom-bap kits. Despite the hip-hop branding, the texture is perfect for minimal.
+- **Scores:** Minimal 4 / Dub 3 / Cinematic 2
+- **Top:** Dusty rim/brush snares; tight compressed kicks; vinyl-bite hat samples as ghost top-end. Extract individual samples, rebuild into minimal kit.
+
+### Drum Booth
+- **Essence:** 20 kits with 16/32/64 pads. Recorded DRY — no room, no FX. Pure acoustic source.
+- **Scores:** Minimal 4 / Dub 3 / Cinematic 3
+- **Top:** Brush snare through long Convolution Reverb; rim click as ghost hat; experimental recordings as off-kit textures.
+
+### Orchestral Mallets
+- **Essence:** Vibraphone, marimba, crotales, glockenspiel, tubular bells, timpani. Multi-articulation.
+- **Scores:** Minimal 4 / Dub 4 / Cinematic 5
+- **Top:** Vibraphone single note + motor wobble through tape delay; crotales as high-freq shimmer; marimba low octave for warm plucked accents.
+
+### Spitfire Brass / String Quartet
+- **Essence:** Intimate chamber brass/strings, Air Edel Studios, vintage mics. Dry not Hollywood.
+- **Scores:** Minimal 4 / Dub 3 / Cinematic 5
+- **Top:** Single muted flugelhorn note (pp) through PitchLoop89 + Convolution Reverb = Arpiar dusty-horn. Cello sustain for bass-register warmth.
+
+### Mood Reel
+- **Essence:** 295+ instrument racks, designed in part by Aimée Portioli (Grand River) and Arovane — serious minimal/ambient pedigree.
+- **Scores:** Minimal 4 / Dub 4 / Cinematic 5
+
+---
+
+## Tier C — Wrong aesthetic but still mineable
+
+These packs were commissioned for genres far from minimal/microhouse/ambient, but every one contains *raw material* (one-shots, noise beds, dry multisamples) worth extracting. Never load the preset chains. Never use the genre MIDI. Strip the kits.
+
+### Build and Drop (Puremagnetik)
+- **Essence:** Festival EDM construction kits — 808s, saw-leads, risers, drops.
+- **Scores:** Minimal 1 / Dub 2 / Cinematic 2
+- **Top:** Riser/downlifter **sample folders** only — strip the kick+lead presets. 808 sub-tails repitched as minimal bass layers.
+- **Use when:** need a risk-free atmospheric riser or noise sweep. Everything else is throwaway.
+- **Avoid:** All preset racks — saturation chains are over-cooked for minimal.
+
+### Drive and Glow (Native Instruments / Ableton)
+- **Essence:** Saturated indie/synthwave chains — soft-clipped leads, tape-emulation pads.
+- **Scores:** Minimal 2 / Dub 3 / Cinematic 3
+- **Top:** Effect Racks for the saturation chains only — copy the guts (Saturator → Shifter → tape delay) and drop into your own signal path. Tape-flutter pads at -30 dB as hidden glue.
+- **Use when:** want soft warmth without building the chain yourself.
+- **Avoid:** All synthwave lead presets — wrong decade.
+
+### Punch and Tilt (Ableton)
+- **Essence:** Warehouse techno kit generator — rave stabs, distorted kicks, tilted hats.
+- **Scores:** Minimal 3 / Dub 4 / Cinematic 1
+- **Top:** Distorted kick one-shots (Drum Rack extraction), not the preset kicks-through-Drum-Buss chains. Tilted/pitched ride-cymbal samples as alien hi-hats.
+- **Use when:** need warehouse grit without going full hardcore. Villalobos occasionally pitches these down 2 octaves.
+- **Avoid:** MIDI clips — 130 BPM warehouse patterns, wrong tempo for minimal.
+
+### Skitter and Step (Ableton)
+- **Essence:** UK garage / 2-step / UKG percussion — hats, shuffled snares, vocal chops.
+- **Scores:** Minimal 2 / Dub 2 / Cinematic 1
+- **Top:** Shuffled closed-hat samples (built for 2-step, work for microhouse). Vocal "chop-and-cut" one-shots for Akufen stutter inputs.
+- **Use when:** need shuffled hi-hat character that standard 909/606 doesn't give.
+- **Avoid:** Garage bassline presets — wrong frequency balance for minimal bass.
+
+### Trap Drums (Sound Oracle / Ableton)
+- **Essence:** Modern trap kits — sub 808s, snappy snares, tight rolls.
+- **Scores:** Minimal 1 / Dub 2 / Cinematic 1
+- **Top:** **808 sub-tails only** as sub-bass layers under a minimal kick. Snappy clap one-shots as high-velocity accents (strip from kits).
+- **Use when:** need sub-heavy low end without building an 808 from scratch.
+- **Avoid:** Entire kits, all hi-hat MIDI rolls (trap signature, wrong for minimal).
+
+### Beat Tools
+- **Essence:** Generic drum-programming toolkit — kicks, snares, hats, claps, percs.
+- **Scores:** Minimal 2 / Dub 2 / Cinematic 2
+- **Top:** Raw one-shots — cherry-pick specific samples (a particular snap, a particular hat) and ignore the preset kits. Good "neutral" source material if you don't want a pack with opinions.
+- **Use when:** building a kit from scratch, want neutral one-shots without aesthetic opinion.
+- **Avoid:** Preset Drum Racks — too generic, no character.
+
+### Drum Essentials
+- **Essence:** Live 12's baseline drum kit library — acoustic + electronic + percussion across 30+ kits.
+- **Scores:** Minimal 1 / Dub 2 / Cinematic 1
+- **Top:** Goldbaby 606 and 808 samples (hidden in the electronic kit folders). Acoustic side-stick and rim-shot one-shots.
+- **Use when:** need a specific drum-machine sample, not an entire kit.
+- **Avoid:** Default kits — too safe, no character.
+
+### SONiVOX Orchestral Brass
+- **Essence:** 11 multisampled brass instruments — trumpet, French horn, trombone, tuba, ensembles.
+- **Scores:** Minimal 3 / Dub 2 / Cinematic 5
+- **Top:** Solo **muted French horn** pp for dusty Arpiar/Cinematic moments. Solo trumpet pp with long release as sustained pitch drone.
+- **Use when:** need a single sustained brass note as a foreground texture — NEVER as ensemble.
+- **Avoid:** All ensemble patches — too Hollywood for minimal.
+
+### SONiVOX Orchestral Strings
+- **Essence:** 12 multisampled strings — violins, violas, cellos, double basses, ensembles.
+- **Scores:** Minimal 3 / Dub 2 / Cinematic 5
+- **Top:** **Pizzicato double-bass** as ghost/kick layer in minimal — short, warm, percussive. **Solo cello sustain pp** for bass-register atmosphere bed.
+- **Use when:** need pizzicato accents or single-note sustained string pad at low dynamic.
+- **Avoid:** Ensemble sustains, legato patches — Hollywood energy.
+
+### SONiVOX Orchestral Woodwinds
+- **Essence:** 10 multisampled woodwinds — flute, oboe, clarinet, bassoon, ensembles.
+- **Scores:** Minimal 3 / Dub 2 / Cinematic 5
+- **Top:** **Solo flute pp sustained** through PitchLoop89 for drifting high register. **Solo bass clarinet pp** as low-register hidden-voice color.
+- **Use when:** need a specific single woodwind color for a single note or short phrase.
+- **Avoid:** Fast articulations, ensembles — too classical.
+
+### Grand Piano (e-instruments)
+- **Essence:** Steinway-style multisampled concert grand.
+- **Scores:** Minimal 3 / Dub 2 / Cinematic 5
+- **Top:** **Single staccato note** with fast release at velocity 60-90 as percussive 'tock'/'thunk'. Lid-open for resonance. Use Upright Piano (Spitfire Bechstein, Tier S) for anything sustained.
+- **Use when:** need a percussive pitched hit, not a piano performance.
+- **Avoid:** Sustained chords (too bright/concert-hall), legato phrases.
+
+### Synth Essentials
+- **Essence:** Default Live preset collection across Operator/Analog/Wavetable/Drift.
+- **Scores:** Minimal 2 / Dub 2 / Cinematic 3
+- **Top:** **Tension + Collision physical-modeling presets** for unusual bowed/struck sounds that aren't obvious presets. Otherwise build from scratch — Operator sine + one-op FM is more useful than any preset here.
+- **Use when:** need a quick physical-modeling starter; otherwise build from scratch.
+- **Avoid:** "Lead" / "Pad" category — too finished, all the same.
+
+### Session Drums Club
+- **Essence:** Acoustic drum kit recorded in a live club/medium room — ambient kit with baked-in room mics.
+- **Scores:** Minimal 3 / Dub 3 / Cinematic 3
+- **Top:** **Side-stick / rim-shot** as main snare or accent in minimal. Tambourine + delay as ghost rattles. Room ambience is already baked in — don't add more reverb.
+- **Use when:** want a drum bed that fights your space (room mics add their own reverb character).
+- **Avoid:** Full kits through Drum Buss — too rock.
+
+### Session Drums Studio
+- **Essence:** Dry studio-recorded acoustic kit — clean, no room, close-mic'd.
+- **Scores:** Minimal 3 / Dub 3 / Cinematic 3
+- **Top:** **Dry rim/brush snare** as starting point for Convolution Reverb experiments (apply your own space). Brush one-shots as percussion texture.
+- **Use when:** want a drum source you can fully control spatially — apply your own reverb, don't fight theirs.
+- **Avoid:** Direct preset use — the dryness feels sterile without post-processing.
+
+### Core Library
+- **Essence:** Everything that ships with Live 12 — all native presets across Analog/Operator/Wavetable/Drift/Simpler/Sampler + all native effect presets + the bundled sample library (Ambient & Atmospheres, Noise & FX, Live Essentials samples).
+- **Scores:** Minimal 3 / Dub 3 / Cinematic 3
+- **Top:** **Ambient & Atmospheres + Noise & FX sample folders** — the unsung gold. "Ethereal Voice 01-04 Dmin 90bpm", "FX Vocal Chant Backwards", "Vocal Chant Aye", "Ethereal Adlib Vocal" are hidden Villalobos bait. Search `samples` path first in `search_browser` before reaching for Splice.
+- **Use when:** hunt these folders BEFORE opening any other pack. Most of Live's best texture material is hiding here.
+- **Avoid:** Named genre presets ("Lead", "Pad", "Bass" categories in each synth) — too generic. Also avoid "Drum Kit Essentials" defaults — go to dedicated drum packs instead.
+
+---
+
+## Workflow: what to do when
+
+**"Build me a minimal-techno track"**
+1. Drone Lab (Harmonic Drone Generator bed) + Glitch and Wash (field recording atmosphere) + Latin Percussion (cuica + claves)
+2. Add Granulator III on a return for vocal clouds
+3. PitchLoop89 + Convolution Reverb at end of any sustained element
+4. Phase Pattern on drum clips for organic timing
+5. Variations on chord stabs for evolution without automation
+
+**"Build a drum kit from samples"**
+1. Golden Era Hip-Hop Drums (dusty snares) + Drum Booth (dry acoustic) + Latin Percussion (unusual hits)
+2. Use `add_drum_rack_pad` tool — never repeated `load_browser_item`
+3. Each sample → role-aware Simpler defaults via `load_browser_item(role="drum")`
+
+**"Make it evolve"**
+1. Granulator III Cloud mode on sustained elements
+2. Variations with quantized morph on effect chains
+3. Vector Map for coupled multi-parameter physical motion
+4. SQ Sequencer with asymmetric per-lane lengths
+
+**"Make it weird without making it wrong"**
+1. Microtuner with 19-TET or Pelog scale
+2. Harmonic Drone Generator in just intonation
+3. Bouncy Notes / Tree Tone for unpredictable pattern generation
+4. Inspired by Nature generally — physics-driven sound design
+
+---
+
+**End of reference.** Devices with atlas entries are linked. For per-device parameter details, grep `mcp_server/atlas/enrichments/` by device `id`.