llms.txt
O catálogo de componentes em texto simples, para agentes que não têm a skill nem como rodar a CLI.
A agent skill é a melhor opção, porque olha o seu app e sabe o que está instalado. Mas nem todo agente aceita skills, e nem todo agente consegue rodar comandos. Para esses casos, o registry também sai em dois arquivos de texto simples, gerados a partir dos mesmos dados.
| Arquivo | Conteúdo | Quando usar |
|---|---|---|
/r/llms.txt |
Cada componente com título, descrição e o texto de quando usar. | Escolher um componente. É pequeno o bastante para qualquer janela de contexto. |
/r/llms-full.txt |
Tudo o que está no llms.txt, mais a API completa: helpers, variantes, tamanhos, argumentos e exemplos de uso. | Escrever ERB sem poder consultar a CLI. |
Formato
Markdown simples, na convenção llms.txt: um título, um resumo curto e seções sobre como instalar, a licença do código e o catálogo em si.
O que eles não dizem
Esses arquivos descrevem o registry, não o seu app. Eles listam todos os 57 componentes, inclusive os que você não instalou, e os helpers desses componentes não existem no seu app.
Instalar à mão deixa o shadwire.json impreciso
llms-full.txt, mas aí a lista no
shadwire.json não é atualizada, e diff, update e
remove dependem dela. Se você puder rodar a CLI, use a CLI.