# Примеры llms.txt: продвинутые файлы с разбором

> Сложные сценарии llms.txt с разбором: несколько языков, версий, пакетов монорепозитория и сервисов, полный текст, сборка в CI и настоящие файлы известных сайтов

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

Один файл в корне подходит небольшому сайту. Когда у проекта несколько языков, версий, пакетов или сервисов, файлов становится несколько, и [вторая редакция proposal](https://llmstxt.org/) говорит, как агент выбирает между ними: берётся самый специфичный файл, который покрывает страницу.

Ниже шесть сценариев. У каждого - схема, структура файлов, пример и типичная ошибка.

| Сценарий | Сколько файлов | Главная мысль |
|---|---|---|
| [Несколько языков](#несколько-языков) | по одному на язык | файл языка лежит в подпути языка |
| [Несколько версий](#несколько-версий) | по одному на версию | корневой файл ведёт на текущую |
| [Монорепозиторий](#монорепозиторий) | корень и пакеты | корень - оглавление, подробности в пакетах |
| [Микросервисы](#микросервисы) | корень и сервисы | один вход, дальше по сервисам |
| [Индекс и полный текст](#индекс-и-полный-текст) | два | индекс обязателен, полный текст - нет |
| [Сборка в CI](#сборка-в-ci) | сколько нужно | файл собирается при каждом изменении |

## Несколько языков

- У сайта несколько языковых версий в подпутях: /ru/, /es/.
- Сложить все языки в один корневой файл. Агент получит смесь и не поймёт, какая версия нужна.
- Язык корневого файла на многоязычном сайте proposal не определяет: это открытый вопрос (issue 147 в репозитории).

- **llms.txt** английская версия, покрывает весь сайт
- ru/
  - **llms.txt** русская версия, покрывает /ru/
- es/
  - **llms.txt** испанская версия, покрывает /es/

**/llms.txt**

```markdown title="llms.txt"
# 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
```

**/ru/llms.txt**

```markdown title="ru/llms.txt"
# Документация

> Подробные руководства и справочник 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/

```markdown title="llms.txt"
# 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** всё про расширения

```markdown title="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

```markdown title="llms.txt"
# 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
- сам текст страниц
- страница -> страница -> страница
- Читается, когда нужен весь корпус
- От сотен килобайт до десятков мегабайт

**llms.txt**

```markdown title="llms.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
```

**llms-full.txt**

```markdown title="llms-full.txt"
# 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

- Документация меняется часто, и файл нельзя вести руками.
- Собирать файл раз в квартал. Ссылки умирают раньше: три примера в прежней версии этой страницы уже отвечали 404.

- Файл собирается вместе с сайтом
- Изменение
- docs/**
- правка страницы
- Сборка
- генератор читает карту сайта
- Проверка
- каждая ссылка отвечает 200
- Публикация
- public/llms.txt

```yaml title=".github/workflows/llms.yml" {16-19}
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](https://llms-full-txt.ru/tools/llmstxt-cli/).

Пример написан для GitHub Actions. Тот же шаг добавляют в сборку на Vercel и Netlify. Платные тарифы [GitHub](https://llms-full-txt.ru/go/pay-github/), [Vercel](https://llms-full-txt.ru/go/pay-vercel/) и [Netlify](https://llms-full-txt.ru/go/pay-netlify/) можно оплатить из России. Весь список: [Как оплачивать и работать из России](https://llms-full-txt.ru/reference/from-russia/).

## Настоящие файлы

Все адреса открывались в день проверки. Для каждого сказано, что файл показывает и чего не доказывает.

- [OpenAI](https://developers.openai.com/llms.txt): Корневой индекс и вложенные файлы для /api, /codex, /commerce. Не доказывает: что chatgpt читает чужие llms.txt.
- [Anthropic](https://platform.claude.com/llms.txt): Индекс документации и полный текст одним файлом. Не доказывает: что claude читает чужие llms.txt.
- [Cloudflare](https://developers.cloudflare.com/llms.txt): Очень большой индекс: полный текст занимает 67 МБ. Не доказывает: что файл такого размера удобен агенту целиком.
- [Stripe](https://docs.stripe.com/llms.txt): llms-full.txt не обязателен: хватает индекса и Markdown-страниц. Не доказывает: что отказ от полного файла - общее правило.
- [Cursor](https://cursor.com/llms.txt): Единственный замеренный сайт с rel=describedby из второй редакции. Не доказывает: что вторая редакция уже распространена.
- [GitHub Docs](https://docs.github.com/llms.txt): Индекс без полного файла на большой документации. Не доказывает: что copilot опирается на этот файл.
- [Mintlify](https://www.mintlify.com/docs/llms.txt): Платформа создаёт файлы автоматически для всех сайтов на ней. Не доказывает: качество каждого такого файла.
- [Yandex Cloud](https://yandex.cloud/llms.txt): Пример на русском сайте. Не доказывает: что поиск яндекса использует такие файлы.

Проверено 3 октября 2026.

## Что дальше

- [Базовые примеры](https://llms-full-txt.ru/examples/basic/) - с чего начать небольшому сайту.
- [Формат файла](https://llms-full-txt.ru/specification/format/) - правила второй редакции.
- [Лучшие практики](https://llms-full-txt.ru/guides/best-practices/) - список проверки.