Guía de adopción
Para incorporar Meridiano a un proyecto nuevo o a un equipo, en orden.
1. Lee lo mínimo
Sistema-Meridiano-v3.md§5 (arquitectura de tokens), §6 (principios) y la sección del medio que te toque (§18 te orienta).- Regla de oro innegociable: nunca referencies un primitivo; siempre la capa semántica.
2. Según tu medio
| Si vas a crear… | Usa | Ejemplo de referencia |
|---|---|---|
| Documento o informe Word | plantillas/Meridiano.dotx |
ejemplos…/01-informe-ejecutivo-docx |
| Presentación | plantillas/Meridiano.potx |
ejemplos…/03-presentacion-pptx |
| Hoja de cálculo | plantillas/Meridiano.xltx |
ejemplos…/04 y 05 |
| Web o app React | meridiano-tokens.css + preset Tailwind (ejemplos…/10) |
ejemplos…/06 a 09 |
| App iOS / Android / Flutter | ejemplos…/10-plantilla-tokens-codigo/salidas/ |
— |
| Diseño en Figma | Variables del archivo "Sistema Meridiano — Tokens" | ejemplos…/10/GUIA-FIGMA.md |
3. Lista de verificación antes de entregar
- [ ] Solo tokens semánticos (ningún hex suelto, ningún primitivo directo)
- [ ] Un solo botón/acción primaria por vista; verbos en los botones
- [ ] Estados completos en lo interactivo (reposo/hover/activo/foco/deshabilitado/error)
- [ ] Contraste: WCAG 2.2 AA como piso; valida con
herramientas/medir_apca.pysi tocaste color - [ ] Teclado: todo alcanzable, foco visible, Escape cierra capas
- [ ] Modo oscuro revisado (mejor aún: diseñado primero, §16)
- [ ] Texto en español correcto: tildes, eñes, tipo oración
- [ ] Documentos con Tabla de Contenido y control de cambios
4. Gobernanza
- Cambios a tokens: editar
tokens.json, regenerar derivados (herramientas/generar_tokens_plataformas.py), medir APCA, actualizar el control de cambios del documento maestro y versionar (SemVer). - Cambios a componentes o patrones: proponerlos contra §8/§9 del documento maestro; si contradicen un anti-patrón (§19), se rechazan por defecto.
- Toda nueva pieza ejemplar debe vivir en
ejemplos-de-uso-y-aplicacion/con su README.
Control de cambios
| Versión | Fecha | Autor | Descripción del cambio |
|---|---|---|---|
| 1.0 | 2026-06-12 | Andrés García | Versión inicial de la guía |