Как создать OKF-бандл для сайта: пошаговый гайд

Шаг 1. Концепты, а не страницы

Главная ошибка первых внедрений — конвертировать каждую HTML-страницу в отдельный markdown-файл. OKF задуман иначе: выделите из контента единицы знания. Для сервисного сайта это услуги, методики, кейсы, термины, регламенты; для контентного — темы и определения. Один концепт = один файл с самодостаточным описанием.

Шаг 2. Структура каталога

Организуйте концепты в подкаталоги по смыслу — спецификация не диктует структуру. Рабочий минимум для сайта услуг: services/ (по файлу на услугу), concepts/ (термины и методики), playbooks/ (процессы), references/ (внешние источники). В корне и в каждом каталоге — index.md с оглавлением: агент читает его первым и открывает только нужное.

Шаг 3. Frontmatter каждого файла

YAML-блок в начале файла: обязательное поле одно — type (например, Service, Concept, Playbook, Reference). Добавьте title, description в одну строку, tags для связей и resource — канонический URL страницы, которую концепт описывает: так агент свяжет знание с живым сайтом. Кросс-ссылки между концептами — относительными markdown-ссылками.

Шаг 4. Публикация и обнаружение

Разместите бандл по адресу /okf/ так, чтобы /okf/index.md открывался напрямую. На WordPress статические файлы кладутся в подкаталог или отдаются плагином; на статических хостингах — простое копирование. Затем добавьте в llms.txt строку со ссылкой на бандл — это сложившийся способ сказать агентам «здесь есть знания». Требованием спецификации это не является.

Инструменты

Три пути: вручную в текстовом редакторе (подходит для 10–20 концептов), генераторы (уже существуют веб-инструменты и WordPress-плагин, собирающие бандл из опубликованных страниц), собственный скрипт — для сайтов с структурированным контентом в базе бандл генерируется напрямую из данных, и это самый управляемый вариант. Референсные реализации Google — enrichment-агент для BigQuery и HTML-визуализатор графа — открыты на GitHub.

Типичные ошибки

Зеркалирование HTML вместо выделения концептов; файлы без type (бандл теряет конформность); отсутствие index.md (агент читает всё подряд и жжёт контекст); мёртвый бандл без автообновления; ожидание SEO-эффекта — его нет и не обещано, это инфраструктура для агентов.