Готовые DESIGN.md для ИИ: как дизайн-коды помогают верстать быстрее и лучше
Разбираем, что такое готовые DESIGN.md-файлы для AI-агентов, зачем они нужны, как помогают в дизайне, верстке и кодинге, где искать хорошие каталоги дизайн-кодов и как использовать их без копирования чужого бренда.
AI-инструменты уже умеют писать код, собирать интерфейсы и генерировать страницы. Но у них есть слабое место: без точного визуального контекста они часто делают одинаковый «современный дизайн» — большие скругления, случайные градиенты, размытые карточки, неоновые кнопки и интерфейс, который вроде бы выглядит аккуратно, но не имеет характера. Готовые DESIGN.md-файлы решают эту проблему иначе. Они дают ИИ не...
Что такое DESIGN.md
DESIGN.md — это Markdown-файл, в котором описан визуальный язык интерфейса.
Обычно в нём собраны:
- цветовая палитра;
- дизайн-токены;
- типографика;
- размеры шрифтов;
- line-height;
- letter-spacing;
- отступы;
- радиусы;
- тени;
- правила для кнопок;
- правила для карточек;
- стили форм;
- состояния элементов;
- примеры компонентов;
- рекомендации do/don’t;
- общее настроение интерфейса.
Если сказать проще, DESIGN.md — это краткая дизайн-система в текстовом виде. Не Figma-макет, не картинка и не абстрактное описание, а набор правил, который можно дать AI-агенту перед генерацией интерфейса.
Слабый запрос выглядит так:
Сделай красивый современный интерфейс.
Проблема: ИИ сам решает, что такое «красивый» и «современный».
Более сильный подход:
Используй DESIGN.md как визуальную основу проекта.
Сохрани:
- цветовую палитру;
- типографику;
- отступы;
- радиусы;
- стиль кнопок;
- стиль карточек;
- общий характер интерфейса.
Задача:
сверстать страницу личного кабинета в этом стиле.
Во втором случае ИИ получает не пустую просьбу, а дизайн-рамку.
Почему это вообще появилось
AI-кодинг быстро упёрся в дизайн.
Модели уже неплохо справляются с задачами вроде:
- сверстать лендинг;
- собрать dashboard;
- сделать форму;
- написать компонент;
- адаптировать страницу;
- поправить CSS;
- подготовить UI-прототип.
Но без визуального контекста они часто выбирают самый усреднённый вариант.
Получается типичный AI-интерфейс:
- много карточек;
- много градиентов;
- случайный glow;
- огромные border-radius;
- generic SaaS-стиль;
- одинаковые кнопки;
- слабая типографика;
- мало характера;
- дизайн не связан с брендом.
Проблема не в том, что ИИ не умеет верстать. Проблема в том, что ему не дали вкус, правила и границы.
DESIGN.md появился как способ передать этот вкус в формате, который AI-агент может прочитать и применить.
Главная идея: не «сделай красиво», а «работай по системе»
Фраза «сделай красиво» почти бесполезна.
Для одного проекта красиво — это строгий dark UI с тонкими линиями.
Для другого — светлый Apple-like минимализм.
Для третьего — плотный developer-tool интерфейс.
Для четвёртого — яркий маркетинговый лендинг.
Для пятого — спокойный редакционный блог.
DESIGN.md убирает эту неопределённость.
Он говорит ИИ:
Вот цвета.
Вот шрифты.
Вот отступы.
Вот радиусы.
Вот стиль карточек.
Вот как выглядят кнопки.
Вот какие акценты использовать.
Вот чего делать нельзя.
Это резко снижает количество случайных решений.
Как готовые md-дизайн-коды помогают разработчику
Разработчик часто не хочет становиться дизайнером. Ему нужно быстро получить аккуратный, цельный интерфейс, который не стыдно показать.
Готовый DESIGN.md помогает сразу в нескольких вещах.
1. Быстрее стартовать
Обычно перед версткой нужно решить:
- какие цвета использовать;
- какой размер заголовков;
- какие отступы между блоками;
- какие кнопки основные;
- как выглядят карточки;
- какие тени допустимы;
- насколько скруглять элементы;
- какой стиль у input и select;
- как оформлять пустые состояния;
- как выглядит таблица;
- как выглядит сайдбар.
Без дизайн-системы всё это приходится придумывать на ходу.
С DESIGN.md старт быстрее: базовые решения уже описаны.
ИИ не начинает с нуля. Он получает готовый визуальный словарь и может сразу применять его в коде.
2. Меньше случайного CSS
Когда нет правил, CSS быстро превращается в набор одноразовых решений:
.card {
border-radius: 18px;
}
.button {
border-radius: 12px;
}
.input {
border-radius: 8px;
}
.modal {
border-radius: 24px;
}
Вроде мелочь, но через несколько страниц интерфейс начинает выглядеть рыхло.
DESIGN.md помогает держать систему:
Для карточек использовать 12px.
Для кнопок использовать 10px.
Для мелких бейджей использовать 6px.
Для input использовать 10px.
Это не просто эстетика. Это техническая дисциплина.
Единые значения проще поддерживать, проще менять и проще объяснять AI-агенту.
3. Верстка становится более предсказуемой
Когда ИИ знает правила, он меньше импровизирует.
Без DESIGN.md он может на одной странице сделать:
- синий primary button;
- зелёный hover;
- фиолетовый gradient;
- серую secondary button;
- карточки с разными тенями;
- разные размеры заголовков;
- разные отступы.
С DESIGN.md можно задать:
Primary action всегда использует один цвет.
Secondary action всегда спокойный.
Danger action только для удаления.
Карточки имеют одинаковый padding.
Заголовки используют один type scale.
После этого верстка становится не набором удачных фрагментов, а частью одной системы.
4. Дизайн легче масштабировать
Одна страница может выглядеть хорошо даже без системы. Проблемы начинаются, когда страниц становится много:
- главная;
- каталог;
- карточка;
- блог;
- админка;
- личный кабинет;
- форма;
- таблица;
- настройки;
- модальные окна;
- пустые состояния.
Если каждая страница создана отдельным промптом без общей дизайн-базы, проект быстро начинает выглядеть как набор разных сайтов.
DESIGN.md решает это как общий источник стиля.
Вы можете сказать AI-агенту:
Все новые страницы делать по правилам DESIGN.md.
Не вводить новые цвета, радиусы и стили кнопок без необходимости.
Если нужен новый компонент, сначала вписать его в текущую систему.
Это особенно полезно для проектов, которые развиваются постепенно.
5. Меньше ручных правок после генерации
Самая раздражающая часть AI-верстки — бесконечные правки:
Сделай кнопку меньше.
Убери градиент.
Сделай отступы одинаковыми.
Не используй такой яркий цвет.
Карточки слишком круглые.
Текст слишком мелкий.
Таблица не похожа на остальные страницы.
Часть этих правок исчезает, если правила заданы заранее.
DESIGN.md работает как предварительное ТЗ для визуала. Он не гарантирует идеальный результат, но уменьшает количество очевидных ошибок.
Как DESIGN.md помогает дизайнеру
На первый взгляд может показаться, что DESIGN.md нужен только разработчикам. На самом деле дизайнеру он тоже полезен.
1. Дизайн становится понятен коду
Figma хорошо показывает внешний вид, но AI-агенту или разработчику часто нужны правила:
- какие токены использовать;
- какие состояния есть у компонента;
- какие отступы системные;
- какие цвета нельзя использовать;
- где primary action, а где decorative accent;
- какие варианты карточек допустимы;
- как ведёт себя интерфейс на мобильной ширине.
DESIGN.md переводит визуальный язык в текстовую инструкцию.
Это удобно для AI-кодинга: модель лучше понимает структурированные правила, чем просьбу «посмотри на скриншот и сделай похоже».
2. Проще передавать стиль команде
Не каждый участник проекта будет внимательно изучать макеты.
Но если есть короткий Markdown-файл с правилами, его проще использовать:
Перед началом любой UI-задачи прочитай DESIGN.md.
Следуй токенам.
Не добавляй новые цвета.
Не меняй типографику.
Используй существующие компоненты.
Это превращает дизайн из картинки в рабочий контракт.
3. Легче сохранять единый визуальный язык
Дизайнер может один раз описать систему, а затем использовать её как основу для задач:
- добавить страницу тарифов;
- сделать экран настроек;
- переделать таблицу пользователей;
- собрать onboarding;
- подготовить мобильную версию;
- обновить карточки блога;
- привести формы к единому стилю.
Если AI-агент работает с DESIGN.md, он меньше отклоняется от выбранного направления.
Как DESIGN.md помогает AI-агенту
AI-агенту нужен контекст. Чем он точнее, тем лучше результат.
DESIGN.md даёт контекст сразу на нескольких уровнях:
- Визуальный уровень — цвета, шрифты, spacing, форма.
- Компонентный уровень — кнопки, карточки, поля, таблицы.
- Поведенческий уровень — hover, focus, active, disabled.
- Редакционный уровень — тон интерфейса, плотность текста, характер.
- Ограничительный уровень — что нельзя использовать.
Для AI-агента это как карта местности. Без карты он может дойти до результата, но будет много блуждать.
Почему это особенно важно для vibe coding
Vibe coding часто критикуют за одно: можно быстро получить работающий интерфейс, но он оказывается визуально случайным.
Сегодня AI сделал одну страницу в стиле Notion.
Завтра вторую — в стиле Linear.
Послезавтра третью — в стиле Stripe.
Потом админка внезапно стала похожа на Bootstrap.
А форма регистрации получила градиентную кнопку, которой нет нигде в проекте.
Проблема не в скорости. Проблема в отсутствии дизайн-памяти.
DESIGN.md добавляет эту память.
Он говорит:
У проекта есть визуальные правила.
Следуй им.
Не изобретай стиль заново на каждой задаче.
Это делает vibe coding менее хаотичным и ближе к нормальной инженерной работе.
Что может быть внутри DESIGN.md
Хороший DESIGN.md обычно содержит несколько разделов.
1. Общая идея стиля
Например:
Интерфейс должен ощущаться как тёмный рабочий инструмент: спокойный, плотный, технологичный, без декоративного шума.
Или:
Стиль — светлый editorial SaaS: много воздуха, сильная типографика, мягкие поверхности, один акцентный цвет.
Этот блок задаёт настроение.
2. Цвета
Цвета должны быть не просто списком hex-кодов, а системой ролей.
Плохо:
#000000
#ffffff
#2563eb
#22c55e
Лучше:
--color-bg: основной фон страницы.
--color-surface: фон карточек.
--color-border: границы и разделители.
--color-text: основной текст.
--color-muted: вторичный текст.
--color-primary: основное действие.
--color-danger: опасные действия.
ИИ должен понимать не только цвет, но и назначение цвета.
3. Типографика
Типографика часто ломает интерфейс сильнее, чем цвета.
В DESIGN.md полезно указать:
- основной шрифт;
- запасной шрифт;
- размеры заголовков;
- размеры текста;
- line-height;
- letter-spacing;
- вес шрифта;
- правила для small text;
- правила для code text.
Пример:
Заголовки крупные, плотные, с отрицательным letter-spacing.
Основной текст 16px, line-height 1.6.
Вторичный текст 14px, muted color.
Код и технические фрагменты — monospace.
Так ИИ не будет случайно делать заголовки слишком большими, а описания слишком мелкими.
4. Отступы
Отступы — основа аккуратной верстки.
Полезно задать:
Базовая сетка: 4px.
Малый gap: 8px.
Средний gap: 16px.
Большой gap: 24px.
Секция: 64–96px.
Карточка: padding 20–24px.
Если отступы не заданы, AI часто делает страницу визуально неровной: где-то слишком тесно, где-то слишком пусто.
5. Радиусы и форма
Радиусы должны быть системными.
Пример:
Малые элементы: 6px.
Input и button: 10px.
Карточки: 16px.
Большие панели: 24px.
Не использовать полностью круглые карточки.
Или для строгого интерфейса:
Радиусы минимальные: 4–8px.
Не использовать pill-формы без необходимости.
Радиусы сильно влияют на характер продукта. Поэтому их нельзя оставлять на усмотрение модели.
6. Компоненты
В DESIGN.md можно описать базовые компоненты:
- button;
- input;
- select;
- textarea;
- card;
- badge;
- table;
- sidebar;
- modal;
- alert;
- empty state;
- navbar;
- pricing card;
- article card.
Пример:
Primary button:
- фон: primary color;
- текст: контрастный;
- radius: 10px;
- padding: 12px 18px;
- hover: слегка темнее;
- не использовать glow.
Такие правила помогают AI-агенту создавать повторяемый UI.
7. Do and Don’t
Это один из самых полезных разделов.
Пример:
Do:
- использовать один акцентный цвет;
- держать карточки визуально спокойными;
- делать кнопки понятными;
- использовать короткие подписи;
- сохранять плотную сетку.
Don’t:
- не добавлять случайные градиенты;
- не использовать больше двух акцентных цветов;
- не делать огромные тени;
- не смешивать разные радиусы;
- не перегружать экран декоративными элементами.
Do/don’t хорошо работают с AI, потому что прямо ограничивают нежелательные решения.
Где искать готовые DESIGN.md и дизайн-коды
Готовые DESIGN.md и похожие дизайн-коды полезны как стартовая точка. Их не стоит воспринимать как набор шаблонов для слепого копирования. Лучше относиться к ним как к библиотеке визуальных подходов: посмотреть структуру, понять логику токенов, взять принципы и адаптировать под свой проект.
Ниже несколько полезных источников.
Open Design

