Примеры llms.txt: сложные сценарии
Сложные сценарии llms.txt с разбором: несколько языков, версий, пакетов монорепозитория и сервисов, полный текст, сборка в CI и настоящие файлы известных сайтов
| Сценарий | Сколько файлов | Главная мысль |
|---|---|---|
| Несколько языков | по одному на язык | файл языка лежит в подпути языка |
| Несколько версий | по одному на версию | корневой файл ведёт на текущую |
| Монорепозиторий | корень и пакеты | корень - оглавление, подробности в пакетах |
| Микросервисы | корень и сервисы | один вход, дальше по сервисам |
| Индекс и полный текст | два | индекс обязателен, полный текст - нет |
| Сборка в CI | сколько нужно | файл собирается при каждом изменении |
Несколько языков
Заголовок раздела «Несколько языков»- Когда подходит
- У сайта несколько языковых версий в подпутях: /ru/, /es/.
- Ловушка
- Сложить все языки в один корневой файл. Агент получит смесь и не поймёт, какая версия нужна.
- Где посмотреть
- Язык корневого файла на многоязычном сайте proposal не определяет: это открытый вопрос (issue 147 в репозитории).
- llms.txt английская версия, покрывает весь сайт
Директорияru/
- llms.txt русская версия, покрывает /ru/
Директорияes/
- llms.txt испанская версия, покрывает /es/
# Documentation Hub
> Comprehensive guides and API reference for developers.
## Getting Started
- [Quick Start](https://docs.example.com/en/quickstart.md): 5-minute setup guide- [Installation](https://docs.example.com/en/install.md): System requirements
## API Reference
- [REST API](https://docs.example.com/en/api/rest.md): HTTP endpoints# Документация
> Подробные руководства и справочник API для разработчиков.
## Начало работы
- [Быстрый старт](https://docs.example.com/ru/quickstart.md): настройка за 5 минут- [Установка](https://docs.example.com/ru/install.md): системные требования
## Справочник API
- [REST API](https://docs.example.com/ru/api/rest.md): HTTP-методыНесколько версий
Заголовок раздела «Несколько версий»- Когда подходит
- Документация хранит несколько версий продукта: /docs/v3/, /docs/v2/.
- Ловушка
- Оставить в корневом файле ссылки на старую версию. Агент напишет код под устаревший API.
Вопрос без версии
- Корневой файл
/llms.txt - Текущая версия
/docs/v3/
Вопрос про старую версию
- Файл версии
/docs/v2/llms.txt - Страницы этой версии
/docs/v2/
# MyLibrary v3.0
> Modern JavaScript utility library (current stable).
## Documentation
- [Migration from v2](https://mylib.dev/docs/v3/migration.md): Breaking changes- [API Reference](https://mylib.dev/docs/v3/api.md): Complete API docs
## Optional
- [v2 llms.txt](https://mylib.dev/docs/v2/llms.txt): Previous stable version- [v1 llms.txt](https://mylib.dev/docs/v1/llms.txt): DeprecatedМонорепозиторий
Заголовок раздела «Монорепозиторий»- Когда подходит
- Один сайт документирует несколько пакетов, у каждого свой раздел.
- Ловушка
- Перечислить в корне все страницы всех пакетов. Файл перестанет помещаться в контекст.
- Где посмотреть
- OpenAI: корневой файл и вложенные индексы для /api, /codex и /commerce.
- llms.txt оглавление: по строке на пакет
Директорияcore/
- llms.txt всё про ядро
Директорияcli/
- llms.txt всё про командную строку
Директорияplugins/
- llms.txt всё про расширения
# Acme Platform
> Monorepo containing all Acme packages and services.
## Packages
- [Core](https://acme.dev/core/llms.txt): Core library and shared utilities- [CLI](https://acme.dev/cli/llms.txt): Command-line interface- [Plugins](https://acme.dev/plugins/llms.txt): Plugin system
## Guides
- [Getting Started](https://acme.dev/guides/quickstart.md): First steps- [Architecture](https://acme.dev/guides/architecture.md): How the packages fit togetherМикросервисы
Заголовок раздела «Микросервисы»- Когда подходит
- Документация описывает набор сервисов с разными API.
- Ловушка
- Смешать публичные и внутренние сервисы. В файл попадает только то, что открыто всем: llms.txt доступ не ограничивает.
- Агентищет, как принять оплату
- Корневой файл
/llms.txtсписок сервисов - Файл сервиса
/billing/llms.txtстраницы биллинга - Нужная страница
/billing/payments.md
# Platform API Documentation
> Microservices platform for e-commerce operations.
## Services
- [Auth](https://docs.platform.io/auth/llms.txt): Authentication and authorization- [Users](https://docs.platform.io/users/llms.txt): User management- [Orders](https://docs.platform.io/orders/llms.txt): Order processing- [Billing](https://docs.platform.io/billing/llms.txt): Payments and invoices
## Optional
- [Status Page](https://status.platform.io): Service healthИндекс и полный текст
Заголовок раздела «Индекс и полный текст»- Когда подходит
- Агенту бывает нужен весь текст документации одним запросом.
- Ловушка
- Считать llms-full.txt частью proposal. Это практика платформ документации, и обязательным файл не является.
- Где посмотреть
- Stripe обходится без полного файла. У Cloudflare он занимает 67 МБ.
llms.txt
ссылки
разделссылкассылка
- Читается первым
- Килобайты
llms-full.txt
сам текст страниц
страницастраницастраница
- Читается, когда нужен весь корпус
- От сотен килобайт до десятков мегабайт
# Framework Documentation
> Full-stack web framework for building modern applications.
## Core
- [Getting Started](https://framework.dev/docs/start.md): Installation and first app- [Routing](https://framework.dev/docs/routing.md): File-based routing- [Middleware](https://framework.dev/docs/middleware.md): Request and response middleware
## Optional
- [Full text](https://framework.dev/llms-full.txt): All pages in one file# Framework Documentation
> Full-stack web framework for building modern applications.
## Getting Started
Install the framework:
npm install framework
Create the first application...
## Routing
Routes are created from files in the pages directory...
## Middleware
Middleware functions have access to the request and the response...Сборка в CI
Заголовок раздела «Сборка в CI»- Когда подходит
- Документация меняется часто, и файл нельзя вести руками.
- Ловушка
- Собирать файл раз в квартал. Ссылки умирают раньше: три примера в прежней версии этой страницы уже отвечали 404.
- Изменение
docs/**правка страницы - pushСборкагенератор читает карту сайта
- Проверкакаждая ссылка отвечает 200
- Публикация
public/llms.txt
name: Update llms.txt
on: push: paths: - 'docs/**' schedule: - cron: '0 0 * * 0'
jobs: update: runs-on: ubuntu-latest steps: - uses: actions/checkout@v4
- name: Generate llms.txt run: | npx llmstxt gen https://docs.example.com/sitemap.xml \ -ep "**/blog/**" -t "My Docs" > public/llms.txt
- name: Commit and push run: | git config user.name "GitHub Action" git config user.email "action@github.com" git add public/llms.txt git diff --staged --quiet || git commit -m "Update llms.txt" git pushКоманды генератора описаны на странице llmstxt CLI.
Пример написан для GitHub Actions. Тот же шаг добавляют в сборку на Vercel и Netlify. Платные тарифы GitHub, Vercel и Netlify можно оплатить из России. Весь список: Как оплачивать и работать из России.
Настоящие файлы
Заголовок раздела «Настоящие файлы»Все адреса открывались в день проверки. Для каждого сказано, что файл показывает и чего не доказывает.
- llms-full.txt
- есть
- Markdown-страницы
- по заголовку Accept
Что показывает. Корневой индекс и вложенные файлы для /api, /codex, /commerce
Чего не доказывает. Что ChatGPT читает чужие llms.txt
Anthropic
platform.claude.com/llms.txt- llms-full.txt
- есть
- Markdown-страницы
- да, с rel=alternate
Что показывает. Индекс документации и полный текст одним файлом
Чего не доказывает. Что Claude читает чужие llms.txt
Cloudflare
developers.cloudflare.com/llms.txt- llms-full.txt
- есть
- Markdown-страницы
- да
Что показывает. Очень большой индекс: полный текст занимает 67 МБ
Чего не доказывает. Что файл такого размера удобен агенту целиком
Stripe
docs.stripe.com/llms.txt- llms-full.txt
- нет
- Markdown-страницы
- по заголовку Accept
Что показывает. llms-full.txt не обязателен: хватает индекса и Markdown-страниц
Чего не доказывает. Что отказ от полного файла - общее правило
Cursor
cursor.com/llms.txt- llms-full.txt
- не проверялось
- Markdown-страницы
- по заголовку Accept
Что показывает. Единственный замеренный сайт с rel=describedby из второй редакции
Чего не доказывает. Что вторая редакция уже распространена
GitHub Docs
docs.github.com/llms.txt- llms-full.txt
- нет
- Markdown-страницы
- да
Что показывает. Индекс без полного файла на большой документации
Чего не доказывает. Что Copilot опирается на этот файл
Mintlify
www.mintlify.com/docs/llms.txt- llms-full.txt
- есть
- Markdown-страницы
- да
Что показывает. Платформа создаёт файлы автоматически для всех сайтов на ней
Чего не доказывает. Качество каждого такого файла
Yandex Cloud
yandex.cloud/llms.txt- llms-full.txt
- не проверялось
- Markdown-страницы
- не проверялось
Что показывает. Пример на русском сайте
Чего не доказывает. Что Поиск Яндекса использует такие файлы
Что дальше
Заголовок раздела «Что дальше»- Базовые примеры - с чего начать небольшому сайту.
- Формат файла - правила второй редакции.
- Лучшие практики - список проверки.