renato97/ableton-mcp-ai
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 1 Wiki Activity

docs: add Kimi K2 onboarding handoff

Browse Source
This commit is contained in:
renato97
2026-03-30 10:06:15 -03:00
parent 08fdd8011b
commit c5109d466c
6 changed files with 398 additions and 9 deletions
Download Patch File Download Diff File Expand all files Collapse all files

22
CLAUDE.md
View File

@@ -26,8 +26,10 @@ The goal is to operate Ableton Live 12 through MCP and a Remote Script so an AI
Read in this order before doing substantial work:
1. `C:\ProgramData\Ableton\Live 12 Suite\Resources\MIDI Remote Scripts\CLAUDE.md`
2. `C:\ProgramData\Ableton\Live 12 Suite\Resources\MIDI Remote Scripts\KIMI_K2_CODEBASE_FIXES.md`
3. inspect the active entrypoints and code directly
2. `C:\ProgramData\Ableton\Live 12 Suite\Resources\MIDI Remote Scripts\KIMI_K2_START_HERE.md`
3. `C:\ProgramData\Ableton\Live 12 Suite\Resources\MIDI Remote Scripts\KIMI_K2_ACTIVE_HANDOFF.md`
4. `C:\ProgramData\Ableton\Live 12 Suite\Resources\MIDI Remote Scripts\docs\ROADMAP.md`
5. inspect the active entrypoints and code directly
Do not trust stale docs over live code.
Do not trust live code over runtime evidence.
@@ -74,10 +76,10 @@ Verified executable paths:
Important:
- those shims currently prefer `AbletonMCP_AI_BAK_20260328_200801\Remote_Script.py`
- they only fall back to `abletonmcp_init.py`
- those shims currently prefer `abletonmcp_init.py`
- the backup runtime only remains as fallback
This means MCP and Ableton Live are not currently using a single implementation.
This means the canonical runtime is now the root `abletonmcp_init.py`.
## Source Of Truth Rules
@@ -213,12 +215,14 @@ As of the latest audit:
- Claude Code and opencode can connect to the MCP
- Ableton can load the `AbletonMCP_AI` Control Surface
- `generate_track` can still push Live into `Audio queue timeout`
- `server.py` currently exposes unique tools without duplicate registrations
- the active runtime path now points to `abletonmcp_init.py` first
- `generate_song` can materialize audio fallback in Arrangement
- `server_v2.py` does not compile
- `server.py` contains duplicated MCP tools
- the backup runtime is still in the active load path
- `clear_all_tracks` still has a soft failure at the end of cleanup
- Z.ai can return `429` and force fallback heuristics
If your task involves repairs, read `KIMI_K2_CODEBASE_FIXES.md` immediately after this file.
If your task involves repairs, read `KIMI_K2_START_HERE.md` and `KIMI_K2_ACTIVE_HANDOFF.md` immediately after this file.
## Fast Diagnostic Checklist