ableton-mcp-ai/.github/copilot-instructions.md

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