# Copilot Instructions

This repository controls Ableton Live 12 through an MCP server plus a Remote Script.

Before suggesting code:

1. Read `AGENTS.md`.
2. Read `CLAUDE.md`.
3. Assume Windows + PowerShell.
4. Prefer the active files, not backups or stale variants.

Key paths:

- `mcp_wrapper.py`
- `abletonmcp_init.py`
- `AbletonMCP_AI\abletonmcp_runtime.py`
- `AbletonMCP_AI\AbletonMCP_AI\MCP_Server\server.py`
- `AbletonMCP_AI\AbletonMCP_AI\MCP_Server\song_generator.py`
- `AbletonMCP_AI\AbletonMCP_AI\MCP_Server\reference_listener.py`

Current product focus:

- editing open `.als` projects
- MCP tools that inspect and mutate the current Live set
- coherence, continuity, and editability
- harmonic MIDI as backbone across the arrangement
- fewer silent gaps and less rigid symmetry
- no automatic vocals
- do not force piano timbre as a product direction

Quality bar:

- changed Python files should compile
- relevant tests should pass
- runtime changes should be validated against Ableton/MCP when possible
- do not claim success from logs or manifests alone

Style:

- PowerShell examples, not bash
- absolute Windows paths in scripts/docs
- standard library imports first
- explicit typing on server-side Python where already used
- structured logging with searchable prefixes
- small, focused changes instead of giant rewrites
