iiuniversitet.ruЦентр обучения нейросетямОткрыть каталог

Нешаблонные лендинги и портфолио

Помогает собрать лендинг, портфолио или редизайн, который не выглядит типовым: сначала разбирает бриф, затем выбирает направление и стиль.

Скиллсообщество: LeonxlnxClaudeMITНужен терминалПроверено на безопасность
Что делает
Помогает собрать лендинг, портфолио или редизайн, который не выглядит типовым: сначала разбирает бриф, затем выбирает направление и стиль.
Когда брать
Когда нужно сделать с нуля или переработать лендинг, портфолио, редакционную или маркетинговую страницу так, чтобы она выглядела как работа дизайнера, а не как шаблон.
Когда не брать
Для дашбордов, плотных интерфейсов продукта, таблиц данных, многошаговых форм, редакторов кода и нативных мобильных приложений.
Пример запроса
Сделай лендинг для студии керамики и заодно переработай устаревший сайт-портфолио, чтобы они не выглядели как шаблон.
Нужно подключить
проект на React / Next.js и Tailwind
Работает лучше с
модель генерации изображений, браузер для проверки результата

Как включить

  1. Скачайте архив и распакуйте его.
  2. Положите папку design-taste-frontend в ~/.claude/skills/.
  3. Откройте Claude Code и опишите задачу своими словами: Claude подхватит скилл по описанию.

Текст

---
name: design-taste-frontend
description: Скилл против «шаблонного» фронтенда для лендингов, портфолио и редизайнов. Агент читает бриф, определяет подходящее дизайн-направление и выпускает интерфейсы, которые не выглядят типовыми. Настоящие дизайн-системы там, где они уместны, аудит перед редизайном, строгая предполётная проверка.
---

tasteskill: скилл против шаблонного фронтенда

Лендинги, портфолио и редизайны. Не дашборды, не таблицы данных, не многошаговые интерфейсы продукта. Каждое правило ниже зависит от контекста. Ничего не срабатывает автоматически. Сначала прочитай бриф, потом бери только то, что подходит.


0. ВЫВОД ИЗ БРИФА (сначала пойми, о чём просят)

Прежде чем трогать код или крутить регуляторы, определи, чего на самом деле хочет пользователь. Большинство дизайна, который делают языковые модели, плох потому, что модель сразу прыгает к эстетике по умолчанию, вместо того чтобы понять задачу.

0.A Сначала прочитай эти сигналы

  1. Тип страницы - лендинг (SaaS / потребительский продукт / агентство / событие), портфолио (разработчик / дизайнер / творческая студия), редизайн (сохранить или переделать полностью), редакционная страница / блог.
  2. Слова про настроение, которые использовал пользователь - «минималистично», «спокойно», «в стиле Linear», «как на Awwwards», «брутализм», «премиальный потребительский», «как у Apple», «игриво», «серьёзный B2B», «редакционный», «как у агентств», «стеклянный», «тёмная технологичность».
  3. Референсы - ссылки, которые он дал, скриншоты, которые вставил, продукты, которые назвал, бренды, с которыми конкурирует.
  4. Аудитория - закупочная комиссия B2B, или потребитель с чувством дизайна, или рекрутер, пролистывающий портфолио. Эстетику выбирает аудитория, а не твой вкус.
  5. Уже существующие элементы бренда - логотип, цвет, шрифт, фотографии. В редизайне это исходный материал, а не необязательная вводная (см. раздел 11).
  6. Негласные ограничения - аудитории, для которых важна доступность, госсектор, регулируемые отрасли, торговля, где главное доверие, детские продукты. Эти ограничения ПЕРЕВЕШИВАЮТ эстетические предпочтения.

0.B Перед генерацией выведи однострочное «Прочтение дизайна» (Design Read)

Перед любым кодом сформулируй одной строкой: «Читаю это так: \<тип страницы> для \<аудитория>, язык \<настроение>, склоняюсь к \<дизайн-система или семейство эстетики>.»

Примеры прочтения:

  • *«Читаю это так: SaaS-лендинг для B2B для технических покупателей, язык минимализма в стиле Linear, склоняюсь к утилитам Tailwind + Geist + сдержанной анимации.»*
  • *«Читаю это так: портфолио дизайнера-одиночки для нанимающих менеджеров, язык редакционной / кинетической типографики, склоняюсь к нативному CSS + анимации, управляемой прокруткой, + нестандартной типографике.»*
  • *«Читаю это так: редизайн сайта государственной услуги, язык, где главное доверие, склоняюсь к GOV.UK Frontend или USWDS.»*

0.C Если бриф неоднозначен, задай один вопрос, а не гадай

Задай ровно один уточняющий вопрос - никогда не вываливай сразу несколько - и только тогда, когда прочтения дизайна действительно расходятся. Пример: *«Это должно быть ближе к чистому Linear или к экспериментальному Awwwards?»*

Если можешь уверенно вывести из контекста, не спрашивай. Просто объяви прочтение дизайна и продолжай.

0.D Дисциплина против значений по умолчанию

Не скатывайся к: фиолетовым ИИ-градиентам, центрированному главному экрану (hero) на тёмной сетчатой заливке, трём одинаковым карточкам преимуществ, банальному глассморфизму на всём подряд, бесконечным циклам микроанимаций повсюду, Inter + slate-900. Это значения по умолчанию у языковых моделей. Сознательно выходи за их пределы, опираясь на прочтение дизайна.


1. ТРИ РЕГУЛЯТОРА (основная настройка)

После прочтения дизайна выставь три регулятора (dials). От них зависит каждое решение ниже о вёрстке, анимации и плотности.

  • **DESIGN_VARIANCE: 8** - 1 = идеальная симметрия, 10 = художественный хаос
  • **MOTION_INTENSITY: 6** - 1 = статика, 10 = кинематографичность / физика
  • **VISUAL_DENSITY: 4** - 1 = художественная галерея / воздух, 10 = кабина пилота / плотные данные

Базовые значения: 8 / 6 / 4. Используй их, если прочтение дизайна не требует другого. Не проси пользователя править этот файл - значения меняются в разговоре.

1.A Вывод значений регуляторов (прочтение дизайна → значения)

СигналVARIANCEMOTIONDENSITY
«минималистично / чисто / спокойно / редакционно / в стиле Linear»5-63-42-3
«премиальный потребительский / как у Apple / люкс / бренд»7-85-73-4
«игриво / дико / Dribbble / Awwwards / экспериментально / агентство»9-108-103-4
«лендинг / портфолио / маркетинговый сайт (по умолчанию)»7-96-83-5
«где главное доверие / госсектор / регулируемая отрасль / критична доступность»3-42-34-5
«редизайн - сохранить»как в существующем+1как в существующем
«редизайн - переделать полностью»+2+2как в существующем

1.B Готовые наборы под сценарии

СценарийVARIANCEMOTIONDENSITY
Лендинг (SaaS, массовый)764
Лендинг (агентство / креатив)983
Лендинг (премиальный потребительский)763
Портфолио (дизайнер / студия)873
Портфолио (разработчик)654
Редакционная страница / блог643
Государственная услуга325
Редизайн - сохранитькак естькак есть+1как есть
Редизайн - переделать полностью+2+2как есть

1.C Как регуляторы управляют результатом

Используй эти значения (или те, что переопределил пользователь) как глобальные переменные. Перекрёстные ссылки во всём документе указывают на именно эти имена переменных - никогда не придумывай псевдонимы вроде LAYOUT_VARIANCE или ANIM_LEVEL.


2. КАРТА «БРИФ → ДИЗАЙН-СИСТЕМА»

Когда у тебя есть прочтение дизайна (раздел 0) и регуляторы (раздел 1), выбери подходящую основу. Не изобретай CSS для того, у чего есть официальный пакет. Не выдавай модный эстетический тренд за официальную систему.

2.A Когда брать настоящую дизайн-систему (официальные пакеты)

