MKClinico Design System — Contexto para LLM y agentes
Version: 2.0
Last updated: 2026-04-21

================================================================================
Rol del modelo de lenguaje en este Design System
================================================================================

Un LLM integrado al DS no solo “escribe texto”: actúa como motor de razonamiento
que acerca diseño y código, mantiene criterios comunes y reduce fricción cuando
el equipo escala. En MKClinico, ese trabajo se apoya en contexto versionado
(.md), CSS del sistema y reglas del repositorio — no en sustituir el juicio
humano en casos ambiguos o clínicos.

================================================================================
Qué aporta este paquete (mapeo a usos habituales DS + IA)
================================================================================

1) Documentación asistida
   - Los archivos mkclinico-ai-context*.md son la “guía máquina-legible”: tokens,
     clases, estados, layout y patrones. Sirven para generar o revisar textos de
     ayuda, checklists y ejemplos coherentes con la API pública del DS.
   - Los cambios de tokens/clases deben reflejarse en esos .md (ver política de
     actualización abajo); el modelo puede ayudar a propagar redacción, no
     reemplaza el proceso de revisión del equipo DS.

2) Generación y refactor de código
   - Con CSS + contexto, el modelo produce markup (HTML/JSX) alineado a clases y
     variables documentadas; en stacks distintos a la guía Next.js, copiar
     estructura y clases, no lógica interna de demos.
   - Patrones repetibles (layout de pantalla, tablas, modales, formularios) están
     descritos con snippets y tablas de props donde aplica.

3) Consultoría y gobernanza (“bot del sistema”)
   - Dudas del tipo “cuándo usar este patrón” se responden contrastando con el
     contexto .md y las reglas .mdc del repo (accesibilidad, botones, tablas,
     arquitectura).
   - Se puede pedir validación explícita: “¿este fragmento cumple el DS?” adjuntando
     código + lite o contexto completo.

4) Design tokens
   - El contexto completo documenta tokens CSS (--color-*, --radius-*, etc.),
     señales visuales → token y convenciones de nombres; favorece sustituir
     valores hardcodeados por variables del sistema en refactors.

================================================================================
Beneficios que buscamos con este enfoque
================================================================================

- Velocidad: menos ida y vuelta por clases inventadas o colores fuera de marca.
- Consistencia: misma fuente de verdad para humanos, IDEs y modelos.
- Accesibilidad: reglas y contexto remiten a patrones y tamaños mínimos de UI;
  auditorías finas siguen siendo responsabilidad del equipo.
- Escalabilidad: un índice corto (este archivo) + contexto profundo permite
  incorporar desarrolladores sin repetir cursos largos sobre cada componente.

================================================================================
Índice operativo — fuentes de verdad y precedencia
================================================================================

Este archivo es un índice y marco de uso; no reemplaza los contextos extensos.

Fuente de verdad y archivos vigentes
- Contexto completo DS: styles/mkclinico-ai-context.md
- Contexto corto / checklist: styles/mkclinico-ai-context-lite.md
- Contexto arquitectura del repo: CONTEXTO-PROYECTO-PARA-IA.md

Regla de precedencia
- Si hay conflicto entre documentos, manda styles/mkclinico-ai-context.md.

Reglas duras (resumen; detalle en .md y reglas .mdc)
- Usar solo clases y tokens del DS documentados.
- Color primario de marca: teal (--color-primario), no azul arbitrario.
- Botones con patrón completo: btn + variante + tamaño.
- Texto legible: no menor a 14px en UI exportable.
- Tablas: --tabla-cols debe calzar exactamente con las celdas por fila.
- En proyectos HTML/CSS externos: incluir mkclinico-ui.min.css.

Notas de uso para IA
- El CSS del CDN aplica estilos, pero no sustituye el contexto IA.
- Para generar código correcto: usar CSS + este índice + mkclinico-ai-context.md
  o la versión lite como primera pasada.
- Las rutas /demo-* son referencia de composición; no forzar lógica Next.js en
  otros stacks.

Política de actualización
- Lista obligatoria del repo (orden y alcance): .cursor/rules/actualizar-contexto-ia.mdc
  — incluye este llm.txt junto a los .md de contexto y las reglas .mdc cuando
  cambie la API pública del DS.
- Editar este archivo cuando cambien rutas o nombres de los enlaces de arriba,
  la regla de precedencia o el resumen de reglas duras deje de coincidir con el
  DS o con los .md de contexto.