livepilot 1.26.0 → 1.26.1

package/livepilot/skills/livepilot-core/references/affordances/_schema.md

@@ -0,0 +1,160 @@
+# Device Affordance Schema
+
+Affordance packets describe WHAT a device is for, WHEN to reach for it,
+and WHEN it's a trap — in structured YAML that the director reads
+during Phase 3 plan generation and Phase 6 execution.
+
+Files live in:
+
+```
+livepilot/skills/livepilot-core/references/affordances/
+├── devices/<slug>.yaml       # per-device affordance
+└── _schema.md                # this file
+```
+
+Affordance packets COMPLEMENT the Device Atlas. The atlas knows what
+devices exist, their URIs, their presets, their `signature_techniques`.
+The affordance packets add the musical-judgment layer: which device
+is the right tool for which feeling, in which context.
+
+## Loading
+
+The director loads an affordance packet when:
+
+1. A candidate plan proposes loading or parameter-tuning that device
+2. A concept packet's `reach_for` list names the device
+3. The user explicitly requests a device ("load an Echo")
+
+The packet's fields populate the plan's description ("use Echo for dub
+tail, not bright slap") and filter out misuse ("Echo on dense high-hat
+patterns is risky per the affordance").
+
+## Schema
+
+```yaml
+# REQUIRED
+id: str                          # e.g. "echo"
+name: str                        # human-readable, e.g. "Echo"
+type: effect | instrument | utility | rack
+category: str                    # e.g. "delay", "filter", "synth", "physical_model"
+aliases: list[str]               # alternate names (e.g. "ping pong delay" for Echo in mode)
+atlas_search_query: str          # search hint — actual URI must be resolved via
+                                  # search_browser(query=this) at runtime. The atlas
+                                  # is the source of truth; hardcoding a URI here
+                                  # would rot on atlas updates.
+
+# What this device is FOR musically
+musical_roles: list[str]
+  # e.g. "dub space", "rhythm shadow", "tail harvesting"
+  # These map onto the sonic_identity fields of concept packets.
+
+# When this device is a strong choice
+strong_for: list[str]
+  # e.g. "widening sparse material", "implied groove without extra notes"
+  # Each entry should describe a musical situation, not a genre name.
+
+# When this device is a trap
+risky_for: list[str]
+  # e.g. "dense high-hat patterns", "muddy low-end sources"
+  # Specific situations where the device DEGRADES the result.
+
+# Parameter ranges with musical consequence
+subtle_ranges:                    # what "just audible" sounds like
+  <param_name>: [low, high]       # e.g. feedback: [0.15, 0.30]
+moderate_ranges:                  # what "obviously there" sounds like
+  <param_name>: [low, high]
+aggressive_ranges:                # what "signature / dramatic" sounds like
+  <param_name>: [low, high]
+
+# Device pairings
+pairings:                         # devices that work well in a chain
+  - device: str                   # pair device name
+    order: before | after | parallel
+    purpose: str                  # why the pairing works
+
+# Anti-pairings
+anti_pairings: list[str]          # device combinations that conflict or cancel
+
+# Post-load verification
+remeasure: list[str]
+  # Which diagnostics to run after this device is loaded or adjusted.
+  # e.g. "spectral_balance", "low_headroom", "groove_motion", "plugin_health"
+
+# How this device interacts with the 4 dimensions
+dimensional_impact:
+  structural: str                 # "low" | "moderate" | "high" | "none"
+  rhythmic: str
+  timbral: str
+  spatial: str
+
+# Which concept-packet aesthetics name this device in their reach_for
+appears_in_packets:
+  artists: list[str]
+  genres: list[str]
+
+# Free-form prose for the director to read when composing plan descriptions
+notes: str
+```
+
+## Field rules
+
+- `atlas_search_query` is a SEARCH HINT, not a URI. The actual URI is
+  resolved at runtime via `search_browser(query=atlas_search_query)`.
+  If the search returns multiple matches, the director picks the
+  first match whose name or URI substring equals `id` (case-insensitive).
+- `parameter_name` values in `subtle_ranges` / `moderate_ranges` /
+  `aggressive_ranges` may differ from the parameter names that
+  `get_device_parameters` returns (display name vs. internal name).
+  Always resolve via `get_device_parameters` at runtime; the affordance
+  YAML names are advisory, not canonical.
+- `subtle_ranges` / `moderate_ranges` / `aggressive_ranges` are
+  advisory numeric bands. Always confirm parameter range via
+  `get_device_parameters` — these bands are for HUMAN-readable
+  "what this sounds like" hints, NOT for automation-recipe bounds.
+- `dimensional_impact` uses `"low"` / `"moderate"` / `"high"` / `"none"`
+  — not numeric. This maps onto the four-move-rule's dimension axis.
+- `remeasure` should name metrics / tools that the director is
+  expected to run post-load. Listing `plugin_health` is mandatory for
+  any AU/VST device (see CLAUDE.md memory).
+- `pairings` and `anti_pairings` describe DEVICE-level relationships,
+  not genre-level ones. A pairing like "Auto Filter before Echo for
+  dub sweeps" lives here; a packet's `reach_for` list lives in
+  concept/.
+
+## Scope for PR 3
+
+The initial affordance set covers the 20 devices most-referenced across
+concept packets:
+
+1. Echo
+2. Auto Filter
+3. Convolution Reverb
+4. Hybrid Reverb  (if enriched in atlas; else skip)
+5. Drift
+6. Corpus
+7. Granulator III
+8. Simpler
+9. Wavetable
+10. Operator
+11. Ping Pong Delay
+12. Saturator
+13. Redux (if enriched in atlas; else Vinyl Distortion)
+14. Utility
+15. EQ Eight
+16. Compressor
+17. Glue Compressor
+18. Chorus-Ensemble
+19. Shifter
+20. Poli
+
+## Sync with atlas
+
+The atlas already has `signature_techniques` for 47 devices. Affordance
+YAMLs SHOULD NOT duplicate those — instead, `notes` can reference them
+via `See atlas signature_techniques for recipes.`
+
+Keep the axes distinct:
+- **Atlas** = what exists, what presets are available, what recipes
+  work on this device
+- **Affordance** = when to reach for this device, when to avoid it,
+  how its parameters translate to musical consequence

package/livepilot/skills/livepilot-core/references/affordances/devices/auto-filter.yaml

@@ -0,0 +1,133 @@
+id: auto_filter
+name: Auto Filter
+type: effect
+category: filter
+aliases:
+  - "auto filter"
+  - "auto-filter"
+atlas_search_query: "Auto Filter"
+
+musical_roles:
+  - filter-sweep arranging
+  - dub-tail shaping on delay returns
+  - wobble-bass foundation (filter + LFO)
+  - build-up tension (closing filter into drop)
+  - single-source-morph melody (filter-as-melody)
+
+strong_for:
+  - long-arc filter sweeps (4-16 bar)
+  - shaping delay returns (on the RETURN, not the input)
+  - LFO-driven wobble bass
+  - subtractive minimal-techno arrangement (filter-as-melody)
+  - removing high-end from samples that feel too bright
+
+risky_for:
+  - already-filtered sources (compounded narrowness)
+  - tracks that depend on top-end for clarity (vocals, cymbals)
+  - busses with multiple harmonic sources (filter sweeps mask key)
+  - short sounds (filter envelope never resolves)
+
+# All parameter values are 0-1 NORMALIZED (raw values you pass to
+# set_device_parameter). The modern AutoFilter2 class uses 0-1 for every
+# band-relevant parameter. value_string in the response is the source of
+# truth for the display-unit (Hz, %, etc.) — always read it.
+#
+# Live-verified frequency mapping (AutoFilter2, v1.18.0):
+#     raw 0.10 → ~40 Hz    (sub)
+#     raw 0.25 → ~100 Hz   (low)
+#     raw 0.45 → ~450 Hz   (low-mid — dub-filtered tails)
+#     raw 0.55 → ~900 Hz   (mid)
+#     raw 0.65 → ~2 kHz    (presence)
+#     raw 0.80 → ~5 kHz    (brightness)
+#     raw 0.90 → ~10 kHz   (air)
+# The curve is roughly exponential — raw → display is NOT linear.
+subtle_ranges:
+  frequency: [0.60, 0.85]    # ~1.2-8 kHz (mid-high, opening the top end)
+  resonance: [0.0, 0.3]
+  envelope_amount: [0.0, 0.2]
+  lfo_amount: [0.0, 0.15]
+moderate_ranges:
+  frequency: [0.40, 0.60]    # ~300-1500 Hz (vocal / chord-stab territory)
+  resonance: [0.3, 0.6]
+  envelope_amount: [0.2, 0.5]
+  lfo_amount: [0.15, 0.4]
+aggressive_ranges:
+  frequency: [0.25, 0.45]    # ~100-450 Hz (dub / low-pass chop)
+  resonance: [0.6, 0.9]      # still ≤1 — AutoFilter2 caps at 1.0
+  envelope_amount: [0.5, 1.0]
+  lfo_amount: [0.4, 1.0]
+  # Pre-v1.18.1 this YAML had LEGACY Hz values (1200-8000 etc) which
+  # applied to the pre-2010 AutoFilter device (class name AutoFilter,
+  # Frequency range 20-135 absolute). Live 12 ships AutoFilter2 which
+  # normalizes everything to 0-1 — the legacy values made set_device_parameter
+  # calls silently clamp or behave unpredictably.
+
+pairings:
+  - device: Echo
+    order: after
+    purpose: filter the input before it hits the delay (dub chain)
+  - device: Saturator
+    order: after
+    purpose: harmonic saturation on the filtered signal
+  - device: Envelope Follower
+    order: parallel
+    purpose: kick-triggered filter sweeps on non-kick elements
+  - device: LFO  # standalone LFO via mapped parameter
+    order: parallel
+    purpose: long-arc filter movement via mapped macro
+
+anti_pairings:
+  - Multiple Auto Filters in series (use one with steeper slope instead)
+  - EQ Eight doing the same cut (redundant with filter)
+
+remeasure:
+  - spectral_balance       # filters directly change spectrum
+  - track_meters           # narrow filtering can kill signal
+  - groove_motion          # LFO-rate filter changes groove feel
+  # Always read value_string after setting any Auto Filter parameter —
+  # the raw 0-1 input maps non-linearly to display Hz/%/etc.
+
+dimensional_impact:
+  structural: moderate     # long sweeps ARE arrangement moves
+  rhythmic: low-moderate
+  timbral: high            # filter is fundamental timbre
+  spatial: low
+
+appears_in_packets:
+  artists:
+    - villalobos
+    - basic-channel
+    - hawtin
+    - skream-mala
+    - daft-punk
+  genres:
+    - dub-techno
+    - minimal-techno
+    - microhouse
+    - house
+    - deep-minimal
+    - dubstep
+    - uk-garage
+
+notes: |
+  Live 12 ships two Auto Filter classes. The modern `AutoFilter2` uses
+  0-1 NORMALIZED for Frequency and Resonance (live-verified against
+  v1.18.0). The legacy `AutoFilter` used an absolute 20-135 Hz range
+  for Frequency. This affordance documents the MODERN class — always
+  inspect the `class_name` field in `get_device_parameters` output
+  before applying: if it's `AutoFilter` (not `AutoFilter2`), the raw
+  values in this YAML will silently clamp or behave unexpectedly.
+
+  Defensive discipline: regardless of class, call
+  `get_device_parameters` after setting and read `value_string` for
+  the actual Hz value. The raw-to-display mapping is non-linear on both
+  classes.
+
+  For dub-techno delay returns: put Auto Filter ON the return track,
+  AFTER the Echo device. Low-pass at moderate frequency (raw ~0.40-0.55,
+  display ~300-900 Hz) with slow LFO (0.15 raw = ~0.26 Hz display)
+  gives the "tail movement" that carries harmony.
+
+  For minimal-techno subtractive: map a macro to the Frequency, draw
+  a 32-bar ramp from closed to open, and let the filter BE the
+  arrangement (Hawtin technique).

package/livepilot/skills/livepilot-core/references/affordances/devices/chorus-ensemble.yaml

@@ -0,0 +1,91 @@
+id: chorus_ensemble
+name: Chorus-Ensemble
+type: effect
+category: modulation
+aliases:
+  - "chorus-ensemble"
+  - "chorus ensemble"
+  - "chorus"
+atlas_search_query: "Chorus-Ensemble"
+
+musical_roles:
+  - thickening pads and leads
+  - synthwave / 80s lead character
+  - warming single-oscillator synths
+  - Juno-style ensemble emulation
+  - subtle stereo spread
+
+strong_for:
+  - synthwave leads (Com Truise / Tycho aesthetic)
+  - warming Poli / Drift patches
+  - Juno-60-style ensemble chorus
+  - pads that feel "thin" from a single oscillator
+  - house / deep-house Rhodes thickening
+
+risky_for:
+  - percussion (chorus smears transients)
+  - bass (chorus widens — destroys mono bass)
+  - already-chorused sources (Poli has internal chorus)
+  - modern-classical / ambient (adds period-specific character — may conflict)
+
+subtle_ranges:
+  amount: [0.0, 0.15]
+  rate: [0.1, 0.8]                # Hz
+  depth: [0.0, 0.2]
+moderate_ranges:
+  amount: [0.15, 0.40]
+  rate: [0.3, 1.2]
+  depth: [0.2, 0.5]
+aggressive_ranges:
+  amount: [0.40, 0.85]
+  rate: [0.8, 3.0]
+  depth: [0.5, 1.0]
+
+pairings:
+  - device: Drift
+    order: after
+    purpose: thickening Drift pads (synthwave, house)
+  - device: Poli
+    order: after
+    purpose: extra thickness beyond Poli's internal chorus
+  - device: Wavetable
+    order: after
+    purpose: thickening wavetable pads (OPN aesthetic)
+  - device: Echo
+    order: after
+    purpose: chorus INTO echo for lush doubled tails
+
+anti_pairings:
+  - "Bass tracks (chorus destroys mono compatibility on bass)"
+  - "Drum bus (chorus smears drum transients)"
+  - "Heavily-detuned Drift/Poli (already wide; chorus compounds)"
+
+remeasure:
+  - stereo_width            # chorus widens
+  - mono_compatibility
+  - spectral_balance
+
+dimensional_impact:
+  structural: none
+  rhythmic: none
+  timbral: moderate
+  spatial: moderate
+
+appears_in_packets:
+  artists:
+    - isolee-luomo
+    - com-truise-tycho
+    - daft-punk
+  genres:
+    - microhouse
+    - synthwave
+    - house
+
+notes: |
+  Chorus-Ensemble is specialist: thickening synths, mostly pads
+  and leads. Never on percussion or bass. For synthwave,
+  moderate amount (0.3-0.5) + slow rate (0.5 Hz) is canonical.
+
+  In concept packets that list Chorus-Ensemble in reach_for, it's
+  typically paired with Drift or Poli — the chorus completes the
+  analog-polysynth character.

package/livepilot/skills/livepilot-core/references/affordances/devices/compressor.yaml

@@ -0,0 +1,98 @@
+id: compressor
+name: Compressor
+type: effect
+category: dynamics
+aliases:
+  - "compressor"
+atlas_search_query: "Compressor"
+
+musical_roles:
+  - sidechain compression triggered by kick (pumping aesthetic)
+  - individual-track dynamics taming
+  - transient shaping (attack parameter)
+  - parallel compression for drum-bus density
+  - envelope-follower-triggered dynamic filtering
+
+strong_for:
+  - house / disco / dance sidechain pumping (via Envelope Follower)
+  - vocal compression for consistency
+  - drum-bus glue (moderate ratio, slow attack)
+  - controlling peaks on transient-heavy material
+  - parallel processing for density without killing transients
+
+risky_for:
+  - ambient / drone material (compression kills the dynamic evolution)
+  - transient-critical sources at aggressive settings (squash kills punch)
+  - already-limited material (compounded compression = lifeless)
+  - subtle-aesthetic contexts (Basic Channel, Gas) — the genre avoids compression
+
+subtle_ranges:
+  threshold: [-6, -3]             # dB
+  ratio: [1.5, 2.5]
+  attack: [10, 30]                # ms
+  release: [50, 200]              # ms
+  gain_reduction: [1, 3]          # dB actual reduction target
+moderate_ranges:
+  threshold: [-12, -6]
+  ratio: [2.5, 4.0]
+  attack: [2, 10]
+  release: [20, 50]
+  gain_reduction: [3, 6]
+aggressive_ranges:
+  threshold: [-20, -12]
+  ratio: [4.0, 10.0]
+  attack: [0.1, 2]
+  release: [5, 20]
+  gain_reduction: [6, 15]
+
+pairings:
+  - device: Envelope Follower
+    order: before  # routed from external kick track
+    purpose: sidechain pumping (house / disco / dance)
+  - device: EQ Eight
+    order: before
+    purpose: cut problem frequencies before compressing
+  - device: Saturator
+    order: before
+    purpose: tame saturation peaks with downstream compression
+  - device: EQ Eight
+    order: after
+    purpose: restore lost brightness after compression
+
+anti_pairings:
+  - "Multiple compressors in series at aggressive settings (squash compound)"
+  - "Limiter after compressor at aggressive settings (double-dynamics-kill)"
+
+remeasure:
+  - track_meters            # compression changes level
+  - spectral_balance        # dynamic EQ shift
+  - groove_motion           # sidechain pumping changes groove
+
+dimensional_impact:
+  structural: none
+  rhythmic: moderate        # sidechain pumping IS rhythmic texture
+  timbral: low
+  spatial: none
+
+appears_in_packets:
+  artists:
+    - daft-punk
+    - moodymann-theo-parrish
+    - com-truise-tycho
+    - skream-mala
+  genres:
+    - house
+    - dubstep
+    - trap
+    - modern-classical
+    - drum-and-bass
+
+notes: |
+  Compressor's most distinctive LivePilot use is sidechain pumping
+  via Envelope Follower — route the kick track's audio into
+  Compressor's sidechain input, ratio 4:1, attack 0.1 ms, release
+  150-250 ms, and non-kick elements breathe with the kick.
+
+  For genres that AVOID compression (Basic Channel dub-techno,
+  Gas ambient), the packet's `avoid` list will explicitly name
+  heavy compression — respect it.

package/livepilot/skills/livepilot-core/references/affordances/devices/convolution-reverb.yaml

@@ -0,0 +1,113 @@
+id: convolution_reverb
+name: Convolution Reverb
+type: effect
+category: reverb
+aliases:
+  - "convolution reverb"
+  - "convolution"
+atlas_search_query: "Convolution Reverb"
+
+musical_roles:
+  - cathedral / hall space for ambient and modern-classical
+  - dub-techno fog chain (100% wet on send)
+  - plate-reverb snare (Golden-era hip-hop)
+  - custom-IR aesthetic (spring, cassette, impulse loops)
+  - tail-harvesting (extract reverb tail as separate source)
+
+strong_for:
+  - creating a specific real-world acoustic (hall, cathedral, chamber)
+  - dub-techno reverb chain (behind Echo on return, 100% wet)
+  - vintage plate / spring character via IR
+  - low CPU reverb for many simultaneous returns
+  - non-standard IRs (metal cabinet, car cabin, sampled vinyl noise)
+
+risky_for:
+  - dry-aesthetic genres (hip-hop without intended plate, trap, boom-bap)
+  - tracks that already have strong spatial identity from another device
+  - short-tail needs (use Hybrid Reverb or Reverb instead)
+  - CPU-constrained sessions with many returns (less of a concern in 12.3+)
+
+subtle_ranges:
+  wet: [0.05, 0.20]              # dry/wet mix
+  decay_time: [0.5, 2.0]         # seconds — actual parameter name
+moderate_ranges:
+  wet: [0.25, 0.50]
+  decay_time: [2.0, 5.0]
+aggressive_ranges:
+  wet: [0.55, 1.0]
+  decay_time: [5.0, 15.0]
+  # 100% wet on a return is the dub-techno default — context-dependent.
+  # On a send-return architecture (not an insert), wet=1.0 is functionally
+  # moderate (send level controls intensity); on an insert it's aggressive.
+
+pairings:
+  - device: Echo
+    order: before
+    purpose: dub chain — Echo feeds the reverb for filtered-delay tails
+  - device: Auto Filter
+    order: before
+    purpose: filter the input before reverb for tone-shaped tails
+  - device: EQ Eight
+    order: after
+    purpose: shelf-cut low-end from reverb tails to prevent mud
+  - device: Utility
+    order: before
+    purpose: mono-ize input before reverb for centered space
+
+anti_pairings:
+  - "Another large-IR reverb in series (use one at 100% wet on a send)"
+  - "Gated Delay on a reverb tail (Gated Delay expects dry input)"
+
+remeasure:
+  - spectral_balance        # reverb bloom can push low-mid
+  - stereo_width            # hall IRs spread stereo
+  - low_headroom            # tail buildup over time
+  - mud_content             # low-end buildup from tail
+
+dimensional_impact:
+  structural: low
+  rhythmic: low
+  timbral: moderate         # IR choice colors tone
+  spatial: high             # dominant consequence
+
+appears_in_packets:
+  artists:
+    - basic-channel
+    - gas
+    - hawtin
+    - basinski
+    - stars-of-the-lid
+    - tim-hecker
+    - shackleton
+    - villalobos
+    - dj-premier-rza
+    - daft-punk
+    - johannsson-richter
+    - robert-henke
+    - photek-source-direct
+    - skream-mala
+    - burial
+  genres:
+    - ambient
+    - dub-techno
+    - deep-minimal
+    - minimal-techno
+    - microhouse
+    - modern-classical
+    - hip-hop
+    - drum-and-bass
+    - uk-garage
+
+notes: |
+  Convolution Reverb is the most-referenced spatial device in the
+  catalog (15 artist packets). IR choice matters more than any other
+  parameter — Farfisa Spring for Basic Channel, cathedral for Gas,
+  Stocktronics RX-4000 for dub-techno variety, hall for Jóhannsson.
+
+  For dub-techno: place on a return track behind Echo, set wet to
+  100%, let tracks send to it. For hip-hop snare: place on a return,
+  set IR to a plate, send snare at -9 dB.
+
+  Per CLAUDE.md analyzer-placement rule: if you load Convolution
+  Reverb on the master chain, the LivePilot_Analyzer must be AFTER
+  it, not before.

package/livepilot/skills/livepilot-core/references/affordances/devices/corpus.yaml

@@ -0,0 +1,84 @@
+id: corpus
+name: Corpus
+type: effect
+category: physical_model
+aliases:
+  - "corpus"
+atlas_search_query: "Corpus"
+
+musical_roles:
+  - physical-modeling resonance on non-pitched sources
+  - metallic / glass / stone percussion textures (Arca / SOPHIE)
+  - pitched resonator on drums
+  - inharmonic bell-drone generator
+  - impossible-acoustic space creation
+
+strong_for:
+  - transforming percussion into pitched tonal content
+  - creating metal-on-glass textures (Arca aesthetic)
+  - resonance-based sound design where the SOURCE gets replaced by its resonance
+  - experimental / noise work (atonal resonance)
+  - noise-bow technique (bowing noise through Corpus)
+
+risky_for:
+  - pitched melodic material (Corpus will fight the source's harmony)
+  - already-resonant sources (double-resonance = chaos)
+  - dense mixes (Corpus's output has complex harmonic content)
+  - conservative production (it always sounds "processed")
+
+subtle_ranges:
+  resonance_amount: [0.0, 0.25]
+  decay: [0.1, 0.5]
+  body_size: [0.3, 0.6]
+moderate_ranges:
+  resonance_amount: [0.25, 0.55]
+  decay: [0.5, 2.0]
+  body_size: [0.15, 0.85]
+aggressive_ranges:
+  resonance_amount: [0.55, 1.0]
+  decay: [2.0, 10.0]              # long sustained resonance
+  body_size: [0.0, 1.0]           # extremes
+
+pairings:
+  - device: Erosion
+    order: before
+    purpose: noise input for resonance coloring
+  - device: Spectral Resonator
+    order: parallel
+    purpose: additional spectral content beyond Corpus model
+  - device: Convolution Reverb
+    order: after
+    purpose: spatial placement of resonance
+
+anti_pairings:
+  - "Another Corpus in series (unpredictable feedback)"
+  - "Tension with Corpus (both physical models — pick one)"
+
+remeasure:
+  - spectral_balance        # Corpus dramatically changes spectrum
+  - low_headroom            # resonance can build up level
+  - plugin_health
+
+dimensional_impact:
+  structural: low
+  rhythmic: low
+  timbral: high
+  spatial: moderate         # Corpus has inherent spatial character
+
+appears_in_packets:
+  artists:
+    - arca-sophie
+  genres:
+    - experimental
+    - idm
+
+notes: |
+  Corpus is the physical-modeling signature for Arca/SOPHIE aesthetic.
+  Use it to transform percussion into pitched textures, or to add
+  metallic resonance that sounds physical rather than synthesized.
+
+  Canonical technique: "Noise Bow" — bow a noise source through Corpus
+  to generate inharmonic drone. See atlas signature_techniques.
+
+  Plans using Corpus should note its `dimensional_impact.timbral=high`
+  means a Corpus plan counts as a timbral plan for the four-move rule.