Бриф читается как…БериПочему
Microsoft / корпоративный SaaS / дашборды@fluentui/react-components или @fluentui/web-componentsОфициальный Fluent UI, токены Microsoft, доступность уже сделана
Интерфейс в духе Google, продукт в стиле Material@material/web + токены Material 3Официально, темы настраиваются через Material Theming
B2B в духе IBM / корпоративная аналитика@carbon/react + @carbon/stylesОфициальный Carbon, отработанные паттерны для плотных данных
Интерфейсы приложений Shopifyвеб-компоненты polaris.js / Polaris ReactОбязательно для админки Shopify
Продукт в духе Atlassian / Jira@atlaskit/* + @atlaskit/tokensОфициальная дизайн-система Atlassian
Девтул в духе GitHub / страница сообщества@primer/css или @primer/react-brandОфициальный Primer; вариант Brand для маркетинга
Государственная услуга Великобританииgovuk-frontendЭтого требуют закон и регуляторы
Госсектор США / где главное довериеuswdsТо же самое
Быстрый MVP для местного бизнеса / агентстваBootstrap 5.3Скучно, быстро, работает
Современная доступная основа на React@radix-ui/themesПримитивы + продуманная тема
Современный SaaS, где компоненты принадлежат тебеshadcn/ui (npx shadcn@latest add ...)Код твой, легко настраивать; никогда не выпускай в состоянии по умолчанию
Современный SaaS на Tailwind / маркетинг ИИ-продуктовУтилиты Tailwind v4 + вариант dark:Вариант по умолчанию для инди-проектов и небольших команд

Правило честности: если бриф читается как одна из систем выше, установи и используй официальный пакет. Не воссоздавай его CSS вручную. Не импортируй токены системы, чтобы потом переопределить 90% из них.

Одна система на проект. Не мешай Fluent React с Carbon в одном дереве. Не импортируй компоненты shadcn/ui в приложение на Material 3.

2.B Когда бриф - это эстетика, а не система

Для этих направлений единого официального пакета нет. Собирай на нативном CSS + Tailwind + поддерживаемой библиотеке компонентов. Честно пиши в комментариях к коду, что заимствовано как вдохновение, а что - официальный материал.

ЭстетикаЧестная реализация
Глассморфизм / «матовое стекло»backdrop-filter, многослойные рамки, подсвечивающие слои. Дай запасной вариант со сплошной заливкой для prefers-reduced-transparency.
Бенто (плиточные сетки как у Apple)CSS Grid с ячейками разного размера. Единой библиотеки нет.
БрутализмНативный CSS, моноширинный шрифт, грубые рамки. Без библиотек.
Редакционный / журнальныйШрифт с засечками, асимметричная сетка, много пустого пространства. Без библиотек.
Тёмная технологичность / хакерский стильМоноширинный шрифт + неоновый акцент, мотивы терминала. Без библиотек.
Аврора / сетчатые градиентыSVG или наложенные радиальные градиенты. Без библиотек.
Кинетическая типографикаНативные CSS-анимации, анимации, управляемые прокруткой, GSAP для перехвата прокрутки. Без библиотек.
Apple Liquid GlassApple документирует это только для платформ Apple. **Официального liquid-glass.css не существует.** Веб-реализации - это приближения на backdrop-filter + многослойные рамки + блики. Явно подписывай как приближение.

3. АРХИТЕКТУРА И СОГЛАШЕНИЯ ПО УМОЛЧАНИЮ

Если прочтение дизайна не выбрало настоящую дизайн-систему (раздел 2.A), по умолчанию действует следующее:

3.A Стек

  • Фреймворк: React или Next.js. По умолчанию - серверные компоненты (RSC).
  • БЕЗОПАСНОСТЬ RSC: глобальное состояние работает ТОЛЬКО в клиентских компонентах. В Next.js оборачивай провайдеры в компонент с "use client".
  • ИЗОЛЯЦИЯ ИНТЕРАКТИВНОСТИ: любой компонент, который использует Motion, слушатели прокрутки или физику указателя, ДОЛЖЕН быть отдельным листовым компонентом с 'use client' в первой строке. Серверные компоненты отрисовывают только статичную вёрстку.
  • Стили: Tailwind v4 (по умолчанию). Tailwind v3 - только если этого требует существующий проект.
  • Для v4: НЕ используй плагин tailwindcss в postcss.config.js. Используй @tailwindcss/postcss или плагин для Vite.
  • Анимация: Motion (библиотека, раньше известная как Framer Motion). Импортируй из motion/react (import { motion } from "motion/react"). Пакет framer-motion всё ещё работает как устаревший псевдоним - в новом коде предпочитай motion/react.
  • Шрифты: всегда используй next/font (Next.js) или размещай у себя через @font-face + font-display: swap. Никогда не подключай Google Fonts через <link> в продакшене.

3.B Состояние

  • Локальные useState / useReducer - для изолированных частей интерфейса.
  • Глобальное состояние - ТОЛЬКО чтобы не протаскивать свойства через много уровней: Zustand, Jotai или контекст React.
  • НИКОГДА не используй useState для непрерывных значений, которые задаёт пользователь (положение мыши, прогресс прокрутки, физика указателя, магнитное наведение). Используй useMotionValue / useTransform / useScroll из Motion. useState заново отрисовывает дерево React при каждом изменении и «складывается» на мобильных.

3.C Иконки

  • Разрешённые библиотеки (по приоритету): @phosphor-icons/react, hugeicons-react, @radix-ui/react-icons, @tabler/icons-react.
  • Не рекомендуется: lucide-react. Допустима, только если пользователь прямо попросил или проект уже от неё зависит.
  • НИКОГДА не рисуй SVG-иконки вручную. Если нужного значка нет, поставь вторую библиотеку или собери из примитивов - не вычерчивай контуры иконок с нуля.
  • Одно семейство на проект. Не смешивай Phosphor с Lucide в одном дереве компонентов.
  • **Задай единую толщину линии (strokeWidth) глобально** (например, 1.5 или 2.0).

3.D Политика по эмодзи

По умолчанию эмодзи не рекомендуются в коде, разметке и видимом тексте. Заменяй символы значками из библиотеки иконок. Исключение: разрешай эмодзи, только если пользователь прямо попросил игривую / чатовую / родную для соцсетей атмосферу - и даже тогда используй их скупо и осмысленно.

3.E Адаптивность и механика вёрстки

  • Стандартизируй точки перелома (sm 640, md 768, lg 1024, xl 1280, 2xl 1536).
  • Ограничивай ширину страницы через max-w-[1400px] mx-auto или max-w-7xl.
  • Стабильность области просмотра: НИКОГДА не используй h-screen для главного экрана (Hero) на всю высоту. ВСЕГДА используй min-h-[100dvh], чтобы вёрстка не прыгала на мобильных (адресная строка iOS Safari).
  • Сетка вместо арифметики на flex: НИКОГДА не считай проценты сложной математикой flexbox (w-[calc(33%-1rem)]). ВСЕГДА используй CSS Grid (grid grid-cols-1 md:grid-cols-3 gap-6).

3.F Проверка зависимостей (обязательно)

Прежде чем импортировать ЛЮБУЮ стороннюю библиотеку, проверь package.json. Если пакета нет, сначала выведи команду установки. Никогда не считай, что библиотека есть.


4. ДИЗАЙНЕРСКИЕ ПРАВИЛА ИНЖЕНЕРИИ (исправление перекосов)

Языковые модели по умолчанию скатываются в клише. Заранее переопределяй эти значения по умолчанию. У каждого правила есть путь исключения, зависящий от контекста.

4.1 Типографика

  • Крупные заголовки (Display / Headlines): по умолчанию text-4xl md:text-6xl tracking-tighter leading-none.
  • Основной текст / абзацы: по умолчанию text-base text-gray-600 leading-relaxed max-w-[65ch].
  • Выбор рубленого шрифта:
  • Не рекомендуется как вариант по умолчанию: Inter. Сначала выбирай Geist, Outfit, Cabinet Grotesk, Satoshi или шрифт с засечками, подходящий бренду.
  • Исключение: Inter допустим, когда пользователь прямо просит нейтральное / стандартное / в стиле Linear ощущение или когда бриф - сайт госсектора / сайт, где доступность на первом месте.
  • Пары шрифтов, которые стоит знать: Geist + Geist Mono, Satoshi + JetBrains Mono, Cabinet Grotesk + Inter Tight, GT America + IBM Plex Mono.
  • ДИСЦИПЛИНА С ЗАСЕЧКАМИ (ОЧЕНЬ НЕ РЕКОМЕНДУЕТСЯ КАК ВАРИАНТ ПО УМОЛЧАНИЮ):
  • Шрифт с засечками очень не рекомендуется как шрифт по умолчанию для любого проекта. «Ощущается творческим / премиальным / редакционным» - НЕ повод тянуться к засечкам. Привычная схема агента «творческий бриф = шрифт с засечками» - самый частый признак ИИ в боевых прогонах.
  • Шрифт с засечками допустим, только если явно верно ОДНО из двух:
  • В брифе бренда буквально назван шрифт с засечками, ИЛИ
  • Семейство эстетики действительно редакционное / люксовое / издательское / рукописное / традиционное / винтажное, И ты можешь объяснить, почему именно этот шрифт с засечками подходит именно этому бренду
  • Для всего остального (креативное агентство, студия дизайна, современный бренд, премиальный потребительский продукт, портфолио, лайфстайл) по умолчанию - рубленый шрифт для крупных заголовков (Geist Display, ABC Diatype, Söhne Breit, Cabinet Grotesk Display, Migra Sans, GT Walsheim, Inter Display, PP Neue Montreal). Рубленые шрифты для заголовков не «скучны» - они вариант по умолчанию по той же причине, по какой чёрный цвет - вариант по умолчанию в моде.
  • ПРАВИЛО АКЦЕНТА (связанное): когда хочешь выделить слово внутри заголовка (кинетический приём вроде «and spatial design»), используй курсив или жирное начертание ТОГО ЖЕ шрифта. НЕ вставляй случайное слово с засечками в рубленый заголовок (или наоборот) ради визуального интереса. Выделение шрифтом другого семейства - любительство. Курсив или жирное начертание в том же семействе - правильный ход.
  • КОНКРЕТНО ЗАПРЕЩЕНЫ как варианты по умолчанию: Fraunces и Instrument_Serif (два любимых у языковых моделей шрифта с засечками для заголовков).
  • Если шрифт с засечками оправдан (редкий случай, см. выше), выбирай из этого списка и НЕ используй один и тот же шрифт в нескольких проектах подряд: PP Editorial New, GT Sectra Display, Cardinal Grotesque, Reckless Neue, Tiempos Headline, Recoleta, Cormorant Garamond, Playfair Display, EB Garamond, IvyPresto, Migra, Editorial Old, Saol Display, Söhne Breit Kursiv, Domaine Display, Canela, Schnyder, Tobias, NB Architekt, ITC Galliard.
  • ЗАПАС ПОД ВЫНОСНЫЕ ЭЛЕМЕНТЫ КУРСИВА (обязательно): когда курсив используется в крупном шрифте и в слове есть буква с нижним выносным элементом (y g j p q), leading-[1] или leading-none обрежут этот элемент. Используй минимум leading-[1.1] и добавь запас pb-1 или mb-1 на оборачивающем элементе. Перед выпуском проверь каждое курсивное слово в крупных заголовках.

4.2 Калибровка цвета

  • Максимум 1 акцентный цвет. Насыщенность по умолчанию < 80%.
  • ПРАВИЛО ЛИЛОВОГО (THE LILA RULE): эстетика «фиолетового / синего свечения ИИ» не рекомендуется как вариант по умолчанию. Никакого автоматического фиолетового свечения кнопок, никаких случайных неоновых градиентов. Используй нейтральные основы (Zinc / Slate / Stone) с контрастными одиночными акцентами (изумрудный, электрический синий, глубокая роза, жжёный оранжевый и т. п.).
  • Исключение: если бренд или бриф прямо просит фиолетовый / лиловый, принимай его. Но делай осмысленно: единая палитра, согласованные нейтральные, сдержанные градиенты. Не типовой слоп из ИИ-градиентов.
  • Одна палитра на проект. Не колеблись между тёплыми и холодными серыми в одном проекте.
  • ФИКСАЦИЯ ЦВЕТОВОЙ ПОСЛЕДОВАТЕЛЬНОСТИ (обязательно): выбранный для страницы акцентный цвет используется на ВСЕЙ странице. Сайт в тёплых серых тонах не получает вдруг синюю кнопку призыва к действию в блоке 7. Сайт с розовым акцентом не получает бирюзовый статусный бейдж в подвале. Выбери один акцент, зафиксируй его, проверь каждый компонент перед выпуском.
  • ЗАПРЕТ НА ПАЛИТРУ «ПРЕМИАЛЬНОГО ПОТРЕБИТЕЛЯ» (обязательно, второй по частоте признак ИИ):
  • Для брифов премиального потребительского сегмента (посуда, велнес, ремесленные товары, люкс, традиционное ремесло, товары для дома напрямую от бренда и т. п.) языковая модель по умолчанию выбирает тёплый бежевый/кремовый + латунь/глину/цвет бычьей крови/охру + эспрессо/чернильный тёмный текст. Конкретно запрещены как фоны и акценты по умолчанию такие семейства hex-значений:
  • Фоны: #f5f1ea, #f7f5f1, #fbf8f1, #efeae0, #ece6db, #faf7f1, #e8dfcb (всё это «тёплая бумага / крем / мел / слоновая кость»)
  • Акценты: #b08947, #b6553a, #9a2436, #9c6e2a, #bc7c3a, #7d5621 (всё это «латунь / глина / цвет бычьей крови / охра»)
  • Текст: #1a1714, #1a1814, #1b1814 (всё это «эспрессо / тёплый почти-чёрный»)
  • Эта палитра ЗАПРЕЩЕНА как вариант по умолчанию для брифов премиального потребительского сегмента. Каждый премиальный потребительский сайт, который ты когда-либо выпускал, использует именно эту палитру. Бренд становится невидимым.
  • Альтернативы по умолчанию (чередуй, не повторяй):
  • Холодная роскошь: серебристо-серый + хром + дымчатый (вспомни Tesla, Apple Watch Hermès без кожи)
  • Лес: глубокий зелёный + слоновая кость + янтарный акцент (вспомни Filson, премиум-линию Patagonia)
  • Чёрный и бежевый-тан: настоящий не совсем чёрный + тёплый тан, резкий контраст, никакого бежевого
  • Кобальт + крем: насыщенный синий на одном нейтральном фоне, без латуни
  • Терракота + сланец: тёплая ржавчина на холодном сером, без латуни
  • Олива + кирпич + бумага: приглушённая олива и кирпично-красный акцент
  • Чистая монохромия + один насыщенный всплеск: не совсем белый + не совсем чёрный + один яркий акцент (электрический синий, изумрудный, ярко-розовый и т. п.)
  • Правило ротации палитры: если в предыдущем премиальном потребительском проекте использовалось семейство «бежевый + латунь», в этом ОБЯЗАТЕЛЬНО должно быть другое семейство. Не выпускай одну и ту же тёплую ремесленную палитру дважды подряд.
  • Исключение: палитра «бежевый + латунь + эспрессо» допустима ТОЛЬКО когда бриф бренда прямо называет эти цвета или когда айдентика бренда действительно винтажная / ремесленная / тёплая-ремесленная, И ты можешь объяснить, почему именно эта палитра подходит именно этому бренду. Тянуться к ней по умолчанию, потому что «это бриф про посуду», запрещено.

4.3 Разнообразие вёрстки

  • ПРОТИВ ЦЕНТРОВАНИЯ: центрированный главный экран (Hero) / H1 не используется при DESIGN_VARIANCE > 4. Принудительно бери «разделённый экран» (50/50), «содержимое слева / картинка справа», «асимметричное пустое пространство» или структуры с закреплением при прокрутке.
  • Исключение: центрированный главный экран допустим в брифах-манифестах, редакционных и анонсах запуска, где само сообщение и есть дизайн.

4.4 Материальность, тени, карточки

  • Используй карточки ТОЛЬКО когда возвышение передаёт настоящую иерархию. В остальных случаях группируй через border-t, divide-y или пустое пространство.
  • Если используешь тень, подкрась её под оттенок фона. Никаких чисто чёрных падающих теней на светлом фоне.
  • При VISUAL_DENSITY > 7: типовые контейнеры-карточки запрещены. Показатели с данными дышат в простой вёрстке.
  • ФИКСАЦИЯ ЕДИНСТВА ФОРМЫ (обязательно): выбери ОДНУ шкалу скруглений для страницы и держись её. Варианты: всё острое (радиус 0), всё мягкое (радиус 12-16px), всё «таблетки» (полное скругление для интерактивных элементов). Смешанные системы допустимы, только если есть задокументированное правило (например, «кнопки - полные таблетки, карточки - 16px, поля ввода - 8px») и оно соблюдается везде. Круглые кнопки в квадратной вёрстке или квадратные карточки на странице с кнопками-таблетками - сломанный дизайн.

4.5 Интерактивные состояния интерфейса

Языковые модели по умолчанию делают «только статичное успешное состояние». Всегда реализуй полные циклы:

  • Загрузка: заглушки-скелеты (skeleton), повторяющие форму итоговой вёрстки. Избегай типовых круглых спиннеров.
  • Пустые состояния: красиво оформлены; показывают, как это заполнить.
  • Состояния ошибки: понятные, встроенные (в формах) или контекстные (уведомления-тосты только для временных событий).
  • Тактильная обратная связь: на :active используй -translate-y-[1px] или scale-[0.98], чтобы имитировать физическое нажатие.
  • ПРОВЕРКА КОНТРАСТА КНОПОК (обязательно, доступность): перед выпуском любой кнопки убедись, что текст кнопки читается на её фоне. Белая кнопка + белый текст, призыв к действию с bg-white и подписью text-white, прозрачная кнопка на фоне страницы без рамки → всё это запрещено. Проверь каждый призыв к действию: коэффициент контраста минимум по WCAG AA (4.5:1 для основного текста, 3:1 для крупного текста 18px+). То же правило касается «призрачных» кнопок поверх фотографий (используй подложку, затемнение или обводку).
  • ЗАПРЕТ НА ПЕРЕНОС ТЕКСТА КНОПКИ (обязательно): текст кнопки ДОЛЖЕН помещаться в одну строку на десктопе. Если подпись вроде «VIEW SELECTED WORK» переносится на 2 или 3 строки, кнопка сломана. Исправь ЛИБО сокращением подписи (максимум 3 слова для основных призывов к действию, лучше 1-2), ЛИБО расширением кнопки (не ограничивай искусственно max-width у призывов к действию). Перенесённые на десктопе призывы к действию - провал предполётной проверки (Pre-Flight Fail).
  • НИКАКИХ ДУБЛЕЙ НАМЕРЕНИЯ В ПРИЗЫВАХ (обязательно): два призыва к действию с одним и тем же намерением на одной странице - провал предполётной проверки. Примеры одного намерения: «Get in touch» + «Contact us» + «Let's talk» + «Start a project» + «Start something» + «Reach out» = всё это намерение «связаться» → выбери ОДНУ подпись и используй её везде на странице (навигация, главный экран, подвал). То же для «Try free» + «Get started» + «Sign up free» (всё это намерение «зарегистрироваться») и «View work» + «See selected work» + «Browse projects» (всё это намерение «портфолио»). Одна подпись на одно намерение.
  • ПРОВЕРКА КОНТРАСТА ФОРМ (обязательно, доступность): поля ввода, текст-подсказки (placeholder), кольца фокуса, вспомогательный текст и текст ошибок — всё проходит контраст WCAG AA относительно фона блока. Светлые подсказки на почти белой форме, белая форма на белом блоке страницы, подписи полей с контрастом ниже 4.5:1 → всё это запрещено. Проверь каждую форму перед выпуском.

4.6 Паттерны для данных и форм

  • Подпись НАД полем. Вспомогательный текст необязателен, но присутствует в разметке. Текст ошибки ПОД полем. Стандартный gap-2 для блоков ввода.
  • Никакого текста-подсказки вместо подписи. Никогда.

4.7 Дисциплина вёрстки (жёсткие правила. Нарушить любое - значит выпустить сломанную работу)

  • Главный экран (Hero) ДОЛЖЕН помещаться в начальную область просмотра. Заголовок максимум 2 строки на десктопе, подтекст максимум 20 слов И максимум 3-4 строки, призывы к действию видны без прокрутки. Если текста слишком много: уменьши шкалу шрифта ИЛИ сократи текст. Если ты не можешь описать ценностное предложение подтекстом в 20 слов, неясно само ценностное предложение, а не правило слишком тесное. Никогда не позволяй главному экрану переполняться и заставлять прокручивать, чтобы найти призыв к действию.
  • Дисциплина размера шрифта на главном экране. Планируй размер шрифта и размер картинки *вместе*. Если картинка главного экрана большая, а заголовок длиннее 6 слов, не начинай с text-7xl/text-8xl. Разумный диапазон по умолчанию: text-4xl md:text-5xl lg:text-6xl для большинства главных экранов; text-6xl md:text-7xl только когда заголовок из 3-5 слов. Заголовок главного экрана в 4 строки - всегда ошибка размера шрифта, никогда не ошибка длины текста.
  • ПОТОЛОК ВЕРХНЕГО ОТСТУПА ГЛАВНОГО ЭКРАНА (обязательно): верхний отступ главного экрана на десктопе максимум pt-24 (≈6rem). Больше - и содержимое главного экрана повисает на середине области просмотра и читается как ошибка вёрстки, а не как намеренное пространство. Если главному экрану нужно больше воздуха, увеличивай шкалу шрифта или размер картинки, а не верхний отступ.
  • ДИСЦИПЛИНА СТЕКА ГЛАВНОГО ЭКРАНА (максимум 4 текстовых элемента). Главный экран - это один момент, а не список возможностей. Допустимые текстовые элементы, максимум 4 в сумме:
  • Надзаголовок (eyebrow; маленькая подпись заглавными буквами) ИЛИ полоса бренда ИЛИ ничего - выбери ноль или один
  • Заголовок (максимум 2 строки, см. выше)
  • Подтекст (максимум 20 слов, максимум 4 строки)
  • Призывы к действию (1 основной + максимум 1 второстепенный)
  • ЗАПРЕЩЕНО на главном экране: мелкая строка под призывами к действию («Работает с GitHub, GitLab и самостоятельно размещённым Git»), полоса доверия («Используют инженерные команды в...»), тизер цены («Бесплатно для одиночек, $10 на пользователя для команд»), маркированный список возможностей, ряд аватарок как социальное доказательство. Всё это переезжает в отдельные блоки сразу под главным экраном.
  • Если на одном главном экране есть и надзаголовок, и строка под призывами, убери строку. Если есть и полоса бренда, и строка, убери строку. Один маленький текстовый элемент на главный экран, максимум.
  • Стена логотипов «Нам доверяют» / «Используют» находится ПОД главным экраном, никогда не внутри него. Главный экран - для ценностного предложения и основного призыва к действию. Стена логотипов - отдельный блок сразу ниже. Не пихай логотипы доверия в тот же flex-ряд, что и текст главного экрана.
  • Навигация ДОЛЖНА отображаться в одну строку на десктопе. Если пункты не помещаются при lg (1024px), сократи подписи, убери второстепенные пункты или перенеси в гамбургер-меню. Двухстрочная навигация на десктопе - сломанный дизайн.
  • Потолок высоты навигации: максимум 80px на десктопе, по умолчанию 64-72px. Никаких огромных «агентских» панелей навигации, съедающих 15% области просмотра.
  • У бенто-сеток ДОЛЖЕН быть ритм, а не однобокое повторение. Не складывай 6 рядов «картинка слева / текст справа». Варьируй композицию: чередуй ряды на всю ширину, плитки разного размера, вертикальные разрывы.
  • ПРАВИЛО ЧИСЛА ЯЧЕЕК БЕНТО (обязательно): в бенто-сетке РОВНО столько ячеек, сколько у тебя содержимого. 3 элемента → 3 ячейки (разбивка 1+2, или 2+1, или асимметричная тройка). 5 элементов → 5 ячеек (2+3, 3+2, главная+4 и т. п.). Если в сетке пустая ячейка посередине или в конце, ты спланировал неправильно. Перестрой сетку; не вставляй пустую плитку.
  • Запрет на повтор семейства вёрстки между блоками. Если ты использовал семейство вёрстки для блока (например, карточки-картинки в 3 колонки, цитата на всю ширину, разделённый текст-картинка), это семейство может появиться на странице максимум ОДИН раз. «Избранные заказы» не должны выглядеть как «Чем мы занимаемся». Лендинг из 8 блоков должен использовать минимум 4 разных семейства вёрстки.
  • ПОТОЛОК ЗИГЗАГООБРАЗНОГО ЧЕРЕДОВАНИЯ (обязательно). Зигзаг «картинка слева + текст справа», затем «текст слева + картинка справа» - банально. Максимум 2 блока подряд с таким разделением на картинку и текст. Третий подряд блок «картинка + текст» - провал предполётной проверки. Разорви шаблон блоком на всю ширину, блоком с вертикальной стопкой, бенто-сеткой, бегущей строкой (marquee) или другим семейством вёрстки.
  • СДЕРЖАННОСТЬ С НАДЗАГОЛОВКАМИ (обязательно, правило №1, которое чаще всего нарушают в боевых прогонах). Надзаголовок (eyebrow) - это маленькая подпись заглавными буквами с широким трекингом над заголовком блока (например, FOUR COLORWAYS, SELECTED WORK, THE HARDWARE, Git-native task management). Типичная CSS-подпись: text-[11px] uppercase tracking-[0.18em], font-mono text-[10.5px] uppercase tracking-[0.22em]. Каждый сайт, собранный ИИ, ставит надзаголовок над КАЖДЫМ заголовком блока, получая один и тот же шаблонный ритм. Жёсткое правило:
  • Максимум 1 надзаголовок на 3 блока. Главный экран считается за 1. То есть на странице из 9 блоков допускается максимум 3 надзаголовка в сумме.
  • Если у блока A есть надзаголовок, у следующих 2 блоков его быть не может.
  • Предполётная проверка механическая: посчитай вхождения uppercase tracking (или похожих маленьких моноширинных подписей капителью над заголовками) во всех компонентах блоков. Если число > ceil(числоБлоков / 3), результат не проходит.
  • Что делать вместо надзаголовка: убрать его совсем. Заголовка достаточно. Если нужно отнести блок к категории, место блока на странице уже его категоризует; подпись не нужна.
  • ЗАПРЕТ РАЗДЕЛЁННОГО ЗАГОЛОВКА БЛОКА (обязательно). Паттерн «слева большой заголовок + справа маленький поясняющий абзац» в роли шапки блока (слева col-span-7/8, справа col-span-4/5 с маленьким абзацем, повисшим в правой колонке) запрещён по умолчанию. У блока должно быть ОДНО сфокусированное сообщение. Если тебе действительно нужны и заголовок, и поясняющий абзац, ставь их вертикально (заголовок сверху, текст ниже, максимум 65ch). Обращайся к разделённой шапке, только если есть настоящая композиционная причина (например, правая колонка несёт визуальный или интерактивный элемент, а не просто текст-заполнитель).
  • Разнообразие фонов в бенто (обязательно). Бенто-блоки и блоки сеток возможностей не могут быть 6 белых карточек на белом с текстом внутри. Минимум 2-3 ячейки в любой многоячеистой сетке должны иметь настоящее визуальное отличие: настоящую картинку, градиент, подходящий бренду (не ИИ-фиолетовый), узор, подкрашенный фон. Кремовое на кремовом бенто с одной только типографикой внутри читается как скучное ИИ-значение по умолчанию, даже если остальная страница хороша.
  • Мобильное схлопывание должно быть явным для каждого блока. Для каждой многоколоночной вёрстки объяви запасной вариант для < 768px в том же компоненте. Никаких допущений вроде «заработает, Tailwind сам справится».

4.8 Стратегия картинок и визуальных материалов

Лендинги и портфолио - это визуальные продукты. Страницы из одного текста с div-ами, изображающими фальшивые скриншоты, - слоп.

Порядок приоритета для визуальных материалов:

  1. Сначала инструмент генерации изображений. Если в среде есть ЛЮБОЙ инструмент генерации изображений (generate_image, MCP-инструмент для изображений, встроенная в IDE генерация, инструменты изображений OpenAI и т. п.), ты ОБЯЗАН использовать его для создания материалов под конкретные блоки: фотография главного экрана, предметные снимки, фоны-текстуры, настроенческие изображения. Генерируй в правильном соотношении сторон для блока. Не пропускай этот шаг на том основании, что CSS вручную кажется быстрее.
  2. Затем настоящие картинки из сети. Когда инструмента генерации нет, используй источники настоящих фотографий. Допустимые варианты по умолчанию:
  3. https://picsum.photos/seed/{descriptive-seed}/{w}/{h} для фото-заглушек (seed должен описывать блок, например marrow-cookware-kitchen)
  4. Настоящие адреса стоковых или брендовых изображений, когда их даёт бриф
  5. Источники с открытой лицензией (Unsplash по прямому адресу, Pexels), если это прямо разрешено
  6. Крайняя мера: скажи пользователю. Если невозможно ни то, ни другое, НЕ заполняй страницу нарисованными вручную SVG-иллюстрациями или «фальшивыми скриншотами» на div-ах. Вместо этого оставь чётко подписанные места-заглушки (<!-- TODO: hero product photo, 1600x1200 -->) и в конце ответа напиши: *«Этой странице нужны настоящие изображения в местах: \[список мест\]. Сгенерируйте или предоставьте их.»*

Даже минималистичным сайтам нужны настоящие изображения. Страница из одного текста - не минимализм. Это незавершённая работа. Даже редакционному сайту в стиле Linear нужно минимум 2-3 настоящих изображения (главный экран, один предметный/лайфстайл-снимок, одно поддерживающее изображение). Если бриф сдержанный, генерируй чёрно-белую минималистичную фотографию; не пропускай изображения целиком только потому, что регулятор низкий.

Настоящие логотипы компаний для социального доказательства. Когда бриф требует стену логотипов «Нам доверяют / Используют / Клиенты», НЕ скатывайся к простым текстовым словесным знакам (<span>Acme Co</span>, оформленным в ряд). Используй настоящие SVG-логотипы:

  • Источник: Simple Icons (https://cdn.simpleicons.org/{slug}/ffffff для любого цвета или npm-пакет simple-icons). Покрывает большинство известных брендов.
  • Альтернатива: devicon для логотипов технологического стека (@svgr/cli или CDN).
  • Придумал название бренда? Тогда придумай и SVG-знак. Сгенерируй простую монограмму (одна буква в круге, лигатура из двух букв, абстрактный знак), отрисованную встроенным <svg> в стиле страницы. Простые текстовые словесные знаки для выдуманных брендов выглядят типово.
  • Всегда проверяй, что логотипы отображаются и в светлой, и в тёмной теме (белый на тёмном, чёрный на светлом или одноцветная переменная темы).
  • Правило «ТОЛЬКО ЛОГОТИП» (обязательно): стена логотипов = логотипы и больше ничего. НЕ печатай под каждым логотипом подписи отрасли / категории (никаких Vercel + hosting снизу, Stripe + payments, Cloudflare + infra). Доверие создаёт логотип, подпись не добавляет того, чего пользователь и так не знает. По желанию: название бренда как альтернативный текст для программ экранного чтения, по желанию ссылка на сайт бренда. Это всё.

Иллюстрации, нарисованные вручную:

  • SVG-иконки из библиотек: нормально (см. раздел 3.C).
  • Декоративные SVG, нарисованные вручную (собственные иллюстрации, логотипы, знаки): настоятельно не рекомендуются, никогда не по умолчанию. Допустимы, только когда:
  • Бриф прямо этого требует («нарисуй мне SVG-логотип»)
  • Это один простой геометрический знак (квадрат, круг, словесный знак крупным шрифтом)
  • Ты уверен в качестве результата

Фальшивые скриншоты на div-ах запрещены. «Собранный вручную предпросмотр продукта», нарисованный прямоугольниками <div>, с фальшивыми списками задач, фальшивыми дашбордами, фальшивыми окнами терминала - это признак ИИ (Tell). Если нужно показать продукт:

  • Используй адрес настоящего скриншота, если он есть
  • Сгенерируй его инструментом для изображений
  • Используй настоящий предпросмотр компонента (реальную мини-версию интерфейса внутри страницы)
  • Или вообще пропусти предпросмотр и используй редакционную фотографию

Главному экрану нужен настоящий визуальный образ. Текст + градиентное пятно - это не главный экран, а заглушка.

4.9 Плотность содержимого

Лендинги живут первым впечатлением, а не полным прочтением. Режь безжалостно.

  • Форма содержимого блока по умолчанию: короткий заголовок (≤ 8 слов) + короткий подабзац (≤ 25 слов) + один визуальный материал ИЛИ один призыв к действию. Всё, что сверх этого, должно быть оправдано задачей блока.
  • Никаких блоков-свалок данных. Таблица из 20 публикаций, список из 30 наград, гигантская матрица цен на маркетинговой странице - неверная вёрстка. Используй:
  • 3-5 главных пунктов + ссылку «Смотреть полный список»
  • Бегущую строку / карусель для демонстрации широты
  • Вообще другую страницу, если данные и есть продукт
  • Длинным спискам нужен другой компонент интерфейса, а не более длинный список. Обычный <ul> с маркерами / рядами divide-y - ленивый выбор. Если пунктов > 5, возьми вместо него одно из этого:
  • Разделение на 2 колонки со сгруппированными пунктами
  • Сетку карточек с картинкой + подписью на каждый пункт
  • Вкладки / аккордеон, если пункты делятся на категории
  • Горизонтальные «таблетки» с привязкой при прокрутке (scroll-snap)
  • Карусель для списков, где важна широта (отзывы, логотипы, возможности)
  • Бегущую строку для «много всего, на чём не нужно задерживаться по отдельности» Спецификация из 10 строк с тонкой линией под каждой строкой - ХУДШИЙ вариант по умолчанию. Либо сгруппируй строки в 2-3 блока с редкими разделителями, либо перейди к вёрстке «карточка на каждую характеристику».
  • Таблицы характеристик отдельно (паттерн Marrow-cookware). Длинная таблица технических характеристик продукта с border-b на каждой строке - ИИ-вариант по умолчанию для брифов про посуду / технику / одежду / ремесленные товары. Запрещено. Конкретные альтернативы:
  • Сетка карточек в 2 колонки: у каждой характеристики своя карточка с названием, значением (крупное число) и однострочным пояснением «почему это важно». Карточки в 2 колонки на десктопе, в 1 колонку на мобильном.
  • Горизонтальные «таблетки» со scroll-snap: каждая характеристика - «таблетка», пользователь может пролистывать их жестом.
  • Сгруппированные блоки: сгруппируй 10 характеристик в 3 логических кластера (например, «Материалы», «Готовка», «Гарантия»), у каждого кластера ОДИН мягкий разделитель и заголовок кластера.
  • Главные против остальных: 3-4 главные характеристики показаны крупными плитками, остальные свёрнуты под раскрывающимся пунктом «Смотреть все характеристики».
  • САМОПРОВЕРКА ТЕКСТА (обязательно перед выпуском): прежде чем объявить любую задачу выполненной, перечитай каждую видимую строку на странице (заголовки, подзаголовки, надзаголовки, подписи кнопок, основной текст, подписи к картинкам, альтернативный текст, текст подвала, сообщения об ошибках). Отметь любую строку, которая:
  • Грамматически сломана («free on its past», «two plans but one is honest», «to put it on the table» вне контекста)
  • Имеет неясные отсылки («we plan to stay that way» без предшествующего контекста)
  • Звучит как галлюцинация ИИ (милая, но неверная игра слов, натянутые метафоры, которые ни к чему не привязаны, фразы «элегантное ничто»)
  • Читается как языковая модель, пытающаяся казаться вдумчивой (пассивно-агрессивная скромность, фальшивые «ремесленные» ярлыки, пародийно-поэтические микро-метазаметки) Перепиши каждую отмеченную строку. Если не уверен, имеет ли строка смысл, замени её простым функциональным предложением. Милый текст, сгенерированный ИИ, хуже скучного текста.
  • Фальшиво-точные числа отмечаются. Числа вроде 92%, 4.1×, 48k, 5.8 mm, 13.4 lb либо:
  • Взяты из настоящих данных (бриф, руководство по бренду, публичные метрики) - нормально
  • Прямо помечены как условные (<!-- mock -->, «пример», «образец данных») - нормально
  • Придуманы ИИ ради эстетики спецификаций - запрещены. Не изображай инженерную точность, которую бренд не заявляет.
  • Один регистр текста на страницу. Не мешай технический моноширинный стиль («47 tasks · 0.6 ctx-switches/day»), редакционную прозу и маркетинговый напор в одной композиции, если голос бренда прямо этого не требует.

4.10 Цитаты и отзывы

  • Максимум 3 строки текста цитаты. Никогда не 6. Если исходная цитата длиннее → сократи её. Цитата на лендинге - это фрагмент, а не весь отзыв.
  • Для очень мелких размеров шрифта (например, отзывы в стиле подвала) предел строк можно немного растянуть. Суть: «помещается в один взгляд».
  • Никаких длинных тире внутри текста цитаты как дизайнерского приёма (долгие паузы, кинетические длинные тире, длинные тире вместо маркеров). См. раздел 9.G - длинное тире запрещено полностью.
  • Подпись: имя + должность + (по желанию) компания. Никогда только имя («- Sarah»).
  • Кавычки: используй настоящие типографские кавычки ( " " ) или никаких. Не прямые ASCII-кавычки ( " ).

4.11 Фиксация темы страницы (единство светлой / тёмной темы)

У страницы ОДНА тема. Блоки не инвертируются.

  • Если страница в тёмной теме, ВСЕ блоки в тёмной теме. Никакого блока в светлой теме с тёплой бумагой, зажатого между тёмными блоками (или наоборот). У пользователя не должно возникать ощущения, что посреди прокрутки он попал на другой сайт.
  • Исключение: если бриф прямо требует приём «История цветовых блоков» (Color Block Story) или «Смена темы при прокрутке» И это намеренная композиция (одна полная смена темы с сильным переходом, а не случайное чередование), его можно использовать один раз на страницу.
  • Поведение по умолчанию: выбери светлую, тёмную или автоматическую (prefers-color-scheme) тему на уровне страницы и зафиксируй её. Оттенки фона блоков внутри одного семейства темы допустимы (bg-zinc-950 рядом с bg-zinc-900); переключение на bg-amber-50 посреди страницы на bg-zinc-950 - сломанный дизайн.
  • Когда используешь дизайн-систему со встроенными темами (Radix Themes, shadcn/ui с <Theme>), задай тему ОДИН раз в layout.tsx или в корне страницы. Не позволяй отдельным блокам её переопределять.

5. ПРОАКТИВНОСТЬ С УЧЁТОМ КОНТЕКСТА

Это инструменты, а не значения по умолчанию. Используй их, когда этого требует прочтение дизайна. Ничто из этого не срабатывает автоматически.

  • Liquid Glass / глассморфизм: подходит для премиального потребительского продукта, всего, что рядом с Apple, люксового бренда или оверлеев поверх медиа. Не подходит для дашбордов, госсектора или «скучного B2B». Если используешь, иди дальше backdrop-blur: добавь внутреннюю рамку в 1px (border-white/10) и лёгкую внутреннюю тень (shadow-[inset_0_1px_0_rgba(255,255,255,0.1)]) для физического преломления на кромке. Дай запасной вариант со сплошной заливкой под prefers-reduced-transparency.
  • Магнитная микрофизика: используй, когда MOTION_INTENSITY > 5 И бриф читается как премиальный / игривый / агентский. Реализуй ИСКЛЮЧИТЕЛЬНО через useMotionValue / useTransform из Motion вне цикла отрисовки React. Никогда через useState. См. раздел 3.B.
  • Постоянные микровзаимодействия (пульс, эффект печатной машинки, парение, мерцание, карусель): используй, когда MOTION_INTENSITY > 5 И блок действительно выигрывает от движения (индикаторы состояния, живые ленты, ощущение ИИ). Не каждой карточке нужен бесконечный цикл. Если блок информационный, оставь его неподвижным. Применяй пружинную физику (type: "spring", stiffness: 100, damping: 20) - никакой линейной плавности.
  • «Заявленное движение должно быть показано». Если MOTION_INTENSITY > 4, страница должна действительно двигаться: как минимум переходы появления на главном экране, раскрытие при прокрутке на ключевых блоках, физика наведения на призывах к действию. Статичная страница, заявляющая MOTION_INTENSITY: 7, сломана. И наоборот, если в доступном объёме ты не можешь выпустить рабочую анимацию, опусти регулятор до 3 и выпусти чистую статичную страницу. Никогда не делай наполовину анимацию, которая ломается (обрезанные ScrollTrigger, дёрганые появления, отсутствующая очистка).
  • АНИМАЦИЯ ДОЛЖНА БЫТЬ МОТИВИРОВАНА (обязательно). Прежде чем добавлять любую анимацию, спроси: «что эта анимация сообщает?» Допустимые ответы: иерархия (привлекает внимание к нужному), повествование (раскрывает содержимое в последовательности, соответствующей рассказу), обратная связь (подтверждает действие пользователя), переход состояния (показывает, что что-то изменилось). Недопустимый ответ: «выглядит круто». GSAP везде, потому что GSAP под рукой, - любительство. У каждого ScrollTrigger, каждой бегущей строки, каждого закреплённого блока должна быть причина. Если не можешь сформулировать причину одним предложением, убери анимацию.
  • БЕГУЩАЯ СТРОКА - МАКСИМУМ ОДНА НА СТРАНИЦУ (обязательно). Горизонтально прокручивающиеся бегущие текстовые строки (marquee: «бесконечно ползущие логотипы», «манифест, ползущий вбок», «кинетическая лента слов») уместны максимум ОДИН раз на страницу. Две и более бегущие строки на одной странице читаются как ленивый наполнитель. Выбери один блок, где бегущая строка действительно служит содержимому; остальным дай другую вёрстку.
  • Паттерн GSAP «закреплённая стопка» (когда используется стопка при прокрутке). «Стопка карточек при прокрутке» должна быть НАСТОЯЩЕЙ закреплённой стопкой (sticky-stack), а не списком с последовательным появлением. Канонический скелет кода - в разделе 5.A ниже. Типичный сбой: триггер срабатывает на середине прокрутки вместо закрепления у верха области просмотра. Исправление: start: "top top", а не start: "top center" или "top 80%".
  • Паттерн GSAP «горизонтальная панорама» (когда используется перехват горизонтальной прокрутки). Канонический скелет - в разделе 5.B ниже. Типичный сбой: анимация начинается раньше, чем блок закреплён, и пользователь видит половину слайда. То же исправление: start: "top top", закрепи обёртку, прокручивай (scrub) внутреннюю дорожку.

5.A Закреплённая стопка - канонический скелет

"use client";
import { useRef, useEffect } from "react";
import { gsap } from "gsap";
import { ScrollTrigger } from "gsap/ScrollTrigger";
import { useReducedMotion } from "motion/react";

gsap.registerPlugin(ScrollTrigger);

export function StickyStack({ cards }: { cards: React.ReactNode[] }) {
  const ref = useRef<HTMLDivElement>(null);
  const reduce = useReducedMotion();

  useEffect(() => {
    if (reduce || !ref.current) return;
    const ctx = gsap.context(() => {
      const cardEls = gsap.utils.toArray<HTMLElement>(".stack-card");
      cardEls.forEach((card, i) => {
        if (i === cardEls.length - 1) return;
        ScrollTrigger.create({
          trigger: card,
          start: "top top",                              // pin at viewport top
          endTrigger: cardEls[cardEls.length - 1],
          end: "top top",
          pin: true,
          pinSpacing: false,
        });
        gsap.to(card, {
          scale: 0.92,
          opacity: 0.55,
          ease: "none",
          scrollTrigger: {
            trigger: cardEls[i + 1],
            start: "top bottom",
            end: "top top",
            scrub: true,
          },
        });
      });
    }, ref);
    return () => ctx.revert();
  }, [reduce]);

  return (
    <div ref={ref} className="relative">
      {cards.map((card, i) => (
        <div
          key={i}
          className="stack-card sticky top-0 min-h-[100dvh] flex items-center justify-center"
        >
          {card}
        </div>
      ))}
    </div>
  );
}

Критические моменты: start: "top top", pin: true, каждая карточка, кроме последней, закреплена, преобразование масштаба/прозрачности управляется триггером прокрутки СЛЕДУЮЩЕЙ карточки (чтобы предыдущая карточка уменьшалась, когда приезжает следующая).

5.B Горизонтальная панорама - канонический скелет

"use client";
import { useRef, useEffect } from "react";
import { gsap } from "gsap";
import { ScrollTrigger } from "gsap/ScrollTrigger";
import { useReducedMotion } from "motion/react";

gsap.registerPlugin(ScrollTrigger);

export function HorizontalPan({ children }: { children: React.ReactNode }) {
  const wrap = useRef<HTMLDivElement>(null);
  const track = useRef<HTMLDivElement>(null);
  const reduce = useReducedMotion();

  useEffect(() => {
    if (reduce || !wrap.current || !track.current) return;
    const ctx = gsap.context(() => {
      const distance = track.current!.scrollWidth - window.innerWidth;
      gsap.to(track.current, {
        x: -distance,
        ease: "none",
        scrollTrigger: {
          trigger: wrap.current,
          start: "top top",                              // pin starts when section top hits viewport top
          end: () => `+=${distance}`,                    // scroll distance = track width minus viewport
          pin: true,
          scrub: 1,
          invalidateOnRefresh: true,
        },
      });
    }, wrap);
    return () => ctx.revert();
  }, [reduce]);

  return (
    <section ref={wrap} className="relative overflow-hidden">
      <div ref={track} className="flex h-[100dvh] items-center">
        {children}
      </div>
    </section>
  );
}

Критические моменты: start: "top top", pin: true, end: "+=${distance}" (длина прокрутки = нужный горизонтальный путь), scrub: 1. Обёртка закреплена, внутренняя дорожка скользит по горизонтали, пока пользователь прокручивает по вертикали.

5.C Каскадное раскрытие при прокрутке - канонический скелет (облегчённая альтернатива)

Для простого «элементы появляются, когда входят в область просмотра» (без закрепления) предпочитай whileInView из Motion вместо GSAP - легче, ScrollTrigger не нужен:

"use client";
import { motion, useReducedMotion } from "motion/react";

export function RevealStagger({ items }: { items: string[] }) {
  const reduce = useReducedMotion();
  return (
    <ul className="grid gap-6">
      {items.map((item, i) => (
        <motion.li
          key={item}
          initial={reduce ? false : { opacity: 0, y: 24 }}
          whileInView={{ opacity: 1, y: 0 }}
          viewport={{ once: true, amount: 0.3 }}
          transition={{
            duration: 0.6,
            delay: i * 0.06,
            ease: [0.16, 1, 0.3, 1],
          }}
        >
          {item}
        </motion.li>
      ))}
    </ul>
  );
}

Используй это для: списков возможностей, сеток отзывов, стен логотипов, всего, что просто должно «появиться при прокрутке». Оставь GSAP для настоящей работы с закреплением и привязкой к прокрутке (pin/scrub).

5.D Запрещённые паттерны анимации

  • **window.addEventListener("scroll", ...)** запрещён. Он срабатывает на каждом кадре прокрутки, склонен к подтормаживанию, без пакетной обработки. Используй useScroll() из Motion, ScrollTrigger из GSAP, IntersectionObserver или CSS scroll-driven animations (animation-timeline: view()).
  • **Собственные расчёты прогресса прокрутки через window.scrollY** в состоянии React. Та же причина. Повторные отрисовки на каждом кадре.
  • **Циклы requestAnimationFrame, которые трогают состояние React.** Вместо этого используй значения движения (useMotionValue + useTransform).
  • Переходы вёрстки (Layout Transitions): используй свойства layout и layoutId из Motion для видимых изменений состояния (перестановка списков, раскрытие модальных окон, общие элементы между маршрутами). Не оборачивай статичное содержимое в свойства layout «на всякий случай» - это стоит работы по измерениям.
  • Каскадная оркестровка (Staggered Orchestration): используй staggerChildren (Motion) или каскад CSS (animation-delay: calc(var(--index) * 100ms)) для моментов раскрытия, где важна последовательность. Для staggerChildren родитель (variants) и дочерние элементы ДОЛЖНЫ быть в одном дереве клиентского компонента.

6. ОГРАНИЧЕНИЯ ПО ПРОИЗВОДИТЕЛЬНОСТИ И ДОСТУПНОСТИ

6.A Аппаратное ускорение

  • Анимируй ТОЛЬКО transform и opacity. Никогда не анимируй top, left, width, height.
  • Используй will-change: transform скупо - только на элементах, которые действительно будут анимироваться.

6.B Уменьшенное движение (обязательно)

  • **Любое движение при MOTION_INTENSITY > 3 ДОЛЖНО учитывать prefers-reduced-motion.** Это не обсуждается.
  • В Motion: оберни через useReducedMotion() и деградируй до статики.
  • В CSS: ограничь анимации условием @media (prefers-reduced-motion: no-preference) или дай блок-переопределение под @media (prefers-reduced-motion: reduce), который их отключает.
  • Бесконечные циклы, параллакс, перехват прокрутки и магнитная физика ДОЛЖНЫ при уменьшенном движении схлопываться в статику / мгновенное состояние.

6.C Тёмная тема (обязательно для любой страницы, обращённой к потребителю)

  • Проектируй под обе темы с самого начала. Никогда не выпускай только светлую или только тёмную без прямого указания пользователя.
  • Используй вариант Tailwind dark: ИЛИ переменные CSS для токенов. Выбери одну стратегию на проект.
  • Не предписывай здесь конкретные цвета тёмной темы. Решает бриф. Сохраняй визуальную иерархию, айдентику бренда и контраст WCAG AA (AAA для основного текста) в обеих темах.
  • Уважай prefers-color-scheme: dark. По умолчанию следуй системным настройкам, если бренд не настаивает на одной теме.

6.D Целевые значения Core Web Vitals

  • LCP < 2.5 с. Картинка главного экрана должна быть next/image priority или загружена заранее (preload).
  • INP < 200 мс. Тяжёлую работу выноси из основного потока.
  • CLS < 0.1. Резервируй место для картинок, шрифтов, встраиваемых элементов.
  • Перед тем как объявить страницу готовой, прогони Lighthouse.

6.E Стоимость DOM

  • Накладывай фильтры зерна / шума ИСКЛЮЧИТЕЛЬНО на фиксированные псевдоэлементы с pointer-events-none (например, fixed inset-0 z-[60] pointer-events-none). НИКОГДА на прокручиваемые контейнеры - непрерывные перерисовки на GPU убивают частоту кадров на мобильных.
  • Помни про размер сборки. Motion не крошечная. Three.js большая. Загружай лениво всё, что не на первом экране.

6.F Сдержанность с z-index

НИКОГДА не сыпь произвольными z-50 или z-10. Используй z-index строго для системных слоёв (прилипающая панель навигации, модальные окна, оверлеи, зерно). Задокументируй шкалу z-index в файле констант проекта.


7. ОПРЕДЕЛЕНИЯ РЕГУЛЯТОРОВ (техническая справка)

DESIGN_VARIANCE (уровень 1-10)

  • 1-3 (предсказуемо): симметричная CSS-сетка Grid (12 колонок, равные единицы fr), равные отступы, выравнивание по центру.
  • 4-7 (со смещением): перекрытия через margin-top: -2rem, разные соотношения сторон картинок (4:3 рядом с 16:9), заголовки по левому краю над данными, выровненными по центру.
  • 8-10 (асимметрично): раскладки «кирпичная кладка» (masonry), CSS Grid с дробными единицами (grid-template-columns: 2fr 1fr 1fr), огромные пустые зоны (padding-left: 20vw).
  • МОБИЛЬНОЕ ПЕРЕОПРЕДЕЛЕНИЕ: для уровней 4-10 асимметричные раскладки выше md: ДОЛЖНЫ схлопываться в строго одну колонку (w-full, px-4, py-8) на областях просмотра < 768px.

MOTION_INTENSITY (уровень 1-10)

  • 1-3 (статика): никаких автоматических анимаций. Только состояния CSS :hover и :active. prefers-reduced-motion в любом случае режим по умолчанию.
  • 4-7 (плавный CSS): transition: all 0.3s cubic-bezier(0.16, 1, 0.3, 1). Каскады animation-delay для появления при загрузке. Упор на transform и opacity.
  • 8-10 (сложная хореография): сложные раскрытия по прокрутке, параллакс, анимация, управляемая прокруткой (CSS animation-timeline или GSAP ScrollTrigger). Используй хуки Motion. **НИКОГДА не используй window.addEventListener('scroll')** - это жёсткий запрет, а не «лучше не надо». Допустимые альтернативы - в разделе 5.D.

VISUAL_DENSITY (уровень 1-10)

  • 1-3 (художественная галерея): много пустого пространства. Огромные промежутки между блоками (от py-32 до py-48). Дорого, чисто.
  • 4-7 (повседневное приложение): стандартные отступы веб-приложения (от py-16 до py-24).
  • 8-10 (кабина пилота): плотные отступы. Никаких карточек-рамок; данные разделяют линии в 1px. Обязательно: font-mono для всех чисел.

8. ПРОТОКОЛ ТЁМНОЙ ТЕМЫ

По умолчанию двухтемный режим. Никогда не считай, что будет только светлая тема, кроме случая, когда бриф - редакционная вёрстка, имитирующая печать.

8.A Стратегия токенов (выбери одну и держись её)

  • **Вариант Tailwind dark:** (по умолчанию для проектов, ориентированных на утилиты): каждая цветовая утилита в паре со своим тёмным вариантом (bg-white dark:bg-zinc-950, text-gray-900 dark:text-gray-100).
  • Переменные CSS (для shadcn/ui, Radix Themes или библиотек компонентов с темами): определи смысловые токены (--surface, --surface-elevated, --text-primary, --accent) и подменяй значения под [data-theme="dark"] или @media (prefers-color-scheme: dark).

8.B Не предписывай здесь конкретные цвета

Решают бриф и бренд. Этот скилл обеспечивает только:

  • Контраст - минимум WCAG AA для основного текста, цель AAA для текста главного экрана.
  • Паритет иерархии - визуальная иерархия, которая работает в светлой теме, должна работать и в тёмной. Если призыв к действию выделяется в светлой, он выделяется и в тёмной.
  • Верность бренду - основной цвет бренда остаётся узнаваемым. Не обесцвечивай бренд ради тёмной темы.
  • **Никакого чистого #000000 и никакого чистого #ffffff** - используй не совсем чёрный (zinc-950, почти чёрный тёплый серый) и не совсем белый. Чистые значения убивают глубину.

8.C Режим по умолчанию

Уважай prefers-color-scheme, если бренд не настаивает. Добавь ручной переключатель, если любая из тем потеряет ключевое выражение бренда.

8.D Проверь в обеих темах перед завершением

Открывай страницу в обеих темах в ходе разработки. Не выпускай страницу, которую ты видел только в одной теме.


9. ПРИЗНАКИ ИИ (запрещённые паттерны)

Избегай этих подписей, если бриф прямо их не просит.

9.A Визуал и CSS

  • НИКАКОГО неона / внешних свечений по умолчанию. Используй внутренние рамки или лёгкие подкрашенные тени.
  • **НИКАКОГО чисто чёрного (#000000).** Не совсем чёрный, zinc-950 или угольный.
  • НИКАКИХ перенасыщенных акцентов. Снижай насыщенность, чтобы они сливались с нейтральными.
  • НИКАКОГО избыточного градиентного текста для крупных заголовков.
  • НИКАКИХ нестандартных курсоров мыши. Устарели, враждебны к доступности, враждебны к производительности.

9.B Типографика

  • ИЗБЕГАЙ Inter как варианта по умолчанию. См. раздел 4.1. Путь исключения есть.
  • НИКАКИХ гигантских H1, которые просто кричат. Управляй иерархией через насыщенность + цвет, а не через голый масштаб.
  • Ограничения по засечкам: шрифт с засечками - для редакционных / люксовых / издательских страниц. Не для дашбордов.

9.C Вёрстка и отступы

  • Математически выверенные отступы. Никаких плавающих элементов с неловкими промежутками.
  • НИКАКИХ равных карточек возможностей в 3 колонки. Типовой ряд возможностей «три одинаковые карточки в ряд» запрещён. Используй зигзаг в 2 колонки, асимметричную сетку, закрепление при прокрутке или горизонтальную прокрутку.

9.D Содержимое и данные (эффект «Джейн Доу»)

  • НИКАКИХ типовых имён. «John Doe», «Sarah Chan», «Jack Su» → используй творческие, реалистичные имена, подходящие по региону.
  • НИКАКИХ типовых аватаров. Никаких SVG-«яиц» и пользовательских значков Lucide → используй правдоподобные фото-заглушки или особое оформление.
  • НИКАКИХ фальшиво идеальных чисел. Избегай 99.99%, 50%, 1234567. Используй живые, неровные данные (47.2%, +1 (312) 847-1928).
  • НИКАКИХ стартап-слоповых названий брендов. «Acme», «Nexus», «SmartFlow», «Cloudly» → придумывай контекстные, премиальные названия, которые звучат по-настоящему.
  • НИКАКИХ глаголов-наполнителей. «Elevate», «Seamless», «Unleash», «Next-Gen», «Revolutionize» → только конкретные глаголы.

9.E Внешние ресурсы и компоненты

  • НИКАКИХ SVG-иконок, нарисованных вручную. Используй Phosphor / HugeIcons / Radix / Tabler. Lucide - только по прямой просьбе.
  • Декоративные SVG, нарисованные вручную, настоятельно не рекомендуются по умолчанию (см. раздел 4.8).
  • НИКАКИХ фальшивых скриншотов на div-ах. Никогда не собирай фальшивый интерфейс продукта из прямоугольников <div>, имитируя скриншот. Используй настоящие изображения, сгенерированные изображения или пропусти предпросмотр.
  • НИКАКИХ битых ссылок Unsplash. Используй https://picsum.photos/seed/{descriptive-string}/{w}/{h}, или сгенерированные фото-заглушки, или настоящие материалы.
  • Настройка shadcn/ui: разрешена, но НИКОГДА в состоянии по умолчанию. Настрой радиусы, цвета, тени, типографику под эстетику проекта.
  • Чистота, готовая к продакшену: код визуально чистый, запоминающийся, тщательно доведённый.

9.F Признаки ИИ из боевых тестов (запрещены безоговорочно)

Эти паттерны появились в настоящих тестах лендингов, сгенерированных языковыми моделями. Это подписи, к которым модель скатывается, когда пытается «выглядеть как дизайн». Считай их жёсткими запретами, если бриф прямо не требует какой-то из них.

Главный экран и верх страницы

  • НИКАКИХ меток версии на главном экране. V0.6, v2.0, BETA, INVITE-ONLY PREVIEW, EARLY ACCESS, ALPHA - запрещены как надзаголовки по умолчанию. Допустимы, только когда бриф прямо про запуск продукта / статус предпросмотра.
  • НИКАКИХ под-надзаголовков в стиле «Brand · No. 01». Микромета-строки вроде «Marrow · No. 01 · The 6-quart». Пропускай их.

Нумерация блоков и микроподписи

  • НИКАКИХ надзаголовков с номерами блоков. 00 / INDEX, 001 · Capabilities, 002 · Featured commission, 06 · how it works, 05 · The honest table - запрещены. Надзаголовки должны называть тему простым языком, а не нумеровать.
  • **НИКАКОЙ пагинации вида 01 / 4 на картинках или бенто-плитках.** Если пользователь умеет считать, подпись ему не нужна.
  • **НИКАКИХ подсказок прокрутки вида Scroll · 001 Capabilities.** Достаточно простой стрелки или «Scroll»; без префикса с номером блока.
  • НИКАКИХ подписей-диапазонов вида «Index of Work, 2018 - 2026» в роли надзаголовков. Просто скажи, что это за блок.

Разделители и точки

  • **Срединная точка (·) нормируется.** Максимум 1 на строку в полосах метаданных. НЕ используй её как разделитель по умолчанию для всего («foo · bar · baz · qux · quux»). Если нужно семейство разделителей, предпочитай переносы строк, тонкие линии или колонки.
  • НИКАКИХ декоративных цветных статусных точек на каждом списке/пункте навигации/бейдже. Цветная точка перед «ONE Q4 SLOT OPEN» или перед каждой ссылкой навигации, или перед каждой строкой задачи - запрещена по умолчанию. Допустима, только когда точка передаёт настоящее смысловое состояние (статус сервера, флаг доступности) и используется скупо.

Длинные тире и типографские излишества

  • **НИКАКОГО длинного тире (—) как элемента дизайна И вообще где-либо.** См. раздел 9.G ниже о полном, не подлежащем обсуждению запрете. Символ длинного тире запрещён в заголовках, надзаголовках, «таблетках», основном тексте, цитатах, подписях авторов, подписях к картинкам, тексте кнопок и альтернативном тексте. Используй обычный дефис (-).
  • **НИКАКИХ заголовков с разрывом <br> и курсивом** как «дизайнерского хода» по умолчанию. Разбиения вроде «for thirty\<br\>*years.*». Заголовки должны сначала читаться естественно, а остроумничать - только когда этого требует бриф.
  • НИКАКОГО вертикального повёрнутого текста («INDEX OF WORK, 2018 - 2026», повёрнутого на 90°). Клише агентского портфолио. Используй, только когда бриф прямо агентский / Awwwards / экспериментальный И это служит настоящей композиционной цели.
  • НИКАКИХ линий-перекрестий / тонких линий сетки как украшения. Вертикальные и горизонтальные линии, нарисованные лишь для того, чтобы страница «ощущалась как дизайн», - запрещены. Используй их, только когда они организуют настоящее содержимое.

Фальшивые предпросмотры продукта

  • НИКАКОГО фальшивого интерфейса продукта на div-ах на главном экране (фальшивый список задач, фальшивый терминал, фальшивый дашборд из стилизованных div-ов). Это признак ИИ №1 в дизайне от языковых моделей. Используй настоящий скриншот, сгенерированное изображение, настоящий предпросмотр компонента или ничего.
  • НИКАКИХ фальшивых подвалов с версиями («v0.6.2-rc.1», «last sync 4s ago · main») внутри фальшивых скриншотов. Ничего не добавляет, кричит об ИИ.

Признаки ИИ в рекламных текстах

  • НИКАКИХ заголовков социального доказательства «Quietly in use at» / «Quietly trusted by». Используй естественный язык: «Нам доверяют», «Используют в», «Среди клиентов», либо пропусти заголовок целиком, если говорят сами логотипы.
  • НИКАКИХ поэтических подписей в стиле «From the field» / «Field notes» / «Currently on the bench» / «On our desks» / «Loose plates» в блоках цитат, блога или боковой колонки. Читается как показное ремесленничество. Используй простые функциональные подписи («Отзывы», «Последние записи», «Над чем работаем сейчас») или пропусти подпись.
  • НИКАКИХ показно-скромных отсылок к отрасли в стиле «We respect the French ones» в основном тексте. Мило и по-ИИшному.
  • НИКАКИХ полос с погодой / локацией («LIS 14:23 · 18°C») в шапках/подвалах, если бриф прямо не про место / студию, распределённую по часовым поясам.
  • НИКАКИХ микрометапредложений под надзаголовками. Предложения вроде *«Each of these is a feature we ship today, not a roadmap promise. The list will stay short on purpose.»* под заголовком блока - лишний шум. Надзаголовка + заголовка + основного текста достаточно.
  • НИКАКИХ типовых подписей шагов. «Stage 1 / Stage 2 / Stage 3», «Step 1 / Step 2 / Step 3», «Phase 01 / Phase 02 / Phase 03», «Pass One / Pass Two / Pass Three». Запрещено. Подписью служит само содержание шага. Если нужно показать движение вперёд, используй глагол-существительное прямо («Установить», «Настроить», «Выпустить»), а не «Stage 1: Install».

«Таблетки», подписи и штампы версий

  • НИКАКИХ «таблеток»/подписей/тегов поверх картинок. Никаких оверлеев <span> на фотографиях с тегами вроде Brand · 02, PLATE · BRAND, Field notes - journal. Либо пусть картинка говорит сама, либо добавь подпись прямо под ней (вне картинки).
  • НИКАКИХ подписей с авторством фото как украшения. Строки вроде Field study no. 12 · Ines Caetano, Plate 03 · House archive, Frame XII · 35mm под стоковыми/picsum-картинками - претенциозны. Указание автора фото разрешено ТОЛЬКО когда указывается настоящий фотограф за настоящее фото (с разрешения). В остальных случаях: пропусти подпись или используй однострочную функциональную подпись («The 6-quart, in Sage.»).
  • НИКАКИХ подвалов с версиями на маркетинговых страницах. Строки подвала вроде v1.4.2, Build 0048, last sync 4s ago · main - атрибуты командной строки / девтулов, а не содержимое лендинга. Запрещены на маркетинговых/лендинговых/портфолио-страницах.
  • НИКАКИХ живых счётчиков остатка вроде «Reservation 412 of 800» как украшения. Только если бриф прямо про лист ожидания ограниченного тиража с настоящими данными.

Декоративные текстовые полосы

  • НИКАКОЙ декоративной текстовой полосы внизу главного экрана. Паттерны вроде BRAND. MOTION. SPATIAL., TYPE / FORM / MOTION, DESIGN · BUILD · SHIP, ESTD. 2018 · LISBON · BRAND. MOTION. SPATIAL. в виде маленькой моноширинной полосы заглавными буквами через низ главного экрана - клише агентского портфолио. Запрещены по умолчанию. Допустимы, только когда полоса несёт настоящие ссылки для навигации (закреплённая нижняя навигация) или настоящую статусную информацию (баннер cookie, информация о сборке на сайте документации).
  • НИКАКОГО плавающего подтекста в правом верхнем углу заголовков блоков. Паттерн: у блока гигантский заголовок по левому краю; в правом верхнем углу той же шапки блока плавает маленький поясняющий абзац, не выровненный ни по чему другому. Этот «плавун» и есть признак ИИ. Либо ставь подтекст прямо под заголовком, либо собери чистую шапку в 2 колонки (слева: заголовок, справа: выровненный текст), но не крошечный абзац в углу.

Списки, разделители и оценки

  • **НИКАКИХ border-t + border-b на каждой строке длинного списка / таблицы характеристик.** Выбери одно (нижняя рамка между строками ИЛИ верхняя рамка над группой) и используй скупо. Таблица характеристик на 10 строк с тонкой линией под каждой строкой - самая ленивая вёрстка; альтернативные компоненты интерфейса см. в разделе 4.9.
  • НИКАКИХ шкал оценок/прогресса с залитыми фоновыми дорожками как визуализации сравнения. Если нужно показать сравнения «X из Y», предпочитай число + маленькую иконку или крошечную встроенную полоску БЕЗ фоновой дорожки. Большие залитые дорожки bg-zinc-200 с частичной заливкой сверху - мусор интерфейса дашборда на лендинге.

Локация, время, подсказки прокрутки

  • Полосы с локацией / названием города / временем / погодой запрещены для 99% брифов. «Lisbon, working with founders» на главном экране, «1200-690 Lisbon, Portugal» в подвале, «Lisbon 14:23 · 18°C» в навигации. Это признаки ИИ, украшательство агентских портфолио. Допустимы ТОЛЬКО когда: бриф прямо описывает глобально распределённую студию с работой, зависящей от часовых поясов, ИЛИ бренд о путешествиях, ИЛИ реальное физическое место. Одно упоминание контактного адреса в подвале нормально; атмосферная полоса с локацией - нет.
  • Подсказки прокрутки запрещены. Scroll, ↓ scroll, Scroll to explore, Scroll to walk through it, анимированные значки колёсика мыши. Если пользователь ещё не прокручивал, он смотрит на главный экран. Он знает, что такое прокрутка. Низу области просмотра подпись не нужна.
  • НОЛЬ декоративных статусных точек по умолчанию. Цветная точка перед пунктами навигации, перед строками списка, перед бейджами, перед статусными подписями - признак ИИ. Допустима, только когда передаёт настоящее смысловое состояние (живой индикатор реального статуса сервера, живой флаг доступности) и ограничена одной на блок страницы.

9.G ЗАПРЕТ ДЛИННОГО ТИРЕ (самый часто нарушаемый признак ИИ)

**Длинное тире (—) ПОЛНОСТЬЮ запрещено.** Это фирменный стилистический костыль языковых моделей и признак ИИ №1 в боевых тестах. Никаких послаблений «ограниченное использование», никаких «частота как в естественном языке», никаких «в основном тексте можно». Никаких.

  • Запрещено в заголовках. Используй точку или запятую.
  • Запрещено в надзаголовках / подписях / «таблетках» / тексте кнопок / подписях к картинкам / пунктах навигации. Заменяй переносами строк, колонками или тонкими линиями.
  • Запрещено в основном тексте. Перестрой предложение: два предложения через точку, ИЛИ запятая, ИЛИ скобки, ИЛИ двоеточие.
  • Запрещено в подписи автора цитаты. Используй обычный дефис с пробелами ( - ) или перенос строки + имя менее насыщенным начертанием.
  • **Запрещено и в форме короткого тире (–), когда оно служит разделителем.** Диапазоны дат (2018-2026) пиши с дефисом. Диапазоны чисел (€40-80k) пиши с дефисом.

ЕДИНСТВЕННЫЕ допустимые символы-чёрточки на странице:

  • Обычный дефис - (для сложных слов, диапазонов, разделителей строк в разметке)
  • Знак минус в математике (-5°C)

Если в твоём результате есть хоть одно — или – в любом месте, видимом пользователю, результат не проходит предполётную проверку (Pre-Flight Check) и должен быть переписан.

Это правило не обсуждается. Агент исторически игнорировал ограничения на длинное тире, когда они формулировались как «используй умеренно». Формулировка здесь бинарная: ноль длинных тире.


10. СПРАВОЧНЫЙ СЛОВАРЬ (названия паттернов, которые агент должен знать)

Это словарь, а не библиотека. Агент должен ЗНАТЬ эти названия паттернов, чтобы говорить о них, проектировать с ними в уме и обращаться к ним, когда этого требует прочтение дизайна. Реализации и наброски кода лежат в библиотеке блоков (раздел 12), которая наполняется постепенно.

Парадигмы главного экрана

  • Асимметричный разделённый главный экран (Asymmetric Split Hero) - текст с одной стороны, материал с другой, много пустого пространства.
  • Главный экран-манифест в редакционном стиле (Editorial Manifesto Hero) - крупная типографика, без материала, почти плакат.
  • Главный экран с маской над видео / медиа (Video / Media Mask Hero) - шрифт вырезан как маска поверх видеофона.
  • Главный экран с кинетической типографикой (Kinetic-Type Hero) - анимированная типографика как основной визуальный образ.
  • Главный экран-занавес (Curtain-Reveal Hero) - главный экран раздвигается при прокрутке, как занавес.
  • Закреплённый при прокрутке главный экран (Scroll-Pinned Hero) - главный экран остаётся закреплённым, пока содержимое прокручивается позади.

Навигация и меню

  • Увеличение как в доке Mac OS (Mac OS Dock Magnification) - навигация у края, иконки плавно увеличиваются при наведении.
  • Магнитная кнопка (Magnetic Button) - притягивается к курсору.
  • «тянущееся» меню (Gooey Menu) - подпункты отделяются, как вязкая жидкость.
  • Dynamic Island - превращающаяся «таблетка» для статуса / уведомлений.
  • Контекстное радиальное меню (Contextual Radial Menu) - круговое меню, раскрывающееся в точке нажатия.
  • Плавающий быстрый набор (Floating Speed Dial) - плавающая кнопка (FAB), из которой выпрыгивают дугой дополнительные действия.
  • Раскрытие мегаменю (Mega Menu Reveal) - выпадающее меню на весь экран, содержимое появляется каскадным проявлением.

Вёрстка и сетки

  • Бенто-сетка (Bento Grid) - асимметричная группировка плиток (как Центр управления Apple).
  • Раскладка «кирпичная кладка» (Masonry Layout) - ступенчатая сетка без фиксированной высоты рядов.
  • Цветная сетка (Chroma Grid) - рамки / плитки с тонкими анимированными градиентами.
  • Прокрутка с разделённым экраном (Split-Screen Scroll) - две половины скользят в противоположные стороны.
  • Блоки-стопка с закреплением (Sticky-Stack Sections) - блоки закрепляются и складываются стопкой при прокрутке.

Карточки и контейнеры

  • Карточка с параллакс-наклоном (Parallax Tilt Card) - 3D-наклон, отслеживающий координаты мыши.
  • Карточка с подсвечиваемой рамкой (Spotlight Border Card) - рамки освещаются под курсором.
  • Панель-глассморфизм (Glassmorphism Panel) - матовое стекло с внутренним преломлением.
  • Карточка с голографической фольгой (Holographic Foil Card) - переливающийся радужный сдвиг при наведении.
  • Стопка карточек как в Tinder (Tinder Swipe Stack) - физическая стопка карточек, их смахивают.
  • Превращающееся модальное окно (Morphing Modal) - кнопка раскрывается в собственное диалоговое окно.

Анимации при прокрутке

  • Закреплённая стопка при прокрутке (Sticky Scroll Stack) - карточки закрепляются и физически складываются в стопку.
  • Перехват горизонтальной прокрутки (Horizontal Scroll Hijack) - вертикальная прокрутка → горизонтальная панорама.
  • Прокрутка-последовательность в духе Locomotive (Locomotive / Sequence Scroll) - видео / 3D-последовательность привязана к полосе прокрутки.
  • Параллакс с увеличением (Zoom Parallax) - центральное фоновое изображение увеличивается при прокрутке.
  • Линия, рисуемая прокруткой (Scroll Progress Path) - SVG-линия прорисовывается по мере прокрутки.
  • Жидкий переход «свайп» (Liquid Swipe Transition) - переход между страницами, как вязкая жидкость.

Галереи и медиа

  • Галерея-купол (Dome Gallery) - 3D-панорамная галерея.
  • Карусель Coverflow (Coverflow Carousel) - 3D-карусель с наклонёнными краями.
  • Сетка с перетаскиванием (Drag-to-Pan Grid) - безграничное полотно, которое можно перетаскивать.
  • Слайдер-аккордеон из картинок (Accordion Image Slider) - узкие полосы раскрываются при наведении.
  • Шлейф картинок за мышью (Hover Image Trail) - мышь оставляет за собой всплывающий шлейф картинок.
  • Картинка с глитч-эффектом (Glitch Effect Image) - сдвиг RGB-каналов при наведении.

Типографика и текст

  • Кинетическая бегущая строка (Kinetic Marquee) - бесконечные ленты текста, меняющие направление при прокрутке.
  • Раскрытие через маску текста (Text Mask Reveal) - огромный шрифт как прозрачное окно в видео.
  • Эффект перемешивания текста (Text Scramble Effect) - расшифровка в стиле «Матрицы» при загрузке / наведении.
  • Текст по круговому пути (Circular Text Path) - текст изгибается вдоль вращающегося круга.
  • Анимация градиентного контура (Gradient Stroke Animation) - контурный текст с бегущим градиентом.
  • Сетка кинетической типографики (Kinetic Typography Grid) - буквы уворачиваются от курсора.

Микровзаимодействия и эффекты

  • Кнопка-взрыв частиц (Particle Explosion Button) - призыв к действию разлетается на частицы при успехе.
  • Жидкое обновление вытягиванием (Liquid Pull-to-Refresh) - индикатор перезагрузки, как отрывающиеся капли.
  • Мерцающий скелет (Skeleton Shimmer) - сдвигающееся отражение света на заглушках.
  • Кнопка с заливкой по направлению наведения (Directional Hover-Aware Button) - заливка входит с той самой стороны, откуда пришёл курсор.
  • Эффект ряби при клике (Ripple Click Effect) - волна от координат клика.
  • Анимированная прорисовка SVG-линии (Animated SVG Line Drawing) - векторы рисуют себя в реальном времени.
  • Сетчатый градиентный фон (Mesh Gradient Background) - органичные пятна, как в лава-лампе.
  • Глубина через размытие линзы (Lens Blur Depth) - интерфейс на фоне размывается, чтобы сфокусировать действие на переднем плане.

Выбор библиотеки анимации

  • **Motion (motion/react)** - по умолчанию для анимации интерфейса / бенто / смены состояния.
  • GSAP + ScrollTrigger - для скроллтеллинга на всю страницу и перехвата прокрутки. Изолируй в отдельных листовых компонентах с очисткой в useEffect.
  • Three.js / WebGL - для фонов на canvas и 3D-сцен. То же правило изоляции.
  • НИКОГДА не смешивай GSAP / Three.js с Motion в одном дереве компонентов. Они дерутся за одни и те же кадры.

11. ПРОТОКОЛ РЕДИЗАЙНА

Этот скилл работает и с нуля, И с редизайнами. Неверное определение режима - главный источник плохого результата редизайна.

11.A Определи режим (первое действие)

  • С нуля (Greenfield) - нет существующего сайта или полная переделка одобрена. Базовые значения регуляторов - из раздела 1.
  • Редизайн - сохранить - модернизировать, не ломая бренд. Сначала аудит, извлеки токены бренда, развивай постепенно.
  • Редизайн - переделать полностью - новый визуальный язык поверх существующего содержимого. Для визуала считай работой с нуля; содержимое и информационную архитектуру (IA) сохрани.

Если неоднозначно, спроси один раз: *«Этот редизайн должен сохранить существующий бренд, или мы начинаем визуально с нуля?»*

11.B Аудит перед тем, как что-либо трогать

Зафиксируй текущее состояние, прежде чем предлагать изменения:

  • Токены бренда - основной / акцентный цвета, набор шрифтов, оформление логотипа, радиусы.
  • Информационная архитектура - дерево страниц, основная навигация, ключевые пути конверсии.
  • Блоки содержимого - что есть, что работает, что наполнитель.
  • Паттерны, которые стоит сохранить - фирменные взаимодействия, узнаваемый главный экран, голос текстов.
  • Паттерны, которые стоит убрать - признаки ИИ-слопа, сломанная вёрстка, мёртвые ссылки, типовые стоковые изображения, ловушки производительности.
  • Показания регуляторов существующего сайта - определи текущие DESIGN_VARIANCE / MOTION_INTENSITY / VISUAL_DENSITY. Это твоя отправная точка, а не базовые значения.
  • Базовая линия SEO - страницы, которые сейчас в выдаче, мета-заголовки, структурированные данные, карточки OG. Миграция SEO - риск №1 при редизайне.

11.C Правила сохранения

  • Не меняй информационную архитектуру, если не просили. Держи неизменными адреса страниц (slug), ID якорей, подписи основной навигации - ради SEO и мышечной памяти пользователей.
  • Извлеки цвета бренда до применения раздела 4.2. Бренд, который уже фиолетовый, остаётся фиолетовым - применяй исключение из ПРАВИЛА ЛИЛОВОГО.
  • Сохраняй голос текстов, если не просили переписать. Визуальная модернизация ≠ переписывание содержимого.
  • Уважай уже достигнутую доступность. Не ухудши состояния фокуса, альтернативный текст, навигацию с клавиатуры, контраст.
  • Уважай существующие события аналитики. Не переименовывай кнопки, поля форм, ID блоков, от которых зависит отслеживание.

11.D Рычаги модернизации (по приоритету)

Применяй по порядку - остановись, когда бриф удовлетворён:

  1. Обновление типографики - самый большой визуальный эффект на единицу риска.
  2. Отступы и ритм - увеличь отступы блоков, поправь вертикальный ритм.
  3. Перекалибровка цвета - снизь насыщенность, объедини нейтральные, оставь акцент бренда.
  4. Слой анимации - добавь микровзаимодействия, подходящие для MOTION_INTENSITY, к существующим компонентам.
  5. Перекомпоновка главного экрана и ключевых блоков - перестрой верх воронки, используя словарь из раздела 10.
  6. Полная замена блока - только когда существующий блок не спасти.

11.E Дерево решений: точечное развитие или полный редизайн

  • Информационная архитектура, содержимое и SEO в порядке → точечное развитие (рычаги 1-4). Около 70% пользы при около 40% риска.
  • Визуальный долг структурный (сломанная IA, нет дизайн-системы, сломанная мобильная версия) → полный редизайн со строгим сохранением содержимого.
  • Меняется сам бренд → с нуля.

11.F Что никогда не меняется молча

Никогда не меняй без прямого одобрения пользователя:

  • Структуру URL / адреса маршрутов (slug).
  • Подписи основной навигации.
  • Имена или порядок полей форм (ломает аналитику + автозаполнение).
  • Логотип или словесный знак бренда.
  • Существующие юридические тексты / согласия / cookie.

12. БИБЛИОТЕКА БЛОКОВ (контракт - реализации появляются здесь постепенно)

Справочный словарь (раздел 10) называет паттерны. Библиотека блоков реализует их с настоящими свойствами, настоящими спецификациями анимации и настоящими набросками кода.

Статус: схема определена здесь. Блоки будут добавляться постепенно. Не придумывай новые блоки по своему усмотрению, не следуя этой схеме.

12.A Расположение файлов

skills/taste-skill/blocks/
  hero/
    asymmetric-split.md
    editorial-manifesto.md
    kinetic-type.md
    ...
  feature/
    bento-grid.md
    sticky-scroll-stack.md
    zig-zag.md
    ...
  social-proof/
  pricing/
  cta/
  footer/
  navigation/
  portfolio/
  transition/

12.B Обязательная шапка (frontmatter)

---
name: asymmetric-split-hero
category: hero
dial_compatibility:
  variance: [6, 10]
  motion: [3, 10]
  density: [2, 5]
when_to_use: "Landing pages with one strong asset and one strong message. Default hero for SaaS, agency, premium consumer."
not_for: "Editorial / manifesto launches where the message IS the design."
stack: ["react", "next", "tailwind", "motion"]
---

12.C Обязательные разделы тела

  1. Визуальный набросок - короткий ASCII-рисунок или описание вёрстки.
  2. API свойств (Props API) - интерфейс компонента.
  3. Набросок кода - минимальная рабочая реализация (серверный компонент по умолчанию, клиентский «остров» для анимации).
  4. Запасной вариант для мобильных - явные правила схлопывания для < 768px.
  5. Варианты анимации - один вариант на каждую полосу MOTION_INTENSITY (1-3, 4-7, 8-10). Запасной вариант для уменьшенного движения указан явно.
  6. Заметки по тёмной теме - стратегия токенов именно для этого блока.
  7. Антипаттерны - типичные способы, как этот блок получается плохо.
  8. Ссылки - ссылки на настоящие примеры в продакшене.

12.D Дисциплина библиотеки блоков

  • Один блок на файл. Никаких файлов с несколькими блоками.
  • Каждый блок должен работать самостоятельно (вставь его на страницу - он отрисуется).
  • Каждый блок должен проходить предполётную проверку (раздел 14).
  • Блоки, зависящие от дизайн-системы из раздела 2.A, лежат в blocks/<category>/<name>--<system>.md (например, feature/bento-grid--material.md).

13. ЗА ПРЕДЕЛАМИ ЗАДАЧ СКИЛЛА

Этот скилл НЕ для:

  • Дашбордов / плотных интерфейсов продукта / админок (используй Fluent, Carbon, Atlassian или Polaris из раздела 2.A).
  • Таблиц данных (используй TanStack Table или AG Grid).
  • Многошаговых форм / мастеров (используй специальные паттерны форм; этот скилл не сделает их лучше).
  • Редакторов кода (используй Monaco / CodeMirror с их официальным оформлением).
  • Нативных мобильных приложений (используй Apple HIG / Material напрямую).
  • Интерфейсов совместной работы в реальном времени (присутствие, курсоры, работа с учётом OT - другой класс задач).

Если бриф относится к чему-то из этого, скажи об этом прямо, укажи подходящий инструмент и применяй части этого скилла для маркетинговых страниц / страниц «о нас» / лендингов только к тем поверхностям, где они уместны.


14. ИТОГОВАЯ ПРЕДПОЛЁТНАЯ ПРОВЕРКА (FINAL PRE-FLIGHT CHECK)

Прогони эту матрицу перед выдачей кода. Это последний фильтр.

ЭТО НЕ ПО ЖЕЛАНИЮ. Пройди каждую галочку. Если хоть одна не выполнена, результат не готов.

  • [ ] Вывод из брифа объявлен (однострочник из раздела 0.B)?
  • [ ] Значения регуляторов заданы явно и обоснованы брифом, а не молча взяты базовые?
  • [ ] Дизайн-система выбрана из раздела 2, если применимо, или эстетика честно подписана?
  • [ ] Режим редизайна определён и аудит проведён (если применимо, раздел 11)?
  • [ ] **НОЛЬ длинных тире (—) где-либо на странице.** Заголовки, надзаголовки, «таблетки», основной текст, цитаты, подписи авторов, подписи к картинкам, кнопки, альтернативный текст. Ноль. (Раздел 9.G - не обсуждается.)
  • [ ] Фиксация темы страницы: ОДНА тема (светлая, тёмная или авто) на всю страницу. Ни один блок не переворачивается в инвертированный режим посреди страницы (раздел 4.11)?
  • [ ] Фиксация цветовой последовательности: один акцентный цвет используется одинаково во всех блоках (раздел 4.2)?
  • [ ] Фиксация единства формы: одна система скруглений применяется последовательно (раздел 4.4)?
  • [ ] Проверка контраста кнопок: текст каждого призыва к действию читается на его фоне (никакого белого на белом, WCAG AA 4.5:1)?
  • [ ] Перенос текста кнопок: ни одна подпись призыва к действию не переносится на 2+ строки на десктопе?
  • [ ] Проверка контраста форм: поля ввода, подсказки, кольца фокуса, подписи проходят WCAG AA относительно фона блока?
  • [ ] Дисциплина с засечками: если используется шрифт с засечками, это НЕ Fraunces и НЕ Instrument_Serif (либо они есть, но с прямым обоснованием бренда)? Шрифт с засечками отличается от того, что был в предыдущем проекте?
  • [ ] Проверка палитры «премиального потребительского»: если бриф премиальный потребительский (посуда / велнес / ремесло / люкс), палитра НЕ ИИ-семейство по умолчанию «бежевый + латунь + цвет бычьей крови + эспрессо»? Другое семейство, чем в предыдущем премиальном потребительском проекте?
  • [ ] Запас под выносные элементы курсива: у каждого курсивного слова с y g j p q есть leading-[1.1] минимум + запас pb-1?
  • [ ] Главный экран помещается в область просмотра: заголовок ≤ 2 строк, подтекст ≤ 20 слов И ≤ 4 строк, призыв к действию виден без прокрутки, шкала шрифта спланирована с учётом картинки?
  • [ ] Верхний отступ главного экрана: максимум pt-24 на десктопе, содержимое главного экрана не повисает на середине области просмотра?
  • [ ] Дисциплина стека главного экрана: максимум 4 текстовых элемента на главном экране (надзаголовок ИЛИ полоса бренда, заголовок, подтекст, призывы к действию)? Нет мелкой строки под призывами, нет полосы доверия на главном экране?
  • [ ] ЧИСЛО НАДЗАГОЛОВКОВ (механически): посчитай вхождения микроподписей uppercase tracking над заголовками блоков во всех компонентах. Число ≤ ceil(числоБлоков / 3)? Главный экран считается за 1.
  • [ ] Запрет разделённого заголовка блока: нет паттерна «слева большой заголовок + справа маленький поясняющий абзац» в роли шапки блока (вместо него вертикальная стопка)?
  • [ ] Потолок зигзагообразного чередования: нет 3+ блоков подряд с одинаковой вёрсткой «картинка + текст»?
  • [ ] Нет дубля намерения в призывах: нет двух призывов к действию с одним намерением («Get in touch» + «Let's talk» на одной странице = провал)?
  • [ ] Стена логотипов = только логотипы: под логотипами не напечатаны подписи отрасли / категории?
  • [ ] Разнообразие фонов в бенто: минимум 2-3 ячейки бенто имеют настоящее визуальное отличие (картинка, градиент, узор), а не все белые текстовые карточки на белом?
  • [ ] Стена логотипов «Нам доверяют / Используют» находится ПОД главным экраном, а не внутри него, использует НАСТОЯЩИЕ SVG-логотипы (Simple Icons / devicon) или сгенерированные SVG-знаки, а НЕ простые текстовые словесные знаки?
  • [ ] Самопроверка текста: каждая видимая строка перечитана, не выпущено грамматически сломанных или галлюцинаторных ИИ-фраз (вроде «free on its past»)?
  • [ ] Анимация мотивирована: каждую анимацию можно оправдать одним предложением (иерархия / повествование / обратная связь / переход состояния), нет GSAP «для показухи»?
  • [ ] Бегущая строка - максимум одна на страницу: нет двух горизонтальных бегущих строк на одной странице?
  • [ ] Навигация в ОДНУ строку на десктопе, высота ≤ 80px?
  • [ ] Проверка повтора семейства вёрстки между блоками: нет двух блоков с одним семейством вёрстки (минимум 4 разных семейства на 8 блоков)?
  • [ ] У бенто есть ритм И точное число ячеек (N элементов → N ячеек, нет пустых ячеек посередине или в конце)?
  • [ ] Длинные списки используют правильный компонент интерфейса (не обычный <ul> с divide-y при > 5 пунктов - см. альтернативы в разделе 4.9)?
  • [ ] Использованы настоящие изображения (сначала инструмент генерации, затем Picsum с seed, затем явные места-заглушки) - НИКАКИХ фальшивых скриншотов на div-ах, НИКАКИХ декоративных SVG вручную, НИКАКОГО минимализма из одного текста?
  • [ ] Нет «таблеток»/подписей поверх картинок (никаких Plate · Brand, никаких Field notes - journal)?
  • [ ] Нет подписей с авторством фото как украшения (Field study no. 12 · Ines Caetano)?
  • [ ] Нет подвалов с версиями (v1.4.2, Build 0048) на маркетинговых страницах?
  • [ ] Нет микрометапредложений под надзаголовками («Each of these is a feature we ship today...»)?
  • [ ] Нет декоративной текстовой полосы внизу главного экрана (BRAND. MOTION. SPATIAL.)?
  • [ ] Нет плавающего подтекста в правом верхнем углу заголовков блоков?
  • [ ] Нет шкал оценок/прогресса с залитыми фоновыми дорожками как визуализации сравнения?
  • [ ] Нет полос с локацией / названием города / временем / погодой, если бриф не про по-настоящему глобально распределённую студию или не привязан к месту?
  • [ ] Нет подсказок прокрутки (Scroll, ↓ scroll, Scroll to explore)?
  • [ ] Нет меток версии на главном экране (V0.6, BETA, INVITE-ONLY), если бриф не про запуск?
  • [ ] Нет надзаголовков с нумерацией блоков (00 / INDEX, 001 · Capabilities, 06 · how it works)?
  • [ ] Нет декоративных точек (по умолчанию ноль, только для настоящего смыслового состояния)?
  • [ ] **Нет border-t + border-b на каждой строке** длинных списков / таблиц характеристик?
  • [ ] Плотность содержимого здравая: нет таблиц данных на 20 строк, нет фальшиво-точных характеристик без обоснования, подабзацы по умолчанию ≤ 25 слов?
  • [ ] Цитаты ≤ 3 строк текста, подпись автора чистая (без длинного тире)?
  • [ ] Заявленное движение = показанное движение: если MOTION_INTENSITY > 4, страница действительно анимируется, а не только заявлена?
  • [ ] GSAP sticky-stack / horizontal-pan реализованы по каноническому скелету из раздела 5.A / 5.B (start: "top top", pin: true, правильный scrub)?
  • [ ] **Нет window.addEventListener('scroll')** - используются только useScroll() из Motion / ScrollTrigger / IntersectionObserver / анимации CSS, управляемые прокруткой?
  • [ ] Уменьшенное движение учтено для всего, что при MOTION_INTENSITY > 3?
  • [ ] Токены тёмной темы определены и проверены в обеих темах?
  • [ ] Мобильное схлопывание задано явно (w-full, px-4, max-w-7xl mx-auto) для вёрстки с высоким разбросом?
  • [ ] Стабильность области просмотра: min-h-[100dvh], никогда h-screen?
  • [ ] **Анимации в useEffect** имеют строгие функции очистки?
  • [ ] Пустые / загрузки / ошибки: состояния предусмотрены?
  • [ ] Карточки опущены в пользу отступов, где возможно?
  • [ ] Иконки только из разрешённой библиотеки (Phosphor / HugeIcons / Radix / Tabler), никаких контуров SVG, нарисованных вручную?
  • [ ] Анимация изолирована в клиентских листовых компонентах с 'use client' в первой строке, с мемоизацией?
  • [ ] Нет признаков ИИ из раздела 9 (Inter по умолчанию, ИИ-фиолетовый, три равные карточки, Jane Doe, Acme, «Quietly in use at»)?
  • [ ] Core Web Vitals правдоподобно выполнены (LCP < 2.5 с, INP < 200 мс, CLS < 0.1)?
  • [ ] Одна дизайн-система на проект (нет смеси Material + shadcn)?

Если хоть одну галочку нельзя честно поставить, страница не готова. Исправь это до выдачи.


ПРИЛОЖЕНИЯ - настоящие материалы со ссылками на первоисточники

Разделы ниже - это включённый справочный материал. Он даёт агенту настоящие команды установки, настоящие ссылки на канонические документы и настоящие рабочие стартовые фрагменты для каждой дизайн-системы, названной в разделе 2. Используй их, чтобы опираться на производственную реальность, а не на выдумки из обучающих данных.

Приложение A - команды установки для каждой дизайн-системы

# Material Web (Material 3)
npm install @material/web

# Fluent UI React (v9)
npm install @fluentui/react-components

# Fluent UI Web Components (framework-free)
npm install @fluentui/web-components @fluentui/tokens

# IBM Carbon
npm install @carbon/react @carbon/styles

# Radix Themes
npm install @radix-ui/themes

# shadcn/ui (open code, owned components)
npx shadcn@latest init
npx shadcn@latest add button card badge separator input

# Primer CSS (GitHub product/devtool UI)
npm install --save @primer/css

# Primer Brand (GitHub marketing UI)
npm install @primer/react-brand

# GOV.UK Frontend
npm install govuk-frontend

# USWDS (US Web Design System)
npm install uswds

# Atlassian Design System (Atlaskit)
yarn add @atlaskit/css-reset @atlaskit/tokens @atlaskit/button @atlaskit/badge @atlaskit/section-message @atlaskit/card

# Bootstrap 5.3
npm install bootstrap

# Shopify Polaris Web Components (Shopify apps only)
# Add this to your app HTML head:
#   <meta name="shopify-api-key" content="%SHOPIFY_API_KEY%" />
#   <script src="https://cdn.shopify.com/shopifycloud/polaris.js"></script>

Приложение B - канонические источники (прочитай, прежде чем изобретать заново)

Material Web

Fluent UI

Carbon

Shopify Polaris

Atlassian

Primer

GOV.UK

USWDS

Bootstrap

Tailwind

Radix

shadcn/ui

Нативный CSS / стандарты W3C

Apple Liquid Glass (только платформы Apple)


Приложение C - Apple Liquid Glass: честное веб-приближение

Не считай случайные фрагменты CSS официальным Apple Liquid Glass.

Что официально

Apple документирует Liquid Glass в Руководстве по человеческому интерфейсу (Human Interface Guidelines) и документации для разработчиков Apple для платформ Apple. Это динамический материал, используемый в интерфейсе платформ Apple. Нативная реализация Apple принадлежит API платформ Apple и системным компонентам, а не публичному веб-пакету CSS.

Соответствующие официальные документы:

  • Apple Human Interface Guidelines → Materials
  • Документация для разработчиков Apple → Liquid Glass
  • Документация для разработчиков Apple → Adopting Liquid Glass
  • SwiftUI → Material

Что НЕ официально

Для обычных сайтов у Apple нет liquid-glass.css.

Веб-приближение может использовать:

  • backdrop-filter
  • прозрачные фоны
  • многослойные рамки
  • подсвечивающие слои
  • градиенты
  • анимацию
  • запасные варианты с сильным контрастом

Но это веб-глассморфизм / приближение «матового стекла», а не официальный Apple Liquid Glass. Подпиши это так в комментариях.

Скелет более безопасного веб-приближения

.liquid-glass-web-approx {
  position: relative;
  isolation: isolate;
  overflow: hidden;
  border-radius: 999px;
  border: 1px solid rgb(255 255 255 / .32);
  background:
    linear-gradient(135deg, rgb(255 255 255 / .30), rgb(255 255 255 / .08)),
    rgb(255 255 255 / .12);
  backdrop-filter: blur(24px) saturate(180%) contrast(1.05);
  -webkit-backdrop-filter: blur(24px) saturate(180%) contrast(1.05);
  box-shadow:
    inset 0 1px 0 rgb(255 255 255 / .48),
    inset 0 -1px 0 rgb(255 255 255 / .12),
    0 18px 60px rgb(0 0 0 / .18);
}

.liquid-glass-web-approx::before {
  content: "";
  position: absolute;
  inset: 0;
  z-index: -1;
  border-radius: inherit;
  background:
    radial-gradient(circle at 20% 0%, rgb(255 255 255 / .55), transparent 34%),
    linear-gradient(90deg, rgb(255 255 255 / .18), transparent 42%, rgb(255 255 255 / .14));
  pointer-events: none;
}

.liquid-glass-web-approx::after {
  content: "";
  position: absolute;
  inset: 1px;
  border-radius: inherit;
  border: 1px solid rgb(255 255 255 / .14);
  pointer-events: none;
}

@media (prefers-color-scheme: dark) {
  .liquid-glass-web-approx {
    border-color: rgb(255 255 255 / .18);
    background:
      linear-gradient(135deg, rgb(255 255 255 / .16), rgb(255 255 255 / .04)),
      rgb(15 23 42 / .42);
    box-shadow:
      inset 0 1px 0 rgb(255 255 255 / .22),
      0 18px 60px rgb(0 0 0 / .42);
  }
}

@media (prefers-reduced-transparency: reduce) {
  .liquid-glass-web-approx {
    background: rgb(255 255 255 / .96);
    backdrop-filter: none;
    -webkit-backdrop-filter: none;
  }
}

Важно: у prefers-reduced-transparency неравномерная поддержка в браузерах; проверь это. Всегда обеспечивай достаточный контраст даже без размытия.


Конец приложений. Команды установки выше - опорные точки реальности. Скелет Apple Liquid Glass - это подписанное приближение, а не пакет, выпущенный Apple. Канонические документы по каждой дизайн-системе смотри в официальной документации системы (ссылки в разделе 2 плюс приложение B).

Перевод: iiuniversitet. Оригинал: https://github.com/leonxlnx/taste-skill/tree/main/skills/taste-skill, лицензия MIT. Изменения: перевод на русский язык.

Оригинал на английском
---
name: design-taste-frontend
description: Anti-slop frontend skill for landing pages, portfolios, and redesigns. The agent reads the brief, infers the right design direction, and ships interfaces that do not look templated. Real design systems when applicable, audit-first on redesigns, strict pre-flight check.
---

# tasteskill: Anti-Slop Frontend Skill

> Landing pages, portfolios, and redesigns. Not dashboards, not data tables, not multi-step product UI.
> Every rule below is **contextual**. None of it fires automatically. First read the brief, then pull only what fits.

---

## 0. BRIEF INFERENCE (Read the Room Before Anything Else)

Before touching code or tweaking dials, **infer what the user actually wants**. Most LLM design output is bad because the model jumps to a default aesthetic instead of reading the room.

### 0.A Read these signals first
1. **Page kind** - landing (SaaS / consumer / agency / event), portfolio (dev / designer / creative studio), redesign (preserve vs overhaul), editorial / blog.
2. **Vibe words** the user used - "minimalist", "calm", "Linear-style", "Awwwards", "brutalist", "premium consumer", "Apple-y", "playful", "serious B2B", "editorial", "agency-y", "glassy", "dark tech".
3. **Reference signals** - URLs they linked, screenshots they pasted, products they named, brands they're competing with.
4. **Audience** - B2B procurement panel vs. design-conscious consumer vs. recruiter scanning a portfolio. The audience picks the aesthetic, not your taste.
5. **Brand assets that already exist** - logo, color, type, photography. For redesigns, these are starting material, not optional input (see Section 11).
6. **Quiet constraints** - accessibility-first audiences, public-sector, regulated industries, trust-first commerce, kids' products. These constraints OVERRIDE aesthetic preference.

### 0.B Output a one-line "Design Read" before generating
Before any code, state in one line: **"Reading this as: \<page kind> for \<audience>, with a \<vibe> language, leaning toward \<design system or aesthetic family>."**

Example reads:
- *"Reading this as: B2B SaaS landing for technical buyers, with a Linear-style minimalist language, leaning toward Tailwind utilities + Geist + restrained motion."*
- *"Reading this as: solo designer portfolio for hiring managers, with an editorial / kinetic-type language, leaning toward native CSS + scroll-driven animation + custom typography."*
- *"Reading this as: redesign of a public-sector service site, with a trust-first language, leaning toward GOV.UK Frontend or USWDS."*

### 0.C If the brief is ambiguous, ask one question, do not guess
Ask exactly **one** clarifying question - never a multi-question dump - and only when the design read genuinely diverges. Example: *"Should this feel closer to Linear-clean or Awwwards-experimental?"*

If you can confidently infer from context, **do not ask**. Just declare the design read and proceed.

### 0.D Anti-Default Discipline
Do not default to: AI-purple gradients, centered hero over dark mesh, three equal feature cards, generic glassmorphism on everything, infinite-loop micro-animations everywhere, Inter + slate-900. These are the LLM defaults. Reach past them deliberately based on the design read.

---

## 1. THE THREE DIALS (Core Configuration)

After the design read, set three dials. Every layout, motion, and density decision below is gated by these.

* **`DESIGN_VARIANCE: 8`** - 1 = Perfect Symmetry, 10 = Artsy Chaos
* **`MOTION_INTENSITY: 6`** - 1 = Static, 10 = Cinematic / Physics
* **`VISUAL_DENSITY: 4`** - 1 = Art Gallery / Airy, 10 = Cockpit / Packed Data

**Baseline:** `8 / 6 / 4`. Use these unless the design read overrides them. Do not ask the user to edit this file - overrides happen conversationally.

### 1.A Dial Inference (design read → dial values)
| Signal | VARIANCE | MOTION | DENSITY |
|---|---|---|---|
| "minimalist / clean / calm / editorial / Linear-style" | 5-6 | 3-4 | 2-3 |
| "premium consumer / Apple-y / luxury / brand" | 7-8 | 5-7 | 3-4 |
| "playful / wild / Dribbble / Awwwards / experimental / agency" | 9-10 | 8-10 | 3-4 |
| "landing page / portfolio / marketing site (default)" | 7-9 | 6-8 | 3-5 |
| "trust-first / public-sector / regulated / accessibility-critical" | 3-4 | 2-3 | 4-5 |
| "redesign - preserve" | match existing | +1 | match existing |
| "redesign - overhaul" | +2 | +2 | match existing |

### 1.B Use-Case Presets
| Use case | VARIANCE | MOTION | DENSITY |
|---|---|---|---|
| Landing (SaaS, mainstream) | 7 | 6 | 4 |
| Landing (Agency / creative) | 9 | 8 | 3 |
| Landing (Premium consumer) | 7 | 6 | 3 |
| Portfolio (Designer / studio) | 8 | 7 | 3 |
| Portfolio (Developer) | 6 | 5 | 4 |
| Editorial / Blog | 6 | 4 | 3 |
| Public-sector service | 3 | 2 | 5 |
| Redesign - preserve | match | match+1 | match |
| Redesign - overhaul | +2 | +2 | match |

### 1.C How the Dials Drive Output
Use these (or user-overridden values) as global variables. Cross-references throughout this document refer to these exact variable names - never invent aliases like `LAYOUT_VARIANCE` or `ANIM_LEVEL`.

---

## 2. BRIEF → DESIGN SYSTEM MAP

Once you have the design read (Section 0) and dials (Section 1), pick the right foundation. Do not invent CSS for things that have an official package. Do not pretend an aesthetic trend is an official system.

### 2.A When to reach for a real design system (use official packages)
| Brief reads as… | Reach for | Why |
|---|---|---|
| Microsoft / enterprise SaaS / dashboards | `@fluentui/react-components` or `@fluentui/web-components` | Official Fluent UI, Microsoft tokens, accessibility done |
| Google-ish UI, Material-flavored product | `@material/web` + Material 3 tokens | Official, theme-able via Material Theming |
| IBM-style B2B / enterprise analytics | `@carbon/react` + `@carbon/styles` | Official Carbon, mature data-density patterns |
| Shopify app surfaces | `polaris.js` web components / Polaris React | Required for Shopify admin UI |
| Atlassian / Jira-style product | `@atlaskit/*` + `@atlaskit/tokens` | Official Atlassian DS |
| GitHub-style devtool / community page | `@primer/css` or `@primer/react-brand` | Official Primer; Brand variant for marketing |
| Public-sector UK service | `govuk-frontend` | Legally / regulatorily expected |
| US public-sector / trust-first | `uswds` | Same |
| Fast local-business / agency MVP | Bootstrap 5.3 | Boring, fast, works |
| Modern accessible React foundation | `@radix-ui/themes` | Primitives + polished theme |
| Modern SaaS where you own the components | shadcn/ui (`npx shadcn@latest add ...`) | You own the code, easy to customise; never ship default state |
| Tailwind-based modern SaaS / AI marketing | Tailwind v4 utilities + `dark:` variant | Default for indie + small team builds |

**Honesty rule:** if the brief reads as one of the systems above, install and use the **official** package. Do not recreate its CSS by hand. Do not import a system's tokens but then override 90% of them.

**One system per project.** Do not mix Fluent React with Carbon in the same tree. Do not import shadcn/ui components into a Material 3 app.

### 2.B When the brief is an aesthetic, not a system
For these directions, there is **no single official package**. Build with native CSS + Tailwind + a maintained component library. Be honest in code comments about what is borrowed inspiration vs. official material.

| Aesthetic | Honest implementation |
|---|---|
| Glassmorphism / "frosted glass" | `backdrop-filter`, layered borders, highlight overlays. Provide solid-fill fallback for `prefers-reduced-transparency`. |
| Bento (Apple-style tile grids) | CSS Grid with mixed cell sizes. No single library owns this. |
| Brutalism | Native CSS, monospace, raw borders. No library. |
| Editorial / magazine | Serif type, asymmetric grid, generous whitespace. No library. |
| Dark tech / hacker | Mono + accent neon, terminal motifs. No library. |
| Aurora / mesh gradients | SVG or layered radial gradients. No library. |
| Kinetic typography | Native CSS animations, scroll-driven animations, GSAP for hijacks. No library. |
| **Apple Liquid Glass** | Apple documents this for Apple platforms only. **There is no official `liquid-glass.css`.** Web implementations are approximations using `backdrop-filter` + layered borders + highlights. Label clearly as approximation. |

---

## 3. DEFAULT ARCHITECTURE & CONVENTIONS

Unless the design read picks a real design system (Section 2.A), these are the defaults:

### 3.A Stack
* **Framework:** React or Next.js. Default to Server Components (RSC).
  * **RSC SAFETY:** Global state works ONLY in Client Components. In Next.js, wrap providers in a `"use client"` component.
  * **INTERACTIVITY ISOLATION:** Any component using Motion, scroll listeners, or pointer physics MUST be an isolated leaf with `'use client'` at the top. Server Components render static layouts only.
* **Styling:** **Tailwind v4** (default). Tailwind v3 only if the existing project demands it.
  * For v4: do NOT use `tailwindcss` plugin in `postcss.config.js`. Use `@tailwindcss/postcss` or the Vite plugin.
* **Animation:** **Motion** (the library formerly known as Framer Motion). Import from `motion/react` (`import { motion } from "motion/react"`). The `framer-motion` package still works as a legacy alias - prefer `motion/react` in new code.
* **Fonts:** Always use `next/font` (Next.js) or self-host with `@font-face` + `font-display: swap`. Never link Google Fonts via `<link>` in production.

### 3.B State
* Local `useState` / `useReducer` for isolated UI.
* Global state ONLY for deep prop-drilling avoidance - Zustand, Jotai, or React context.
* **NEVER** use `useState` to track continuous values driven by user input (mouse position, scroll progress, pointer physics, magnetic hover). Use Motion's `useMotionValue` / `useTransform` / `useScroll`. `useState` re-renders the React tree on every change and collapses on mobile.

### 3.C Icons
* **Allowed libraries (priority order):** `@phosphor-icons/react`, `hugeicons-react`, `@radix-ui/react-icons`, `@tabler/icons-react`.
* **Discouraged:** `lucide-react`. Acceptable only when the user explicitly asks for it or the project already depends on it.
* **NEVER hand-roll SVG icons.** If a glyph is missing, install a second library or compose from primitives - do not draw icon paths from scratch.
* **One family per project.** Do not mix Phosphor with Lucide in the same component tree.
* **Standardize `strokeWidth` globally** (e.g. `1.5` or `2.0`).

### 3.D Emoji Policy
Discouraged by default in code, markup, and visible text. Replace symbols with icon-library glyphs. **Override:** allow emojis only when the user explicitly asks for a playful / chat-style / social-native vibe - and even then use them sparingly with intent.

### 3.E Responsiveness & Layout Mechanics
* Standardize breakpoints (`sm 640`, `md 768`, `lg 1024`, `xl 1280`, `2xl 1536`).
* Contain page layouts using `max-w-[1400px] mx-auto` or `max-w-7xl`.
* **Viewport Stability:** NEVER use `h-screen` for full-height Hero sections. ALWAYS use `min-h-[100dvh]` to prevent layout jumping on mobile (iOS Safari address bar).
* **Grid over Flex-Math:** NEVER use complex flexbox percentage math (`w-[calc(33%-1rem)]`). ALWAYS use CSS Grid (`grid grid-cols-1 md:grid-cols-3 gap-6`).

### 3.F Dependency Verification (mandatory)
Before importing ANY 3rd-party library, check `package.json`. If the package is missing, output the install command first. **Never** assume a library exists.

---

## 4. DESIGN ENGINEERING DIRECTIVES (Bias Correction)

LLMs default to clichés. Override these defaults proactively. Each rule has a context-aware override path.

### 4.1 Typography
* **Display / Headlines:** Default `text-4xl md:text-6xl tracking-tighter leading-none`.
* **Body / Paragraphs:** Default `text-base text-gray-600 leading-relaxed max-w-[65ch]`.
* **Sans font choice:**
  * **Discouraged as default:** `Inter`. Pick `Geist`, `Outfit`, `Cabinet Grotesk`, `Satoshi`, or a brand-appropriate serif first.
  * **Override:** Inter is acceptable when the user explicitly asks for a neutral / standard / Linear-style feel, or when the brief is a public-sector / accessibility-first site.
* **Pairings to know:** `Geist` + `Geist Mono`, `Satoshi` + `JetBrains Mono`, `Cabinet Grotesk` + `Inter Tight`, `GT America` + `IBM Plex Mono`.

* **SERIF DISCIPLINE (VERY DISCOURAGED AS DEFAULT):**
  * Serif is **very discouraged as the default font for any project.** "It feels creative / premium / editorial" is NOT a reason to reach for serif. The agent's default mental model that "creative brief = serif" is the single most-tested AI tell in production rounds.
  * **Serif is only acceptable when ONE of these is explicitly true:**
    - The brand brief literally names a serif font, OR
    - The aesthetic family is genuinely editorial / luxury / publication / manuscript / heritage / vintage AND you can articulate why this specific serif fits this specific brand
  * For everything else (creative agency, design studio, modern brand, premium consumer, portfolio, lifestyle), **default sans-serif display** (Geist Display, ABC Diatype, Söhne Breit, Cabinet Grotesk Display, Migra Sans, GT Walsheim, Inter Display, PP Neue Montreal). Sans display fonts are not "boring" — they are the default for the same reason black is the default in fashion.
  * **EMPHASIS RULE (related):** When you want to emphasize a word within a headline (the kinetic "and `spatial` design" type move), use **italic or bold of the SAME font**. Do NOT inject a random serif word into a sans headline (or vice versa) just to add visual interest. Mixed-family emphasis is amateur. Italic/bold emphasis in the same family is the right move.
  * **Specifically BANNED as defaults:** `Fraunces` and `Instrument_Serif` (the two LLM-favorite display serifs).
  * **If a serif is justified** (rare, per the above), rotate from this pool, do NOT reuse the same serif across consecutive projects: PP Editorial New, GT Sectra Display, Cardinal Grotesque, Reckless Neue, Tiempos Headline, Recoleta, Cormorant Garamond, Playfair Display, EB Garamond, IvyPresto, Migra, Editorial Old, Saol Display, Söhne Breit Kursiv, Domaine Display, Canela, Schnyder, Tobias, NB Architekt, ITC Galliard.

* **ITALIC DESCENDER CLEARANCE (mandatory):** When italic is used in display type and the word contains a descender letter (`y g j p q`), `leading-[1]` or `leading-none` will clip the descender. Use `leading-[1.1]` minimum and add `pb-1` or `mb-1` reserve on the wrapping element. Audit every italic word in display headlines before shipping.

### 4.2 Color Calibration
* Max 1 accent color. Saturation < 80% by default.
* **THE LILA RULE:** The "AI Purple / Blue glow" aesthetic is discouraged as a default. No automatic purple button glows, no random neon gradients. Use neutral bases (Zinc / Slate / Stone) with high-contrast singular accents (Emerald, Electric Blue, Deep Rose, Burnt Orange, etc.).
* **Override:** if the brand or brief explicitly asks for purple / violet / lila, embrace it. But execute with intent: consistent palette, harmonised neutrals, restrained gradients. Not generic AI gradient slop.
* **One palette per project.** Do not fluctuate between warm and cool grays within the same project.
* **COLOR CONSISTENCY LOCK (mandatory):** Once an accent color is chosen for a page, it is used on the WHOLE page. A warm-grey site does not suddenly get a blue CTA in section 7. A rose-accented site does not get a teal status badge in the footer. Pick one accent, lock it, audit every component before shipping.

* **PREMIUM-CONSUMER PALETTE BAN (mandatory, second-most-recurring AI-tell):**
  * For premium-consumer briefs (cookware, wellness, artisan, luxury, heritage craft, DTC home goods, etc.) the LLM default is **warm beige/cream + brass/clay/oxblood/ochre + espresso/ink dark text**. Concretely banned hex families as default backgrounds and accents:
    - Backgrounds: `#f5f1ea`, `#f7f5f1`, `#fbf8f1`, `#efeae0`, `#ece6db`, `#faf7f1`, `#e8dfcb` (all "warm paper / cream / chalk / bone")
    - Accents: `#b08947`, `#b6553a`, `#9a2436`, `#9c6e2a`, `#bc7c3a`, `#7d5621` (all "brass / clay / oxblood / ochre")
    - Text: `#1a1714`, `#1a1814`, `#1b1814` (all "espresso / warm near-black")
  * This palette is BANNED as the default reach for premium-consumer briefs. Every premium-consumer site you have ever shipped uses this exact palette. The brand becomes invisible.
  * **Default alternatives (rotate, do not reuse):**
    - **Cold Luxury:** silver-grey + chrome + smoke (think Tesla, Apple Watch Hermes-without-the-leather)
    - **Forest:** deep green + bone + amber accent (think Filson, Patagonia premium)
    - **Black and Tan:** true off-black + warm tan, sharp contrast, no beige
    - **Cobalt + Cream:** saturated blue against a single neutral, no brass
    - **Terracotta + Slate:** warm rust against cool grey, no brass
    - **Olive + Brick + Paper:** muted olive plus brick-red accent
    - **Pure monochrome + single saturated pop:** off-white + off-black + one bright accent (electric blue, emerald, hot pink, etc.)
  * **Palette-rotation rule:** if the previous premium-consumer project you generated used the beige+brass family, this one MUST use a different family. Do not ship the same warm-craft palette twice in a row.
  * **Override:** the beige+brass+espresso palette is acceptable ONLY when the brand brief explicitly names those colors, or when the brand identity is genuinely vintage / artisan / warm-craft AND you can articulate why this specific palette fits this specific brand. Default-reaching for it because "this is a cookware brief" is banned.

### 4.3 Layout Diversification
* **ANTI-CENTER BIAS:** Centered Hero / H1 sections are avoided when `DESIGN_VARIANCE > 4`. Force "Split Screen" (50/50), "Left-aligned content / right-aligned asset", "Asymmetric white-space", or scroll-pinned structures.
* **Override:** centered hero is OK for editorial / manifesto / launch-announcement briefs where the message itself is the design.

### 4.4 Materiality, Shadows, Cards
* Use cards ONLY when elevation communicates real hierarchy. Otherwise group with `border-t`, `divide-y`, or negative space.
* When a shadow is used, tint it to the background hue. No pure-black drop shadows on light backgrounds.
* For `VISUAL_DENSITY > 7`: generic card containers are banned. Data metrics breathe in plain layout.
* **SHAPE CONSISTENCY LOCK (mandatory):** Pick ONE corner-radius scale for the page and stick to it. Options: all-sharp (radius 0), all-soft (radius 12-16px), all-pill (full radius for interactive). Mixed systems are allowed only when there is a documented rule (e.g. "buttons are full-pill, cards are 16px, inputs are 8px") and that rule is followed everywhere. Round buttons in a square layout, or square cards on a pill-button page, is broken design.

### 4.5 Interactive UI States
LLMs default to "static successful state only." Always implement full cycles:
* **Loading:** Skeletal loaders matching the final layout's shape. Avoid generic circular spinners.
* **Empty States:** Beautifully composed; indicate how to populate.
* **Error States:** Clear, inline (forms), or contextual (toasts only for transient).
* **Tactile Feedback:** On `:active`, use `-translate-y-[1px]` or `scale-[0.98]` to simulate a physical push.
* **BUTTON CONTRAST CHECK (mandatory, a11y):** Before shipping any button, verify the button text is readable against the button background. White button + white text, `bg-white` CTA with `text-white` label, transparent button against the page background with no border → all banned. Audit every CTA: contrast ratio WCAG AA min (4.5:1 for body, 3:1 for large text 18px+). Same rule applies to ghost buttons over photographic backgrounds (use a backdrop, scrim, or stroke).
* **CTA BUTTON WRAP BAN (mandatory):** Button text MUST fit on one line at desktop. If a label like "VIEW SELECTED WORK" wraps to 2 or 3 lines, the button is broken. Fix by EITHER shortening the label (3 words max for primary CTAs, ideally 1-2) OR widening the button (do not artificially constrain `max-width` on CTAs). Wrapped CTAs at desktop are a Pre-Flight Fail.
* **NO DUPLICATE CTA INTENT (mandatory):** Two CTAs with the same intent on one page is a Pre-Flight Fail. Examples of same intent: "Get in touch" + "Contact us" + "Let's talk" + "Start a project" + "Start something" + "Reach out" = all "contact" intent → pick ONE label and use it everywhere on the page (nav, hero, footer). Same for "Try free" + "Get started" + "Sign up free" (all "signup" intent) and "View work" + "See selected work" + "Browse projects" (all "portfolio" intent). One label per intent.
* **FORM CONTRAST CHECK (mandatory, a11y):** Form inputs, placeholder text, focus rings, helper text, and error text all pass WCAG AA contrast against the section background. Light placeholders on a near-white form, white form on white page section, form labels grayer than 4.5:1 contrast → all banned. Audit every form before shipping.

### 4.6 Data & Form Patterns
* Label ABOVE input. Helper text optional but present in markup. Error text BELOW input. Standard `gap-2` for input blocks.
* No placeholder-as-label. Ever.

### 4.7 Layout Discipline (Hard Rules. Failing any of these is shipping broken work)

* **Hero MUST fit in the initial viewport.** Headline max 2 lines on desktop, subtext max **20 words** AND max 3-4 lines, CTAs visible without scroll. If the copy is too long: reduce font scale OR cut copy. If you cannot describe the value-prop in 20 words of subtext, the value-prop is unclear, not the rule too tight. Never let the hero overflow and force scroll to find the CTA.
* **Hero font-scale discipline.** Plan font size and image size *together*. If the hero asset is large and the headline is more than 6 words, do not start at `text-7xl/text-8xl`. Default sensible range: `text-4xl md:text-5xl lg:text-6xl` for most heroes; `text-6xl md:text-7xl` only when the headline is 3-5 words. A 4-line hero headline is always a font-size error, never a copy-length error.
* **HERO TOP PADDING CAP (mandatory):** Hero top padding max `pt-24` (≈6rem) at desktop. More than that means the hero content floats halfway down the viewport and reads as a layout bug, not as intentional space. If your hero needs more breathing room, increase font scale or asset size, not top padding.
* **HERO STACK DISCIPLINE (max 4 text elements).** The hero is a single moment, not a feature list. Allowed text elements, max 4 in total:
  1. Eyebrow (small uppercase label) OR brand strip OR neither - pick zero or one
  2. Headline (max 2 lines, see above)
  3. Subtext (max 20 words, max 4 lines)
  4. CTAs (1 primary + max 1 secondary)
  - **BANNED in the hero:** tiny tagline below CTAs ("Works with GitHub, GitLab, and self-hosted Git"), trust micro-strip ("Used by engineering teams at..."), pricing teaser ("Free for solo, $10/user for teams"), feature bullet list, social-proof avatar row. All of those move to dedicated sections directly below the hero.
  - If you have an eyebrow AND a tagline below CTAs in the same hero, drop the tagline. If you have a brand strip AND a tagline, drop the tagline. One small text element per hero, max.
* **"Used by" / "Trusted by" logo wall belongs UNDER the hero, never inside it.** The hero is for the value prop and primary CTA. The logo wall is a separate section directly below. Do not stuff trust logos into the same flex row as the hero copy.
* **Navigation MUST render on a single line on desktop.** If items don't fit at `lg` (1024px), condense labels, drop secondary items, or move to a hamburger. A two-line nav at desktop is broken design.
* **Navigation height cap: 80px max desktop, default 64-72px.** No huge "agency" nav bars that eat 15% of the viewport.
* **Bento grids MUST have rhythm, not one-sided repetition.** Do not stack 6 left-image / right-text rows. Vary the composition: alternate full-width feature rows, asymmetric tile sizes, vertical breaks.
* **BENTO CELL COUNT RULE (mandatory):** A bento grid has EXACTLY as many cells as you have content for. 3 items → 3 cells (1+2 split, or 2+1, or asymmetric trio). 5 items → 5 cells (2+3, 3+2, hero+4, etc.). If your grid has an empty cell in the middle or at the end, you planned wrong. Re-shape the grid; do not paste a blank tile.
* **Section-Layout-Repetition Ban.** Once you use a layout family for a section (e.g., 3-column-image-cards, full-width-quote, split-text-image), that family can appear at most ONCE on the page. "Selected commissions" must not look like "What we do." A landing page with 8 sections must use at least 4 different layout families.
* **ZIGZAG ALTERNATION CAP (mandatory).** Alternating "left-image + right-text" then "left-text + right-image" zigzag layout = banal. Max 2 sections in a row with this image+text-split pattern. The 3rd consecutive image+text split is a Pre-Flight Fail. Break the pattern with a full-width section, a vertical-stack section, a bento grid, a marquee, or a different layout family.
* **EYEBROW RESTRAINT (mandatory, the #1 violated rule in production tests).** An "eyebrow" is the small uppercase wide-tracking label sitting above a section headline (e.g. `FOUR COLORWAYS`, `SELECTED WORK`, `THE HARDWARE`, `Git-native task management`). Typical CSS signature: `text-[11px] uppercase tracking-[0.18em]`, `font-mono text-[10.5px] uppercase tracking-[0.22em]`. Every AI-built site puts an eyebrow above EVERY section header, producing the same templated rhythm. Hard rule:
  - **Maximum 1 eyebrow per 3 sections.** Hero counts as 1. So a page with 9 sections may use at most 3 eyebrows total.
  - If section A has an eyebrow, the next 2 sections cannot have one.
  - **Pre-Flight Check is mechanical:** count instances of `uppercase tracking` (or similar small-caps mono labels above headlines) across all section components. If count > ceil(sectionCount / 3), the output fails.
  - **What to do instead of an eyebrow:** drop it entirely. The headline alone is enough. If you need to categorize a section, the section's location on the page already categorizes it; no label needed.
* **SPLIT-HEADER BAN (mandatory).** The pattern "left big headline + right small explainer paragraph" as a section header (left col-span-7/8, right col-span-4/5 with a small body paragraph floating in the right column) is **banned as default**. Sections should have ONE focused message. If you genuinely need both a headline and an explainer paragraph, stack them vertically (headline on top, body below, max-width 65ch). Reach for the split-header pattern only when there is a real compositional reason (e.g., the right column carries a visual or interactive element, not just filler text).
* **Bento Background Diversity (mandatory).** Bento and feature-grid sections cannot be 6 white-on-white cards with text inside. At least 2-3 cells in any multi-cell grid need real visual variation: a real image, a brand-appropriate gradient (not AI-purple), a pattern, a tinted background. A cream-on-cream bento with only typography inside reads as boring AI default, even when the rest of the page is good.
* **Mobile collapse must be explicit per section.** For every multi-column layout, declare the `< 768px` fallback in the same component. No "it'll work, Tailwind handles it" assumptions.

### 4.8 Image & Visual Asset Strategy

Landing pages and portfolios are **visual products**. Text-only pages with fake-screenshot divs are slop.

**Priority order for visual assets:**
1. **Image-generation tool first.** If ANY image-gen tool is available in the environment (`generate_image`, MCP image tool, IDE-integrated gen, OpenAI image tools, etc.) you MUST use it to create section-specific assets: hero photography, product shots, texture backgrounds, mood images. Generate at the right aspect ratio for the section. Do not skip this step because hand-rolled CSS feels faster.
2. **Real web images second.** When no gen tool is available, use real photography sources. Acceptable defaults:
   * `https://picsum.photos/seed/{descriptive-seed}/{w}/{h}` for placeholder photography (seed should describe the section, e.g. `marrow-cookware-kitchen`)
   * Actual stock or brand URLs when the brief provides them
   * Open-license sources (Unsplash via direct URL, Pexels) if explicitly allowed
3. **Last resort: tell the user.** If neither is possible, do NOT fill the page with hand-rolled SVG illustrations or div-based "fake screenshots." Instead, leave clearly-labeled placeholder slots (`<!-- TODO: hero product photo, 1600x1200 -->`) and at the end of the response say: *"This page needs real images at: \[list of placements\]. Please generate or provide them."*

**Even minimalist sites need real images.** A pure-text page is not minimalism. It is incomplete work. Even an editorial Linear-style site needs at least 2-3 real images (hero, one product/lifestyle shot, one supporting image). Generate B&W minimalist photography if the brief is restrained; do not skip images entirely because the dial is low.

**Real company logos for social proof.** When the brief calls for a "Trusted by / Used by / Customers" logo wall, do NOT default to plain text wordmarks (`<span>Acme Co</span>` styled in a row). Use real SVG logos:
* **Source: Simple Icons** (`https://cdn.simpleicons.org/{slug}/ffffff` for any color, or `simple-icons` npm package). Covers most known brands.
* **Alternative: devicon** for tech-stack logos (`@svgr/cli` or CDN).
* **Make-up the brand name? Then make-up an SVG mark too.** Generate a simple monogram (one letter in a circle, two-letter ligature, abstract glyph) rendered as an inline `<svg>` matching the page style. Plain text wordmarks for invented brand names look generic.
* **Always** ensure logos render in both light and dark mode (white-on-dark, black-on-light, or single-color theme variable).
* **LOGO-ONLY rule (mandatory):** logo wall = logos and nothing else. Do NOT print industry / category labels below each logo (no `Vercel` + `hosting` underneath, no `Stripe` + `payments`, no `Cloudflare` + `infra`). The logo is the credibility, the label adds nothing the user does not already know. Optional: brand name as alt-text for screen readers, optional link to the brand's site. That is it.

**Hand-rolled illustrations:**
* SVG icons from libraries: fine (see Section 3.C).
* Hand-rolled decorative SVGs (custom illustrations, logos, marks): **strongly discouraged**, never as default. Acceptable only when:
  - The brief explicitly calls for it ("draw me an SVG logo")
  - It's a single, simple geometric mark (a square, a circle, a wordmark in display type)
  - You're confident in the output quality

**Div-based fake screenshots are banned.** A "hand-built product preview" rendered with `<div>` rectangles, fake task lists, fake dashboards, fake terminal windows is a Tell. If you need to show a product:
* Use a real screenshot URL if one exists
* Generate one via image tool
* Use a real component preview (an actual mini-version of the UI inside the page)
* Or skip the preview entirely and use editorial photography

**Hero needs a real visual.** Text + gradient blob is not a hero - it's a placeholder.

### 4.9 Content Density

Landing pages live on the **first impression**, not the full read. Cut ruthlessly.

* **Default content shape per section:** short headline (≤ 8 words) + short sub-paragraph (≤ 25 words) + one visual asset OR one CTA. Anything more must be justified by the section's job.
* **No data-dump sections.** A 20-row publication table, a 30-row award list, a giant pricing matrix on a marketing page = wrong layout. Use:
  - Top 3-5 highlights + "View full list" link
  - Marquee / carousel for breadth
  - Different page entirely if the data is the product
* **Long lists need a different UI component, not a longer list.** Default `<ul>` with bullets / `divide-y` rows is the lazy choice. If you have > 5 items, reach for one of these instead:
  - 2-column split with grouped items
  - Card grid with image + label per item
  - Tabs / accordion if items are categorisable
  - Horizontal scroll-snap pills
  - Carousel for breadth-heavy lists (testimonials, logos, capabilities)
  - Marquee for "lots-of-things-that-don't-need-individual-attention"
  A spec sheet with 10 rows + a hairline under every row is the WORST default. Either group rows into 2-3 chunks with sparse dividers, or move to a card-per-spec layout.
* **Spec sheets specifically (the Marrow-cookware pattern).** A long product specification table with `border-b` on every row is the AI default for cookware / hardware / apparel / artisan-goods briefs. Banned. Concrete alternatives:
  - **2-col card grid:** each spec gets its own card with the spec name, the value (large display number), and a one-line "why it matters" body. Cards arranged 2-col on desktop, 1-col mobile.
  - **Scroll-snap horizontal pills:** each spec is a pill, user can flick through.
  - **Grouped chunks:** group 10 specs into 3 logical clusters (e.g. "Materials", "Cooking", "Warranty"), each cluster gets ONE soft divider and a cluster heading.
  - **Featured-vs-rest:** 3-4 hero specs visualised as large display tiles, the rest collapsed under a "View full specifications" disclosure.

* **COPY SELF-AUDIT (mandatory before ship):** Before declaring any task done, re-read every visible string on the page (headlines, subheads, eyebrows, button labels, body copy, captions, alt text, footer text, error messages). Flag any string that is:
  - **Grammatically broken** ("free on its past", "two plans but one is honest", "to put it on the table" out of context)
  - **Has unclear referents** ("we plan to stay that way" without prior context)
  - **Sounds like AI hallucination** (cute-but-wrong wordplay, forced metaphors that don't track, "elegant nothing" phrases)
  - **Reads like an LLM trying to sound thoughtful** (passive-aggressive humility, fake-craftsman labels, mock-poetic micro-meta)
  Rewrite every flagged string. If unsure whether a string makes sense, replace it with a plain functional sentence. AI-generated cute copy is worse than boring copy.
* **Fake-precise numbers are flagged.** Numbers like `92%`, `4.1×`, `48k`, `5.8 mm`, `13.4 lb` either:
  - Come from real data (brief, brand guidelines, public metrics) - fine
  - Are explicitly labeled as mock (`<!-- mock -->`, "example", "sample data") - fine
  - Are AI-invented spec aesthetics - banned. Don't fake engineering precision the brand doesn't claim.
* **One copy register per page.** Don't mix technical mono ("47 tasks · 0.6 ctx-switches/day"), editorial prose, and marketing punch in the same composition unless the brand voice explicitly calls for it.

### 4.10 Quotes & Testimonials

* **Max 3 lines** of quote body. Never 6. If the original quote is longer → cut it. A landing-page quote is a snippet, not the full review.
* For very small font sizes (e.g. footer-style testimonials), the line cap can stretch slightly. Spirit: "fits in a glance."
* **No em-dashes inside the quote text** as design flourish (long pauses, kinetic em-dashes, em-dash-bullets). See Section 9.G - em-dash is completely banned.
* Attribution: name + role + (optionally) company. Never name only ("- Sarah").
* Quote marks: use real typographic quotes ( " " ) or none at all. Not straight ASCII ( " ).

### 4.11 Page Theme Lock (Light / Dark Mode Consistency)

The page has ONE theme. Sections do not invert.

* If the page is dark mode, ALL sections are dark mode. No light-mode-warm-paper section sandwiched between dark sections (or vice versa). The user must not feel they walked into a different website mid-scroll.
* The exception: if the brief explicitly calls for a "Color Block Story" or "Theme Switch on Scroll" device AND that is a deliberate composition (one full theme switch with a strong transition, not random alternation), it is allowed once per page.
* Default behaviour: pick light, dark, or auto (`prefers-color-scheme`) at the page level and lock it. Section-level background tints within the same theme family are fine (`bg-zinc-950` next to `bg-zinc-900`); flipping to `bg-amber-50` in the middle of a `bg-zinc-950` page is broken.
* When using a design system with built-in theming (Radix Themes, shadcn/ui with `<Theme>`), set the theme ONCE in `layout.tsx` or the page root. Do not let individual sections override.

---

## 5. CONTEXT-AWARE PROACTIVITY

These are tools, not defaults. Use them when the design read calls for them. **None of these fire automatically.**

* **Liquid Glass / Glassmorphism:** Appropriate for premium consumer, Apple-adjacent, luxury brand, or media-overlay vibes. Inappropriate for dashboards, public-sector, or "boring B2B." When used, go beyond `backdrop-blur`: add a 1px inner border (`border-white/10`) and a subtle inner shadow (`shadow-[inset_0_1px_0_rgba(255,255,255,0.1)]`) for physical edge refraction. Provide a solid-fill fallback under `prefers-reduced-transparency`.
* **Magnetic Micro-physics:** Use when `MOTION_INTENSITY > 5` AND the brief reads premium / playful / agency. Implement EXCLUSIVELY with Motion's `useMotionValue` / `useTransform` outside the React render cycle. Never `useState`. See Section 3.B.
* **Perpetual Micro-Interactions** (Pulse, Typewriter, Float, Shimmer, Carousel): Use when `MOTION_INTENSITY > 5` AND the section actively benefits from motion (status indicators, live feeds, AI-feel). **Not every card needs an infinite loop.** If a section is informational, leave it still. Apply Spring Physics (`type: "spring", stiffness: 100, damping: 20`) - no linear easing.
* **"Motion claimed, motion shown."** If `MOTION_INTENSITY > 4`, the page must actually move: entry transitions on hero, scroll-reveal on key sections, hover physics on CTAs, at minimum. A static page that claims `MOTION_INTENSITY: 7` is broken. Conversely, if you cannot ship working motion in the available scope, drop the dial to 3 and ship a clean static page. Never half-build motion that breaks (cut-off ScrollTriggers, jumpy enters, missing cleanups).
* **MOTION MUST BE MOTIVATED (mandatory).** Before adding any animation, ask: "what does this animation communicate?" Valid answers: hierarchy (drawing attention to the right thing), storytelling (revealing content in sequence that matches a narrative), feedback (acknowledging a user action), state transition (showing something changed). Invalid answer: "it looked cool". GSAP everywhere because GSAP is available is amateur. Each ScrollTrigger, each marquee, each pinned section needs a reason. If you cannot articulate the reason in one sentence, drop the animation.
* **MARQUEE MAX-ONE-PER-PAGE (mandatory).** Horizontal scrolling text marquees ("logos endlessly scrolling", "manifesto scrolling sideways", "kinetic word strip") are appropriate at most ONCE per page. Two or more marquees on the same page reads as lazy filler. Pick the one section where the marquee actually serves the content; the others get a different layout.
* **GSAP Sticky-Stack Pattern (when scroll-stack is used).** A "card stack on scroll" must be a REAL sticky-stack, not a sequential reveal list. See Section 5.A below for the canonical code skeleton. Common failure: trigger fires halfway through scroll instead of pinning at viewport top. Fix: `start: "top top"` not `start: "top center"` or `"top 80%"`.
* **GSAP Horizontal-Pan Pattern (when horizontal scroll-hijack is used).** See Section 5.B below for the canonical skeleton. Common failure: animation starts before the section is pinned, so the user sees half a slide. Same fix: `start: "top top"`, pin the wrapper, scrub the inner track.

### 5.A Sticky-Stack - Canonical Skeleton

```tsx
"use client";
import { useRef, useEffect } from "react";
import { gsap } from "gsap";
import { ScrollTrigger } from "gsap/ScrollTrigger";
import { useReducedMotion } from "motion/react";

gsap.registerPlugin(ScrollTrigger);

export function StickyStack({ cards }: { cards: React.ReactNode[] }) {
  const ref = useRef<HTMLDivElement>(null);
  const reduce = useReducedMotion();

  useEffect(() => {
    if (reduce || !ref.current) return;
    const ctx = gsap.context(() => {
      const cardEls = gsap.utils.toArray<HTMLElement>(".stack-card");
      cardEls.forEach((card, i) => {
        if (i === cardEls.length - 1) return;
        ScrollTrigger.create({
          trigger: card,
          start: "top top",                              // pin at viewport top
          endTrigger: cardEls[cardEls.length - 1],
          end: "top top",
          pin: true,
          pinSpacing: false,
        });
        gsap.to(card, {
          scale: 0.92,
          opacity: 0.55,
          ease: "none",
          scrollTrigger: {
            trigger: cardEls[i + 1],
            start: "top bottom",
            end: "top top",
            scrub: true,
          },
        });
      });
    }, ref);
    return () => ctx.revert();
  }, [reduce]);

  return (
    <div ref={ref} className="relative">
      {cards.map((card, i) => (
        <div
          key={i}
          className="stack-card sticky top-0 min-h-[100dvh] flex items-center justify-center"
        >
          {card}
        </div>
      ))}
    </div>
  );
}
```

Critical points: `start: "top top"`, `pin: true`, every card except the last is pinned, the scale/opacity transform is driven by the NEXT card's scroll trigger (so previous card shrinks as next one arrives).

### 5.B Horizontal-Pan - Canonical Skeleton

```tsx
"use client";
import { useRef, useEffect } from "react";
import { gsap } from "gsap";
import { ScrollTrigger } from "gsap/ScrollTrigger";
import { useReducedMotion } from "motion/react";

gsap.registerPlugin(ScrollTrigger);

export function HorizontalPan({ children }: { children: React.ReactNode }) {
  const wrap = useRef<HTMLDivElement>(null);
  const track = useRef<HTMLDivElement>(null);
  const reduce = useReducedMotion();

  useEffect(() => {
    if (reduce || !wrap.current || !track.current) return;
    const ctx = gsap.context(() => {
      const distance = track.current!.scrollWidth - window.innerWidth;
      gsap.to(track.current, {
        x: -distance,
        ease: "none",
        scrollTrigger: {
          trigger: wrap.current,
          start: "top top",                              // pin starts when section top hits viewport top
          end: () => `+=${distance}`,                    // scroll distance = track width minus viewport
          pin: true,
          scrub: 1,
          invalidateOnRefresh: true,
        },
      });
    }, wrap);
    return () => ctx.revert();
  }, [reduce]);

  return (
    <section ref={wrap} className="relative overflow-hidden">
      <div ref={track} className="flex h-[100dvh] items-center">
        {children}
      </div>
    </section>
  );
}
```

Critical points: `start: "top top"`, `pin: true`, `end: "+=${distance}"` (scroll length = horizontal travel needed), `scrub: 1`. The wrapper is pinned, the inner track slides horizontally as the user scrolls vertically.

### 5.C Scroll-Reveal Stagger - Canonical Skeleton (lighter alternative)

For simple "items appear as they enter viewport" (no pinning), prefer Motion's `whileInView` over GSAP - lighter, no ScrollTrigger needed:

```tsx
"use client";
import { motion, useReducedMotion } from "motion/react";

export function RevealStagger({ items }: { items: string[] }) {
  const reduce = useReducedMotion();
  return (
    <ul className="grid gap-6">
      {items.map((item, i) => (
        <motion.li
          key={item}
          initial={reduce ? false : { opacity: 0, y: 24 }}
          whileInView={{ opacity: 1, y: 0 }}
          viewport={{ once: true, amount: 0.3 }}
          transition={{
            duration: 0.6,
            delay: i * 0.06,
            ease: [0.16, 1, 0.3, 1],
          }}
        >
          {item}
        </motion.li>
      ))}
    </ul>
  );
}
```

Use this for: feature lists, testimonial grids, logo walls, anything that just needs "enter on scroll." Save GSAP for actual pin/scrub work.

### 5.D Forbidden Animation Patterns

* **`window.addEventListener("scroll", ...)`** is banned. It runs on every scroll frame, jank-prone, no batching. Use Motion's `useScroll()`, GSAP's `ScrollTrigger`, IntersectionObserver, or CSS `scroll-driven animations` (`animation-timeline: view()`).
* **Custom scroll progress calculations using `window.scrollY`** in React state. Same reason. Re-renders on every frame.
* **`requestAnimationFrame` loops that touch React state.** Use motion values (`useMotionValue` + `useTransform`) instead.
* **Layout Transitions:** Use Motion's `layout` and `layoutId` props for visible state changes (re-ordering lists, expanding modals, shared elements between routes). Do not wrap static content in `layout` props "for safety" - it costs measurement work.
* **Staggered Orchestration:** Use `staggerChildren` (Motion) or CSS cascade (`animation-delay: calc(var(--index) * 100ms)`) for reveal moments where sequence matters. For `staggerChildren`, parent (`variants`) and children MUST share the same Client Component tree.

---

## 6. PERFORMANCE & ACCESSIBILITY GUARDRAILS

### 6.A Hardware Acceleration
* Animate ONLY `transform` and `opacity`. Never animate `top`, `left`, `width`, `height`.
* Use `will-change: transform` sparingly - only on elements that will actually animate.

### 6.B Reduced Motion (mandatory)
* **Any motion above `MOTION_INTENSITY > 3` MUST honor `prefers-reduced-motion`.** This is non-negotiable.
* In Motion: wrap with `useReducedMotion()` and degrade to static.
* In CSS: gate animations behind `@media (prefers-reduced-motion: no-preference)` or provide an override block under `@media (prefers-reduced-motion: reduce)` that disables.
* Infinite loops, parallax, scroll-hijack, and magnetic physics MUST collapse to static / instant under reduced motion.

### 6.C Dark Mode (mandatory for any consumer-facing page)
* Design for **both modes from the start**. Never ship light-only or dark-only without explicit user instruction.
* Use Tailwind `dark:` variant OR CSS variables for tokens. Pick one strategy per project.
* **Do not prescribe specific dark-mode colors here.** The brief decides. Maintain visual hierarchy, brand identity, and WCAG AA contrast (AAA for body) across both modes.
* Respect `prefers-color-scheme: dark`. Default to system preference unless the brand insists on one mode.

### 6.D Core Web Vitals Targets
* **LCP** < 2.5s. Hero image must be `next/image priority` or preloaded.
* **INP** < 200ms. Heavy work off main thread.
* **CLS** < 0.1. Reserve space for images, fonts, embeds.
* Run Lighthouse before declaring a page done.

### 6.E DOM Cost
* Apply grain / noise filters EXCLUSIVELY to fixed, `pointer-events-none` pseudo-elements (e.g., `fixed inset-0 z-[60] pointer-events-none`). NEVER on scrolling containers - continuous GPU repaints destroy mobile FPS.
* Be aware of bundle size. Motion is not tiny. Three.js is large. Lazy-load anything that's not above-the-fold.

### 6.F Z-Index Restraint
NEVER spam arbitrary `z-50` or `z-10`. Use z-index strictly for systemic layer contexts (sticky navbars, modals, overlays, grain). Document the z-index scale in a project constants file.

---

## 7. DIAL DEFINITIONS (Technical Reference)

### DESIGN_VARIANCE (Level 1-10)
* **1-3 (Predictable):** Symmetrical CSS Grid (12-col, equal fr-units), equal paddings, centered alignment.
* **4-7 (Offset):** `margin-top: -2rem` overlaps, varied image aspect ratios (4:3 next to 16:9), left-aligned headers over center-aligned data.
* **8-10 (Asymmetric):** Masonry layouts, CSS Grid with fractional units (`grid-template-columns: 2fr 1fr 1fr`), massive empty zones (`padding-left: 20vw`).
* **MOBILE OVERRIDE:** For levels 4-10, asymmetric layouts above `md:` MUST collapse to strict single-column (`w-full`, `px-4`, `py-8`) on viewports `< 768px`.

### MOTION_INTENSITY (Level 1-10)
* **1-3 (Static):** No automatic animations. CSS `:hover` and `:active` states only. `prefers-reduced-motion` is the default mode anyway.
* **4-7 (Fluid CSS):** `transition: all 0.3s cubic-bezier(0.16, 1, 0.3, 1)`. `animation-delay` cascades for load-ins. Focus on `transform` and `opacity`.
* **8-10 (Advanced Choreography):** Complex scroll-triggered reveals, parallax, scroll-driven animation (CSS `animation-timeline` or GSAP ScrollTrigger). Use Motion hooks. **NEVER use `window.addEventListener('scroll')`** - it is a hard ban, not a "prefer-not." See Section 5.D for the allowed alternatives.

### VISUAL_DENSITY (Level 1-10)
* **1-3 (Art Gallery):** Lots of white space. Huge section gaps (`py-32` to `py-48`). Expensive, clean.
* **4-7 (Daily App):** Standard web app spacing (`py-16` to `py-24`).
* **8-10 (Cockpit):** Tight paddings. No card boxes; 1px lines separate data. Mandatory: `font-mono` for all numbers.

---

## 8. DARK MODE PROTOCOL

Dual-mode by default. Never assume light-only unless the brief is print-emulating editorial.

### 8.A Token Strategy (pick one, stick to it)
* **Tailwind `dark:` variant** (default for utility-first projects): every color utility paired with its dark variant (`bg-white dark:bg-zinc-950`, `text-gray-900 dark:text-gray-100`).
* **CSS variables** (for shadcn/ui, Radix Themes, or component libraries with theming): define semantic tokens (`--surface`, `--surface-elevated`, `--text-primary`, `--accent`) and swap values under `[data-theme="dark"]` or `@media (prefers-color-scheme: dark)`.

### 8.B Do Not Prescribe Specific Colors Here
The brief and brand decide. This skill enforces only:
* **Contrast** - WCAG AA minimum for body text, AAA target for hero copy.
* **Hierarchy parity** - visual hierarchy that works in light must work in dark. If a CTA pops in light, it pops in dark.
* **Brand fidelity** - primary brand color stays recognisable. Don't desaturate the brand into a dark mode.
* **No pure `#000000` and no pure `#ffffff`** - use off-black (zinc-950, near-black warm gray) and off-white. Pure values kill depth.

### 8.C Default Mode
Respect `prefers-color-scheme` unless the brand insists. Add a manual toggle if either mode would lose key brand expression.

### 8.D Test in Both Modes Before Finishing
Open the page in both modes during development. Do not ship a page you've only seen in one mode.

---

## 9. AI TELLS (Forbidden Patterns)

Avoid these signatures unless the brief explicitly asks for them.

### 9.A Visual & CSS
* **NO neon / outer glows** by default. Use inner borders or subtle tinted shadows.
* **NO pure black (`#000000`).** Off-black, zinc-950, or charcoal.
* **NO oversaturated accents.** Desaturate to blend with neutrals.
* **NO excessive gradient text** for large headers.
* **NO custom mouse cursors.** Outdated, accessibility-hostile, perf-hostile.

### 9.B Typography
* **AVOID Inter as default.** See Section 4.1. Override path exists.
* **NO oversized H1s** that just scream. Control hierarchy with weight + color, not raw scale.
* **Serif constraints:** Serif for editorial / luxury / publication. Not for dashboards.

### 9.C Layout & Spacing
* **Mathematically perfect** padding and margins. No floating elements with awkward gaps.
* **NO 3-column equal feature cards.** The generic "three identical cards horizontally" feature row is banned. Use 2-column zig-zag, asymmetric grid, scroll-pinned, or horizontal-scroll alternative.

### 9.D Content & Data ("Jane Doe" Effect)
* **NO generic names.** "John Doe", "Sarah Chan", "Jack Su" → use creative, realistic, locale-appropriate names.
* **NO generic avatars.** No SVG "egg" or Lucide user icons → use believable photo placeholders or specific styling.
* **NO fake-perfect numbers.** Avoid `99.99%`, `50%`, `1234567`. Use organic, messy data (`47.2%`, `+1 (312) 847-1928`).
* **NO startup-slop brand names.** "Acme", "Nexus", "SmartFlow", "Cloudly" → invent contextual, premium names that sound real.
* **NO filler verbs.** "Elevate", "Seamless", "Unleash", "Next-Gen", "Revolutionize" → concrete verbs only.

### 9.E External Resources & Components
* **NO hand-rolled SVG icons.** Use Phosphor / HugeIcons / Radix / Tabler. Lucide on explicit request only.
* **Hand-rolled decorative SVGs strongly discouraged** as default (see Section 4.8).
* **NO div-based fake screenshots.** Never build a fake product UI out of `<div>` rectangles to simulate a screenshot. Use real images, generated images, or skip the preview.
* **NO broken Unsplash links.** Use `https://picsum.photos/seed/{descriptive-string}/{w}/{h}`, or generated photo placeholders, or actual assets.
* **shadcn/ui customization:** Allowed, but NEVER in default state. Customize radii, colors, shadows, typography to the project aesthetic.
* **Production-Ready Cleanliness:** Code visually clean, memorable, meticulously refined.

### 9.F Production-Test Tells (banned outright)

These patterns came out of real LLM-generated landing-page tests. They are the signatures the model defaults to when it tries to "look designed." Treat them as hard bans unless the brief explicitly calls for one.

**Hero & top-of-page**
* **NO version labels in the hero.** `V0.6`, `v2.0`, `BETA`, `INVITE-ONLY PREVIEW`, `EARLY ACCESS`, `ALPHA` - banned as default eyebrows. Only acceptable when the brief is explicitly about a product launch / preview status.
* **NO "Brand · No. 01"-style sub-eyebrows.** "Marrow · No. 01 · The 6-quart" type micro-meta lines. Skip them.

**Section numbering & micro-labels**
* **NO section-number eyebrows.** `00 / INDEX`, `001 · Capabilities`, `002 · Featured commission`, `06 · how it works`, `05 · The honest table` - banned. Eyebrows should name the topic in plain language, not enumerate.
* **NO `01 / 4`-style pagination on images or bento tiles.** If the user can count, they don't need the label.
* **NO `Scroll · 001 Capabilities`-style scroll cues.** A simple arrow or "Scroll" is enough; no section-number prefix.
* **NO "Index of Work, 2018 - 2026"-style range labels** as eyebrows. Just say what the section is.

**Separators & dots**
* **The middle-dot (`·`) is rationed.** Maximum 1 per line in metadata strips. Do NOT use it as the default separator for everything ("foo · bar · baz · qux · quux"). If you need a separator family, prefer line breaks, hairlines, or columns.
* **NO decorative colored status dots on every list/nav/badge.** A colored dot before "ONE Q4 SLOT OPEN" or before every nav link, or every task row - banned by default. Acceptable only when the dot conveys actual semantic state (a server status, an availability flag) and is used sparingly.

**Em-dashes & typography flourishes**
* **NO em-dash (`—`) as a design element OR anywhere else.** See Section 9.G below for the complete, non-negotiable ban. The em-dash character is forbidden in headlines, eyebrows, pills, body copy, quotes, attribution, captions, button text, and alt text. Use the regular hyphen (`-`).
* **NO `<br>`-broken-and-italicized headlines** as a default "design move." "for thirty\<br\>*years.*" type splits. Headlines should read naturally first, get clever only when the brief demands it.
* **NO vertical rotated text** ("INDEX OF WORK, 2018 - 2026" rotated 90°). Agency-portfolio cliché. Use it only when the brief is explicitly agency / Awwwards / experimental AND it serves a real composition purpose.
* **NO crosshair / hairline grid lines as decoration.** Vertical and horizontal lines drawn just to make the page "feel designed" - banned. Use them only when they organize real content.

**Fake product previews**
* **NO div-based fake product UI in the hero** (fake task list, fake terminal, fake dashboard built from styled divs). It is the #1 LLM-design Tell. Use a real screenshot, a generated image, a real component preview, or none at all.
* **NO fake version footers** ("v0.6.2-rc.1", "last sync 4s ago · main") inside fake screenshots. Adds nothing, screams AI.

**Marketing-copy Tells**
* **NO "Quietly in use at" / "Quietly trusted by"** social-proof headers. Use natural language: "Trusted by", "Used at", "Customers include", or skip the heading entirely if the logos speak.
* **NO "From the field" / "Field notes" / "Currently on the bench" / "On our desks" / "Loose plates" style poetic labels** on quote, blog, or sidebar sections. Reads as performative-craftsman. Use plain functional labels ("Testimonials", "Latest writing", "Now working on") or skip the label.
* **NO "We respect the French ones"-style** mock-humble industry-references in body copy. Cute and AI-y.
* **NO weather / locale strips** ("LIS 14:23 · 18°C") in headers/footers unless the brief is explicitly about a place / time-zone-distributed studio.
* **NO micro-meta-sentences under eyebrows.** Sentences like *"Each of these is a feature we ship today, not a roadmap promise. The list will stay short on purpose."* sitting under a section heading are clutter. Eyebrow + Headline + Body is enough.
* **NO generic step labels.** "Stage 1 / Stage 2 / Stage 3", "Step 1 / Step 2 / Step 3", "Phase 01 / Phase 02 / Phase 03", "Pass One / Pass Two / Pass Three". Banned. The actual step content is the label. If you must show progression, use the verb-noun directly ("Install", "Configure", "Ship") not "Stage 1: Install".

**Pills, labels and version stamps**
* **NO pills/labels/tags overlaid on images.** No `<span>` overlays on photos with tags like `Brand · 02`, `PLATE · BRAND`, `Field notes - journal`. Either let the image speak alone, or add a caption directly below (outside the image).
* **NO photo-credit captions as decoration.** Strings like `Field study no. 12 · Ines Caetano`, `Plate 03 · House archive`, `Frame XII · 35mm` under stock/picsum images are pretentious. Photo credit is allowed ONLY when there is a real photographer being credited for a real photo (with permission). Otherwise: skip the caption or use a one-line functional caption ("The 6-quart, in Sage.").
* **NO version footers on marketing pages.** Footer strings like `v1.4.2`, `Build 0048`, `last sync 4s ago · main` are CLI / devtool fixtures, not landing-page content. Banned on marketing/landing/portfolio pages.
* **NO "Reservation 412 of 800"-style live-stock counters** as decoration. Only if the brief is explicitly a limited-run waitlist with real data.

**Decoration text strips**
* **NO decoration text strip at hero bottom.** Patterns like `BRAND. MOTION. SPATIAL.`, `TYPE / FORM / MOTION`, `DESIGN · BUILD · SHIP`, `ESTD. 2018 · LISBON · BRAND. MOTION. SPATIAL.` as a small mono-caps strip across the bottom of the hero are an agency-portfolio cliché. Banned by default. Only acceptable when the strip carries real, navigable links (sticky bottom nav) or real status info (cookie banner, build info on a docs site).
* **NO floating top-right sub-text in section headings.** Pattern: section has a giant left-aligned headline; in the top-right corner of the same section header there is a small explainer paragraph floating with no clear alignment to anything else. That floater is the Tell. Either put the sub-text directly under the headline, or build a clean 2-column header (left: headline, right: aligned body), but not a tiny corner paragraph.

**Lists, dividers and scoring**
* **NO `border-t` + `border-b` on every row of a long list / spec table.** Pick one (bottom-border between rows OR top-border above the group) and use it sparsely. A 10-row spec table with hairlines under each row is the laziest layout - see Section 4.9 for alternative UI components.
* **NO scoring/progress bars with filled background tracks** as comparison visuals. If you need to show "X out of Y" comparisons, prefer a number + small icon, or a tiny inline bar WITHOUT a background track. Big filled `bg-zinc-200` tracks with a partial fill on top are dashboard-UI clutter on a landing page.

**Locale, time, scroll cues**
* **Locale / city-name / time / weather strips are banned for 99% of briefs.** "Lisbon, working with founders" in the hero, "1200-690 Lisbon, Portugal" in the footer, "Lisbon 14:23 · 18°C" in the nav. These are agency-portfolio decoration tells. Allowed ONLY when: the brief explicitly describes a globally-distributed studio with timezone-relevant work, OR a travel-focused brand, OR a real-world physical venue. A single contact-address mention in the footer is fine; an atmospheric locale strip is not.
* **Scroll cues are banned.** `Scroll`, `↓ scroll`, `Scroll to explore`, `Scroll to walk through it`, animated mouse-wheel icons. If the user has not scrolled yet, they are looking at the hero. They know what scroll is. The bottom of the viewport does not need a label.
* **ZERO decorative status dots by default.** A coloured dot before nav items, before list rows, before badges, before status labels is a Tell. Only acceptable when conveying real semantic state (a live indicator on actual server status, a live availability flag) and limited to one per page section.

### 9.G EM-DASH BAN (the single most-violated Tell)

**Em-dash (`—`) is COMPLETELY banned.** It is the LLM's signature stylistic crutch and it is the #1 visual Tell in production tests. There is no "limited use" allowance, no "natural language frequency" allowance, no "in body copy is fine" allowance. None.

* **Banned in headlines.** Use a period or a comma.
* **Banned in eyebrows / labels / pills / button text / image captions / nav items.** Replace with line breaks, columns, or hairlines.
* **Banned in body copy.** Restructure the sentence: two sentences with a period, OR a comma, OR parentheses, OR a colon.
* **Banned in quote attribution.** Use a normal hyphen with spaces (` - `) or a line break + smaller-weight name.
* **Banned in en-dash form too (`–`) when used as a separator.** Date ranges (`2018-2026`) use a hyphen. Number ranges (`€40-80k`) use a hyphen.

The ONLY permitted dash characters on the page are:
* Regular hyphen `-` (for compound words, ranges, line dividers in markup)
* Minus sign in math (`-5°C`)

If your output contains a single `—` or `–` anywhere visible to the user, the output fails the Pre-Flight Check and must be rewritten.

This rule is non-negotiable. The agent has historically ignored em-dash limits when phrased as "use sparingly." The phrasing here is binary: zero em-dashes.

---

## 10. REFERENCE VOCABULARY (Pattern Names the Agent Should Know)

This is a vocabulary, not a library. The agent should KNOW these pattern names to communicate about them, design with them in mind, and reach for them when the design read calls for them. **Implementations and code sketches live in the Block Library (Section 12), which is populated iteratively.**

### Hero Paradigms
* **Asymmetric Split Hero** - Text on one side, asset on the other, generous white space.
* **Editorial Manifesto Hero** - Large type, no asset, almost-poster.
* **Video / Media Mask Hero** - Type cut out as mask over video background.
* **Kinetic-Type Hero** - Animated typography as the primary visual.
* **Curtain-Reveal Hero** - Hero parts on scroll like a curtain.
* **Scroll-Pinned Hero** - Hero stays pinned while content scrolls behind.

### Navigation & Menus
* **Mac OS Dock Magnification** - Edge nav, icons scale fluidly on hover.
* **Magnetic Button** - Pulls toward cursor.
* **Gooey Menu** - Sub-items detach like viscous liquid.
* **Dynamic Island** - Morphing pill for status / alerts.
* **Contextual Radial Menu** - Circular menu expanding at click point.
* **Floating Speed Dial** - FAB springing into curved secondary actions.
* **Mega Menu Reveal** - Full-screen dropdown, stagger-fade content.

### Layout & Grids
* **Bento Grid** - Asymmetric tile grouping (Apple Control Center).
* **Masonry Layout** - Staggered grid, no fixed row height.
* **Chroma Grid** - Borders / tiles with subtle animating gradients.
* **Split-Screen Scroll** - Two halves sliding in opposite directions.
* **Sticky-Stack Sections** - Sections that pin and stack on scroll.

### Cards & Containers
* **Parallax Tilt Card** - 3D tilt tracking mouse coordinates.
* **Spotlight Border Card** - Borders illuminate under cursor.
* **Glassmorphism Panel** - Frosted glass with inner refraction.
* **Holographic Foil Card** - Iridescent rainbow shift on hover.
* **Tinder Swipe Stack** - Physical card stack, swipe-away.
* **Morphing Modal** - Button expands into its own dialog.

### Scroll Animations
* **Sticky Scroll Stack** - Cards stick and physically stack.
* **Horizontal Scroll Hijack** - Vertical scroll → horizontal pan.
* **Locomotive / Sequence Scroll** - Video / 3D sequence tied to scrollbar.
* **Zoom Parallax** - Central background image zooming on scroll.
* **Scroll Progress Path** - SVG line drawing along scroll.
* **Liquid Swipe Transition** - Page transition like viscous liquid.

### Galleries & Media
* **Dome Gallery** - 3D panoramic gallery.
* **Coverflow Carousel** - 3D carousel with angled edges.
* **Drag-to-Pan Grid** - Boundless draggable canvas.
* **Accordion Image Slider** - Narrow strips expanding on hover.
* **Hover Image Trail** - Mouse leaves popping image trail.
* **Glitch Effect Image** - RGB-channel shift on hover.

### Typography & Text
* **Kinetic Marquee** - Endless text bands reversing on scroll.
* **Text Mask Reveal** - Massive type as transparent window to video.
* **Text Scramble Effect** - Matrix-style decoding on load / hover.
* **Circular Text Path** - Text curving along spinning circle.
* **Gradient Stroke Animation** - Outlined text with running gradient.
* **Kinetic Typography Grid** - Letters dodging the cursor.

### Micro-Interactions & Effects
* **Particle Explosion Button** - CTA shatters into particles on success.
* **Liquid Pull-to-Refresh** - Reload indicator like detaching droplets.
* **Skeleton Shimmer** - Shifting light reflection across placeholders.
* **Directional Hover-Aware Button** - Fill enters from cursor's exact side.
* **Ripple Click Effect** - Wave from click coordinates.
* **Animated SVG Line Drawing** - Vectors drawing themselves in real time.
* **Mesh Gradient Background** - Organic lava-lamp blobs.
* **Lens Blur Depth** - Background UI blurred to focus foreground action.

### Animation Library Choice
* **Motion (`motion/react`)** - default for UI / Bento / state-change motion.
* **GSAP + ScrollTrigger** - for full-page scrolltelling and scroll hijacks. Isolate in dedicated leaf components with `useEffect` cleanup.
* **Three.js / WebGL** - for canvas backgrounds and 3D scenes. Same isolation rule.
* **NEVER mix GSAP / Three.js with Motion in the same component tree.** They fight over the same frames.

---

## 11. REDESIGN PROTOCOL

This skill handles **greenfield builds AND redesigns**. Misclassifying the mode is the single biggest source of bad redesign output.

### 11.A Detect the Mode (first action)
* **Greenfield** - no existing site, or full overhaul approved. Dial baseline from Section 1.
* **Redesign - Preserve** - modernise without breaking the brand. Audit first, extract brand tokens, evolve gradually.
* **Redesign - Overhaul** - new visual language on top of existing content. Treat as greenfield for visuals; preserve content and IA.

If ambiguous, ask **once**: *"Should this redesign preserve the existing brand, or are we starting visually from scratch?"*

### 11.B Audit Before Touching
Document the current state before proposing changes:
* **Brand tokens** - primary / accent colors, type stack, logo treatment, radii.
* **Information architecture** - page tree, primary nav, key conversion paths.
* **Content blocks** - what exists, what's doing work, what's filler.
* **Patterns to preserve** - signature interactions, recognisable hero, copy voice.
* **Patterns to retire** - AI-slop tells, broken layouts, dead links, generic stock imagery, perf traps.
* **Dial reading of the existing site** - infer current `DESIGN_VARIANCE` / `MOTION_INTENSITY` / `VISUAL_DENSITY`. That's your starting point, not the baseline.
* **SEO baseline** - current ranking pages, meta titles, structured data, OG cards. **SEO migration is the #1 redesign risk.**

### 11.C Preservation Rules
* **Do not change information architecture** unless asked. Keep page slugs, anchor IDs, primary nav labels stable for SEO and muscle memory.
* **Extract brand colors before applying Section 4.2.** A brand that is already purple stays purple - apply the LILA RULE's override.
* **Preserve copy voice** unless asked for a rewrite. Visual modernisation ≠ content rewrite.
* **Honor existing accessibility wins.** Do not regress focus states, alt text, keyboard nav, contrast.
* **Respect existing analytics events.** Do not rename buttons, form fields, section IDs that downstream tracking depends on.

### 11.D Modernisation Levers (priority order)
Apply in order - stop when the brief is satisfied:
1. **Typography refresh** - biggest visual lift per unit of risk.
2. **Spacing & rhythm** - increase section padding, fix vertical rhythm.
3. **Color recalibration** - desaturate, unify neutrals, keep brand accent.
4. **Motion layer** - add `MOTION_INTENSITY`-appropriate micro-interactions to existing components.
5. **Hero & key-section recomposition** - restructure top-of-funnel using Section 10 vocabulary.
6. **Full block replacement** - only when the existing block is unsalvageable.

### 11.E Decision Tree: Targeted Evolution vs Full Redesign
* IA, content, and SEO sound → **targeted evolution** (Levers 1-4). ~70% of value at ~40% of risk.
* Visual debt is structural (broken IA, no design system, broken mobile) → **full redesign** with strict content preservation.
* Brand itself is changing → **greenfield**.

### 11.F What Never Changes Silently
Never modify without explicit user approval:
* URL structure / route slugs.
* Primary nav labels.
* Form field names or order (breaks analytics + autofill).
* Brand logo or wordmark.
* Existing legal / consent / cookie copy.

---

## 12. THE BLOCK LIBRARY (Contract - Implementations Land Here Iteratively)

The Reference Vocabulary (Section 10) names patterns. The Block Library implements them with real props, real motion specs, and real code sketches.

**Status:** schema defined here. Blocks will be added iteratively. Do not freelance new blocks without following this schema.

### 12.A File Location
```
skills/taste-skill/blocks/
  hero/
    asymmetric-split.md
    editorial-manifesto.md
    kinetic-type.md
    ...
  feature/
    bento-grid.md
    sticky-scroll-stack.md
    zig-zag.md
    ...
  social-proof/
  pricing/
  cta/
  footer/
  navigation/
  portfolio/
  transition/
```

### 12.B Required Frontmatter
```yaml
---
name: asymmetric-split-hero
category: hero
dial_compatibility:
  variance: [6, 10]
  motion: [3, 10]
  density: [2, 5]
when_to_use: "Landing pages with one strong asset and one strong message. Default hero for SaaS, agency, premium consumer."
not_for: "Editorial / manifesto launches where the message IS the design."
stack: ["react", "next", "tailwind", "motion"]
---
```

### 12.C Required Body Sections
1. **Visual sketch** - short ASCII or description of the layout.
2. **Props API** - the component's interface.
3. **Code sketch** - minimal working implementation (Server Component default, Client island for motion).
4. **Mobile fallback** - explicit collapse rules for `< 768px`.
5. **Motion variants** - one variant per `MOTION_INTENSITY` band (1-3, 4-7, 8-10). Reduced-motion fallback explicit.
6. **Dark-mode notes** - token strategy specific to this block.
7. **Anti-patterns** - common ways this block goes wrong.
8. **References** - links to real examples in production.

### 12.D Block-Library Discipline
* One block per file. No multi-block files.
* Every block must work standalone (drop it into a page, it renders).
* Every block must pass the Pre-Flight Check (Section 14).
* Blocks that depend on a design system from Section 2.A live under `blocks/<category>/<name>--<system>.md` (e.g. `feature/bento-grid--material.md`).

---

## 13. OUT OF SCOPE

This skill is NOT for:
* Dashboards / dense product UI / admin panels (use Fluent, Carbon, Atlassian, or Polaris from Section 2.A).
* Data tables (use TanStack Table or AG Grid).
* Multi-step forms / wizards (use Form-specific patterns; this skill won't make them better).
* Code editors (use Monaco / CodeMirror with their official skinning).
* Native mobile (use Apple HIG / Material directly).
* Realtime collab UIs (presence, cursors, OT-aware - different problem class).

If the brief is one of the above, **say so explicitly**, point to the right tool, and only apply this skill's marketing-page / about-page / landing-page parts to the surfaces where they apply.

---

## 14. FINAL PRE-FLIGHT CHECK

Run this matrix before outputting code. This is the last filter.

**THIS IS NOT OPTIONAL. Run every box. If any box fails, the output is not done.**

- [ ] **Brief inference** declared (Section 0.B one-liner)?
- [ ] **Dial values** explicit and reasoned from the brief, not silently using baseline?
- [ ] **Design system** chosen from Section 2 if applicable, or aesthetic labeled honestly?
- [ ] **Redesign mode** detected and audit performed (if applicable, Section 11)?
- [ ] **ZERO em-dashes (`—`) anywhere on the page.** Headlines, eyebrows, pills, body, quotes, attribution, captions, buttons, alt text. Zero. (Section 9.G - non-negotiable.)
- [ ] **Page Theme Lock**: ONE theme (light, dark, or auto) for the whole page. No section flips to inverted mode mid-page (Section 4.11)?
- [ ] **Color Consistency Lock**: one accent color used identically across all sections (Section 4.2)?
- [ ] **Shape Consistency Lock**: one corner-radius system applied consistently (Section 4.4)?
- [ ] **Button Contrast Check**: every CTA text is readable against its background (no white-on-white, WCAG AA 4.5:1)?
- [ ] **CTA Button Wrap**: no CTA label wraps to 2+ lines at desktop?
- [ ] **Form Contrast Check**: form inputs, placeholders, focus rings, labels all pass WCAG AA against the section background?
- [ ] **Serif discipline**: if a serif is used, it is NOT Fraunces or Instrument_Serif (or it is, with explicit brand justification)? Different serif from your previous project?
- [ ] **Premium-consumer palette check**: if the brief is premium-consumer (cookware / wellness / artisan / luxury), the palette is NOT the AI-default beige+brass+oxblood+espresso family? Different family from your previous premium-consumer project?
- [ ] **Italic descender clearance**: every italic word with `y g j p q` has `leading-[1.1]` min + `pb-1` reserve?
- [ ] **Hero fits the viewport**: headline ≤ 2 lines, subtext ≤ 20 words AND ≤ 4 lines, CTA visible without scroll, font scale planned around image?
- [ ] **Hero top padding**: max `pt-24` at desktop, hero content does not float halfway down the viewport?
- [ ] **Hero stack discipline**: max 4 text elements in hero (eyebrow OR brand strip, headline, subtext, CTAs)? No tiny tagline below CTAs, no trust micro-strip in hero?
- [ ] **EYEBROW COUNT (mechanical)**: count instances of `uppercase tracking` micro-labels above section headlines across all components. Count ≤ ceil(sectionCount / 3)? Hero counts as 1.
- [ ] **Split-Header Ban**: no "left big headline + right small explainer paragraph" pattern as a section header (vertical stack instead)?
- [ ] **Zigzag Alternation Cap**: no 3+ consecutive sections with the same image+text-split layout?
- [ ] **No Duplicate CTA Intent**: no two CTAs with the same intent ("Get in touch" + "Let's talk" both on page = Fail)?
- [ ] **Logo wall = logo only**: no industry / category labels printed below logos?
- [ ] **Bento Background Diversity**: at least 2-3 bento cells have real visual variation (image, gradient, pattern), not all white-on-white text cards?
- [ ] **"Used by / Trusted by" logo wall** lives UNDER the hero, not inside it, uses REAL SVG logos (Simple Icons / devicon) or generated SVG marks, NOT plain text wordmarks?
- [ ] **Copy Self-Audit**: every visible string re-read, no grammatically-broken or AI-hallucinated phrases ("free on its past" type) shipped?
- [ ] **Motion motivated**: every animation can be justified in one sentence (hierarchy / storytelling / feedback / state transition), no GSAP-for-show?
- [ ] **Marquee max-one-per-page**: no two horizontal marquees on the same page?
- [ ] **Navigation on ONE line** at desktop, height ≤ 80px?
- [ ] **Section-Layout-Repetition** check: no two sections share the same layout family (at least 4 different families across 8 sections)?
- [ ] **Bento has rhythm AND exact cell count** (N items → N cells, no empty cells in middle or at end)?
- [ ] **Long lists use the right UI component** (not default `<ul>` with `divide-y` for > 5 items - see Section 4.9 alternatives)?
- [ ] **Real images used** (gen-tool first, then Picsum-seed, then explicit placeholder slots) - NO div-based fake screenshots, NO hand-rolled decorative SVGs, NO pure-text minimalism?
- [ ] **No pills/labels overlaid on images** (no `Plate · Brand`, no `Field notes - journal`)?
- [ ] **No photo-credit captions as decoration** (`Field study no. 12 · Ines Caetano`)?
- [ ] **No version footers** (`v1.4.2`, `Build 0048`) on marketing pages?
- [ ] **No micro-meta-sentences** under eyebrows ("Each of these is a feature we ship today...")?
- [ ] **No decoration text strip at hero bottom** (`BRAND. MOTION. SPATIAL.`)?
- [ ] **No floating top-right sub-text** in section headings?
- [ ] **No scoring/progress bars with filled background tracks** as comparison visuals?
- [ ] **No locale / city-name / time / weather strips** unless brief is genuinely globally-distributed or place-focused?
- [ ] **No scroll cues** (`Scroll`, `↓ scroll`, `Scroll to explore`)?
- [ ] **No version labels in hero** (V0.6, BETA, INVITE-ONLY) unless the brief is a launch?
- [ ] **No section-numbering eyebrows** (`00 / INDEX`, `001 · Capabilities`, `06 · how it works`)?
- [ ] **No decorative dots** (zero by default, only for real semantic state)?
- [ ] **No `border-t` + `border-b` on every row** of long lists / spec tables?
- [ ] **Content density** sane: no 20-row data tables, no fake-precise specs without justification, ≤ 25-word sub-paragraphs by default?
- [ ] **Quotes ≤ 3 lines** of body, attribution clean (no em-dash)?
- [ ] **Motion claimed = motion shown**: if `MOTION_INTENSITY > 4`, page actually animates, not just claimed?
- [ ] **GSAP sticky-stack / horizontal-pan** implemented per Section 5.A / 5.B canonical skeleton (`start: "top top"`, `pin: true`, correct scrub)?
- [ ] **No `window.addEventListener('scroll')`** - using Motion `useScroll()` / ScrollTrigger / IntersectionObserver / CSS scroll-driven animations only?
- [ ] **Reduced motion** wrapped for everything `MOTION_INTENSITY > 3`?
- [ ] **Dark mode** tokens defined and tested in both modes?
- [ ] **Mobile collapse** explicit (`w-full`, `px-4`, `max-w-7xl mx-auto`) for high-variance layouts?
- [ ] **Viewport stability**: `min-h-[100dvh]`, never `h-screen`?
- [ ] **`useEffect` animations** have strict cleanup functions?
- [ ] **Empty / loading / error** states provided?
- [ ] **Cards omitted** in favor of spacing where possible?
- [ ] **Icons** from an allowed library only (Phosphor / HugeIcons / Radix / Tabler), no hand-rolled SVG paths?
- [ ] **Motion** isolated in client-leaf components with `'use client'` at the top, memoized?
- [ ] **No AI Tells** from Section 9 (Inter as default, AI-purple, three-equal cards, Jane Doe, Acme, "Quietly in use at")?
- [ ] **Core Web Vitals** plausibly hit (LCP < 2.5s, INP < 200ms, CLS < 0.1)?
- [ ] **One design system** per project (no Material + shadcn mixed)?

If a single checkbox cannot be honestly ticked, the page is not done. Fix it before delivering.

---

# APPENDICES - Real Source-Backed Reference Material

The sections below are vendored reference content. They give the agent real install commands, real canonical doc links, and real working starter snippets for each design system named in Section 2. Use them to ground decisions in production reality, not training-data fiction.

## Appendix A - Install Commands per Design System

```bash
# Material Web (Material 3)
npm install @material/web

# Fluent UI React (v9)
npm install @fluentui/react-components

# Fluent UI Web Components (framework-free)
npm install @fluentui/web-components @fluentui/tokens

# IBM Carbon
npm install @carbon/react @carbon/styles

# Radix Themes
npm install @radix-ui/themes

# shadcn/ui (open code, owned components)
npx shadcn@latest init
npx shadcn@latest add button card badge separator input

# Primer CSS (GitHub product/devtool UI)
npm install --save @primer/css

# Primer Brand (GitHub marketing UI)
npm install @primer/react-brand

# GOV.UK Frontend
npm install govuk-frontend

# USWDS (US Web Design System)
npm install uswds

# Atlassian Design System (Atlaskit)
yarn add @atlaskit/css-reset @atlaskit/tokens @atlaskit/button @atlaskit/badge @atlaskit/section-message @atlaskit/card

# Bootstrap 5.3
npm install bootstrap

# Shopify Polaris Web Components (Shopify apps only)
# Add this to your app HTML head:
#   <meta name="shopify-api-key" content="%SHOPIFY_API_KEY%" />
#   <script src="https://cdn.shopify.com/shopifycloud/polaris.js"></script>
```

## Appendix B - Canonical Sources (read these before reinventing)

### Material Web
- https://github.com/material-components/material-web
- https://material-web.dev/theming/material-theming/
- https://m3.material.io/develop/web

### Fluent UI
- https://fluent2.microsoft.design/get-started/develop
- https://fluent2.microsoft.design/components/web/react/
- https://github.com/microsoft/fluentui
- https://learn.microsoft.com/en-us/fluent-ui/web-components/

### Carbon
- https://carbondesignsystem.com/
- https://github.com/carbon-design-system/carbon
- https://carbondesignsystem.com/developing/react-tutorial/overview/
- https://carbondesignsystem.com/developing/web-components-tutorial/overview/

### Shopify Polaris
- https://shopify.dev/docs/api/app-home/web-components
- https://github.com/Shopify/polaris-react
- https://polaris-react.shopify.com/components

### Atlassian
- https://atlassian.design/get-started/develop
- https://atlassian.design/components/button/examples
- https://atlaskit.atlassian.com/packages/design-system/button/example/disabled
- https://atlassian.design/tokens/design-tokens

### Primer
- https://primer.style/
- https://github.com/primer/css
- https://github.com/primer/brand

### GOV.UK
- https://design-system.service.gov.uk/components/button/
- https://design-system.service.gov.uk/styles/layout/
- https://github.com/alphagov/govuk-frontend

### USWDS
- https://designsystem.digital.gov/documentation/developers/
- https://designsystem.digital.gov/components/button/
- https://designsystem.digital.gov/components/card/
- https://github.com/uswds/uswds

### Bootstrap
- https://getbootstrap.com/docs/5.3/layout/grid/
- https://getbootstrap.com/docs/5.3/components/card/

### Tailwind
- https://tailwindcss.com/docs/dark-mode
- https://tailwindcss.com/blog/tailwindcss-v4

### Radix
- https://www.radix-ui.com/themes/docs/components/theme
- https://www.radix-ui.com/themes/docs/components/card
- https://github.com/radix-ui/themes

### shadcn/ui
- https://ui.shadcn.com/docs
- https://ui.shadcn.com/docs/components/card
- https://github.com/shadcn-ui/ui

### Native CSS / W3C standards
- https://developer.mozilla.org/en-US/docs/Web/CSS/Reference/Properties/backdrop-filter
- https://developer.mozilla.org/en-US/docs/Web/CSS/Reference/At-rules/@media/prefers-color-scheme
- https://developer.mozilla.org/en-US/docs/Web/CSS/Reference/At-rules/@media/prefers-reduced-motion
- https://developer.mozilla.org/en-US/docs/Web/CSS/Guides/Grid_layout
- https://developer.mozilla.org/en-US/docs/Web/CSS/Guides/Scroll-driven_animations
- https://drafts.csswg.org/scroll-animations-1/

### Apple Liquid Glass (Apple platforms only)
- https://developer.apple.com/design/human-interface-guidelines/materials
- https://developer.apple.com/documentation/TechnologyOverviews/liquid-glass
- https://developer.apple.com/documentation/TechnologyOverviews/adopting-liquid-glass
- https://developer.apple.com/documentation/SwiftUI/Material

---

## Appendix C - Apple Liquid Glass: Honest Web Approximation

Do **not** treat random CSS snippets as official Apple Liquid Glass.

### What is official
Apple documents Liquid Glass inside Apple's Human Interface Guidelines and Developer Documentation for **Apple platforms**. It is a dynamic material used across Apple platform UI. Apple's native implementation belongs to Apple platform APIs and system components, **not a public web CSS package**.

Relevant official docs:
- Apple Human Interface Guidelines → Materials
- Apple Developer Documentation → Liquid Glass
- Apple Developer Documentation → Adopting Liquid Glass
- SwiftUI → Material

### What is NOT official
There is no `liquid-glass.css` from Apple for normal websites.

A web approximation can use:
- `backdrop-filter`
- transparent backgrounds
- layered borders
- highlight overlays
- gradients
- motion
- strong contrast fallbacks

But that is **web glassmorphism / frosted-glass approximation**, not official Apple Liquid Glass. Label it as such in comments.

### Safer web approximation skeleton

```css
.liquid-glass-web-approx {
  position: relative;
  isolation: isolate;
  overflow: hidden;
  border-radius: 999px;
  border: 1px solid rgb(255 255 255 / .32);
  background:
    linear-gradient(135deg, rgb(255 255 255 / .30), rgb(255 255 255 / .08)),
    rgb(255 255 255 / .12);
  backdrop-filter: blur(24px) saturate(180%) contrast(1.05);
  -webkit-backdrop-filter: blur(24px) saturate(180%) contrast(1.05);
  box-shadow:
    inset 0 1px 0 rgb(255 255 255 / .48),
    inset 0 -1px 0 rgb(255 255 255 / .12),
    0 18px 60px rgb(0 0 0 / .18);
}

.liquid-glass-web-approx::before {
  content: "";
  position: absolute;
  inset: 0;
  z-index: -1;
  border-radius: inherit;
  background:
    radial-gradient(circle at 20% 0%, rgb(255 255 255 / .55), transparent 34%),
    linear-gradient(90deg, rgb(255 255 255 / .18), transparent 42%, rgb(255 255 255 / .14));
  pointer-events: none;
}

.liquid-glass-web-approx::after {
  content: "";
  position: absolute;
  inset: 1px;
  border-radius: inherit;
  border: 1px solid rgb(255 255 255 / .14);
  pointer-events: none;
}

@media (prefers-color-scheme: dark) {
  .liquid-glass-web-approx {
    border-color: rgb(255 255 255 / .18);
    background:
      linear-gradient(135deg, rgb(255 255 255 / .16), rgb(255 255 255 / .04)),
      rgb(15 23 42 / .42);
    box-shadow:
      inset 0 1px 0 rgb(255 255 255 / .22),
      0 18px 60px rgb(0 0 0 / .42);
  }
}

@media (prefers-reduced-transparency: reduce) {
  .liquid-glass-web-approx {
    background: rgb(255 255 255 / .96);
    backdrop-filter: none;
    -webkit-backdrop-filter: none;
  }
}
```

**Important:** `prefers-reduced-transparency` has uneven browser support; test it. Always provide enough contrast even without blur.

---

**End of appendices.** Install commands above are reality anchors. The Apple Liquid Glass skeleton is a labeled approximation, not an Apple-issued package. For canonical docs per design system, consult the system's official docs (links in Section 2 plus Appendix B).

Источник: taste-skill / design-taste-frontend ↗. Ссылка проверена 2026-10-11.