Capas y sistemas anidados

Las capas

Cada ficha pertenece a una capa. Las capas van del criterio a lo más compuesto; una capa solo usa piezas de las anteriores. Los fundamentos van primero porque son el porqué; los tokens son ese criterio convertido en valores.

Capa	Qué contiene	Ejemplo
Fundamentos	Reglas de criterio: tipografía, color, maquetación, movimiento, voz, ilustración. Explican cómo y cuándo, y enlazan a sus tokens.	«Los titulares van en serif ligera»
Tokens	Valores con nombre y su rol. Se leen del código de producción.	--ink, --radius-lg, --dur-micro
Componentes	Piezas reutilizables. Se navegan por función (Acciones, Navegación, Formularios, Feedback, Contenido, Superposiciones) y llevan su nivel atómico como dato.	Botón, Enlace de texto, Cabecera
Patrones	Composiciones que resuelven un problema: secciones, pantallas y flujos.	Hero, Precios
Superficies	Las páginas reales de producción. Hoy viven en producción; el sistema las enlaza.	Landing, área de cliente

Función para navegar, nivel atómico para componer

Shopify, Vercel y la mayoría de sistemas de referencia listan los componentes por función, no por átomos, moléculas y organismos. Nosotros hacemos lo mismo en la interfaz. El nivel atómico (nivel: atomo | molecula | organismo) se mantiene en cada ficha como regla interna: un átomo no usa otros componentes, una molécula usa átomos y un organismo usa moléculas o átomos. Sirve para el método y para los agentes, no para buscar.

Las iniciativas no son una capa: agrupan trabajo en curso que atraviesa capas (ver Estados).

Sistemas anidados

Un sistema puede extender otro ("extiende" en system.json). El sistema hijo hereda la estructura, las reglas y los tokens del padre y solo redefine lo suyo.

base (metodología, shell, tokens neutros)
├── producto-a (marca, landing, área de cliente)
└── producto-b (marca, app)

Reglas de la herencia:

• Los tokens se redefinen por nombre. Un hijo no inventa un nombre nuevo para un rol que ya existe en el padre.
• Las fichas del padre aparecen en el hijo salvo que el hijo las sustituya con el mismo id.
• La metodología es común e interna: vive en docs/metodologia/, no se duplica por sistema y solo se muestra en los sistemas que la activan ("metodologia": true).

El sistema base y la resolución de herencia están pendientes (ver docs/TAREAS.md).

Tres niveles de token

Cuando un sistema crece, los tokens se separan en tres niveles:

1. Primitivos: la paleta y las escalas en bruto (--gray-900).
2. Semánticos: el rol (--ink, --paper). Es lo que usan los componentes.
3. De componente: ajustes locales (--btn-bg).

Empieza por los semánticos y añade los de componente cuando un componente los necesite. Los primitivos solo hacen falta cuando hay varias marcas o temas que comparten paleta.