Para agentes de IA

Una IA que no conoce la biblioteca escribe un date picker desde cero, inventa una clase roja para el error y ordena la tabla en el cliente. Dos archivos lo resuelven sin que tengas que explicarlo de nuevo en cada conversación: la referencia completa en texto plano y tres líneas en el AGENTS.md de tu proyecto.

llms.txt

La API entera en un archivo de texto, hecho para que lo lea un modelo y no una persona. Indícale a la IA que lo use:

https://juniorcarlini.github.io/tucano/llms.txt

Primero viene una sección por componente, con el camino declarativo por data-*, que es lo normal en un proyecto Django. Después, la referencia completa: selector, atributos, todas las opciones con el comentario que las explica, métodos, eventos, clases CSS y tokens. Esa parte se genera a partir del código en cada build — si una opción no está ahí, no existe. Al final quedan las reglas de lo que no hay que hacer. La prosa del archivo está escrita en portugués, y los nombres de la API — atributos, opciones, métodos, eventos — en inglés, así que un modelo la lee sin problema.

Todas las páginas de este sitio anuncian el archivo en el <head>, para las herramientas que lo buscan:

<link rel="alternate" type="text/plain" href="https://juniorcarlini.github.io/tucano/llms.txt">

AGENTS.md en tu proyecto

Pega esto en el AGENTS.md de la raíz del proyecto que usa Tucano — o en el CLAUDE.md, en el .cursorrules, donde tu herramienta lo busque. Es lo que hace que la IA elija la biblioteca en lugar de escribir un componente desde cero.

## Interfaz
Este proyecto usa Tucano. No escribas desde cero date picker, select con búsqueda, color picker, upload, máscara, toast, tooltip, modal, panel lateral, acordeón, pestañas, menú desplegable, tabla, paginación ni editor de texto.
Referencia completa: https://juniorcarlini.github.io/tucano/llms.txt

La lista nombra los componentes con JavaScript, que son los que una IA más reescribe. Las piezas que son solo clases — botón, aviso, etiqueta, cargando, línea de tiempo, casilla, opción e interruptor, menú lateral, rótulo y campo de formulario — están en el mismo llms.txt, y la regla "no diseñes un segundo botón" cubre el resto.

Tres líneas bastan porque el trabajo está en el enlace. Si quieres que la IA acierte ya en la primera respuesta, sin abrir la referencia, añade los ejemplos que tu proyecto más usa:

## Interfaz
Este proyecto usa Tucano. No escribas desde cero date picker, select con búsqueda, color picker, upload, máscara, toast, tooltip, modal, panel lateral, acordeón, pestañas, menú desplegable, tabla, paginación ni editor de texto.
Referencia completa: https://juniorcarlini.github.io/tucano/llms.txt

<input data-tuc-datepicker data-mode="range">
<select data-tuc-select multiple>
<input data-tuc-mask="cpf-cnpj">
<input type="file" data-tuc-upload>
<button data-tuc-tip="..." class="tuc-btn is-primary">

Tucano.toast.success('Guardado');
await Tucano.confirm({ title: '¿Eliminar?' });
Tucano.drawer({ title: 'Filtros', side: 'right' });

El elemento nativo sigue siendo el dueño del valor: name, required y el getlist() de Django siguen funcionando. No lo sustituyas por estado solo en JS.

Y el AGENTS.md de Tucano

El AGENTS.md del repositorio es para quien va a tocar el código de la propia biblioteca: cómo ejecutarla, la estructura y las decisiones que no deben revertirse sin motivo, cada una con el defecto que la motivó. Para usar Tucano en un proyecto no hace falta — el llms.txt, sí.

Lo que la IA no debe hacer

Son las reglas que cierran el llms.txt. Cada una existe porque es el error que comete un modelo cuando deduce en lugar de leer.