Open Design — open-source проект для AI-дизайна и генерации интерфейсов через coding agents. Он интересен не только как инструмент, но и как пример того, куда движется AI-дизайн: дизайн-системы, skills, sandbox preview, экспорт и работа через привычные AI coding CLI.
Чем полезен:
- показывает, как дизайн можно связать с AI-агентами;
- помогает понять идею design systems как входного контекста;
- подходит для изучения подхода «дизайн как код + агент»;
- полезен разработчикам, которые хотят собирать UI не хаотично, а через систему.
Это не просто каталог красивых стилей. Это пример среды, где дизайн становится частью AI-workflow.
Refero Styles

Refero Styles — каталог готовых визуальных стилей в формате DESIGN.md. Его ценность в том, что можно быстро посмотреть разные эстетики, выбрать близкое направление и использовать его как основу для AI-верстки.
Чем полезен:
- помогает быстро найти визуальное направление;
- даёт готовый Markdown-контекст для AI-агента;
- показывает цвета, типографику, spacing, компоненты и дизайн-токены;
- экономит время на старте UI-задачи;
- помогает объяснить ИИ не словами «сделай красиво», а конкретной дизайн-системой.
Refero Styles особенно полезен, если нужно быстро подобрать стиль для лендинга, SaaS-интерфейса, админки, блога, карточек или прототипа.
Google DESIGN.md
Google DESIGN.md — спецификация формата DESIGN.md. Это не каталог стилей, а базовое описание самого подхода: как описывать визуальную идентичность для coding agents, как сочетать design tokens и Markdown-объяснения, как валидировать файл и экспортировать токены.
Чем полезен:
- объясняет стандарт DESIGN.md;
- показывает структуру файла;
- разделяет machine-readable tokens и human-readable rationale;
- помогает делать собственные DESIGN.md не хаотично, а по понятной логике;
- даёт основу для проверки и экспорта дизайн-токенов.
Если вы хотите не просто скачать чужой стиль, а сделать свой DESIGN.md для проекта, лучше начать именно с этой спецификации.
Awesome DESIGN.md

