# SPRINT 7: Session View Máster — Plan Completo (100+ Fases)

> **Objetivo**: Transformar `_cmd_build_pro_session` en un sistema de producción Session View de calidad profesional con variación masiva de samples (100+), humanización avanzada, progresiones armónicas coherentes, y estructura musical real de ~4 minutos.
>
> **Scope**: 100% Session View. Zero Arrangement View automation. El usuario usa F9 manualmente cuando desee.
>
> **Total Fases**: 100+
> **Tracks Objetivo**: 20 (actual: 14)
> **Scenes Objetivo**: 13 (actual: 8)
> **Samples por canción**: 100+ (rotando toda la librería)

---

## 📊 MÉTRICAS DE ÉXITO

| Métrica | Valor Objetivo | Actual |
|---------|----------------|--------|
| Samples usados por canción | 100+ | ~20 |
| Scenes creadas | 13 | 8 |
| Tracks totales | 20 | 14 |
| Duración | ~4 minutos | ~2:30 |
| Progresiones únicas | 8+ | 8 |
| Variación por scene | 100% | 80% |

---

## 🏗️ ARQUITECTURA DE SCENES FINAL (13 Scenes)

```
Scene 0: Intro         (4 bars)  Energy 0.20 — Pad, Ambience
Scene 1: Verse A       (8 bars)  Energy 0.50 — +Drums Sparse, Bass
Scene 2: Verse B       (8 bars)  Energy 0.60 — +Lead Melody
Scene 3: Pre-Chorus    (4 bars)  Energy 0.75 — +Riser, Snare Roll
Scene 4: Chorus A      (8 bars)  Energy 0.95 — Full +Impact
Scene 5: Chorus B      (8 bars)  Energy 0.90 — +Modulation
Scene 6: Verse C       (8 bars)  Energy 0.55 — Variation
Scene 7: Chorus C      (8 bars)  Energy 0.95 — Full
Scene 8: Bridge        (4 bars)  Energy 0.40 — Minimal, Tension
Scene 9: Build Up      (4 bars)  Energy 0.80 — Rising
Scene 10: Final Chorus (8 bars)  Energy 1.00 — Maximum
Scene 11: Outro        (4 bars)  Energy 0.30 — Fade
Scene 12: End          (2 bars)  Energy 0.00 — Silence
```

**Total: 70 bars = ~2:56 @ 95bpm** (expandible a 80 bars para ~3:20)

---

## 🎯 FASES 1-10: Arquitectura de Tracks Expandida (20 Tracks)

### Audio Tracks (14)
1. Drum Loop (prota, 95% vol)
2. Kick Sub (grave, 60-80Hz)
3. Kick Mid (cuerpo, 100-150Hz)
4. Kick Top (click, 2-4kHz)
5. Snare Body (cuerpo, 200Hz)
6. Snare Crack (brillo, 5kHz)
7. HiHat Closed
8. HiHat Open
9. Shaker/Tambourine
10. Congas
11. Timbal/Toms
12. Bass Audio
13. FX
14. Ambience/Atmosphere

### MIDI Tracks (6)
15. Dembow MIDI
16. Bass MIDI
17. Chords MIDI
18. Lead Melody MIDI
19. Pad MIDI
20. Stabs/Chops MIDI

---

## 🎯 FASES 11-25: Variación Masiva de Samples

### Sistema `_pick_for_scene_advanced`
- Distribuir TODOS los samples disponibles en las 13 scenes
- Regla: ningún sample se repite en 2 scenes consecutivas
- Rotación por energía: samples suaves para intro/outro, pesados para chorus

### Sample Pools
- **26 kicks** → repartidos en scenes 1-10 (2-3 por scene donde hay drums)
- **26 snares** → repartidos en scenes 1-10
- **34 drumloops** → repartidos en scenes 1,2,4,6,7,10
- **10 bass** → repartidos en scenes 1-10
- **34 perc loops** → repartidos en scenes 1-10
- **24 fx** → repartidos en scenes 3,4,8,9,11
- **84 oneshots** → usados para melodic hits, vocal chops
- **658 SentimientoLatino2025** → pool masivo para variedad infinita

**Total: 100+ samples únicos por canción**

---

## 🎯 FASES 26-40: Humanización Avanzada

### Perfiles por Instrumento (10 perfiles)
1. **Kick**: timing ±5ms, velocity ±15, length ±5%
2. **Snare**: timing ±10ms, velocity ±20, ghost notes aleatorias
3. **HiHat**: timing ±15ms, velocity ±30, swing 0.5-0.7
4. **Bass**: timing ±8ms, velocity ±12
5. **Chords**: timing ±12ms, velocity ±18
6. **Lead**: timing ±12ms, velocity ±18, micro-pitch drift
7. **Pad**: timing ±5ms, velocity ±10 (suave)
8. **Perc**: timing ±15ms, velocity ±25
9. **FX**: timing ±20ms (creativo)
10. **Stabs**: timing ±10ms, velocity ±15

### Features
- Micro-timing por sección (intro más loose, chorus tight)
- Velocity scaling por energía (intro 50-70, chorus 90-127)
- Groove templates: dembow, moombahton, perreo, trap
- Ghost notes automáticas en snare (velocity 40-60, timing random)
- Fills automáticos en transiciones
- Crescendo/decrescendo velocity

---

## 🎯 FASES 41-55: Progresiones Armónicas Profesionales

### 16 Progresiones Catalogadas

