# llms.txt: пример файла и базовые шаблоны

> Образцы llms.txt с разбором для сайта документации, интернет-магазина, блога и сайта компании - что в каждом разделе, почему так и что стоит изменить под себя

Страница: https://llms-full-txt.ru/examples/basic/
Указатель сайта: https://llms-full-txt.ru/llms.txt

Ниже четыре образца `llms.txt` для разных сайтов. Адреса и названия в них учебные: домен `.example` не существует.

Структура у всех одна: название, описание, разделы со ссылками. Различается то, что считается главным.

Копировать стоит не текст, а подход: какие разделы выбраны и что написано в пояснениях.

## Самый короткий корректный файл

Обязателен только заголовок:

```markdown
# Колос
```

Формально файл верный, но пользы в нём нет: агенту некуда идти. Рабочий минимум - название, описание и хотя бы один раздел.

```markdown
# Колос

> Пекарня в Казани: хлеб и выпечка с доставкой.

## Главное

- [Меню и цены](https://kolos.example/menu.md): весь ассортимент с составом
- [Доставка](https://kolos.example/delivery.md): районы, время, стоимость
```

## Сайт документации

- llms.txt
- Документация сервиса
- Название и описание

```
# Колос API
> Сервис доставки для интернет-магазинов: расчёт стоимости, создание заказов, отслеживание.
```

- Кому и зачем нужен сервис
- Важное заранее

```
Все запросы требуют ключа в заголовке Authorization.
Версия API указывается в адресе: /v2/.
```

- То, без чего агент ошибётся в первом же запросе
- С чего начать

```
## Начало
- [Быстрый старт](https://kolos.example/docs/start.md): ключ, первый запрос, первый заказ
- [Аутентификация](https://kolos.example/docs/auth.md): ключи, права, срок действия
```

- Путь новичка
- Справочник

```
## API
- [Заказы](https://kolos.example/docs/orders.md): создание, изменение, отмена
- [Тарифы](https://kolos.example/docs/rates.md): расчёт стоимости по адресу и весу
- [Ошибки](https://kolos.example/docs/errors.md): коды и что с ними делать
```

- По одной ссылке на предмет
- Второстепенное

```
## Optional
- [История изменений](https://kolos.example/docs/changelog.md): версии и даты
```

- Можно пропустить, если нужен короткий контекст

Почему так:

- Ссылки ведут на Markdown-версии страниц: агенту не придётся разбирать HTML.
- Блок «важное заранее» экономит ошибки. Туда идёт то, что касается всех запросов.
- В справочнике нет всех методов подряд: по одной странице на предмет.

## Интернет-магазин

```markdown
# Волна

> Интернет-магазин бытовой техники: чайники, кофеварки, пылесосы. Доставка по России.

Цены на сайте указаны в рублях с учётом НДС. Наличие обновляется раз в час.

## Каталог

- [Чайники](https://volna.example/category/kettles/): электрические и для плиты, от 1 до 2,5 л
- [Кофеварки](https://volna.example/category/coffee/): капельные, рожковые, капсульные
- [Пылесосы](https://volna.example/category/vacuum/): проводные, вертикальные, роботы

## Покупателю

- [Доставка](https://volna.example/delivery/): города, сроки, стоимость, самовывоз
- [Оплата](https://volna.example/payment/): карты, рассрочка, оплата при получении
- [Возврат и гарантия](https://volna.example/returns/): сроки, условия, адрес сервиса
- [Контакты](https://volna.example/contacts/): телефон, адрес, часы работы

## Optional

- [О компании](https://volna.example/about/): реквизиты и история
```

Почему так:

- В файле категории, а не все товары. Товаров тысячи, и их список уже есть в `sitemap.xml`.
- Раздел «Покупателю» отвечает на вопросы, которые задают чаще всего: доставка, оплата, возврат.
- Цены в файл не включены: они меняются. Точные цену и наличие машина возьмёт со страницы товара из структурированных данных.

Что описывает товарную страницу: [Структурированные данные и JSON-LD](https://llms-full-txt.ru/guides/json-ld/).

## Блог

```markdown
# Заметки о сети

> Блог о том, как устроены сайты: скорость, доступность, поиск. Пишет один автор, новые статьи раз в две недели.

## Главные материалы

- [Почему сайт медленный](https://notes.example/slow-site.md): пять причин и как найти свою
- [Доступность с нуля](https://notes.example/a11y-start.md): что проверить на любом сайте за час
- [Как читать отчёт Lighthouse](https://notes.example/lighthouse.md): какие числа важны, какие нет

## Темы

- [Скорость](https://notes.example/topics/speed/): статьи о загрузке и отрисовке
- [Доступность](https://notes.example/topics/a11y/): статьи о клавиатуре, контрасте, чтении с экрана

## Optional

- [Все статьи](https://notes.example/archive/): полный список по датам
- [Об авторе](https://notes.example/about/): опыт и контакты
```

Почему так:

- Сначала лучшие статьи, а не последние. Для ленты новых записей есть RSS.
- Полный архив вынесен в `Optional`.
- В описании сказано, кто пишет и как часто: это помогает оценить источник.

## Сайт компании

```markdown
# Бюро «Опора»

> Проектируем и строим каркасные дома в Татарстане. Работаем по договору с фиксированной ценой.

## Услуги

- [Проектирование](https://opora.example/design/): состав проекта, сроки, что нужно от заказчика
- [Строительство](https://opora.example/build/): этапы, сроки, гарантия
- [Готовые проекты](https://opora.example/projects/): планировки и площади

## Как мы работаем

- [Этапы и оплата](https://opora.example/process/): от замера до сдачи
- [Вопросы и ответы](https://opora.example/faq/): участок, фундамент, зима, ипотека
- [Контакты](https://opora.example/contacts/): адрес, телефон, часы работы
```

Почему так:

- Нет раздела с новостями и вакансиями: на вопросы клиента они не отвечают.
- Страница с вопросами и ответами включена обязательно: это готовые ответы.

## Что общего у хороших файлов

- Описание отвечает на вопрос «что здесь и для кого».
- Разделов немного, и они названы по смыслу.
- У каждой ссылки есть пояснение.
- Второстепенное лежит в `Optional`.
- Ничего закрытого и ничего лишнего.

## Что читать дальше

- [Продвинутые примеры](https://llms-full-txt.ru/examples/advanced/) - как устроены файлы настоящих сайтов
- [Лучшие практики](https://llms-full-txt.ru/guides/best-practices/) - правила и типичные ошибки
- [Формат файла](https://llms-full-txt.ru/specification/format/) - точные требования
- [Начало работы](https://llms-full-txt.ru/guides/getting-started/) - путь по шагам
