Para IA

La documentación en Markdown para asistentes de IA (llms.txt).

Los asistentes de IA (Claude Code, GitHub Copilot, Cursor, ChatGPT...) no necesitan leer las páginas como una persona: el menú, las demos y los estilos solo les gastan contexto. Por eso la documentación también se publica en Markdown, siguiendo el formato llms.txt: texto limpio, los parámetros de cada componente y el código de ejemplo real (el mismo que ejecuta esta documentación), en inglés.

/llms.txt Índice: qué es AstrolUI, reglas básicas y un enlace a cada página. Empiece por aquí. /llms-full.txt Toda la documentación en un solo fichero, para dársela completa a un agente. /ai/basic-component-button.txt Una página en Markdown (aquí, Button). Cada página tiene la suya en /ai/. /ai/migration.txt Guía de migración: cada cambio del refactor para .NET 10 con el código antes y después.

1. Usarla en su proyecto

Añada estas líneas al fichero de instrucciones de su asistente (Claude Code lee CLAUDE.md, GitHub Copilot .github/copilot-instructions.md y Cursor .cursor/rules). Así, cuando escriba código con AstrolUI, consultará la documentación en lugar de inventar parámetros. En un chat también puede pegar el enlace de llms-full.txt o el de la página del componente.

<!-- Claude Code: CLAUDE.md · GitHub Copilot: .github/copilot-instructions.md · Cursor: .cursor/rules/astrolui.mdc -->

## AstrolUI

This project uses AstrolUI (Blazor, .NET 10). Before writing UI code, read https://doc.astrolui.com/llms.txt

and open the page of each component you use (https://doc.astrolui.com/ai/<page>.txt).

For code written for older AstrolUI versions follow https://doc.astrolui.com/ai/migration.txt

2. Desde cada página

Al pie de cada página hay un enlace Markdown para IA que abre la misma página en formato para IA.

3. Cómo se mantiene

Los ficheros se generan a partir de los textos y del código de las páginas, así que no hay que escribir nada dos veces. Tras cambiar la documentación, regenérelos:

python 2-Shared/tools/docs_ai_export.py # llms.txt, llms-full.txt and wwwroot/ai/*.txt

python 2-Shared/tools/docs_search_index.py # search index of these docs