livepilot 1.16.1 → 1.17.1

package/mcp_server/atlas/enrichments/instruments/drum_rack.yaml

@@ -0,0 +1,142 @@
+id: drum_rack
+name: Drum Rack
+sonic_description: >
+  A container instrument that maps up to 128 drum pads — each pad hosts its own
+  Simpler (or Sampler, Operator, or any other instrument plus effect chain) and
+  responds to one MIDI note. Drum Rack is not a synth: its sonic character comes
+  entirely from the samples and devices loaded into its pads. Think of it as
+  infrastructure — the spine that turns a folder of one-shots into a playable
+  kit with per-pad routing, choke groups, and macro control.
+synthesis_type: sample_container
+character_tags: [container, infrastructure, kit_builder, per_pad_chain, macro_addressable]
+use_cases:
+  - build_drum_kit_from_loose_samples
+  - per_pad_effects_processing
+  - choke_groups_for_hat_pairs
+  - macro_controlled_drum_performance
+  - parallel_sample_layering_on_a_single_pad
+  - host_for_sliced_break_recomposition
+genre_affinity:
+  primary: [hip_hop, electronic, techno, house, trap]
+  secondary: [dnb, footwork, ambient, experimental, all]
+complexity: beginner
+self_contained: false
+introduced_in: "6.0"
+pack: Core Library
+is_container: true
+chain_model: per_pad_instrument_and_effects
+
+key_parameters:
+  - name: "Pad Note Assignment"
+    description: >
+      Each pad is assigned a MIDI note (C1=36 by convention for the kick).
+      Programmatic: use `set_drum_chain_note(track, chain_index, note)` rather
+      than GUI drag. The Live 12.4+ drum-map uses note 36 for the bottom-left
+      pad by default.
+    range: [0, 127]
+    type: int
+    sweet_spots:
+      kick: 36
+      snare: 38
+      closed_hat: 42
+      open_hat: 46
+      clap: 39
+      ride: 51
+
+  - name: "Pad Volume (per chain)"
+    description: "Each pad has its own volume fader on the chain"
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      anchor_kick: 0.85
+      accent_snare: 0.75
+      ghost_hat: 0.35
+
+  - name: "Pad Pan (per chain)"
+    description: "Stereo placement per pad — crucial for width on hats/percs"
+    range: [-1.0, 1.0]
+    type: float
+    sweet_spots:
+      center: 0.0
+      hat_right: 0.25
+      perc_wide: 0.6
+
+  - name: "Choke Group"
+    description: >
+      Pads in the same choke group cut each other off (pair hats so closed
+      cuts open, or group percussion so overlapping hits don't stack).
+    range: [0, 16]
+    type: int
+    sweet_spots:
+      hat_pair: 1
+      percussion_cluster: 2
+
+  - name: "Macro 1-8"
+    description: >
+      Drum Rack macros address any parameter across any pad chain. Use for
+      performance gestures (global dust filter, global saturation, pad volumes
+      collected onto one knob).
+    range: [0.0, 127.0]
+    type: float
+
+pairs_well_with:
+  - device: "Drum Buss"
+    reason: "The native glue — shape/boom/transients for the whole kit post-rack. Often the entire mix tool a drum rack needs"
+  - device: "Compressor"
+    reason: "Glue the kit into one punch — 2-4 dB gain reduction with a medium attack"
+  - device: "EQ Eight"
+    reason: "High-pass below 30 Hz, notch masking from kick/snare"
+  - device: "Saturator"
+    reason: "Add harmonic weight without gain staging pain. Especially on sampled kits that sound sterile"
+  - device: "Reverb"
+    reason: "Per-pad sends (build a reverb return) rather than stacking on the master"
+  - device: "Gate"
+    reason: "Tighten room-mic'd one-shots or trim bleed from multi-sampled kits"
+
+starter_recipes:
+  - name: "Empty Kit for Sample Programming"
+    description: "Build from scratch — use add_drum_rack_pad for each slot"
+    genre: electronic
+    steps:
+      - "Create empty Drum Rack on a MIDI track"
+      - "For each sample: add_drum_rack_pad(track, note=36+i, sample_path=...)"
+      - "Verify each pad landed: get_track_info, check chain count"
+      - "Set pad volumes by role: kick 0.85, snare 0.75, hats 0.4"
+
+  - name: "Sliced-Break Reprogram"
+    description: "Take a break loop, slice it, reroute to a Drum Rack for MIDI programming"
+    genre: dnb
+    steps:
+      - "Load break to Simpler in Slicing mode"
+      - "classify_simpler_slices to identify kick/snare/hat roles"
+      - "Recreate as Drum Rack with each slice as its own pad"
+      - "Program new pattern — you now have MIDI control of the break"
+
+  - name: "Layered Kick (sub + click + body)"
+    description: "Single kick pad with three parallel instruments for fullness"
+    genre: techno
+    steps:
+      - "Drum Rack → pad 36 (kick) → add 3 chains within that pad"
+      - "Chain 1: sub sine (Operator sine wave)"
+      - "Chain 2: transient click (short sample)"
+      - "Chain 3: body (sampled kick tail)"
+      - "Balance chain volumes — sub first, body second, click last"
+
+gotchas:
+  - "A Drum Rack with no pads produces nothing — loading the container alone is not enough. Always verify at least one chain exists via get_track_info before firing notes"
+  - "Pad 36 (C1) is the bottom-left in the default view and the conventional kick slot. Live 12's auto-mapping assumes this"
+  - "add_drum_rack_pad is the ONE reliable tool for adding pads. Using load_browser_item repeatedly to 'add' pads creates nested racks, not siblings"
+  - "Each pad is itself a chain with its own Volume/Pan/Solo/Mute — per-pad mute is different from muting the pad's chain. Use set_chain_volume for the pad-level fader"
+  - "Macros must be explicitly mapped — they don't auto-address pad volumes. Use add_rack_macro + map_plugin_parameter on the underlying instrument"
+  - "Choke groups 0 and 'None' are the same (no choke). Use 1-16 for actual mutual-exclusion grouping"
+  - "A sliced Simpler inside a Drum Rack pad responds to slice-base pitch (36+N), NOT the pad's own MIDI note. Mis-configured slicing→pad routing is a common silence cause"
+  - "Per-pad sends can be shown/hidden by the rack's S (Send) button on the chain list. Hidden sends still work, but you can't see them — makes debugging missing reverb very hard"
+
+learn_more:
+  official: "https://www.ableton.com/en/live-manual/12/drum-racks/"
+  livepilot_related_tools:
+    - add_drum_rack_pad
+    - set_drum_chain_note
+    - get_rack_chains
+    - set_chain_volume
+    - rename_chain

package/mcp_server/atlas/enrichments/instruments/electric.yaml

@@ -78,6 +78,17 @@ key_parameters:
       clean: 0.5
       asymmetric_bark: 0.3
 
+signature_techniques:
+  - name: "Classic Rhodes"
+    description: "Suitcase preset, tremolo at 5 Hz, chorus modest. The tine-bar mechanism is already in the model — no outboard reverb needed for the classic sound."
+    aesthetic: ['jazz', 'neo_soul', 'r_and_b']
+  - name: "Gritty Wurlitzer"
+    description: "Wurly preset, short attack, amp drive in the 20-30% range, high-pass at 100 Hz. The reed-bar grit IS the character — don't EQ it out."
+    aesthetic: ['soul', 'funk', 'lo_fi']
+  - name: "Tape-warped EP"
+    description: "Rhodes through Grain Delay + Auto Filter LFO, slight pitch detune. Boards of Canada / lo-fi hip-hop territory — the imperfection is the sound."
+    aesthetic: ['lo_fi', 'downtempo', 'hip_hop']
+
 pairs_well_with:
   - device: "Chorus-Ensemble"
     reason: "Classic electric piano chorus — essential for the Juno-Rhodes sound"

package/mcp_server/atlas/enrichments/instruments/emit.yaml

@@ -102,6 +102,17 @@ key_parameters:
       natural: 500.0
       ambient: 3000.0
 
+signature_techniques:
+  - name: "Grain cloud (Tim Hecker)"
+    description: "Load a sustained pad source, grain density high, pitch randomization slight, reverb send heavy. The grains blur the source into an undifferentiated textural bed."
+    aesthetic: ['ambient', 'drone', 'experimental']
+  - name: "Generative evolving bass"
+    description: "Source = a droning note, grain density medium, randomize position slightly. The bass evolves organically without automation."
+    aesthetic: ['ambient', 'deep_minimal', 'generative']
+  - name: "Fluid texture"
+    description: "Short vocal sample as source, grain density sparse, position LFO slow, pitch spread wide. Not a chord, not a noise — a liminal texture that sits between."
+    aesthetic: ['experimental', 'ambient', 'idm']
+
 pairs_well_with:
   - device: "Reverb"
     reason: "Spectral sounds merge beautifully with long reverb — creates immersive washes"

package/mcp_server/atlas/enrichments/instruments/meld.yaml

@@ -101,6 +101,17 @@ key_parameters:
       tight: 100.0
       ambient: 2000.0
 
+signature_techniques:
+  - name: "Layered evolving pad"
+    description: "Two Drift engines with different characters (one dark, one bright), crossfade-modulated by slow LFO. The pad morphs between timbres without notes changing."
+    aesthetic: ['ambient', 'deep_minimal', 'cinematic']
+  - name: "Bass + sub stack"
+    description: "Engine A: mid bass with character. Engine B: pure sine sub. Balanced -3 dB apart. Two engines = precise crossover without needing a split."
+    aesthetic: ['dub_techno', 'trap', 'dnb']
+  - name: "Dual-voice chord"
+    description: "Engine A: plucked pluck at root. Engine B: sustained pad at 3rd/5th. Stacked voicing without needing two tracks."
+    aesthetic: ['house', 'deep_house', 'melodic_techno']
+
 pairs_well_with:
   - device: "Reverb"
     reason: "MPE expression + reverb creates deeply immersive evolving soundscapes"

package/mcp_server/atlas/enrichments/instruments/operator.yaml

@@ -133,6 +133,17 @@ key_parameters:
       subtle_vibrato: 0.1
       deep_modulation: 0.5
 
+signature_techniques:
+  - name: "DX7 bell cluster"
+    description: "Algorithm 5 (two parallel 2-op stacks), operator ratios 1:3.51 and 1:14, envelope decay long. The inharmonic ratio 3.51 is the classic bell metallic quality."
+    aesthetic: ['synthwave', '80s', 'ambient']
+  - name: "Haas deep bass"
+    description: "Single sine carrier, modulator at ratio 1:1 low feedback, fundamental at C1. The sine fundamental is what reproduces on laptop speakers via harmonics — FM adds body without touching fundamental."
+    aesthetic: ['dub_techno', 'deep_house']
+  - name: "Aphex ambient FM pad"
+    description: "Algorithm with 3 serial carriers, slow LFO modulating operator levels, long release. Shifts timbre over 16+ bars without notes changing. The 'breathing' is the composition."
+    aesthetic: ['idm', 'ambient', 'experimental']
+
 pairs_well_with:
   - device: "Reverb"
     reason: "FM bells and keys sound stunning with plate or hall reverb"

package/mcp_server/atlas/enrichments/instruments/poli.yaml

@@ -128,6 +128,17 @@ key_parameters:
       standard: 6
       full: 12
 
+signature_techniques:
+  - name: "Juno-style detuned chord"
+    description: "2 saws detuned 7 cents, sub-osc octave down, low-pass with slight resonance, chorus send heavy. 80s Juno territory without the preset."
+    aesthetic: ['synthwave', '80s', 'italo']
+  - name: "Retro stab"
+    description: "Single saw, fast filter envelope, high resonance, short decay. Classic 1987 house stab — works on top of any groove."
+    aesthetic: ['house', 'acid_house', 'electro']
+  - name: "Warm pad"
+    description: "Saw+square, slow attack, chorus, subtle LFO on cutoff. Where Poli shines vs Analog: less clinical, more 'plastic-fantastic' 80s charm."
+    aesthetic: ['synthwave', 'vaporwave', 'synth_pop']
+
 pairs_well_with:
   - device: "Reverb"
     reason: "Lush pads benefit from plate or hall reverb for depth"

package/mcp_server/atlas/enrichments/instruments/sampler.yaml

@@ -14,6 +14,7 @@ genre_affinity:
 complexity: advanced
 self_contained: false
 introduced_in: "1.0"
+pack: Core Library
 
 key_parameters:
   - name: "Filter Type"
@@ -159,6 +160,17 @@ key_parameters:
       natural: 0.5
       full_range: 1.0
 
+signature_techniques:
+  - name: "Orchestral multi-velocity"
+    description: "4 velocity layers per note (pp/mp/mf/ff), velocity->filter positive so harder hits open brighter. Essential for sampled orchestral realism — anything else sounds like a toy keyboard."
+    aesthetic: ['cinematic', 'orchestral']
+  - name: "Layered ensemble pad"
+    description: "2-3 sample layers per key, detune each slightly, filter each differently. One sample = thin; three samples stacked = lush ensemble without needing a real choir."
+    aesthetic: ['ambient', 'cinematic', 'pop']
+  - name: "Round-robin drum kit"
+    description: "Multi-sample kick/snare/hat with 3-4 round-robin variations per note. Humanizes programmed drums — no two hits sound identical without needing micro-timing."
+    aesthetic: ['all']
+
 pairs_well_with:
   - device: "EQ Eight"
     reason: "Surgical frequency shaping for multi-sampled instruments in a mix context"

package/mcp_server/atlas/enrichments/instruments/simpler.yaml

@@ -14,6 +14,7 @@ genre_affinity:
 complexity: beginner
 self_contained: false
 introduced_in: "1.0"
+pack: Core Library
 
 key_parameters:
   - name: "Mode"
@@ -159,6 +160,17 @@ key_parameters:
       subtle: 0.3
       wide: 0.7
 
+signature_techniques:
+  - name: "Vocal micro-chop (Akufen)"
+    description: "Load vocal, slicing mode, slice per transient, assign pads to short syllable fragments. Program MIDI pattern on the slices — the rhythmic chopping IS the vocal line."
+    aesthetic: ['microhouse', 'deep_minimal']
+  - name: "Villalobos sub-bass layer"
+    description: "One-shot mode, pitched sub sample in C1, warp off, amp envelope short. Layer this UNDER your kick — the sub_low (20-60 Hz) band carries the weight."
+    aesthetic: ['minimal_techno', 'dub_techno']
+  - name: "J Dilla micro-timed kit"
+    description: "Slicing mode on a classic break (e.g. Amen, Funky Drummer), slice per transient, then program MIDI with slight timing offsets (+/-10 ticks) — Dilla's micro-drunk feel comes from MIDI, not groove templates."
+    aesthetic: ['hip_hop', 'lo_fi', 'soul']
+
 pairs_well_with:
   - device: "Auto Filter"
     reason: "Adds rhythmic filter movement and envelope following to sampled material"
@@ -215,3 +227,6 @@ gotchas:
   - "Transpose shifts pitch in semitones, not time — use Warp for time-stretching without pitch change"
   - "crop_simpler and reverse_simpler are available as LivePilot tools for destructive sample editing"
   - "replace_simpler_sample only works if a sample is already loaded — cannot replace an empty Simpler"
+  - "Snap must be OFF after load_sample_to_simpler, or the sample plays silently (known Live bug). LivePilot auto-clears Snap in the role-aware load path"
+  - "load_browser_item Simplers come up at Volume=-12 dB and Ve Mode=None; track meter reads normal but master reads silence. Set Volume=0 dB on sustained tracks"
+  - "Slice mode maps slice N to MIDI pitch 36+N (base C1), NOT 60+C3 — notes at pitch 60+ produce silence. See `get_simpler_slices` doesn't disclose the base pitch"

package/mcp_server/atlas/enrichments/instruments/tension.yaml

@@ -97,6 +97,17 @@ key_parameters:
       subtle: 0.1
       expressive: 0.3
 
+signature_techniques:
+  - name: "Plucked gut string"
+    description: "Plectrum exciter, string damping high, body=acoustic guitar, noise low. Useful as a percussion-melody hybrid when acoustic guitar sampling feels sterile."
+    aesthetic: ['ambient', 'folk_electronic', 'cinematic']
+  - name: "Bowed cello low register"
+    description: "Bow exciter, slow speed, pressure medium, body=cello, full sustain. Pair with Convolution Reverb hall IR for Jóhann Jóhannsson / Max Richter territory."
+    aesthetic: ['cinematic', 'ambient', 'modern_classical']
+  - name: "Metal-string drone"
+    description: "Bow on a high-tension thin string, no damping, infinite sustain — the sound is pure harmonic series. Useful under sustained pads as hidden-voice color."
+    aesthetic: ['ambient', 'drone', 'experimental']
+
 pairs_well_with:
   - device: "Reverb"
     reason: "Bowed strings and plucks sound natural in reverberant spaces — essential for realism"

package/mcp_server/atlas/enrichments/instruments/vector_fm.yaml

@@ -103,6 +103,17 @@ key_parameters:
       natural: 300.0
       ambient: 2000.0
 
+signature_techniques:
+  - name: "Modulated bell cluster"
+    description: "Carrier at C4, modulator at inharmonic ratio, Vector X controlling modulator depth, Vector Y controlling feedback. Particle motion makes the bell evolve physically."
+    aesthetic: ['ambient', 'experimental', 'deep_minimal']
+  - name: "Metallic drone"
+    description: "Low carrier (C1), high modulator, Vector coupled to both. Sounds like a large resonant object being struck and allowed to decay over 30 seconds."
+    aesthetic: ['drone', 'ambient', 'experimental']
+  - name: "Pulsing FM bass"
+    description: "Carrier at fundamental, modulator LFO'd by Vector X, amp LFO'd by Vector Y. FM bass with physical 'breathing' rather than square-wave LFO control."
+    aesthetic: ['deep_minimal', 'idm', 'experimental']
+
 pairs_well_with:
   - device: "Reverb"
     reason: "FM timbres gain depth and space in reverb — morphing vector creates shifting reflections"

package/mcp_server/atlas/enrichments/instruments/vector_grain.yaml

@@ -111,6 +111,17 @@ key_parameters:
       balanced: 5000.0
       open: 15000.0
 
+signature_techniques:
+  - name: "Basinski tape degradation"
+    description: "Load a vocal or orchestral source, grain size medium, grain position drifting slowly (via Vector), feedback high. Each playback degrades slightly — the source DECAYS as the piece plays."
+    aesthetic: ['ambient', 'experimental', 'modern_classical']
+  - name: "Dense grain cloud"
+    description: "Grain density maximum, pitch spread wide, position random. The source is obliterated into texture — useful when the sample is too recognizable."
+    aesthetic: ['idm', 'ambient', 'drone']
+  - name: "Slow-motion sustain"
+    description: "Grain size long (500-1000ms), density low (1-2 grains), pitch ratio 0.5 or 0.25. Effectively time-stretches the source with lo-fi grain character. Stars of the Lid territory."
+    aesthetic: ['ambient', 'drone', 'modern_classical']
+
 pairs_well_with:
   - device: "Reverb"
     reason: "Grain clouds dissolve beautifully into reverb — creates immersive washes"

package/mcp_server/atlas/enrichments/instruments/wavetable.yaml

@@ -102,6 +102,17 @@ key_parameters:
     range: ["Matrix routing"]
     type: enum
 
+signature_techniques:
+  - name: "Supersaw trance lead"
+    description: "Saw wavetable, voices=7, spread=0.35, subosc square octave up, LPF fully open, chorus via unison detune not effect. Aim for glued breadth not comb-filter thinness."
+    aesthetic: ['trance', 'edm', 'progressive']
+  - name: "Morphing ambient pad"
+    description: "Two wavetables (e.g. Formant + Noise), wavetable-position modulated by slow LFO (0.05 Hz), filter envelope negative so tone opens during decay. No notes change — the TIMBRE is the music."
+    aesthetic: ['ambient', 'experimental', 'idm']
+  - name: "Wobble bass"
+    description: "Square-ish wavetable, LFO to filter cutoff synced at 1/8 or 1/16, depth near max. Classic dubstep bass — position automation over 4 bars moves texture under the wobble."
+    aesthetic: ['dubstep', 'bass_music', 'trap']
+
 pairs_well_with:
   - device: "Reverb"
     reason: "Pads and textures come alive with long reverb tails and high diffusion"

package/mcp_server/atlas/enrichments/midi_effects/filler.yaml

@@ -27,6 +27,23 @@ signature_techniques:
   - name: "Quick drum sketch"
     description: "Dial density, click generate, commit the pattern you like. Move on — don't spend time."
     aesthetic: [all]
+  - name: "Sparse minimal starter"
+    description: "Density at 20-30%, kick-snare-hat only, randomize → random sparse pattern → pick one as the minimal starting point for further human editing."
+    aesthetic: [deep_minimal, microhouse]
+
+pairs_well_with:
+  - device: "Drum Rack"
+    reason: "Filler outputs MIDI — route it INTO a Drum Rack, not onto a synth"
+  - device: "Velocity"
+    reason: "Filler's velocity output is often flat — follow with Velocity MIDI effect for dynamic shaping"
+  - device: "Retrigger"
+    reason: "Filler for base pattern, Retrigger for fill density on accent beats"
+
+gotchas:
+  - "Filler OUTPUTS MIDI to subsequent devices on the track — it does not play back on its own. Place before a Drum Rack"
+  - "Patterns (Iftah, from Generators by Iftah pack) is more musical for minimal. Use Filler when you want FREE and instant"
+  - "Randomize re-generates on every click — use undo to A/B compare patterns"
+  - "Density doesn't account for genre — high density in trap context, low in minimal. Adjust per aesthetic"
 
 learn_more:
   pack: "Building Max Devices"

package/mcp_server/atlas/enrichments/utility/performer.yaml

@@ -31,6 +31,21 @@ signature_techniques:
   - name: "Crossfader-style A/B"
     description: "Build a crossfader that switches between two device states via inverse macro curves."
     aesthetic: [performance]
+  - name: "Single pedal = intro-to-drop"
+    description: "Map a footpedal input via MIDI → Performer fader → filter open, send boost, reverb decay extend, LFO depth rise. One pedal drives an arrangement energy shift."
+    aesthetic: [live_performance]
+
+pairs_well_with:
+  - device: "Variations"
+    reason: "Performer controls continuous, Variations controls discrete — combine for coarse (Variations) + fine (Performer) morphing"
+  - device: "Any M4L or plugin"
+    reason: "Performer is the glue — any parameter becomes performable via curve-shaped Macro"
+
+gotchas:
+  - "Performer is a macro CONTROLLER, not a generator. Without mappings, it does nothing"
+  - "Curve editor is not exposed via MCP — set shapes in the Max UI"
+  - "Crossfader controls are two faders with inverse curves, not a single crossfader — design for that mental model"
+  - "Saving a Performer preset captures mappings BY PATH (e.g. track 3 device 2 param X). Duplicating the track breaks the mapping — remap after track restructure"
 
 learn_more:
   official: "https://www.ableton.com/en/packs/performance-pack/"

package/mcp_server/atlas/enrichments/utility/vector_map.yaml

@@ -31,6 +31,27 @@ signature_techniques:
   - name: "Coupled filter + reverb motion"
     description: "Particle X → filter cutoff, particle Y → reverb wet, particle velocity → dry/wet balance. Single physical motion drives a 3-parameter sonic change."
     aesthetic: [ambient, experimental]
+  - name: "Gravity-well attractor"
+    description: "Set strong gravity toward center + low friction → particle orbits return to origin with decay. Map to pad tone controls → pad breathes in-and-out toward a rest state."
+    aesthetic: [ambient, generative]
+  - name: "Chaotic lock-in"
+    description: "High initial velocity + medium friction → particle wanders, eventually settles. Map to filter + detune → synth starts mobile, finds a rest-state timbre over 16 bars."
+    aesthetic: [deep_minimal, experimental]
+
+pairs_well_with:
+  - device: "Tree Tone"
+    reason: "Both from Inspired by Nature — Vector Map drives Tree Tone's structural parameters for coupled organic motion"
+  - device: "Bouncy Notes"
+    reason: "Vector Map modulates Bouncy Notes' ballistics → asymmetric, evolving note cascades"
+  - device: "Any parameter-rich synth"
+    reason: "Vector Map really shines when addressing 4+ coupled parameters on the same instrument — Wavetable, Tension, Collision"
+
+gotchas:
+  - "Vector Map is a MODULATOR. Without destination mappings, the particle motion is invisible"
+  - "Heavy-parameter mappings can create runaway feedback loops (mod destination is itself a modulator source) — sanity-check your mod routing for cycles"
+  - "The particle is a single point — NOT multi-particle. For swarm behavior, stack multiple Vector Maps"
+  - "Very low friction values make the particle orbit forever — pair with gravity to stabilize"
+  - "Freezing the session (freeze_track) captures the particle's current state, not its dynamic behavior — flatten with the particle paused at a known position"
 
 learn_more:
   pack: "Inspired by Nature"