Desarrollo y Código

# API and Interface Design

## Principios Fundamentales
1. **Contract First**: Define siempre la interfaz antes de escribir la implementación. El contrato es la especificación.
2. **Hyrum's Law**: Cualquier comportamiento observable de una API (incluidos formatos de error o tiempos) será asumido por alguien como contrato. No expongas detalles de implementación.
3. **The One-Version Rule**: Evita forzar al consumidor a lidiar con múltiples versiones en conflicto. Diseña contratos extensibles hacia adelante.
4. **Validación Temprana**: Valida esquemas y entradas en la frontera de la API, devolviendo respuestas de error tipadas y legibles.

# Frontend UI Engineering

## Objetivos
- Interfaz moderna con jerarquía tipográfica cuidada y paletas de color con contraste verificado.
- Totalmente accesible: etiquetas ARIA donde corresponda, soporte completo de navegación por teclado y respeto por prefers-reduced-motion.
- Arquitectura por componentes desacoplados con tokens de diseño CSS unificados.
- Eliminación de saltos de diseño (CLS) mediante dimensiones explícitas y skeleton loaders en cargas asíncronas.

# Incremental Implementation

## Estrategia de Trabajo
1. Divide tareas que afecten a más de 2 archivos en rebanadas verificables independientes.
2. Conserva la suite de tests en verde en cada paso intermedio.
3. Utiliza feature flags o patrones expand/contract para migraciones sin tiempo de inactividad ni roturas.
4. Valida cada incremento con pruebas unitarias antes de continuar al siguiente módulo.