Imported from bestdeejay-design/lovii-design (AGENTS.md). Install upstream with npx skills add bestdeejay-design/lovii-design. Copyright stays with the author.

AGENTS.md — правила для ИИ-агентов проекта LOVII

Этот файл читают любые ИИ-агенты (Claude, Codex, opencode, собственные боты), работающие с клиентским кодом LOVII: lovii_demo, lovii-site, будущие продовые репозитории. Прочитай его до первой правки стилей.

1. Карта мира

Продукт	Репо	Ветка	URL	Роль
Дизайн-система	`bestdeejay-design/lovii-design`	main	https://bestdeejay-design.github.io/lovii-design/ (хаб · гайд · examples · lovii.css)	Источник истины; правка стилей ТОЛЬКО здесь; разноска `tools/propagate.py --push`
Главный сайт (white paper)	`bestdeejay-design/lovii`	main	https://lovii.ru	Прод, потребитель ДС
Витрина-приложение	`bestdeejay-design/lovii_demo`	master	https://lovii.mobiap.com	Эталон реализации, канон стилей
Инвест-портал	`bestdeejay-design/lovii-invest`	main	https://invest.lovii.ru	Живой архив до ДС (модернизация после релиза)
Легаси-сайт (исходник контента)	`bestdeejay-design/lovii-legacy`	main	https://bestdeejay-design.github.io/lovii-legacy/	Архив: Next.js-экспорт с хеш-роутами; контент перенесён в lovii-site (старый URL lovii-site — 404, GitHub не редиректит)
Превью нового lovii.ru	`bestdeejay-design/lovii-site`	main	https://bestdeejay-design.github.io/lovii-site/	Статика на lovii.css (снапшот, TARGETS); до Дня X — noindex/Disallow, релиз → lovii.ru

Клиентские роли LOVII (для новых экранов): клиент · бизнес · партнёр · амбассадор · инвестор. Референс-экраны ролей — examples/01…05.html; поведение экрана (якоря, адаптив, PWA, hash-роуты) — examples/06-ux-lab.html (см. examples/README.md); собирать новый экран начинай с каркаса референса.

Канон стилей — lovii.mobiap.com. Токены канона — tokens/tokens.css и tokens/design-tokens.json в этом репозитории.
lovii-site — статический HTML из генератора /home/z/my-project/scripts/build_lovii_site.py (правки страниц — только в генераторе, руками HTML не править; приёмка: paths/facts/smoke-стражи), деплой GitHub Pages из корня репо.
lovii_demo — ванильный HTML/CSS/JS + service worker sw.js (кэш lovii-vN), ветка master деплоится напрямую.

2. Железные правила (нарушать нельзя)

Никакого хардкода стилей. Цвет — только var(--lv-*), тень/радиус/длительность — из шкалы. Новое значение = сначала коммит в lovii-design, потом использование.
Иерархия изменений: lovii-design → lovii_demo → lovii-site → проверка обоих продов. Прямые правки стилей реализаций в обход ДС запрещены.
Канон — lovii.mobiap.com. При расхождении реализаций правится та, что ниже по иерархии, а не токен. Расхождения фиксируй в docs/06-application.md, не прячь.
Темы. Управление: data-theme="light|dark" на <html>, хранение localStorage['lovii_theme'], anti-FOUC инлайн-скрипт до CSS. Не хранить тему в React-state/cookies. Не использовать filter: invert. Логотипы/иконки — оба в DOM, видимость через CSS.
Логотип. Тёмный канон — assets/lovii-logo-dark.svg (md5 145731d888e5d913ce85de3a9789d097, идентичен lovii-logo-black.svg). Высветленный lovii-logo-dark.svg удалён из канона 2026-09-04 — не восстанавливать.
Soft-пары. soft-pink→pink-dark, soft-tiffany→tiffany-text, soft-gold→gold-text, grey-soft→#999. Не смешивать тоны.
Тексты на градиентах — только --lv-on-brand (вторичные — rgba(255,255,255,.65–.7)).
Кэш демки. Любое изменение статики демки = поднять ?v=N в index.html и CACHE lovii-vN в sw.js (иначе PWA-пользователи застрянут на старом).
Пуш-дисциплина. Коммиты по одному смыслу, сообщение — тип(область): суть. Не форс-пушить master/main.
Навигация ДС. Страницы дизайн-системы (хаб, style-guide, examples) подключают assets/nav.js перед </body> — единое меню «☰». Список страниц меняется только в assets/nav.js.
Иконки. Эмоджи в UI запрещены (v1.3). Только SVG из assets/icons.svg: 24px сетка, stroke 2, currentColor, префикс i-. Новая иконка — через коммит в lovii-design. Анатомия и состояния компонентов — docs/09-components.md.
Секреты. Токены доступа GitHub никогда не попадают в файлы — только переменные окружения/разовые команды.
Гайд — проекция канона. В шаблонах (tools/tpl-*.part.html) и JS style-guide запрещено копировать значения токенов: свотчи, демо-точки тем и meta theme-color читают инлайннутый tokens.css (parseTokenBuckets). Неизбежные пины помечай комментарием TOKEN-PIN. Страж: python3 tools/check-sync.py — 0 ошибок после каждой пересборки гайда.
Единый файл ДС — lovii.css (LOVII UI). Компоненты живут ТОЛЬКО в css/lovii-components.css (слой B); lovii.css — генерируемая сборка слоя A (tokens/tokens.css) + слоя B (python3 tools/build-lovii-css.py). Сайты получают снапшот с провенансом; править снапшот в сайте = нарушение — правится lovii-design, потом разнос. Новый компонент = css/lovii-components.css + живой образец в examples/08 + docs/09; паритет проверяй скриншот-диффом (scripts/check_lovii_css_parity.py).
Разноска — только фреймворк-циклом. Правка стиля: исходники слоёв → build-lovii-css.py → check-sync.py → commit+push в lovii-design → python3 tools/propagate.py --push (снапшоты + стражи + точечные коммиты/пуши во всех потребителей из tools/targets.json). Коммитится только файл снапшота, никогда -A. Новый сайт на фреймворке = запись в tools/targets.json.

