nextjs-style-guide/AGENTS.md

# Правила для агентов

При работе с документацией следовать правилам из CONTRIBUTING.md.

- Язык документации и коммитов — русский.
- После изменений в `.md`-файлах — запустить `npm run llms` для обновления `llms.txt` и README.
- При добавлении нового раздела — обновить сайдбар (`.vitepress/config.ts`):
  он же является источником порядка и группировки для `llms.txt`.
-												docs: добавлен AGENTS.md с правилами для агентов

- ссылка на CONTRIBUTING.md как основной источник правил
- операционные напоминания: язык, npm run docs, обновление конфигов, кеш

											
										
										
											2026-03-30 09:23:27 +03:00
+								# Правила для агентов
 								При работе с документацией следовать правилам из CONTRIBUTING.md.
 								- Язык документации и коммитов — русский.
-												feat: генерация llms.txt, лендинг с выбором языка и ZIP-архивов

- удалён concat-md.js: вместо единого RULES.md теперь llms.txt
- добавлен generate-llms.ts: собирает llms.txt из sidebar config, копирует
  .md-файлы для отдачи LLM и упаковывает ZIP-архивы по локалям
- добавлен корневой /llms.txt как роутер на /ru/llms.txt и /en/llms.txt
- добавлен манифест /manifest.json со ссылками и версией сборки
- добавлен лендинг docs/index.md (layout: false) с автоопределением
  языка, переключателями языка и темы
- английская локаль временно заблокирована: карточки как заглушки,
  ссылка на /en/ в роутере без href
- добавлены поля llmsBlockquote и llmsContext в локали для
  технодокументационного описания в llms.txt
- разделены VitePress-локали: root (только лендинг), ru (/ru/), en (/en/)
- добавлен srcExclude: ['public/**'] чтобы VitePress не рендерил
  сгенерированные .md как страницы
- добавлен Vite-плагин для отдачи .txt и .md с charset=utf-8
- добавлена секция в Caddyfile для текстовых файлов
- BUILD_VERSION пробрасывается из Gitea CI через docker --build-arg
  и подставляется в лендинг через Vite define
- Dockerfile: установка zip, npm run llms перед npm run build
- обновлены внутренние ссылки в docs/ru/**/*.md на префикс /ru/
- обновлены AGENTS.md и CONTRIBUTING.md под новый процесс
- README/README_RU генерируются из docs/{lang}/index.md, остаются в репо

											
										
										
											2026-04-25 18:06:27 +03:00
+								- После изменений в `.md`-файлах — запустить `npm run llms` для обновления `llms.txt` и README.
 								- При добавлении нового раздела — обновить сайдбар (`.vitepress/config.ts`):
 								  он же является источником порядка и группировки для `llms.txt`.