Реестр правил

Обычный текст и плейсхолдеры держат контраст не ниже 4.5:1 к своему фону, крупный и жирный — 3:1. Приглушённый серый на светлом фоне — самая частая причина нечитаемого интерфейса: если сомневаешься, двигай цвет в сторону основного текста. Статусные цвета проверяй в обеих темах: палитра, подобранная на тёмном фоне, на светлом обычно проваливается.

Всё, что делается мышью, делается с клавиатуры: Tab проходит по порядку чтения, Escape закрывает слой, после закрытия фокус возвращается на триггер. Кольцо фокуса видно и не убирается через outline: none. Действие, доступное только по наведению, считается недоступным.

У интерактивного элемента есть hover, focus-visible, active, disabled; у экрана с данными — загрузка, пустота и ошибка. Пустое состояние объясняет, что делать дальше, а не пишет «ничего нет». Проверяй вёрстку на длинном и коротком тексте: перенос и обрезка входят в дизайн.

Анимируй только переход состояния: появление, уход, отклик на нажатие. Вход и выход идут на ease-out за 150–250 мс, ease-in не используй — он делает интерфейс вязким. Анимируй transform и opacity, а не width, height и отступы. Действие, которое пользователь повторяет десятки раз за день, не анимируй вовсе.

Каждый блок с анимацией сопровождай @media (prefers-reduced-motion: reduce): переход схлопывается в мгновенный или в смену прозрачности. Движение — это украшение поверх работающего интерфейса, а не условие, без которого он не показывается.

Не делай push, публикацию пакетов, деплой, отправку сообщений и любые другие внешние действия без явной просьбы пользователя. Коммиты и переключение веток — тоже только по просьбе: локальный коммит допустим, когда пользователь попросил сохранить работу.

Если пользователь ссылается на прошлую работу, решение или «что мы делали раньше», сначала найди это в хранилище Obsidian через MCP: фильтруй по проекту и дате во frontmatter и читай только нужные заметки. Заметки о сессиях не пиши сам: их экспортирует планировщик.