# Professional Workflow Guide - AbletonMCP_AI

> **Versión:** 3.0 Senior Architecture  
> **Fecha:** 2026-04-12  
> **Total Tools:** 114+ herramientas profesionales

---

## Índice

1. [Flujo Completo Paso a Paso](#flujo-completo-paso-a-paso)
2. [Fase 1: Setup y Preparación](#fase-1-setup-y-preparación)
3. [Fase 2: Producción Musical](#fase-2-producción-musical)
4. [Fase 3: Efectos y Automation](#fase-3-efectos-y-automation)
5. [Fase 4: Mezcla Profesional](#fase-4-mezcla-profesional)
6. [Fase 5: Mastering y Export](#fase-5-mastering-y-export)
7. [Troubleshooting Guide](#troubleshooting-guide)

---

## Flujo Completo Paso a Paso

### Diagrama de Flujo

```
┌─────────────────────────────────────────────────────────────────────┐
│                    PROFESSIONAL WORKFLOW                             │
├─────────────────────────────────────────────────────────────────────┤
│                                                                      │
│  ┌──────────┐    ┌──────────┐    ┌──────────┐    ┌──────────┐    │
│  │  SETUP   │───▶│ PRODUCCIÓN│───▶│   FX     │───▶│  MIXING  │    │
│  │          │    │          │    │ AUTOMATION│    │          │    │
│  └──────────┘    └──────────┘    └──────────┘    └──────────┘    │
│       │                                               │           │
│       ▼                                               ▼           │
│  ┌──────────┐                                    ┌──────────┐    │
│  │ CHECKPOINT│                                   │ MASTERING │    │
│  └──────────┘                                    └──────────┘    │
│                                                       │           │
│                                                       ▼           │
│                                                  ┌──────────┐    │
│                                                  │  EXPORT  │    │
│                                                  └──────────┘    │
│                                                                      │
└─────────────────────────────────────────────────────────────────────┘
```

---

## Fase 1: Setup y Preparación

### Paso 1.1: Health Check Obligatorio

```python
# SIEMPRE ejecutar primero - verifica conectividad con Ableton
ableton-live-mcp_health_check

# Resultado esperado:
# {
#   "status": "healthy",
#   "score": 5/5,
#   "checks": {
#     "tcp_server": "✓ OK",
#     "song_access": "✓ OK", 
#     "tracks_access": "✓ OK",
#     "browser_access": "✓ OK",
#     "update_loop": "✓ OK"
#   }
# }
```

### Paso 1.2: Configuración del Proyecto

```python
# Configurar BPM y tonalidad
ableton-live-mcp_set_tempo --tempo 95
ableton-live-mcp_set_time_signature --numerator 4 --denominator 4

# Opcional: análisis de librería si es primera vez
ableton-live-mcp_analyze_library
ableton-live-mcp_get_library_stats
```

### Paso 1.3: Crear Estructura de Tracks

```python
# Tracks de Audio (Drums)
ableton-live-mcp_create_audio_track  # Track 2: Kick
ableton-live-mcp_create_audio_track  # Track 3: Snare
ableton-live-mcp_create_audio_track  # Track 4: HiHat
ableton-live-mcp_create_audio_track  # Track 5: Percussion

# Tracks MIDI (Bass, Melody, Chords)
ableton-live-mcp_create_midi_track   # Track 6: Bass
ableton-live-mcp_create_midi_track   # Track 7: Chords
ableton-live-mcp_create_midi_track   # Track 8: Melody

# Tracks FX
ableton-live-mcp_create_audio_track  # Track 9: FX/Risers
ableton-live-mcp_create_audio_track  # Track 10: Atmosphere

# Nombrar tracks
ableton-live-mcp_set_track_name --track_index 2 --name "Kick"
ableton-live-mcp_set_track_name --track_index 3 --name "Snare"
ableton-live-mcp_set_track_name --track_index 4 --name "HiHat"
ableton-live-mcp_set_track_name --track_index 5 --name "Percussion"
ableton-live-mcp_set_track_name --track_index 6 --name "Bass"
ableton-live-mcp_set_track_name --track_index 7 --name "Chords"
ableton-live-mcp_set_track_name --track_index 8 --name "Melody"
```

### Paso 1.4: Guardar Checkpoint

```python
# Guardar estado inicial
ableton-live-mcp_save_checkpoint --name "setup_inicial"
```

---

## Fase 2: Producción Musical

### 2.1: Cargar Samples de Librería

```python
# Escanear librería para ver samples disponibles
ableton-live-mcp_scan_library --subfolder reggaeton/kick
ableton-live-mcp_scan_library --subfolder reggaeton/snare

# Cargar samples directamente a tracks
ableton-live-mcp_load_sample_direct \
    --track_index 2 \
    --file_path "libreria/reggaeton/kick/kick 1.wav" \
    --slot_index 0

ableton-live-mcp_load_sample_direct \
    --track_index 3 \
    --file_path "libreria/reggaeton/snare/snare 1.wav" \
    --slot_index 0

ableton-live-mcp_load_sample_direct \
    --track_index 4 \
    --file_path "libreria/reggaeton/hi-hat/hihat 1.wav" \
    --slot_index 0
```

### 2.2: Crear Patrones en Arrangement View

```python
# KICK - Pattern básico (cada compás)
ableton-live-mcp_create_arrangement_audio_pattern \
    --track_index 2 \
    --file_path "C:\\...\\libreria\\reggaeton\\kick\\kick 1.wav" \
    --positions [0, 4, 8, 12, 16, 20, 24, 28, 32, 36, 40, 44, 48, 52, 56, 60] \
    --name "KickPattern"

# SNARE - En beats 2 y 4 (compases 2, 4, 6, 8...)
ableton-live-mcp_create_arrangement_audio_pattern \
    --track_index 3 \
    --file_path "C:\\...\\libreria\\reggaeton\\snare\\snare 1.wav" \
    --positions [2, 6, 10, 14, 18, 22, 26, 30, 34, 38, 42, 46, 50, 54, 58, 62] \
    --name "SnarePattern"

# HIHAT - Cada medio compás
ableton-live-mcp_create_arrangement_audio_pattern \
    --track_index 4 \
    --file_path "C:\\...\\libreria\\reggaeton\\hi-hat\\hihat 1.wav" \
    --positions [1, 3, 5, 7, 9, 11, 13, 15, 17, 19, 21, 23, 25, 27, 29, 31, 33, 35, 37, 39, 41, 43, 45, 47, 49, 51, 53, 55, 57, 59, 61, 63] \
    --name "HiHatPattern"
```

### 2.3: Generar MIDI (Bass, Chords, Melody)

```python
# Bass line - 16 compases
ableton-live-mcp_generate_bass_clip \
    --track_index 6 \
    --bars 16 \
    --root_notes [36, 36, 41, 41, 43, 43, 36, 36] \
    --style melodic

# Chords - Progresión i-v-vi-iv en Am
ableton-live-mcp_generate_chords_clip \
    --track_index 7 \
    --bars 16 \
    --progression i-v-vi-iv \
    --key Am

# Melody
ableton-live-mcp_generate_melody_clip \
    --track_index 8 \
    --bars 16 \
    --scale minor \
    --density medium
```

### 2.4: Humanización (Feel Natural)

```python
# Aplicar humanización a tracks MIDI
ableton-live-mcp_apply_human_feel --track_index 6 --intensity 0.3
ableton-live-mcp_apply_human_feel --track_index 7 --intensity 0.2
ableton-live-mcp_apply_human_feel --track_index 8 --intensity 0.4
```

### 2.5: Verificación

```python
# Verificar clips creados
ableton-live-mcp_get_arrangement_status
ableton-live-mcp_get_arrangement_clips

# Iniciar reproducción para escuchar
ableton-live-mcp_start_playback
```

---

## Fase 3: Efectos y Automation

### 3.1: Crear Estructura de Secciones

```python
# Generar secciones musicales completas
# Intro: 8 compases
ableton-live-mcp_create_section_at_bar \
    --track_index 2 \
    --section_type intro \
    --at_bar 0 \
    --duration_bars 8

# Verse: 16 compases  
ableton-live-mcp_create_section_at_bar \
    --track_index 6 \
    --section_type verse \
    --at_bar 8 \
    --duration_bars 16

# Chorus: 8 compases
ableton-live-mcp_create_section_at_bar \
    --track_index 7 \
    --section_type chorus \
    --at_bar 24 \
    --duration_bars 8

# Outro: 8 compases
ableton-live-mcp_create_section_at_bar \
    --track_index 2 \
    --section_type outro \
    --at_bar 32 \
    --duration_bars 8
```

### 3.2: FX y Transiciones

```python
# Riser antes del chorus (compás 20-24)
ableton-live-mcp_create_riser \
    --track_index 9 \
    --start_bar 20 \
    --duration 4 \
    --intensity 0.8

# Impact en el chorus (compás 24)
ableton-live-mcp_create_impact \
    --track_index 9 \
    --position 24 \
    --intensity 1.0 \
    --impact_type sub_drop

# Downlifter después del chorus (compás 32)
ableton-live-mcp_create_downlifter \
    --track_index 9 \
    --start_bar 32 \
    --duration 4 \
    --intensity 0.7

# Break/Silence para tensión
ableton-live-mcp_create_silence \
    --track_index 2 \
    --start_bar 15 \
    --duration 1
```

### 3.3: Automation Profesional

```python
# Filter sweep en el chorus (build up)
ableton-live-mcp_automate_filter \
    --track_index 7 \
    --start_bar 20 \
    --end_bar 24 \
    --start_freq 200 \
    --end_freq 20000

# Volume automation fade in
# Nota: Usar set_track_volume en diferentes puntos
ableton-live-mcp_set_track_volume --track_index 8 --volume 0.0  # Mute al inicio
ableton-live-mcp_set_track_volume --track_index 8 --volume 0.7  # Aumentar en chorus
```

### 3.4: Variaciones y Fills

```python
# Añadir fills de percusión
ableton-live-mcp_add_percussion_fills \
    --track_index 5 \
    --positions [7, 15, 23, 31]

# Crear variación de loop para chorus
ableton-live-mcp_variate_loop \
    --track_index 2 \
    --intensity 0.5

# Call and response en melodía
ableton-live-mcp_add_call_and_response \
    --phrase_track 8 \
    --response_length 2
```

---

## Fase 4: Mezcla Profesional

### 4.1: Configurar Buses y Routing

```python
# Crear bus de drums
ableton-live-mcp_create_bus_track --bus_type Drums

# Rutear tracks de drums al bus
ableton-live-mcp_route_track_to_bus \
    --track_index 2 \
    --bus_name "Drums"

ableton-live-mcp_route_track_to_bus \
    --track_index 3 \
    --bus_name "Drums"

ableton-live-mcp_route_track_to_bus \
    --track_index 4 \
    --bus_name "Drums"

# Crear pistas de retorno (returns)
ableton-live-mcp_create_return_track --effect_type Reverb
ableton-live-mcp_create_return_track --effect_type Delay
```

### 4.2: Configurar Envíos (Sends)

```python
# Enviar melodía a reverb
ableton-live-mcp_set_track_send \
    --track_index 8 \
    --return_index 0 \
    --amount 0.3

# Enviar chords a delay
ableton-live-mcp_set_track_send \
    --track_index 7 \
    --return_index 1 \
    --amount 0.2
```

### 4.3: EQ y Compresión

```python
# EQ en kick (limpiar frecuencias bajas)
ableton-live-mcp_configure_eq \
    --track_index 2 \
    --preset kick

# EQ en bass
ableton-live-mcp_configure_eq \
    --track_index 6 \
    --preset bass

# Compresión en drums
ableton-live-mcp_configure_compressor \
    --track_index 2 \
    --preset drums \
    --threshold -20 \
    --ratio 4

# Sidechain: Kick ducking Bass
ableton-live-mcp_setup_sidechain \
    --source_track 2 \
    --target_track 6 \
    --amount 0.7
```

### 4.4: Balance de Niveles

```python
# Auto gain staging
ableton-live-mcp_auto_gain_staging

# Ajustes manuales finos
ableton-live-mcp_set_track_volume --track_index 2 --volume 0.85  # Kick
ableton-live-mcp_set_track_volume --track_index 3 --volume 0.75  # Snare
ableton-live-mcp_set_track_volume --track_index 4 --volume 0.60  # HiHat
ableton-live-mcp_set_track_volume --track_index 6 --volume 0.80  # Bass
ableton-live-mcp_set_track_volume --track_index 7 --volume 0.70  # Chords
ableton-live-mcp_set_track_volume --track_index 8 --volume 0.75  # Melody

# Panoramización
ableton-live-mcp_set_track_pan --track_index 7 --pan -0.2  # Chords ligeramente izquierda
ableton-live-mcp_set_track_pan --track_index 8 --pan 0.2   # Melody ligeramente derecha
```

---

## Fase 5: Mastering y Export

### 5.1: Master Chain

```python
# Aplicar cadena de mastering al master
ableton-live-mcp_apply_master_chain --preset standard

# Ajustar volumen master
ableton-live-mcp_set_master_volume --volume 0.9
```

### 5.2: Quality Check

```python
# Verificación completa de calidad
ableton-live-mcp_full_quality_check

# Detectar y balancear energía entre secciones
ableton-live-mcp_detect_energy_curve
ableton-live-mcp_balance_sections

# Arreglar problemas detectados automáticamente
ableton-live-mcp_fix_quality_issues
```

### 5.3: Validación Final

```python
# Validar consistencia del proyecto
ableton-live-mcp_validate_project

# Sugerencias de mejora
ableton-live-mcp_suggest_improvements

# Resumen del proyecto
ableton-live-mcp_get_project_summary
ableton-live-mcp_get_production_report
```

### 5.4: Export

```python
# Exportar mix completo masterizado
ableton-live-mcp_export_project \
    --path "C:\\Users\\Usuario\\Music\\MiTrack_Master.wav" \
    --format wav

# Renderizar stems individuales para mezcla externa
ableton-live-mcp_render_stems \
    --output_dir "C:\\Users\\Usuario\\Music\\Stems"

# Versión instrumental (sin voz)
ableton-live-mcp_render_instrumental \
    --output_path "C:\\Users\\Usuario\\Music\\MiTrack_Instrumental.wav"

# Radio Edit (versión corta)
ableton-live-mcp_create_radio_edit \
    --output_path "C:\\Users\\Usuario\\Music\\MiTrack_Radio.wav"

# DJ Edit (extended intro/outro)
ableton-live-mcp_create_dj_edit \
    --output_path "C:\\Users\\Usuario\\Music\\MiTrack_DJ.wav"
```

### 5.5: Guardar y Backup

```python
# Guardar preset del proyecto para reusar
ableton-live-mcp_save_as_preset \
    --name "MiTemplateReggaeton" \
    --description "Template completo con drums, bass, chords, melody"

# Duplicar proyecto
ableton-live-mcp_duplicate_project --new_name "MiTrack_v2"

# Guardar checkpoint final
ableton-live-mcp_save_checkpoint --name "produccion_completa"
```

---

## Troubleshooting Guide

### Problemas de Conexión

| Problema | Causa | Solución |
|----------|-------|----------|
| `score: 0/5` | Ableton no cargó script | Reiniciar Ableton, verificar `__init__.py` |
| `tcp_server: FAIL` | Puerto 9877 ocupado | Matar proceso: `taskkill /F /IM "Ableton Live 12 Suite.exe"` |
| `song_access: FAIL` | No hay proyecto abierto | Crear nuevo proyecto o abrir existente |

### Problemas de Producción

| Problema | Causa | Solución |
|----------|-------|----------|
| `created_count: 0` | Ningún método de inyección funcionó | Verificar: archivo existe, track es audio, formato soportado |
| Clips muy cortos | One-shots sin duración | Usar samples WAV de duración completa |
| Posiciones incorrectas | Usando Método 5 (recording) | Normal, ±1 beat tolerancia. Reiniciar para Métodos 1-3 |
| No hay sonido | Tracks muteados o volumen 0 | Verificar `set_track_volume` y `set_track_mute` |

### Problemas de Samples

| Problema | Causa | Solución |
|----------|-------|----------|
| Sample no carga | Ruta incorrecta | Usar rutas absolutas con doble backslash `\\` |
| Sample no suena | No warping | Añadir `--warp true` al cargar |
| Librería vacía | No escaneada | Ejecutar `analyze_library` primero |

### Problemas de Mezcla

| Problema | Causa | Solución |
|----------|-------|----------|
| Distorsión | Volumen master > 1.0 | Reducir `set_master_volume` a 0.9 o menos |
| Falta claridad | Frecuencias solapadas | Aplicar EQ en cada track |
| Kick no corta | Sin sidechain | Configurar `setup_sidechain` kick→bass |
| Reverb excesiva | Send muy alto | Reducir `set_track_send --amount` a 0.3 o menos |

### Problemas de Performance

| Problema | Causa | Solución |
|----------|-------|----------|
| Ableton lento | Demasiados plugins | Congelar tracks o renderizar a audio |
| CPU alta | Procesamiento paralelo | Desactivar: `enable_parallel_processing --enabled false` |
| Memoria baja | Samples no optimizados | Usar `get_memory_usage` y limpiar |

### Errores Comunes y Soluciones

```python
# ERROR: "Track index out of range"
# SOLUCIÓN: Verificar tracks existentes primero
ableton-live-mcp_get_tracks

# ERROR: "Sample not found"  
# SOLUCIÓN: Verificar ruta y escanear librería
ableton-live-mcp_scan_library --subfolder reggaeton/kick

# ERROR: "No clips in arrangement"
# SOLUCIÓN: Crear clips antes de verificar
ableton-live-mcp_create_arrangement_audio_pattern --track_index 2 ...

# ERROR: "Export failed"
# SOLUCIÓN: Verificar directorio existe y permisos de escritura
```

### Comandos de Recuperación

```python
# Deshacer última acción
ableton-live-mcp_undo

# Rehacer acción deshecha  
ableton-live-mcp_redo

# Guardar checkpoint antes de operaciones riesgosas
ableton-live-mcp_save_checkpoint --name "antes_de_cambios"

# Reinicio completo del sistema (si todo falla)
# 1. Cerrar Ableton
# 2. Eliminar archivos de recovery
# 3. Reiniciar Ableton
# 4. Ejecutar health_check
```

---

## Ejemplos Rápidos

### Beat Completo en 5 Líneas

```python
# Setup
ableton-live-mcp_health_check
ableton-live-mcp_set_tempo --tempo 95

# Producción completa automática
ableton-live-mcp_generate_complete_reggaeton \
    --bpm 95 \
    --key Am \
    --style perreo \
    --structure full \
    --use_samples true

# Master y export
ableton-live-mcp_apply_master_chain --preset standard
ableton-live-mcp_export_project --path "beat.wav"
```

### Producir desde Referencia

```python
# Usar archivo de audio como referencia de estilo
ableton-live-mcp_produce_from_reference \
    --audio_path "C:\\referencia.mp3"

# O usando la nueva API:
ableton-live-mcp_generate_from_reference \
    --reference_audio_path "C:\\referencia.mp3"
```

### Workflow Timeline Directo

```python
# Crear canción completa en Arrangement View directamente
ableton-live-mcp_build_arrangement_timeline \
    --sections_json '[
        {"name": "Intro", "start_bar": 0, "duration_bars": 8, "tracks": [{"type": "drums", "variation": "minimal"}]},
        {"name": "Verse", "start_bar": 8, "duration_bars": 16, "tracks": [{"type": "drums", "variation": "full"}, {"type": "bass", "variation": "standard"}]},
        {"name": "Chorus", "start_bar": 24, "duration_bars": 8, "tracks": [{"type": "drums", "variation": "full"}, {"type": "bass", "variation": "melodic"}, {"type": "chords", "variation": "i-v-vi-iv"}, {"type": "melody", "variation": "lead"}]}
    ]' \
    --genre reggaeton \
    --tempo 95 \
    --key Am \
    --style standard
```

---

## Referencia Rápida de Comandos

| Fase | Comando | Descripción |
|------|---------|-------------|
| Setup | `health_check` | Verificar sistema |
| Setup | `set_tempo` | Configurar BPM |
| Setup | `create_audio_track` | Crear track de audio |
| Setup | `create_midi_track` | Crear track MIDI |
| Producción | `create_arrangement_audio_pattern` | Inyectar audio en Arrangement |
| Producción | `generate_bass_clip` | Generar línea de bajo |
| Producción | `generate_chords_clip` | Generar progresión de acordes |
| Producción | `generate_melody_clip` | Generar melodía |
| FX | `create_riser` | Crear riser/buildup |
| FX | `create_impact` | Crear impact/drop |
| FX | `automate_filter` | Automatizar filtro |
| Mixing | `create_bus_track` | Crear bus de mezcla |
| Mixing | `setup_sidechain` | Configurar sidechain |
| Mixing | `configure_eq` | Aplicar EQ |
| Mixing | `configure_compressor` | Aplicar compresión |
| Mixing | `auto_gain_staging` | Auto-balance de niveles |
| Master | `apply_master_chain` | Cadena de mastering |
| Export | `export_project` | Exportar a audio |
| Export | `render_stems` | Renderizar stems |

---

## Historial

- **v3.0** (2026-04-12): Documentación completa del Professional Workflow
- **Autor:** AbletonMCP_AI Senior Architecture Team

## Relacionado

- `API_REFERENCE_PRO.md` - Documentación completa de todas las tools
- `skill_produccion_audio.md` - Skill de producción detallada
- `skill_reinicio_ableton.md` - Proceso de reinicio
