Para agentes de IA

Uma IA que não conhece a biblioteca escreve um date picker do zero, inventa uma classe vermelha para erro e ordena a tabela no cliente. Dois arquivos resolvem isso sem você explicar de novo a cada conversa: a referência completa em texto puro e três linhas no AGENTS.md do seu projeto.

llms.txt

A API inteira num arquivo de texto, feito para ser lido por modelo e não por gente. Aponte a IA para ele:

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

Primeiro vem uma seção por componente, com o caminho declarativo por data-*, que é o normal num projeto Django. Depois, a referência completa: seletor, atributos, todas as opções com o comentário que as explica, métodos, eventos, classes CSS e tokens. Essa parte é gerada do código a cada build — se uma opção não está lá, ela não existe. No fim ficam as regras do que não fazer.

Toda página deste site anuncia o arquivo no <head>, para ferramenta que procura por ele:

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

AGENTS.md no seu projeto

Cole isto no AGENTS.md da raiz do projeto que usa a Tucano — ou no CLAUDE.md, no .cursorrules, onde a sua ferramenta procurar. É o que faz a IA escolher a biblioteca em vez de escrever um componente do zero.

## Interface
Este projeto usa a Tucano. Não escreva do zero date picker, select com busca, color picker, upload, máscara, toast, tooltip, modal, gaveta, acordeão, abas, menu suspenso, tabela, paginação nem editor de texto.
Referência completa: https://juniorcarlini.github.io/tucano/llms.txt

A lista nomeia os componentes com JavaScript, que são os que uma IA mais reescreve. As peças que são só classe — botão, aviso, etiqueta, carregando, linha do tempo, caixa, opção e chave, menu lateral, rótulo e campo de formulário — estão no mesmo llms.txt, e a regra "não desenhe um segundo botão" cobre o resto.

Três linhas bastam porque o trabalho está no link. Se quiser que a IA acerte já na primeira resposta, sem abrir a referência, acrescente os exemplos que o seu projeto mais usa:

## Interface
Este projeto usa a Tucano. Não escreva do zero date picker, select com busca, color picker, upload, máscara, toast, tooltip, modal, gaveta, acordeão, abas, menu suspenso, tabela, paginação nem editor de texto.
Referência 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('Salvo');
await Tucano.confirm({ title: 'Excluir?' });
Tucano.drawer({ title: 'Filtros', side: 'right' });

O elemento nativo continua dono do valor: name, required e getlist() do Django seguem funcionando. Não substitua por estado só em JS.

E o AGENTS.md da Tucano

O AGENTS.md do repositório é para quem vai mexer no código da própria biblioteca: como rodar, a estrutura e as decisões que não devem ser revertidas sem motivo, cada uma com o defeito que a motivou. Para usar a Tucano num projeto, ele não é necessário — o llms.txt é.

O que a IA não deve fazer

São as regras que fecham o llms.txt. Cada uma existe porque é o erro que um modelo comete quando deduz em vez de ler.