Designesy

12-секундный зацикленный ролик, записанный на главной странице. Он воспроизводится один раз и останавливается на итоговой оценке. Если вы предпочитаете уменьшенную анимацию, вместо него отображается неподвижный кадр. Посмотрите, как он работает на designesy.org.

Контроль качества интерфейсов, созданных с помощью AI: оцените любой URL по 45 детерминированным проверкам и получите оценку от A до F. Сервис доступен на designesy.org.

Быстрый старт

Оцените любой URL за 5 секунд — без установки:

npx @designesy/score@latest https://your-site.com

Добавьте сервер в Claude Desktop, Cursor или любой MCP-клиент:

# Claude Code, удалённое подключение (без установки и авторизации):
claude mcp add --transport http designesy https://www.designesy.org/api/mcp

# Или локальный запуск через stdio с помощью PyPI:
pip install designesy-mcp && designesy-mcp

Клонируете этот репозиторий? Файл .mcp.json в корне подключает локальный сервер (uvx designesy-mcp) к Claude Code как сервер проекта. При первом открытии проекта Claude Code попросит подтвердить подключение. Для работы нужен uv.

Добавьте проверку соответствия дизайн-контракту в CI:

- uses: LE-VAI/designesy-org@v1
  with:
    url: https://your-app.vercel.app
    min-score: 70
    min-grade: C
    post-comment: true   # публикует краткий комментарий в PR (по умолчанию)

Один и тот же движок из 45 проверок используется MCP-сервером (17 инструментов для AI-агентов), CLI без обязательных зависимостей (npx @designesy/score), GitHub Action и публичной таблицей лидеров на designesy.org/leaderboard.

Designesy Contract Check — это GitHub Action, который оценивает любой URL по дизайн-системному контракту из 45 проверок (токены, анимация, доступность, ритм, такт, уравновешенность, идентичность, взаимодействие, производительность, адаптивность, семантика, безопасность, спецификация, UX-тексты) и останавливает выполнение CI, если оценка или буквенная отметка опускается ниже заданного порога. LLM не участвует в процессе: каждая проверка основана на опубликованном детерминированном правиле, поэтому одна и та же страница всегда получает одинаковые результаты.

Инструменты

designesy_score — Оценить доступный по URL сайт по дизайн-контракту из 45 проверок. Возвращает балл, буквенную оценку (A–F) и результаты каждой проверки.
designesy_tokens_score — Проверить файл дизайн-токенов DTCG. 10 проверок на соответствие W3C DTCG 2025.10.
designesy_a11y_score — Получить рекомендации по доступности WCAG 2.2 AA и шаблон скрипта для Playwright/axe-core.
designesy_motion_score — Проверить файл анимации Lottie. 10 проверок на соответствие спецификации Lottie v1.0.1 и стандартам анимации из §16.
designesy_contract — Получить дизайн-системный контракт (токены, анимация, такт, ритм, типографика, проверка целиком или только по указанным разделам верхнего уровня sections).
designesy_catalog — Получить список опубликованных пакетов Designesy с версиями и URL. Количество пакетов возвращается в package_count.
designesy_design_review — Получить качественную рубрику для оценки дизайна по 8 измерениям.
designesy_skill_md — Получить контракт в формате агентского навыка SKILL.md для Cursor, Claude Code или Replit.
designesy_agent_json — Получить документ обнаружения /.well-known/agent.json.
designesy_llms_txt — Получить краткое описание для агентов из /llms.txt.
designesy_llms_full_txt — Получить полное описание для агентов из /llms-full.txt в качестве справочных данных. Инструкции по загрузке данных и готовый к вставке запрос для агента остаются в опубликованном файле.
designesy_drift_score — Оценить отклонения интерфейса на доступном по URL сайте: 12 проверок пользовательских свойств и ссылок var().
designesy_readiness_score — Оценить готовность URL к работе с AI: 10 проверок наличия машиночитаемых артефактов дизайна (токенов DTCG, llms.txt, agent.json, конечной точки MCP, DESIGN.md и других).
designesy_guardrails — Сформировать набор файлов с требованиями к сборке для кодирующих агентов на основе токенов сайта: токены DTCG, конфигурация Stylelint, правила AGENTS.md, контракт компонентов, антипаттерны и DESIGN.md.
designesy_monitor_score — Повторно выполнить проверки отклонений относительно предыдущих снимков и провести 10 проверок мониторинга. Может отправить уведомление об отклонениях на указанный адрес электронной почты.
designesy_compare — Сравнить токены двух доступных по URL сайтов: добавленные, удалённые и переименованные токены, изменённые значения, отклонения масштаба и контрастности, а также разницу в оценках.
designesy_report — Сформировать сводный отчёт по URL (оценка × 0.5 + отклонения × 0.3 + готовность × 0.2) с интерактивной панелью на платформах, поддерживающих MCP Apps.

