25 августа 2026 г.
Дублировать текст в доках снова дёшево: синхронизацию правок берёт на себя агент
Дакс Раад из opencode повторяет один и тот же кусок на разных страницах доков, а держать копии в синхроне оставил агенту.
dax
@thdxr
Дублировать стало дешевле, раз у нас есть LLM, и мне кажется, это меняет довольно многое. Я тут занимаюсь доками (для LLM) и спокойно повторяю один и тот же текст на нескольких страницах, где он к месту. Знаю: понадобится что-то поменять — агент проследит, чтобы обновилось везде.
· 36,1 тыс. просмотров
Правило «не повторяйся» в доках держалось годами. Дакс Раад, автор opencode, его отменил.
Он пишет доки для LLM и спокойно ставит один и тот же кусок на всех страницах, где тот уместен. Понадобится правка — по всем копиям пройдёт агент.
Раньше дубль был долгом. Единый источник и ссылки «см. раздел выше» держались ровно потому, что вторая копия рано или поздно расходилась с первой. Теперь расхождение чинит тот же агент, который эти доки читает.
Машину кормят markdown. Доки opencode уже отдают чистую версию страницы по добавлению .md: opencode.ai/docs/agents.md открывается как text/plain на 20 440 байт (проверка 25.08.2026). Агенту не приходится продираться через вёрстку.
10 августа 2026 Джереми Ховард выпустил llms.txt v2, первую ревизию стандарта с сентября 2024 года. Markdown-копию страницы теперь можно называть page.md или page.html.md, а связь страницы с ней объявлять HTTP-заголовком Link, вообще не трогая HTML.
Свой llms.txt при этом есть не у всех. У opencode он отвечает 404, а запрос на него висит в репозитории с 16 января 2026 и всё ещё открыт. Anthropic, OpenAI и команда Gemini свои файлы публикуют, только Google Search их не читает (обзор Search Engine Journal, 17.08.2026).
Дубли весят. Полный дамп доков Anthropic одним файлом тянет 38 МБ, короткий индекс — 64 КБ (проверка 25.08.2026). У себя Anthropic ту же задачу решает иначе: метаданные скилла в Agent Skills висят в промпте всегда, а тело до 5 тысяч токенов грузится только когда скилл срабатывает.
Дальше вопрос к площадкам: кто начнёт отдавать markdown-копию каждой страницы по умолчанию.
Первоисточник