Awesome DESIGN.md — подборка DESIGN.md-файлов, вдохновлённых популярными developer-focused сайтами и дизайн-системами.
Чем полезен:
- даёт много готовых примеров;
- помогает сравнивать разные визуальные подходы;
- показывает, как популярные сайты можно описывать через design tokens;
- удобен как библиотека референсов для AI-агентов;
- показывает, как DESIGN.md можно положить в проект и использовать как визуальный контекст.
Важный момент: такие коллекции лучше использовать как вдохновение, а не как способ сделать копию чужого бренда.
Awesome Claude Design

Awesome Claude Design — коллекция DESIGN.md-файлов, ориентированная на работу с Claude Design. Проект показывает идею: загрузить DESIGN.md и получить стартовую дизайн-систему, компоненты, preview-карточки и UI-kit.
Чем полезен:
- показывает, как DESIGN.md может превращаться в полноценный UI-скелет;
- полезен для изучения связки «дизайн-файл → агент → компоненты»;
- помогает быстрее стартовать с прототипом;
- даёт примеры того, как структурированный стиль влияет на генерацию интерфейса.
Но здесь особенно важно помнить: многие стили вдохновлены публичными сайтами и брендами. Использовать их лучше как отправную точку, а не как готовую визуальную идентичность для коммерческого продукта.
Как правильно использовать такие каталоги
Плохой подход:
Возьми стиль из каталога и сделай мой сайт точно так же.
Так вы рискуете получить чужой визуальный язык, который не подходит продукту и может выглядеть как копия.
Хороший подход:
Изучи этот DESIGN.md как референс.
Возьми:
- структуру токенов;
- принцип работы с цветами;
- подход к типографике;
- spacing scale;
- правила компонентов;
- do/don’t.
Адаптируй:
- цвета под мой бренд;
- типографику под русский язык;
- плотность интерфейса под мой продукт;
- компоненты под реальные сценарии;
- тексты под мою аудиторию.
Не копируй бренд напрямую.
Готовый DESIGN.md должен быть не чужим костюмом, а чертежом, по которому вы собираете собственную систему.
На что смотреть при выборе готового DESIGN.md
Перед тем как брать стиль из каталога, проверьте:
- подходит ли он вашей аудитории;
- не слишком ли он декоративный;
- есть ли понятная цветовая система;
- описана ли типографика;
- есть ли spacing scale;
- есть ли правила для кнопок, карточек и форм;
- есть ли do/don’t;
- можно ли адаптировать стиль под русский интерфейс;
- не выглядит ли результат как копия известного бренда;
- подходит ли стиль для всех страниц проекта, а не только для красивого hero-блока.
Если стиль хорош только на первом экране лендинга, но разваливается в таблицах, формах и админке, для реального продукта он слабый.
Как использовать готовый DESIGN.md в проекте
Есть несколько рабочих сценариев.
Сценарий 1. Дать DESIGN.md перед задачей
Самый простой способ:
Ниже DESIGN.md проекта. Используй его как обязательный визуальный контекст.
[вставить DESIGN.md]
Задача:
сверстать страницу настроек пользователя.
Требования:
- использовать существующие токены;
- не добавлять новые цвета;
- сохранить стиль кнопок и карточек;
- сделать адаптивную верстку;
- не менять текущую архитектуру проекта.
Такой подход подходит для разовой задачи.
Сценарий 2. Хранить DESIGN.md в корне проекта
Лучше положить файл в проект:
/DESIGN.md
И в промпте писать:
Перед началом задачи прочитай DESIGN.md и следуй его правилам.
Это удобно, если вы постоянно работаете с Codex, Cursor, Claude Code или другим AI-агентом.
Сценарий 3. Использовать DESIGN.md как стандарт для ревью
DESIGN.md полезен не только для генерации, но и для проверки результата.
Промпт:
Проверь эту страницу на соответствие DESIGN.md.
Проверь:
- цвета;
- типографику;
- отступы;
- радиусы;
- кнопки;
- карточки;
- формы;
- состояние hover/focus;
- визуальную иерархию.
Формат ответа:
таблица: проблема, где находится, какое правило нарушено, как исправить.
Это превращает дизайн-ревью в более конкретный процесс.
Сценарий 4. Адаптировать чужой стиль под свой проект
Готовый DESIGN.md не нужно копировать слепо. Его можно использовать как основу.
Например, вам нравится строгий dark UI, но у проекта уже есть свои цвета.
Промпт:
Возьми структуру и принципы этого DESIGN.md, но адаптируй под мой бренд.
Сохрани:
- плотную сетку;
- строгие карточки;
- аккуратные кнопки;
- низкий визуальный шум.
Замени:
- primary color на #2563eb;
- шрифты на Inter/system-ui;
- тексты интерфейса на русский язык;
- слишком яркие акценты на более спокойные.
Не копируй бренд напрямую.
Собери адаптированный DESIGN.md для моего проекта.
Так вы используете чужой дизайн как референс, а не как клон.
Почему нельзя просто копировать стиль известного продукта
Готовые дизайн-коды соблазняют: взял стиль Linear, Vercel, Stripe, Apple или Cursor — и получил красивый продукт.
Но здесь есть риск.
Чужой стиль может не подходить вашему проекту:
- другая аудитория;
- другой тип продукта;
- другая плотность интерфейса;
- другой контент;
- другой бренд;
- другие сценарии;
- другой уровень доверия;
- другая визуальная задача.
Например, интерфейс developer tool может быть плотным, тёмным и строгим. Но если вы делаете сайт для широкой аудитории, такой стиль может выглядеть тяжело.
И наоборот: мягкий светлый editorial-стиль может плохо подойти для админки, где важны таблицы, статусы и быстрые действия.
Правильный подход:
Не копировать стиль полностью.
Извлечь принципы.
Адаптировать под задачу.
Где готовые DESIGN.md особенно полезны
1. Лендинги
Для лендинга важно быстро задать:
- визуальный стиль;
- hero-секцию;
- кнопки;
- карточки преимуществ;
- блоки доверия;
- pricing;
- FAQ;
- CTA.
DESIGN.md помогает сделать страницу цельной.
2. SaaS-интерфейсы
Для SaaS особенно важны:
- dashboard;
- sidebar;
- таблицы;
- фильтры;
- формы;
- статусы;
- пустые состояния;
- уведомления;
- модальные окна.
Без дизайн-системы SaaS быстро превращается в набор разных экранов.
3. Админки
Админка не должна быть «красивой ради красоты». Она должна быть удобной, плотной и предсказуемой.
DESIGN.md помогает задать:
- таблицы;
- списки;
- кнопки действий;
- danger-действия;
- фильтры;
- bulk actions;
- пустые состояния;
- логи;
- карточки метрик.
Это особенно полезно, если админка постепенно дорабатывается AI-агентом.
4. Блоги и контентные сайты
Для блога важны:
- типографика;
- ширина текста;
- заголовки;
- цитаты;
- code blocks;
- таблицы;
- карточки статей;
- оглавление;
- навигация;
- SEO-блоки.
DESIGN.md может описать не только интерфейс, но и правила чтения.
5. Мобильные прототипы
Мобильный интерфейс особенно чувствителен к отступам, размерам и состояниям.
DESIGN.md помогает удержать:
- размер tap targets;
- spacing;
- bottom navigation;
- карточки;
- формы;
- состояния ошибок;
- пустые экраны;
- onboarding.
6. Генерация компонентов
Если нужно сделать не страницу, а компонент, DESIGN.md тоже полезен.
Примеры:
Сделай компонент PricingCard по DESIGN.md.
Сделай EmptyState для пустой библиотеки промптов.
Сделай таблицу пользователей в стиле текущей админки.
Сделай карточку статьи для блога.
AI-агенту проще создавать компоненты, когда он понимает общий визуальный язык.
Как DESIGN.md улучшает промпты для Codex и Cursor
Обычный промпт для UI-задачи:
Сделай красивую страницу тарифов.
Сильный промпт с DESIGN.md:
Перед началом прочитай DESIGN.md.
Задача:
сверстать страницу тарифов.
Требования:
- использовать существующую цветовую палитру;
- использовать системные отступы;
- карточки тарифов должны соответствовать правилам card;
- primary CTA использовать только для главного тарифа;
- secondary buttons использовать для остальных тарифов;
- не добавлять новые градиенты;
- не менять базовую типографику;
- адаптировать страницу под mobile.
Формат результата:
изменить только нужные файлы и кратко указать, что сделано.
Разница огромная. Во втором варианте агент получает критерии качества.
Что должно быть в хорошем промпте с DESIGN.md
Если вы даёте AI-агенту DESIGN.md, не ограничивайтесь фразой «используй стиль».
Лучше указывать:
Перед началом прочитай DESIGN.md.
Задача:
[что нужно сделать]
Обязательно:
- использовать токены из DESIGN.md;
- не добавлять новые цвета без необходимости;
- соблюдать правила типографики;
- соблюдать spacing scale;
- использовать существующие стили кнопок, карточек и форм;
- сохранить адаптивность;
- все новые элементы должны выглядеть частью текущей системы.
Запрещено:
- добавлять случайные градиенты;
- использовать новые тени;
- менять базовые радиусы;
- смешивать несколько визуальных стилей;
- копировать чужой бренд напрямую.
После выполнения:
кратко указать, какие правила DESIGN.md были применены.
Такой промпт работает лучше, чем просто «сделай по DESIGN.md».
DESIGN.md не заменяет дизайнера
Важно не превратить DESIGN.md в магический амулет.
Он помогает, но не решает всё.
DESIGN.md не заменяет:
- продуктовую логику;
- UX-исследование;
- понимание аудитории;
- информационную архитектуру;
- работу с текстами;
- визуальную иерархию в сложных сценариях;
- проверку доступности;
- тестирование интерфейса;
- финальное дизайн-ревью.
Он даёт AI-агенту рамки. Но хорошие рамки не гарантируют хороший продукт.
Если сценарий плохой, DESIGN.md не спасёт. Он просто красиво оформит плохой сценарий.
Главный риск: красивый, но чужой интерфейс
Готовые дизайн-коды могут привести к другой проблеме: все начнут делать сайты «как Linear», «как Stripe», «как Vercel», «как Apple».
Это лучше, чем хаотичный AI-дизайн, но всё равно не идеал.
Если проект просто копирует чужой визуальный язык, он теряет собственный характер.
Правильнее использовать DESIGN.md так:
Взять дисциплину.
Взять структуру.
Взять принципы.
Не копировать лицо бренда.
Например, можно взять у одного референса плотность интерфейса, у другого — типографическую аккуратность, у третьего — подход к карточкам. А затем собрать собственный DESIGN.md под проект.
Как сделать свой DESIGN.md
Можно начать с простого файла.
# DESIGN.md
## Общий стиль
Тёмный интерфейс для SaaS-продукта. Стиль строгий, современный, без декоративного шума. Главное — читаемость, понятная иерархия и аккуратные рабочие экраны.
## Цвета
- Background: #0b1020
- Surface: #111827
- Surface elevated: #172033
- Border: #243047
- Text primary: #f8fafc
- Text secondary: #94a3b8
- Primary: #2563eb
- Success: #22c55e
- Warning: #f59e0b
- Danger: #ef4444
## Типографика
- Font: Inter, system-ui, sans-serif
- H1: 40px, line-height 1.1, font-weight 700
- H2: 28px, line-height 1.2, font-weight 700
- Body: 16px, line-height 1.6
- Small: 14px, line-height 1.5
## Отступы
- Base unit: 4px
- Small gap: 8px
- Medium gap: 16px
- Large gap: 24px
- Section gap: 64px
- Card padding: 24px
## Радиусы
- Buttons: 10px
- Inputs: 10px
- Cards: 18px
- Modals: 24px
## Компоненты
### Button
Primary button uses Primary background and white text. No gradients. Hover state slightly darker. Disabled state muted.
### Card
Cards use Surface background, Border color, 18px radius and 24px padding. Avoid strong shadows.
### Input
Inputs use dark surface, border, 10px radius, clear focus state with primary border.
## Do
- Use one primary accent.
- Keep layouts clean.
- Use consistent spacing.
- Prefer clarity over decoration.
- Keep Russian UI text concise.
## Don’t
- Do not add random gradients.
- Do not use more than one primary accent.
- Do not use glassmorphism by default.
- Do not make cards overly rounded.
- Do not create new button styles without reason.
Такого файла уже достаточно, чтобы AI-агент работал аккуратнее.
Как использовать готовый DESIGN.md без вреда
Используйте простой порядок:
- Найдите стиль, близкий к задаче.
- Изучите не только цвета, но и правила.
- Уберите то, что не подходит вашему проекту.
- Замените фирменные цвета на свои.
- Адаптируйте типографику под русский язык.
- Проверьте компоненты: кнопки, формы, карточки, таблицы.
- Добавьте запреты.
- Сохраните файл в проект.
- Требуйте от AI-агента читать его перед UI-задачами.
- Проверяйте результат по этому же файлу.
Главное — не использовать DESIGN.md как костыль для вкуса. Используйте его как систему.
Готовый промпт для Codex или Cursor
Перед началом задачи прочитай DESIGN.md в корне проекта и используй его как обязательный визуальный стандарт.
Задача:
[описать страницу, компонент или правку]
Требования:
- использовать цвета, типографику, spacing, radius и компонентные правила из DESIGN.md;
- не добавлять новые цвета, тени, градиенты и варианты кнопок без необходимости;
- сохранить текущую архитектуру проекта;
- все новые UI-тексты писать на русском языке;
- сделать адаптивную верстку;
- проверить hover, focus, disabled и empty states, если они применимы.
Ограничения:
- не копировать внешний бренд напрямую;
- не переписывать весь UI;
- не подключать тяжёлые зависимости;
- не менять backend-логику без необходимости;
- не выводить полный код в ответ.
После выполнения:
кратко указать:
1. Что сделано.
2. Какие файлы изменены.
3. Какие правила DESIGN.md были применены.
4. Что проверить вручную.
Готовый промпт для создания DESIGN.md под проект
Составь DESIGN.md для моего проекта.
Контекст проекта:
[описать сайт, продукт, аудиторию, стиль, текущий UI]
Цель:
получить структурированный Markdown-файл, который AI-агент сможет использовать как дизайн-контекст при верстке страниц и компонентов.
Нужно описать:
- общий визуальный стиль;
- цветовые токены;
- типографику;
- spacing scale;
- border-radius;
- shadows/elevation;
- кнопки;
- формы;
- карточки;
- таблицы;
- навигацию;
- пустые состояния;
- do/don’t;
- правила адаптивности.
Требования:
- не использовать абстрактные фразы без конкретных значений;
- все UI-тексты и комментарии на русском языке;
- учитывать текущий стиль проекта;
- не копировать чужой бренд напрямую;
- сделать файл пригодным для Codex/Cursor/Claude Code.
Формат ответа:
готовый DESIGN.md в Markdown.
Чеклист хорошего DESIGN.md
Перед использованием проверьте файл:
- Есть общее описание стиля.
- Цвета имеют роли, а не просто hex-коды.
- Типографика описана конкретно.
- Есть spacing scale.
- Радиусы системные.
- Описаны основные компоненты.
- Есть правила do/don’t.
- Указаны ограничения.
- Есть правила для адаптивности.
- Нет противоречий.
- Стиль подходит проекту.
- Файл можно дать AI-агенту без дополнительных объяснений.
- Он не копирует чужой бренд напрямую.
- Его можно использовать для ревью результата.
Если файл проходит этот чеклист, он уже может заметно улучшить AI-верстку.
Частые ошибки при использовании DESIGN.md
Ошибка 1. Копировать чужой стиль без адаптации
Плохо:
Сделай мой сайт полностью как этот бренд.
Лучше:
Используй принципы: плотная сетка, строгая типографика, один акцентный цвет. Цвета и компоненты адаптируй под мой проект.
Ошибка 2. Давать слишком общий DESIGN.md
Плохо:
Стиль современный, красивый, минималистичный.
Лучше:
Фон #0b1020, карточки #111827, primary #2563eb, body 16px/1.6, card radius 18px, button radius 10px, card padding 24px.
ИИ лучше работает с конкретикой.
Ошибка 3. Не указывать запреты
Если не указать, чего нельзя делать, модель может добавить лишнее.
Полезные запреты:
Не использовать случайные градиенты.
Не добавлять glassmorphism.
Не вводить новые accent colors.
Не менять типографику.
Не делать карточки слишком круглыми.
Ошибка 4. Не использовать DESIGN.md для ревью
Многие дают DESIGN.md только перед генерацией. Но его можно использовать и после.
Промпт:
Проверь результат на соответствие DESIGN.md и найди нарушения.
Это помогает довести интерфейс до системы.
Ошибка 5. Смешивать несколько несовместимых стилей
Плохо:
Сделай как Apple, Linear, Stripe, Notion и Cyberpunk одновременно.
Лучше:
Основной стиль — строгий dark SaaS. Можно взять у Linear плотность и контраст, но без копирования бренда и без лишних ярких акцентов.
Сильный дизайн почти всегда строится на выборе, а не на смешивании всего.
FAQ
DESIGN.md — это замена Figma?
Нет. DESIGN.md не заменяет макеты, прототипы и работу дизайнера. Он помогает описать дизайн-систему в текстовом виде, чтобы AI-агент мог применять её при верстке и генерации компонентов.
Можно ли использовать готовый DESIGN.md из чужого продукта?
Можно как референс, но не стоит копировать чужой бренд напрямую. Лучше взять принципы, адаптировать цвета, типографику и компоненты под свой проект.
Зачем DESIGN.md, если можно просто показать скриншот?
Скриншот показывает внешний вид, но не всегда объясняет правила. DESIGN.md описывает систему: токены, роли цветов, отступы, компоненты, do/don’t. Для AI-агента это часто полезнее, чем одна картинка.
Где хранить DESIGN.md?
Лучше хранить в корне проекта или в папке документации. Например: /DESIGN.md или /docs/DESIGN.md. В промптах для Codex или Cursor можно прямо писать: «перед началом прочитай DESIGN.md».
Подходит ли DESIGN.md для старого проекта?
Да. Даже если проект уже существует, можно описать текущие правила, убрать хаос и использовать файл как основу для будущих UI-задач.
DESIGN.md помогает только в дизайне?
Нет. Он помогает и в кодинге: снижает количество случайных CSS-решений, упрощает ревью, помогает держать компоненты единообразными и делает задачи для AI-агента точнее.
Какие каталоги DESIGN.md стоит посмотреть?
Для старта стоит посмотреть Open Design, Refero Styles, Google DESIGN.md, Awesome DESIGN.md и Awesome Claude Design. Первый полезен как пример AI-design workflow, второй — как каталог готовых стилей, Google DESIGN.md — как спецификация формата, а Awesome-коллекции — как библиотека вдохновения и готовых DESIGN.md-файлов.
Итог
Готовые DESIGN.md-файлы появились потому, что AI-агентам не хватает не только задачи, но и вкуса, системы и визуальной памяти.
Они помогают заменить расплывчатое «сделай красиво» на понятные правила: цвета, типографика, отступы, компоненты, ограничения и do/don’t. Для разработчика это означает меньше случайного CSS и меньше ручных правок. Для дизайнера — более понятную передачу визуального языка в код. Для AI-агента — конкретный контекст, по которому можно строить интерфейс.
Каталоги вроде Open Design, Refero Styles, Google DESIGN.md, Awesome DESIGN.md и Awesome Claude Design полезны как быстрый вход в эту практику. Но их не нужно использовать как способ копировать чужие бренды. Сильный подход — брать структуру, принципы и дисциплину дизайн-системы, а затем адаптировать всё под свой продукт.
Хороший DESIGN.md — это не украшение проекта. Это рабочий стандарт, который помогает быстрее проектировать, верстать, проверять и развивать интерфейс без визуального хаоса.