Для LLM-агентов

Эта страница говорит агенту, как читать портал дёшево и надёжно.

Машинная поверхность (контракт)

Артефакт	Назначение
/developers/llms.txt	Курируемые точки входа с однострочными описаниями плюс секция Instructions
/developers/llms-full.txt	Вся дока одним Markdown-документом
/developers/<path>.md	Markdown-двойник каждой HTML-страницы — бери его, не HTML
/developers/manifest.json	Nav-дерево + карта роут → content-хэш; сравнивай хэши, чтобы найти изменившиеся страницы
/developers/versions.json	Опубликованные версии доков и время текущей сборки
/developers/api/openapi.json	Замороженный контракт OpenAPI, из которого сгенерирован REST-справочник этой сборки
/developers/sitemap.md	Все страницы плоским списком .md-двойников — самый дешёвый полный индекс
/developers/agents.md	Что портал даёт агенту и чего не обещает — прочитайте, прежде чем что-либо предполагать
/developers/search-index.json	Маршрут, заголовок, подзаголовки и фрагмент текста на страницу — индекс, который ранжирует инструмент search docs-MCP
/developers/changelog.json	Заметки о выпусках как JSON Feed 1.1: записи портала и API плюс каждая capability-версия агентов
/.well-known/agent-skills/index.json	Каталог навыков (Agent Skills discovery 0.2.0): enterium-integration/SKILL.md с sha256-дайджестом — npx skills add устанавливает его
https://entherium.duckdns.org:8443/mcp/docs/	Эта документация как MCP-инструменты (search / fetch / submit_feedback), без токена — подробнее
https://entherium.duckdns.org:8443/api/status.json	Статус платформы в форме Statuspage v2, без токена
/.well-known/llms.txt, /.well-known/api-catalog	Алиасы в корне: конвенция llms.txt и каталог API по RFC 9727 (application/linkset+json) со ссылками на замороженный контракт, справочник, пробу здоровья и страницу онбординга MCP

Обнаружение с любой страницы

Каждая HTML-страница несёт в <head> две link-relation (llms.txt v2): <link rel="alternate" type="text/markdown" href="<route>.md"> — Markdown-двойник этой страницы — и <link rel="describedby" href="/developers/llms.txt"> — индекс, который её покрывает. Зеркало отдаёт их и HTTP-заголовком Link: (rel="llms-txt", rel="llms-full-txt", rel="api-catalog") и X-Llms-Txt, так что инструмент, читающий только заголовки, тоже находит индекс. Каждый .md-двойник начинается с однострочной директивы с адресом индекса — агент, пришедший по прямой ссылке, не потеряется.

.md-двойники и manifest.json отдаются с ETag: шлите If-None-Match при перечитывании — 304 скажет, что страница не менялась, без передачи тела.

Практические правила

1. Предпочитай .md-двойники HTML — тот же контент, доля токенов.
2. Чтобы понять, что изменилось с прошлого чтения, храни карту pages из manifest.json и сравнивай с текущей — хэш роута меняется только тогда, когда меняется содержимое самой страницы.
3. Английские страницы — канон; русские зеркала существуют для людей.
4. Mermaid-диаграммы сохраняют исходник в .md-двойниках — читай код-блок, не тяни отрендеренный SVG.