3. Как применять (порядок работы агента)

Прочитай docs/01-principles.md — принципы и приоритет источников.
Для нового экрана: определи роль → возьми каркас из examples/ (01 клиент · 02 бизнес · 03 партнёр · 04 амбассадор · 05 инвестор · 06 UX · 07 тон · 08 библиотека).
Компоненты бери из полного набора — живая библиотека examples/08-components.html (работает на едином lovii.css), реестр и порядок расширения docs/12-components.md; собирай готовыми сниппетами из docs/07-patterns.md; для цвета/текста/геометрии — сверяйся с tokens/tokens.css (значения) и docs/02–04 (правила). Тексты интерфейса (кнопки, тосты, empty, ошибки) — по docs/11-brand-voice.md: голос, матрица тона, словарь, канонические формулировки; текстовая приёмка — checklist §12. Сайт продукта (lovii.ru, лонгрид/white paper) — по docs/13-site-longform.md: класс артефакта, ленточные паттерны, SEO/печать.
Для тем — docs/05 (контракт) + копируй anti-FOUC/applyTheme как есть (есть и в SKILL.md, и в docs/07 §1).
Типовые процедуры (новый токен, приёмка, перенос из легаси) — по рецептам docs/08-recipes.md.
Перед завершением задачи прогони docs/checklist.md — это приёмка.
Если нужного токена нет — предложи токен (имя --lv-* по аналогии), внеси в tokens.css + design-tokens.json + style-guide (пересборка: python3 tools/build-style-guide.py), и только потом используй.
Зафиксируй изменения: CHANGELOG.md (semver) + таблица расхождений (если затронута).

4. Маппинг имён (легаси ↔ канон)

демка css/lovii.css: --pink→--lv-pink, --ink→--lv-ink, --bg→--lv-bg, --card→--lv-card, --surface→--lv-surface, --soft-*→--lv-soft-*, --*-text→--lv-*-text и т.д. (полный список docs/06).
lovii-site globals.css: Tailwind --color-lovii-* и shadcn-слой — вторичны, выводятся из канона; классы bg-lovii-pink/text-lovii-dim использовать вместо сырых значений.
Утилити-классы канона: .brand-gradient, .shadow-soft, .shadow-lift, .lv-enter, .lv-float, .lv-dot, .lv-edge-fade, .no-scrollbar.

5. Что читать дальше

Значения и правила: docs/02-color · 03-typography · 04-space-shape-motion
Темы: docs/05-theming
Интеграция и расхождения: docs/06-application
Компоненты (сниппеты): docs/07-patterns
Анатомия и состояния: docs/09-components
UX-паттерны (scroll, адаптив, PWA, hash): docs/10-ux-patterns
Рецепты типовых задач: docs/08-recipes
Полный набор компонентов: examples/08-components.html + docs/12-components.md
Сайт продукта на каноне: lovii.ru (репозиторий bestdeejay-design/lovii) + docs/13-site-longform.md
Референсы по ролям: examples/README.md
Приёмка: docs/checklist.md
Визуально: style-guide.html (обе темы)

lovii-design

About

AGENTS.md — правила для ИИ-агентов проекта LOVII

1. Карта мира

2. Железные правила (нарушать нельзя)

3. Как применять (порядок работы агента)

4. Маппинг имён (легаси ↔ канон)

5. Что читать дальше

Use it

Manifest

Reviews