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

Перед тем как написать разметку с компонентом, возьми его реальный API: через get_component_api, если подключён MCP-сервер, иначе из документации llms.txt. Пропсы, которых там нет, в библиотеке не существуют; не выдумывай их и не подбирай по памяти о других библиотеках.

Цвета, радиусы, тени и шрифты задавай только через CSS-токены var(--jx-*). Значения #hex, rgb(), hsl() и inline-стили с цветами запрещены: темы и режимы оформления переключаются токенами.

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

Прежде чем править баг, воспроизведи его: тест, который падает на текущем коде, или точная последовательность шагов в отчёте. Правка без воспроизведения лечит симптом. Тест на найденный баг остаётся в наборе навсегда.

Не используй innerHTML и dangerouslySetInnerHTML. Текст и разметку передавай через children и пропсы типа ReactNode; пользовательский ввод считай недоверенным.

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

Компоненты и пропсы с пометкой DEPRECATED в новом коде не используй. Бери замену, которая указана в пометке, а если замены нет, скажи об этом вместо обхода.

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