Справочная таблица инструментов

Инструмент	Описание
`designesy_score`	Оценить доступный по URL сайт по дизайн-контракту из 45 проверок — возвращает балл, буквенную оценку (A–F) и результаты каждой проверки
`designesy_tokens_score`	Проверить файл дизайн-токенов DTCG (10 проверок на соответствие W3C DTCG 2025.10)
`designesy_a11y_score`	Получить рекомендации по доступности WCAG 2.2 AA и шаблон скрипта для Playwright/axe-core
`designesy_motion_score`	Проверить файл анимации Lottie (10 проверок на соответствие спецификации Lottie v1.0.1 и стандартам анимации из §16)
`designesy_contract`	Получить дизайн-системный контракт (токены, анимация, такт, ритм, типографика, проверка) целиком или только по указанным разделам верхнего уровня `sections`
`designesy_catalog`	Получить список опубликованных пакетов Designesy с версиями и URL
`designesy_design_review`	Получить качественную рубрику для оценки дизайна по 8 измерениям
`designesy_skill_md`	Получить контракт в формате агентского навыка SKILL.md (для Cursor/Claude Code/Replit)
`designesy_agent_json`	Получить документ обнаружения /.well-known/agent.json
`designesy_llms_txt`	Получить краткое описание для агентов из /llms.txt
`designesy_llms_full_txt`	Получить полное описание для агентов из /llms-full.txt в качестве справочных данных (инструкции по загрузке данных и готовый к вставке запрос для агента остаются в опубликованном файле)
`designesy_drift_score`	Оценить отклонения интерфейса на доступном по URL сайте (12 проверок пользовательских свойств и ссылок var())
`designesy_readiness_score`	Оценить готовность URL к работе с AI (10 проверок машиночитаемых артефактов дизайна)
`designesy_guardrails`	Сформировать набор файлов с требованиями к сборке для кодирующих агентов на основе токенов сайта (6 файлов)
`designesy_monitor_score`	Повторно выполнить проверки отклонений относительно предыдущих снимков; провести 10 проверок мониторинга; при необходимости отправить уведомление об отклонениях по электронной почте
`designesy_compare`	Сравнить токены двух доступных по URL сайтов и показать разницу в оценках
`designesy_report`	Сформировать сводный отчёт по URL (оценка, отклонения, готовность) с панелью MCP App

Доступные ресурсы

Сайт: designesy.org
Конечная точка MCP: designesy.org/api/mcp (Streamable HTTP, без авторизации)
Оценка сайта: designesy.org/score
Таблица лидеров: designesy.org/leaderboard — оценены 30 сайтов
Методология: designesy.org/methodology — полная методология оценки по 45 проверкам
Контракт: designesy.org/contracts/design-system
Машиночитаемый формат: designesy.org/contracts/design-system.json

Проверка контракта

Сайт проверяется на соответствие дизайн-системному контракту по 45 детерминированным критериям с привязкой к токенам. Обе отметки берут данные из актуальной таблицы лидеров, которая обновляется при еженедельной повторной оценке. Поэтому указанная здесь оценка всегда соответствует результатам движка. Результаты отдельных проверок доступны на странице оценки. О том, как рассчитывается оценка, читайте на странице методологии.

Контракт

45 проверок в 14 категориях с разными весами: токены, анимация, доступность, ритм, такт, уравновешенность, идентичность, взаимодействие, производительность, адаптивность, семантика, безопасность, спецификация, UX-тексты
Принципы UX-текстов (добавлены в v0.4.0) — 16 принципов UX-копирайтинга и 4 проверки (глагольные формулировки на кнопках, отсутствие точек в конце, описательный текст ссылок, отсутствие текста ALL CAPS)
10 обязательных стандартов анимации — продуманное сглаживание, явное указание свойств, появление через прозрачность, неподвижность при управлении с клавиатуры, отсутствие анимации макета, ограничение для сенсорного ввода, ограниченная длительность, сценарии с уменьшенной анимацией, асимметричное нажатие, отсутствие ease-in
10 токенов звуковых сигналов — пользовательский $type: sound (новый тип относительно W3C DTCG 2025.10), движок Cuelume 0.2 (MIT), только для взаимодействий. В документе звуковых токенов описаны ещё 9 дополнительных сигналов обратной связи — всего 19
10 открытых противоречий — задокументированы, а не скрыты
Физика пружины — токены по умолчанию и для импульса движения с пользовательским $type: spring
Машиночитаемый формат — W3C DTCG 2025.10 с пользовательскими расширениями

Полная история внедрения опубликована на странице контракта.

GitHub Action

Добавьте проверку соответствия дизайн-контракту в CI:

