MUSIC LIFE

Vive la música. Crea la tuya. Haz que el mundo la escuche.

Music Life es un simulador de vida y carrera musical con mundo online compartido: empiezas con 500 € y una guitarra de segunda mano en Albor, una ciudad mediterránea ficticia, y construyes la carrera (y la vida) que tú decidas. Combina acción directa (pasear, componer música real, conciertos jugables) con gestión profunda (dinero, banda, contratos, sello propio), y la música que crean los jugadores suena de verdad en el mundo de todos.

Este repositorio es la fuente única de verdad del proyecto: hoy contiene la documentación de diseño y producción; cuando empiece el desarrollo, contendrá también el código fuente.

Por dónde empezar

Si quieres…	Lee
Entender el juego en 10 minutos	Pitch v2 (descárgalo y ábrelo en el navegador) o Visión v2
Conocer el proceso de desarrollo que seguimos	Guía maestra
Ver cómo se aplica a Music Life	Guía aplicada
Saber por qué se decidió algo	Registro de decisiones
Ver qué se está haciendo y qué viene	Tablero
Ver el Kanban, el portal y cómo se trabaja con GitHub	Herramientas de producción
Proponer un cambio o una idea	CONTRIBUTING.md

Estructura

Los nombres de archivos y carpetas van siempre en inglés (el juego será multiidioma); el contenido de los documentos, en español.

music-life/
├── docs/                    Documentación de proceso, producción, negocio y legal
│   ├── concept/             Concepto: v2 vigente, v1 histórico y anexos, brief original
│   ├── master-guide/        Guía genérica de desarrollo de videojuegos (proceso, fases, puertas)
│   ├── applied-guide/       La guía maestra respondida para Music Life (A1–A26 y plan paso a paso)
│   ├── decisions/           Registro de decisiones (ADR): qué se decidió, cuándo y por qué
│   ├── vision/              One-pager y pilares (DIR)
│   ├── production/          Plan, equipo, riesgos, puertas y el tablero (board/) (PROD)
│   ├── business/            Mercado, presupuesto, business case, financiación (NEG)
│   ├── legal/               Política de IA, licencias, procedencia, términos (LEG)
│   ├── prototypes/          Un informe por prototipo P1–P8
│   └── playtests/           Planes, guiones e informes de investigación de usuarios (URS)
├── design/
│   ├── gdd/                 GDD y specs por sistema (DIR y diseñadores)
│   ├── economy/             Hojas, parámetros e informes de simulación (SIS)
│   ├── ux/                  Guía de UX, flujos, enlaces a Figma (UXD)
│   └── world/               Mapas y greyboxes de Albor (MUN)
├── narrative/               Biblia, fichas, storylets, diálogos, Crónica (NAR, GUI)
├── art/                     Biblia, concept, fuentes y exportaciones (ART)
├── audio/                   Biblia, instrumentos, canciones semilla, FMOD (SON, COM, SFX)
├── tech/                    TDD, formato .mlsong, budgets (TEC)
├── code/                    Código fuente (vacío hasta #021)
├── data/                    Contenido del juego en JSON y CSV con esquemas
├── loc/                     Cadenas, glosario, memoria de traducción (LOC)
├── qa/                      Plan de QA, casos de prueba, informes (QAT)
├── marketing/               Plan, textos de tienda, tráileres, kit de prensa (MKT)
├── ops/                     Manuales de incidencias, moderación, soporte, temporadas (TYS, BAK, ONL)
└── .github/                 Plantillas de issues (incluida la ficha de paso) y PR, propietarios de código

Es la estructura del apéndice F de la guía aplicada. Cada carpeta tiene un README.md con su contenido, su dueño y los pasos del plan que la llenan primero.

Estado actual

• Fase: F0 · Cierre del concepto, en curso (arranque anticipado respecto a diciembre de 2026, autorizado por Enrique). Sale con la puerta G0.
• Hecho: #001 (repositorio, tablero y plantilla de ficha), #002 (registro de decisiones D-01 a D-25) y #003 (equipo de F0–F1 y fichas de mandato), efectivos al fusionar sus PR.
• Bloqueado: #004 (forma jurídica, LEG): recomendación entregada en docs/legal/legal-entity-recommendation.md; espera a Enrique 👤 (revisión del abogado externo, decisión y alta).
• Siguiente: #005, #006, #008, #012, #013, #014, #015 y #016 están en Listo.
• Tablero: docs/production/board/.
• Concepto vigente: v2 (cinco modos VIVE / CREA / ACTÚA / GESTIONA / CONECTA, online asíncrono primero).

Cómo trabajamos (resumen)

1. Todo cambio entra por Pull Request contra main; nadie escribe directamente en main.
2. Las ideas y tareas se abren como issues con las plantillas (propuesta de diseño, tarea, decisión, error).
3. Las decisiones importantes se registran en docs/decisions/.
4. El avance del plan se sigue en el tablero: una tarjeta por paso; los cambios de estado también entran por PR.
5. Documentos en Markdown siempre que se pueda (se pueden revisar línea a línea); HTML solo para páginas visuales como el pitch.
6. Nombres de archivos, carpetas, rutas y ramas en inglés.

Detalles en CONTRIBUTING.md.

Confidencialidad

Repositorio privado. Su contenido (concepto, nombres, arte, planes de negocio) es confidencial: no lo compartas fuera del equipo sin permiso del propietario del proyecto.