Assistentes de IA

O site gera llms.txt, llms-full.txt, o Custom Elements Manifest e versões Markdown das páginas. Esses recursos ajudam assistentes a localizar a API da versão instalada sem depender apenas do HTML renderizado.

Esse trabalho também é chamado de GEO (Generative Engine Optimization) ou AEO (Answer Engine Optimization). Na prática, ele começa com o mesmo fundamento do SEO: conteúdo original, rastreável, rápido, semanticamente organizado e claro para pessoas. Os arquivos llms*.txt são uma convenção complementar para ferramentas que decidam consumi-los; não substituem HTML, sitemap, metadados ou documentação visível.

Quando existem documentações versionadas, llms.txt e llms-full.txt apontam para a versão estável mais recente. A documentação em desenvolvimento usa llms-next.txt e llms-full-next.txt; cada versão publicada também possui arquivos próprios, como llms-1.0.0.txt e llms-full-1.0.0.txt. O botão de assistência por IA seleciona automaticamente o arquivo correspondente à versão da página aberta.

O índice prioriza páginas individuais de componentes. Cada uma reúne, no mesmo Markdown, a visão geral e as seções de API disponíveis — propriedades, eventos, métodos, slots, acessibilidade e dependências. Os fragmentos técnicos internos não são indexados isoladamente, e arquivos agregados com a API de todos os componentes não são gerados. Para uma pergunta específica, localize primeiro a página do componente no llms.txt; use llms-full.txt apenas quando precisar de contexto amplo.

Contexto recomendado

Informe ao assistente:

• framework e versão;
• pacote GovBR-DS utilizado;
• componente e comportamento desejado;
• restrições de acessibilidade;
• se a resposta deve usar HTML, Angular, React ou Vue;
• página da API e diretriz oficial relacionada.

Prompts de exemplo

Crie em React um formulário com @govbr-ds/webcomponents-react.
Use React Hook Form com Controller, cite as páginas da API utilizadas
e revise nomes de eventos, labels, foco e mensagens de erro.

Migre este componente imperativo do @govbr-ds/core para br-select.
Use somente APIs documentadas, explique atributos versus propriedades
e preserve o comportamento de teclado.

Revise este modal GovBR-DS para nome acessível, foco inicial,
tecla Escape e retorno de foco. Aponte o que exige teste manual.

Como a IA deve usar este conteúdo

Esta página é uma orientação curta para assistentes que consultam llms-full.txt. Para implementar algo, a IA deve:

• confirmar a API na página do componente e no Custom Elements Manifest gerado para a mesma versão;
• usar apenas pacotes, tags e eventos documentados, preferindo APIs canônicas;
• tratar o código gerado como ponto de partida e recomendar validação conforme o guia de formulários e o guia de acessibilidade.

As regras detalhadas ficam nas páginas de formulários, eventos nativos e customizados e convenções de API. Depreciações são documentadas na página do componente correspondente. Para decisões de design, consulte gov.br/ds.

O robots.txt de produção permite crawlers de mecanismos de busca e assistentes de IA. Previews de Merge Requests e branches são públicos para revisão, mas usam noindex e não devem ser tratados como fonte canônica.