| Función | Progresión | Uso |
|---------|-----------|-----|
| Intro | vi-IV-I-V | Suave, establecedora |
| Verse | i-v-vi-IV | Estándar reggaeton |
| PreChorus | i-iv-VII-VI | Tensión ascendente |
| Chorus | i-V-vi-IV | Poderosa, resolutiva |
| Bridge | iv-VII-i-VI | Modal, diferente |
| Outro | i-v-i-VII | Resolución suave |

### Features Avanzadas
- Modulación de key (subir 1 semitono en Chorus B)
- Chord anticipation (acorde 1/16 antes del beat)
- Acordes suspendidos (sus2, sus4, 7sus4) para tensión
- Inversiones de acordes por suavidad
- 9nas y 11nas en chorus para riqueza
- Secondary dominants (V/vi, V/IV)
- Modal interchange del paralelo menor

---

## 🎯 FASES 56-70: Estructura Musical Real

Ver tabla de scenes arriba.

**Total: 70 bars = ~2:56 @ 95bpm**

---

## 🎯 FASES 71-85: MIDI Avanzado y Melodías

### 8 Estilos de Bass
1. sub — Solo graves, sustained
2. sustained — Notas largas, legato
3. pluck — Cortas, staccato
4. slap — percusivo, attack fuerte
5. slide — glissandos entre notas
6. octaves — Doble octava para chorus
7. harmonics — Armónicos brillantes
8. synth — Bajos sintéticos, LFO

### Features
- Contramelodías automáticas
- Arpegios en pre-chorus
- Call and response en verses
- Fills de drums por scene
- Rolls de snare en builds
- Melodic variation engine
- Pads evolutivos (filtro abriendo)
- Stabs sincopados
- Pitch bend en bass slides
- Vocal chop patterns
- Sidechain automático en pads
- Energetic hi-hats (32nd notes)
- Minimal hi-hats (8th notes)

---

## 🎯 FASES 86-100: Automatización y Polish

1. Volume por scene (fade ins/outs)
2. Filter sweeps en intros/builds
3. Reverb send automation
4. Delay throws en fin de frases
5. Pumping sidechain en bass
6. Pan automation para movimiento
7. Mix snapshots por energía
8. Clip gain staging automático
9. Tape saturation en master
10. Stereo widening
11. Glue compression en drum bus
12. Ducking de melody (para vocals)
13. Coherencia espectral validada

---

## 🚀 PLAN DE IMPLEMENTACIÓN

### Equipos de Agentes (20 agentes)

**Equipo A: Arquitectura Tracks (Agentes 1-3)**
- Agente 1: Fases 1-4 (Kick layers, Snare layers)
- Agente 2: Fases 5-7 (Percs, FX, Ambience)
- Agente 3: Fases 8-10 (Vocal Chop, Bass 2, Stabs)

**Equipo B: Sample Variation (Agentes 4-7)**
- Agente 4: Fases 11-15 (Kick rotation, Snare rotation, Drumloop rotation)
- Agente 5: Fases 16-20 (Perc rotation, FX rotation, No repeat rule, Energy pools)
- Agente 6: Fases 21-23 (SentimientoLatino2025 integration, Mood selector)
- Agente 7: Fases 24-25 (Crossfade, Coherence validation)

**Equipo C: Humanización (Agentes 8-10)**
- Agente 8: Fases 26-30 (Perfiles, Micro-timing, Velocity scaling)
- Agente 9: Fases 31-35 (Ghost notes, Groove templates, Fills)
- Agente 10: Fases 36-40 (Crescendo, Decrescendo, Live feel)

**Equipo D: Armónica (Agentes 11-13)**
- Agente 11: Fases 41-45 (16 progresiones, Tensión armónica, Asignación)
- Agente 12: Fases 46-50 (Suspensiones, Inversiones, 9nas/11nas)
- Agente 13: Fases 51-55 (Dominantes secundarias, Modal interchange)

**Equipo E: Estructura (Agentes 14-15)**
- Agente 14: Fases 56-65 (Scenes 0-9)
- Agente 15: Fases 66-70 (Scenes 10-12, Validación duración)

**Equipo F: MIDI Avanzado (Agentes 16-18)**
- Agente 16: Fases 71-75 (Bass styles, Contramelodías, Arpegios)
- Agente 17: Fases 76-80 (Fills, Rolls, Variation engine, Pads)
- Agente 18: Fases 81-85 (Stabs, Vocal chops, Sidechain, Hi-hats)

**Equipo G: Polish (Agentes 19-20)**
- Agente 19: Fases 86-93 (Automation volume, Filter, Reverb, Delay, Sidechain)
- Agente 20: Fases 94-100 (Mix snapshots, Gain staging, Saturation, Widening, Final validation)

---

## 📁 Archivos a Modificar

1. `AbletonMCP_AI/__init__.py` — Funciones principales
2. `AbletonMCP_AI/mcp_server/engines/pattern_library.py` — HumanFeel
3. `AbletonMCP_AI/mcp_server/server.py` — MCP tools
4. `AbletonMCP_AI/mcp_server/integration.py` — Coordination

---

## ✅ CRITERIOS DE ACEPTACIÓN

- [ ] 20 tracks creados automáticamente
- [ ] 13 scenes con energía definida
- [ ] 100+ samples diferentes cargados
- [ ] Ningún sample repetido en scenes consecutivas
- [ ] Humanización aplicada a todos los clips MIDI
- [ ] 8+ progresiones armónicas diferentes
- [ ] Duración ~4 minutos
- [ ] Listo para F9 (user ejecuta manualmente)

---

**Estado**: PLAN COMPLETO — Listo para implementación con 20 agentes

**Fecha de inicio**: 2026-04-13
**Desarrollador**: Kimi K2 + 20 Agentes Paralelos
**Reviewer**: Qwen
