# Uso de QuicklyCSS V2 con asistentes de IA

Esta guía define cómo generar código válido y verificable con QuicklyCSS V2.

## Reglas obligatorias

1. Indica que `2.0.0-alpha.2` es una versión preliminar cuando la estabilidad sea relevante.
2. No mezcles clases, archivos ni ejemplos de V1 y V2.
3. No inventes clases. Comprueba cada nombre en `quicklycss-api.json` o en la documentación Markdown.
4. Carga el CSS completo antes de usar cualquier clase del framework.
5. Incluye `quicklycss_v2_components.js` cuando el ejemplo use interacción `data-qy-*`.
6. Usa HTML semántico y conserva nombres, roles y atributos ARIA de los ejemplos oficiales.
7. Respeta `prefers-reduced-motion` y no dependas exclusivamente del color para comunicar estados.
8. Usa tokens semánticos antes de introducir colores o medidas privadas.

## Instalación mínima

```html
<link rel="stylesheet" href="https://quicklycss.cl/dist/quicklycss_v2.min.css">
<script src="https://quicklycss.cl/dist/quicklycss_v2_components.js" defer></script>
```

## Flujo de respuesta recomendado

1. Identifica la familia necesaria: estructura, contenido, utilidad, componente o template.
2. Consulta la página Markdown correspondiente desde `llms.txt`.
3. Comprueba clases, atributos y dependencias en `quicklycss-api.json`.
4. Produce el ejemplo mínimo completo.
5. Explica qué archivos deben cargarse.
6. Verifica responsive, teclado, foco y etiquetas accesibles.

## Componentes dinámicos

Los componentes son inicializados automáticamente al cargar el script. Después de insertar contenido dinámico puede ejecutarse nuevamente:

```js
QuicklyComponents.init();
```

La operación es idempotente.

## Antipatrones

- No uses una clase porque “parece” seguir la nomenclatura del framework.
- No copies clases de Bootstrap, Tailwind u otros frameworks dentro de un ejemplo QuicklyCSS.
- No combines bundles completo y modular en la misma página.
- No trates los templates como una API CSS adicional.
- No presentes V2 como estable antes de `2.0.0`.

## Fuentes de verdad

- `llms.txt`: índice breve y rutas de consulta.
- `llms-full.txt`: contexto documental consolidado.
- `quicklycss-api.json`: catálogo legible por máquinas.
- `docs/*.md`: documentación limpia por tema.
- `CHANGELOG.md`: cambios por versión.
- `BITACORA.md`: detalle técnico de los cambios, decisiones y verificaciones de cada entrega.
- `MIGRATION_V1_V2.md`: límites y estrategia de migración.