Skip to content

🚀 QUICKSTART - 05_01_HIERARCHY_FRAMEWORK

📖 COMIENZA AQUÍ

1️⃣ Lee primero (en orden)

  1. README.md (5 min)
  2. Visión general del sistema
  3. Qué hace y por qué es crítico

  4. Métricas clave

  5. ESTRUCTURA.md (10 min)

  6. Árbol completo de carpetas
  7. Qué va en cada una

  8. Cronograma de fases

  9. PLAN_DE_DESARROLLO.md (30 min)

  10. Plan detallado de 12 tareas
  11. Especificaciones técnicas
  12. Entregables por tarea

🎯 DECISIÓN RÁPIDA: ¿Qué documento necesito?

Si eres DESARROLLADOR:

Quiero entender qué nivel es mi módulo: → Ir a 05_01_00_level_definitions/ (cuando esté implementado) → Leer LEVEL_SEMANTICS.md

Quiero saber qué reglas debo seguir: → Ir a 05_01_01_composition_rules/ (cuando esté implementado) → Leer RULE_CATALOG.md

Quiero usar un pattern aprobado: → Ir a 05_01_03_pattern_library/ (cuando esté implementado) → Leer PATTERN_LIBRARY.md

Quiero evitar errores comunes: → Ir a 05_01_04_anti_patterns/ (cuando esté implementado) → Leer ANTIPATTERN_CATALOG.md

Si eres ARQUITECTO:

Quiero ver el pipeline completo: → Leer 05_01_02_validation_engine/VALIDATION_PIPELINE.md (cuando esté)

Quiero configurar enforcement: → Leer 05_01_06_enforcement_system/ENFORCEMENT_LEVELS.md (cuando esté)

Quiero revisar métricas: → Leer 05_01_08_metrics_collector/METRICS_CATALOG.md (cuando esté)

Quiero aprobar excepciones: → Leer 05_01_07_exemption_system/EXEMPTION_PROCESS.md (cuando esté)

Si eres PROJECT MANAGER:

Quiero ver el cronograma: → Leer sección "CRONOGRAMA RESUMIDO" en PLAN_DE_DESARROLLO.md

Quiero ver criterios de éxito: → Leer sección "CRITERIOS DE ÉXITO" en PLAN_DE_DESARROLLO.md

Quiero ver riesgos: → Leer sección "RIESGOS Y MITIGACIONES" en PLAN_DE_DESARROLLO.md

🛠️ DESARROLLO: ¿Por dónde empiezo?

PASO 1: Entender la jerarquía

L0_KERNEL → L1_ATOM → L2_CELL → L3_ENGINE

Regla de oro: Un nivel solo puede depender de niveles inferiores

PASO 2: Comenzar por Fase 1

cd 05_01_00_level_definitions/
# Implementar:
# - Enums de niveles
# - Matriz de dependencias
# - Parser de metadata

PASO 3: Seguir orden de tareas

TAREA 1 (00) → TAREA 2 (01) → TAREA 3 (02) → TAREA 4 (04)
     ↓              ↓              ↓              ↓
TAREA 5 (03) → TAREA 6 (05) → TAREA 7 (06) → TAREA 8 (07)
     ↓              ↓              ↓              ↓
TAREA 9 (08) → FINAL-A → FINAL-B → FINAL-C

⚡ COMANDOS ÚTILES (cuando estén implementados)

# Crear nuevo módulo validado
audiolab-new-module --name MyFilter --level L1_ATOM

# Validar módulo
audiolab-validate --module MyFilter

# Ver patterns disponibles
audiolab-patterns --category L1→L2

# Solicitar exemption
audiolab-exemption request --module MyModule --reason "..."

# Dashboard de métricas
audiolab-metrics dashboard

# Detectar anti-patterns
audiolab-scan --anti-patterns

📊 MATRIZ DE DEPENDENCIAS (referencia rápida)

           L0    L1    L2    L3
L0_KERNEL  ❌    ❌    ❌    ❌
L1_ATOM    ✅    ❌    ❌    ❌
L2_CELL    ✅    ✅    ✅*   ❌
L3_ENGINE  ✅    ✅    ✅    ❌

* = permitido sin ciclos

Lectura: Fila "puede depender de" Columna

✅ CHECKLIST DE INICIO

Para empezar a desarrollar:

  • Leí README.md completo
  • Entendí la jerarquía L0→L1→L2→L3
  • Revisé la matriz de dependencias
  • Leí PLAN_DE_DESARROLLO.md (al menos Tareas 1-3)
  • Entiendo el orden de implementación
  • Tengo el entorno de desarrollo listo

Para contribuir:

  • Elegí una tarea del plan
  • Leí las especificaciones técnicas
  • Entiendo los entregables esperados
  • Tengo las dependencias necesarias
  • Sé qué tests debo escribir

🆘 FAQ RÁPIDO

P: ¿Qué es L0, L1, L2, L3? R: Niveles de jerarquía. L0 = primitivas, L1 = componentes, L2 = sistemas, L3 = motores completos.

P: ¿Por qué no puedo hacer L1 depender de L1? R: Para evitar acoplamiento horizontal. L1 atoms deben ser independientes y solo usar kernels L0.

P: ¿Qué pasa si necesito violar una regla? R: Usa el Exemption System (TAREA 8) con justificación formal y aprobación de arquitecto.

P: ¿Cómo sé si mi módulo es L1 o L2? R: Si es stateful pero simple → L1. Si combina múltiples L1 → L2.

P: ¿Cuándo se valida la jerarquía? R: En 4 niveles: IDE (tiempo real) → Compile → Link → CI/CD.

P: ¿Cuánto tiempo toma implementar todo esto? R: ~28 semanas (7 meses) según cronograma del plan.

Documento Propósito Tiempo lectura
README.md Visión general 5 min
ESTRUCTURA.md Árbol de carpetas 10 min
PLAN_DE_DESARROLLO.md Plan técnico completo 30 min
Este archivo Guía de inicio rápido 5 min

📞 SOPORTE

Status Actual: 🚧 En Planificación Carpetas Creadas: 12/12 ✅ Documentación: Completa ✅ Código: Por implementar

¡Listo para empezar! Comienza por README.md →