contrapunk

Import or map Vital synth presets/banks into Elixir. Use when touching .vital/.vitalbank files, Downloads Vital assets, B5 preset format, wavetable import, or Vital compatibility.

Create or review nih-plug CLAP/VST3 plugin crates in Contrapunk, especially Elixir plugin work. Use when adding plugin/Cargo.toml crates, implementing Plugin/ClapPlugin/Vst3Plugin, handling MIDI events, or creating DAW-facing synth/effect skeletons.

Wire or review feature-flagged audio-chain cutovers in Contrapunk, especially replacing the legacy built-in Synth with ElixirSynthBlock behind elixir-synth. Use when touching src-tauri/src/audio_clock.rs, src/chain/*, built-in synth routing, Chain AudioBlock setup, or A-Cut work.

Measure and surface code entropy across the Contrapunk codebase. Use when the user asks "where should I refactor?", "what's the highest-entropy area?", "show codebase health", "what are the next steps?", or before a release. Also called automatically by the SessionStart hook for a fast snapshot. Produces a structured report with hotspots prioritized for action.

Enforce a TDD-driven workflow for Contrapunk feature/bug work. Use whenever a new feature or non-trivial bug fix is being implemented. Specifies the red-green-refactor loop, where tests live, what counts as "tested first", and how to plug into the project's existing test infrastructure. Also called automatically by the contrapunk-harmony-fixer agent.

Run Contrapunk performance checks and surface regressions. Use when the user asks "is performance still good?", "did this regress latency?", "check bundle size", "any audio glitches?", or before tagging a release. Also called automatically by the contrapunk-harmony-fixer agent before commit. Covers harmony-engine throughput, audio-callback allocation, WASM/UI bundle size, and known hot-path concerns from CONCERNS.md.

Cut a patch release of Contrapunk (e.g. v1.1.0 -> v1.1.1). Use when the user says "ship a patch", "cut v1.X.Y", "release the fix", or asks to roll up shipped fixes into a release. Bumps version files, validates, pushes, watches the macOS .dmg build, tags, and creates the GitHub Release with hand-written notes covering all commits since the last tag.