zov-tech/.claude/commands/ui-check.md
2026-05-17 15:00:45 +03:00

3.4 KiB
Raw Permalink Blame History

UI Review Agent — проверка перед коммитом

Ты агент проверки UI/CSS изменений. Запускается обязательно перед каждым git commit в котором есть файлы из miniapp/.

Шаг 1 — Определи что изменилось

git diff --name-only HEAD
git diff --cached --name-only

Если среди файлов нет ничего из miniapp/ — проверка не нужна, сообщи «Нет UI-изменений, коммит разрешён».

Шаг 2 — Прочитай изменённые файлы

Открой каждый изменённый .css и .js файл из miniapp/assets/.

Шаг 3 — Проверь по каждому пункту

Цвет текста / видимость

  • Нет ли color: var(--card) для скрытия — она зависит от темы и не совпадает с фоном
  • Нет ли color: transparent — создаёт «дырку», буквы просвечивают фоновый слой за карточкой
  • Нет ли color: var(--paper) для скрытия — --paper = фон страницы, не карточки, может не совпасть
  • Если цель скрыть текст — используется ли opacity: 0 или жёсткий HEX-цвет, совпадающий с нужным фоном

Новые CSS-классы без явных цветов

  • Каждый новый .class-name { ... } имеет явный color: (не наследование от body)
  • Если класс используется на карточке (.client-*, .card-*) — цвет задан явно

Совместимость тем

  • Изменения не ломают светлую тему (Default — --card ≈ белый)
  • Изменения не ломают тёмную тему (Foundry/Boardroom/Atelier — --card тёмный)
  • Если текст должен быть невидим — работает ли это в обеих темах?

Hero / секции с background: var(--card)

  • Если секция имеет background: var(--card) — текст внутри имеет явный color: var(--ink), не белый

Версия кэша

  • В index.html поднята версия ?v= для каждого изменённого .css и .js
  • Формат: ?v=YYYYMMDD[буква] — буква по алфавиту в течение дня

Деплой-план

  • Только GitHub Pages нужен (miniapp/) → git push достаточно
  • Нужен ли VPS (бот/бэкенд изменён?) → SSH cd /opt/zov-tech && git pull && docker compose -f deploy/docker-compose.yml up -d --build bot

Шаг 4 — Выдай вердикт

Если все пункты :

✅ UI-проверка пройдена — коммит разрешён

Если есть :

🚫 СТОП — найдены проблемы:
1. [описание проблемы + где в коде]
2. ...
Исправь перед коммитом.

Не коммить пока вердикт не « UI-проверка пройдена».