- uses: LE-VAI/designesy-org@v1
  with:
    url: https://your-app.vercel.app
    min-score: 70
    min-grade: C
    post-comment: true   # публикует краткий комментарий в PR (по умолчанию)

Оценивает URL с помощью доступного онлайн-движка /api/score и останавливает выполнение workflow, если балл или буквенная оценка опускаются ниже заданного порога. Запускается на node24, публикует комментарии в PR через базовый GitHub REST API и не требует зависимостей. Подробные инструкции приведены в action/README.md.

CLI

Оценивайте URL из командной строки — для локальной разработки, pre-commit hooks и скриптов:

# No install needed:
npx @designesy/score designesy.org

# With gating (exit 1 on failure):
npx @designesy/score linear.app --min-score 70 --min-grade B

# JSON output for piping:
npx @designesy/score vercel.com --format canonical --json

Обязательные зависимости не требуются. Движок работает локально, без сервера Designesy; проверки, для которых нужен браузер, возвращают статус MANUAL. Полный список параметров смотрите в --help, а справочное руководство — в README пакета score.

При работе с клоном этого репозитория: папка dist/ движка не включена в репозиторий, поэтому сначала соберите его.

npm --prefix packages/score ci
npm run build:score
node packages/score/dist/cli.js designesy.org

Старая версия cli/designesy-score.mjs (npm run score) использует ту же сборку. Она устарела и заменена на @designesy/score. Её параметр --api (или переменная окружения SCORE_API) включает удалённый резервный режим: URL отправляется на сервер оценки вместо локальной обработки. По умолчанию этот режим отключён.

Репозиторий

Сайт — приложение на Next.js 16 с App Router (React 19, сборка webpack), размещённое на Vercel. Пакеты npm и MCP-сервер находятся рядом с ним.

apps/site                              the site, its API routes (/api/score, /api/mcp) and its build checks (scripts/)
packages/score                         @designesy/score: the scoring engine and CLI (npm)
packages/cli                           @designesy/cli: one CLI for tokens and score (npm)
packages/tokens                        @designesy/tokens: DTCG token validator (npm)
packages/stylelint-plugin-dtcg-tokens  @designesy/stylelint-plugin-dtcg-tokens (npm)
packages/lab-builder                   @designesy/lab-builder (npm)
packages/designesy-mcp                 designesy-mcp: the local stdio MCP server (PyPI)
packages/vai-icons, vai-motion         @vai/icons and @vai/motion (not yet published)
action.yml, action/dist                the Designesy Contract Check GitHub Action
cli/                                   designesy-score, the older CLI (superseded by @designesy/score)
scripts/                               repo-level scripts
docs/designesy                         founding notes from May 2026: mission, architecture, contracts, labs
DESIGN.md                              operating principles and agent rules (v0.1)
AGENTS.md                              agent operating rules

Режим контрактной проверки, в котором страница оценивается по вашему файлу DESIGN.md или файлу токенов DTCG, описан в спецификации режима контрактной проверки.

Контракт дизайна в формате DESIGN.md формируется на основе исходного контракта и публикуется по адресу designesy.org/DESIGN.md. Корневой файл DESIGN.md — это более ранняя версия устава v0.1.

Чем Designesy не является

Designesy — не галерея шаблонов. Это не универсальный инструмент для AI-дизайна и не мудборд.

Designesy — это система.

Часто задаваемые вопросы

Нужен ли API-ключ?

Нет. Конечная точка MCP использует stateless Streamable HTTP без аутентификации. Шестнадцать из 17 инструментов доступны только для чтения; designesy_monitor_score может отправить уведомление об изменении оценки на указанный вами адрес электронной почты.

Результаты детерминированы?

Да. В цикле оценки не используется LLM: каждая проверка детерминирована и воспроизводима. Для одной и той же страницы, движка и контракта всегда формируются одинаковые результаты, а дайджест в квитанции позволяет это проверить. Содержимое активного URL может измениться между запусками; результаты кэшируются на 24 часа.

По каким критериям выполняется оценка?

По действующему контракту дизайн-системы Designesy: 45 проверок в 14 категориях с разными весами — токены, анимация, доступность, ритмика, такт, собранность, идентичность, взаимодействие, производительность, адаптивность, семантика, безопасность, спецификация и копирайтинг.

Можно ли использовать инструмент в CI?

Да. GitHub Action позволяет блокировать выполнение workflow при несоответствии контракту: сборка завершится с ошибкой, если оценка опустится ниже заданного порога.

Где опубликован контракт?

На страницах designesy.org/contracts/design-system (для чтения) и designesy.org/contracts/design-system.json (машиночитаемый формат W3C DTCG 2025.10).

Лицензия

MIT — см. файл LICENSE. Контракт общедоступен, код открыт и распространяется по лицензии MIT.