LLMs.txt

Сайт документации отдаёт документацию CDS в машиночитаемом формате по конвенции llmstxt.org. Это способ подключить дизайн-систему к агенту, который не умеет в AI Skills — Cursor, Copilot, Windsurf и другие.

Наборы документации

Документация нарезана по темам: агент с ограниченным контекстом берёт нужный срез, а не весь каталог.

Файл	Что внутри	Когда брать
/llms.txt	Индекс: список наборов и назначение всех компонентов	Точка входа, начните с него
/llms-components.txt	Компоненты: назначение, примеры и контракт API	Сборка интерфейса — основной срез
/llms-tokens.txt	Токены и темы	Работа с цветом и темизацией
/llms-guides.txt	Подключение, конвенции, формы, тематизация, Tailwind, tree-shaking, адаптив	Настройка проекта
/llms-migration.txt	Миграция CDS 3 → CDS 4	Перевод существующего кода
/llms-full.txt	Всё сразу	Только если контекст позволяет

Те же файлы лежат в npm-пакете — node_modules/@central-design-system/components/llms/. Офлайн-вариант удобнее, когда агент работает без доступа в сеть.

Что внутри

Индекс llms.txt перечисляет наборы и даёт назначение каждого компонента, сгруппированное по категориям, — по нему агент выбирает компонент, не читая полный каталог:

### Controls (17)

- **CdsSelect** — Селект открывает выпадающий список и позволяет выбрать одно
  или несколько значений из заранее известного набора: страну, статус, категорию
- **CdsCombobox** — Комбобокс — поле с выпадающим списком и свободным вводом

В остальных файлах на каждый компонент идёт секция: назначение, подсказка «Смотрите также», проза документации с живыми примерами и контракт API.

# CdsButton

_Категория: Content · появился в 4.0.0_

Кнопка — основной способ запустить действие: отправить форму, открыть модальное
окно, подтвердить выбор.

**Смотрите также:** Для перехода, оформленного как текст в абзаце, подойдёт
CdsLink, а для выбора одного из вариантов — CdsButtonToggle.

## Вариации
...

## Рекомендации

| ✅ Хорошо | ❌ Плохо |
| --- | --- |
| Одно главное действие на экране — primary, остальные менее контрастны. | Несколько primary-кнопок соревнуются за внимание. |

## API

### CdsButton

**Props**

| Prop | Type | Default | Required | Description |
| --- | --- | --- | --- | --- |
| `appearance` | `"primary" \| "secondary" \| "tertiary" \| "inverse"` | `'primary'` | no | Внешний вид компонента |

Как подключить

Добавьте указатель на нужный файл в инструкции вашего продукта (AGENTS.md, .cursorrules, .github/copilot-instructions.md):

Компоненты CDS: https://<адрес-документации>/llms-components.txt
Токены и темы: https://<адрес-документации>/llms-tokens.txt

В Cursor файлы подключаются через @Docs, в Windsurf — через @ или .windsurfrules.

Для Claude Code есть вариант точнее

AI Skills подгружают справочники по мере надобности и несут процедуру работы, а не только данные. Плоский каталог нужен там, где скиллы не поддерживаются.

Как это генерируется

Файлы собираются из исходников дизайн-системы и вручную не редактируются:

cd packages/components
bun run generate:meta   # контракты компонентов → meta.json
bun run generate:llms   # meta.json + страницы документации → llms/

Источник — та же модель контента, что и у AI Skills: контракты берутся из meta.json, назначение и проза — из страниц документации компонентов, примеры — из демо, общих с сайтом и Storybook. Поэтому каталог не расходится с тем, что вы читаете здесь.