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

docs/REFERENCE_TRACK_EJEMPLO_MICRO_STEMS.md

@@ -0,0 +1,113 @@
+# Reference Track Ejemplo - Micro Stems
+
+Ultima revision: 2026-03-30
+
+Referencia analizada:
+
+- `C:\ProgramData\Ableton\Live 12 Suite\Resources\MIDI Remote Scripts\libreria\reggaeton\ejemplo.mp3`
+
+Evidencia guardada:
+
+- `C:\ProgramData\Ableton\Live 12 Suite\Resources\MIDI Remote Scripts\temp\ejemplo_micro_stems_report.json`
+- `C:\ProgramData\Ableton\Live 12 Suite\Resources\MIDI Remote Scripts\temp\ejemplo_arrangement_plan_validation.json`
+
+## Resumen duro
+
+- tempo detectado: `99.384 BPM`
+- key detectada: `Am`
+- duracion: `249.463s`
+- secciones detectadas: `33`
+- micro segmentos considerados: `875`
+- micro segmentos elegidos: `31`
+- palette dominante del plan validado: `ss_rnbl`
+
+## Lo que aparece como DNA del tema
+
+### Ritmo
+
+- token dominante claro: `dembow`
+- hats y snare apuntan fuerte a familia `ss_rnbl`
+- los fills e impactos tambien quedan bastante claros
+
+### Low end
+
+- el rol `bass_loop` converge a `ss_rnbl`
+- token dominante: `reese`
+- conclusion: el bajo de referencia pide low-end simple y sostenido, no demasiadas capas nuevas
+
+### Ambiente
+
+- `atmos_fx` converge a `Midilatino_Zara ... Texture`
+- token dominante: `pad`
+- conclusion: el aire del track es un soporte textural leve, no un hook gigante ni un FX loco
+
+### Melodia
+
+Despues de bloquear vocal contamination en `synth_loop`, el foco armonico quedo asi:
+
+- `pluck 7.wav`
+- `Midilatino_Holanda ... Pluck 2.wav`
+- `Midilatino_Cielo ... Harp.wav`
+
+Conclusion:
+
+- la referencia, vista solo desde audio, tira mas a `pluck / harp / pad` que a un synth grueso
+- no esta apareciendo `piano` como token dominante
+
+## Por que no aparece piano
+
+No significa que la referencia no tenga piano o keys en el feel general.
+
+Significa que:
+
+- el matching micro actual usa audio
+- en esta libreria, muchos pianos viven en:
+  - `sounds presets`
+  - `MIDI PACK`
+  - subcarpetas `MIDI`
+- por eso el sistema aun no puede concluir "usa este piano" solo con audio matching
+
+## Hallazgos importantes
+
+### Hallazgo 1
+
+Antes del fix, `synth_loop` podia subir un archivo tipo `lead vocals dry`.
+
+Eso ya fue corregido.
+
+### Hallazgo 2
+
+El selector de pack podia elegir carpetas genericas como `20 One Shots` como pack dominante.
+
+Eso tambien ya fue corregido.
+
+### Hallazgo 3
+
+Aun con micro stems activos, el plan validado puede terminar con `synth_loop = null`.
+
+Eso no es un bug aislado del scorer.
+
+Es una senal de arquitectura:
+
+- falta un camino real para material armonico no-audio
+
+## Contrato musical para el siguiente sprint
+
+Si una nueva generacion basada en `ejemplo.mp3` quiere parecerse mas a la referencia, tiene que respetar esto:
+
+1. dembow simple y estable
+2. low-end con una sola identidad dominante
+3. pocas familias sonoras
+4. hook melodico corto tipo `pluck / keys / harp / piano`, no capas random
+5. contraste por seccion con densidad, no con cambio total de universo sonoro
+
+## Implicacion de desarrollo
+
+El siguiente salto no es "mejor score de audio".
+
+Es:
+
+1. enlazar audio families con `MIDI` y presets hermanos
+2. convertir `micro_stem_summary` en `phrase plan`
+3. dejar que el remake pueda decidir `keys/piano/pluck` aunque el activo no exista como loop de audio
+