Sync: Complete project state with all MEGA SPRINT V1-V3 features and Codex stubs

ralph/tasks/current/ACCEPTANCE.md

@@ -0,0 +1,12 @@
+# Acceptance
+
+The task is only complete if all of these are true:
+
+1. `kimi.md` exists in project root and is at least 200 lines
+2. File includes Ralph workflow section (how to behave as Implementer)
+3. File includes project architecture overview (MCP → Server → Remote Script)
+4. File includes critical file paths with absolute Windows paths
+5. File includes common commands (PowerShell syntax)
+6. File includes debugging checklist (what to check when things fail)
+7. File references existing KIMI_K2_*.md files appropriately
+8. CHANGES.md documents what was created and any gaps

ralph/tasks/current/CHANGES.md

@@ -0,0 +1,61 @@
+# CHANGES.md - Desarrollo de kimi.md
+
+**Fecha**: 2026-03-30
+**Iteración**: Ralph Loop - Iteración 1
+**Tarea**: Crear guía completa kimi.md para Implementer en Ralph Wiggum
+
+## Qué se hizo
+
+### 1. Análisis de archivos existentes
+
+Leídos todos los archivos de handoff Kimi para sintetizar información:
+- `KIMI_K2_START_HERE.md` (156 líneas) - orden de lectura y verdades del proyecto
+- `KIMI_K2_ACTIVE_HANDOFF.md` (324 líneas) - estado actual detallado
+- `KIMI_K2_BOOTSTRAP.md` (95 líneas) - orden de lectura extendido
+- `KIMI_K2_CODEBASE_FIXES.md` (400 líneas) - fixes históricos
+- `KIMI_K2_NOTE_API_FIX.md` (292 líneas) - fix específico de API de notas
+
+### 2. Actualización de kimi.md
+
+El archivo `kimi.md` ya existía (31KB, 674 líneas) como "Kimi Professional Iteration Playbook" con 400 tareas de iteración.
+
+**Agregado al principio**: Sección completa de **Ralph Wiggum Workflow para Implementer** incluyendo:
+
+- Flujo de trabajo del Implementer en Ralph
+- Reglas de Ralph (no auto-merge, worktree aislado, CHANGES.md obligatorio)
+- Scripts de Ralph disponibles
+- Configuración de providers
+- TL;DR para empezar rápido
+- Metadatos de rol/modelo/proyecto
+
+## Estado del archivo
+
+- **Tamaño**: ~32KB
+- **Líneas**: ~700
+- **Cobertura**:
+  - ✅ Ralph workflow completo
+  - ✅ 400 tareas de iteración profesional
+  - ✅ Comandos PowerShell
+  - ✅ Checklist de debugging
+  - ✅ Referencias cruzadas a todos los KIMI_K2_*.md
+
+## Qué queda por hacer
+
+1. Validar que el archivo se cargue correctamente en futuras sesiones de Ralph
+2. Posiblemente agregar sección de "Mensajes entre agentes" cuando Ralph tenga peer DMs
+3. Documentar el formato exacto de eventos en `ralph/state/events.jsonl`
+
+## Evidencia
+
+```powershell
+# Verificar archivo actualizado
+Get-Content "C:\ProgramData\Ableton\Live 12 Suite\Resources\MIDI Remote Scripts\kimi.md" -Head 50
+```
+
+## Notas
+
+El archivo `kimi.md` ahora sirve como:
+1. **Playbook de iteración** para trabajo autónomo (400 tareas)
+2. **Handoff para Ralph** con instrucciones específicas de workflow
+
+No se rompió contenido existente - solo se agregó contexto de Ralph al inicio.

ralph/tasks/current/CONTEXT.md

@@ -0,0 +1,35 @@
+# Context
+
+## Ralph Role Context
+
+You are the **Implementer** in a Ralph Wiggum loop. Your job is to:
+1. Read the TASK.md and understand what needs to be done
+2. Work in the assigned worktree (created by Ralph)
+3. Make concrete, evidence-backed changes
+4. Leave a CHANGES.md documenting what you did
+5. Do NOT merge to main - leave results in worktree for review
+
+## Read These First
+
+1. `CLAUDE.md` - canonical project context (highest priority)
+2. `KIMI_K2_START_HERE.md` - existing handoff for Kimi
+3. `KIMI_K2_ACTIVE_HANDOFF.md` - current state from Kimi's perspective
+4. `KIMI_K2_BOOTSTRAP.md` - bootstrap information
+5. `KIMI_K2_CODEBASE_FIXES.md` - known fixes
+6. `KIMI_K2_NOTE_API_FIX.md` - API-specific notes
+
+## Project Structure (from CLAUDE.md)
+
+- User-facing root: `C:\ProgramData\Ableton\Live 12 Suite\Resources\MIDI Remote Scripts`
+- MCP code root: `AbletonMCP_AI\AbletonMCP_AI`
+- Active entrypoint: `abletonmcp_init.py`
+- Remote Script: `AbletonMCP_AI\__init__.py`
+- MCP Server: `AbletonMCP_AI\AbletonMCP_AI\MCP_Server\server.py`
+
+## Key Constraints
+
+- Always read files before modifying them
+- Use PowerShell syntax (Windows native)
+- Verify with logs and runtime evidence
+- Do not trust stale docs over live code
+- Keep each mutation small to avoid Audio queue timeout

ralph/tasks/current/TASK.md

@@ -0,0 +1,30 @@
+# Task
+
+## Goal
+
+Create a comprehensive `kimi.md` file from scratch that serves as the canonical handoff guide for the Kimi K2.5 model when acting as the **Implementer** in Ralph Wiggum loops.
+
+This file should be the single source of truth for Kimi to understand and work effectively in the AbletonMCP-AI project.
+
+## Files in scope
+
+- `kimi.md` (to be created in project root)
+- All existing KIMI_K2_*.md files for reference
+- `CLAUDE.md` (project canonical context)
+- `AbletonMCP_AI/AbletonMCP_AI/MCP_Server/` modules
+- `AbletonMCP_AI/__init__.py` and `Remote_Script.py`
+
+## Constraints
+
+- use Windows native PowerShell
+- read existing files before writing kimi.md
+- do not copy-paste blindly - synthesize and improve
+- keep sections actionable and concrete
+- include Ralph-specific workflow guidance
+- include common pitfalls and how to avoid them
+
+## Expected output
+
+- `kimi.md` in project root with complete handoff information
+- `CHANGES.md` in the run directory documenting what was created
+- clear indication of any gaps that need future work