Секции и структура llms.txt

Секция - заголовок H2 и список ссылок под ним. Proposal называет такой список «file list»: перечень адресов, где лежат подробности.

## Документация

- [Быстрый старт](https://example.com/quickstart.md): первые шаги
- [Справочник API](https://example.com/api.md): методы и параметры

Названия секций proposal не задаёт, кроме одного - Optional. Остальные выбирает автор файла.

Это наблюдение по опубликованным файлам, а не требование.

## Optional

- [История изменений](https://example.com/changelog.md): версии
- [Планы](https://example.com/roadmap.md): что будет дальше
- [Как участвовать](https://example.com/contributing.md)

По тексту второй редакции Optional используется «по соглашению» для второстепенной информации: это ссылки, которые агент может пропустить, когда нужен более короткий контекст.

1. Заголовок H1 - название проекта.
2. Цитата с коротким описанием.
3. Подробности без заголовков.
4. Секции с главными ссылками.
5. Optional - последней.

Порядок первых трёх частей задан proposal. Порядок секций между собой - на усмотрение автора; главное ставят выше.

# FastHTML

> FastHTML - библиотека на Python для серверных веб-приложений на основе HTMX.

Важно:

- синтаксис не совместим с FastAPI
- React, Vue и Svelte не поддерживаются

## Docs

- [Быстрый старт](https://fastht.ml/docs/tutorials/quickstart_for_web_devs.html.md): обзор возможностей
- [Справочник HTMX](https://github.com/bigskysoftware/htmx/blob/master/www/content/reference.md): атрибуты, события, заголовки

## Examples

- [Список дел](https://github.com/AnswerDotAI/fasthtml/blob/main/examples/adv_app.py): полное приложение с разбором

## Optional

- [Документация Starlette](https://gist.githubusercontent.com/jph00/809e4a4808d4510be0e3dc9565e9cbd3/raw/9b717589ca44cedc8aaf00b2b8cacef922964c0f/starlette-sml.md): выдержка, полезная для работы с FastHTML

Пример взят из текста proposal и сокращён.

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

/llms.txt          -> весь сайт
/docs/llms.txt     -> только документация
/api/llms.txt      -> только API

Страница /docs/install/ покрыта и корневым файлом, и /docs/llms.txt; агент должен взять второй.

По тому же правилу файл можно положить в языковой раздел:

/llms.txt        -> весь сайт
/ru/llms.txt     -> русский раздел
/en/llms.txt     -> английский раздел

На каком языке писать корневой файл многоязычного сайта, proposal не говорит. Этот вопрос открыт в репозитории proposal.

По типу материала:

## Tutorials

- [Для начинающих](https://example.com/tutorial/basic.md): первые шаги, 30 минут
- [Углублённый курс](https://example.com/tutorial/advanced.md): два часа

## API Reference

- [REST API](https://example.com/api/rest.md): методы HTTP
- [SDK](https://example.com/api/sdk.md): клиентские библиотеки

По платформе:

## JavaScript

- [Пакет npm](https://example.com/js/install.md): установка и запуск

## Python

- [Пакет PyPI](https://example.com/python/install.md): установка через pip

Слишком много секций. Десять секций по одной ссылке читаются хуже, чем три секции с понятными пояснениями.

Секции без ссылок. Заголовок без списка ничего не даёт агенту.

Файл без ссылок вообще. По данным разбора корпуса Common Crawl, без единой ссылки опубликованы 23% файлов llms.txt. Такой файл не выполняет свою задачу: агенту некуда идти.

Повтор ссылки в нескольких секциях. Одна ссылка - одна секция.

Ссылки на страницы, неудобные модели. Если у страницы есть Markdown-версия, ссылаться стоит на неё.

Подробнее - в разделе Лучшие практики.

Файлы документации меняются, поэтому названия секций здесь не приводятся: надёжнее открыть сами файлы. Все адреса проверены 3 октября 2026 года.

• developers.openai.com/llms.txt - корневой файл и вложенные индексы для /api, /codex, /commerce
• docs.stripe.com/llms.txt - большой индекс без llms-full.txt
• developers.cloudflare.com/llms.txt - индекс по продуктам
• fastht.ml/docs/llms.txt - файл в подпути, пример из самого proposal