aura-dna

🧬 El ADN de Aura — Filosofías Centrales de Fluxo AI

Reglas inmutables que definen cómo se siente el producto y cómo se construye el código. No son sugerencias: son el ADN. Aplícalas sin esperar a que te lo pidan.

🧠 Producto y UX (cómo se siente Aura)

1. Libertad por Defecto — "Freedom First" (Excel Killer)

• La IA sugiere, nunca impone. El usuario tiene siempre la autoridad final; actúas como facilitador/conserje, jamás como un dictador que bloquea acciones.
• Brújula, no jaula. Nada de "hard caps" que impidan registrar la realidad. Si el usuario excede el presupuesto, muéstralo visualmente — nunca bloquees la transacción. El Ledger (libro mayor) es la verdad absoluta.

2. Fricción Cero — Regla de los "< 2 clics"

• Toda acción clave (registrar un gasto, completar un hábito, ajustar un presupuesto) debe lograrse en menos de 2 clics.
• Visual Cues primero. El cerebro lee posición y color antes que texto: prioriza tarjetas flotantes, edición en línea (inline edit) y botones contextuales. Evita modales burocráticos y formularios pesados.

3. Hábitos Atómicos — "Atomic Habits"

• Accesible, no obligatorio. El progreso es progreso mientras apunte al objetivo. Premia la consistencia y la creación de riqueza; nunca castigues las caídas.
• Dopamina retroactiva (gamificación positiva). Recompensa el esfuerzo real (niveles, rachas, ahorro visualizado) de forma orgánica y anclada 100 % en datos reales — jamás números inventados.

4. Revelación Progresiva — "Progressive Disclosure"

• No abrumes. Las acciones destructivas y la configuración avanzada se esconden tras zonas de toque secundarias.
• El estado de reposo (resting state) de la interfaz es siempre minimalista, limpio y libre de ruido visual.

🏗️ Ingeniería y Arquitectura (leyes inmutables)

1. Proteger el Estado Dorado — "Protect the Golden State"

• El último despliegue funcional de la rama principal es sagrado: no se compromete con hacks rápidos.
• Todo cambio debe ser atómico, reversible y acotado al problema. No refactorices código que ya funciona (Conservation of Code).

2. Air Gap — Separación de Responsabilidades

• El frontend es "Dumb UI": se limita a renderizar el estado.
• Toda lógica de negocio, matemática, cálculos o mutaciones de datos vive exclusivamente en la capa de dominio (servicios, hooks dedicados, Cloud Functions).

3. Cero Duplicación — Ingeniería Pragmática

• No dupliques herramientas. Si ya existe un componente/servicio que cumple la función, reutilízalo. Nunca clones código para un flujo nuevo.
• Eficiencia radical. Prohibido añadir librerías pesadas (WYSIWYG, gráficos extra) si las APIs nativas del navegador, CSS o Tailwind ya bastan.

4. Cohesión Sistémica — "Systemic Cohesion"

• Contratos estrictos + Ubiquitous Language. Frontend y backend hablan el mismo idioma (esquemas TypeScript rígidos). Eleva términos genéricos a conceptos de negocio claros ("The Vault", "Wealth Engines").
• Diseño tokenizado. Todo color, sombra, borde o radio deriva de variables CSS semánticas (bg-card, shadow-neo) — la app debe ser agnóstica al tema.

✅ Auto-chequeo obligatorio (ANTES de escribir código)

Antes de escribir o refactorizar cualquier línea de código, valida mentalmente que tu solución respeta este ADN:

• ¿Libera o restringe? ¿Sugiero sin bloquear al usuario?
• ¿< 2 clics? ¿El flujo es de fricción mínima y visual?
• ¿Premia sin castigar? ¿La gamificación se ancla en datos reales?
• ¿Revelación progresiva? ¿El estado de reposo queda limpio?
• ¿Protejo el Estado Dorado? ¿El cambio es atómico, reversible y acotado?
• ¿Respeto el Air Gap? ¿La lógica vive en el dominio, no en la UI?
• ¿Cero duplicación? ¿Reutilizo en vez de clonar? ¿Evito librerías pesadas?
• ¿Cohesión sistémica? ¿Contratos TS rígidos y design tokens semánticos?

Si una sola casilla falla, rediseña antes de escribir. El ADN no se negocia.