diff --git a/.claude/commands/ui-check.md b/.claude/commands/ui-check.md new file mode 100644 index 0000000..8313652 --- /dev/null +++ b/.claude/commands/ui-check.md @@ -0,0 +1,58 @@ +# UI Review Agent — проверка перед коммитом + +Ты агент проверки UI/CSS изменений. Запускается **обязательно перед каждым `git commit`** в котором есть файлы из `miniapp/`. + +## Шаг 1 — Определи что изменилось +```bash +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-проверка пройдена».** diff --git a/CLAUDE.md b/CLAUDE.md index 351a9d9..d70761d 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -1,6 +1,17 @@ # Claude — правила работы с проектом zov-tech -## ⚠️ ОБЯЗАТЕЛЬНЫЙ PRE-COMMIT CHECKLIST для любых UI/CSS изменений +## ⚠️ ОБЯЗАТЕЛЬНЫЙ АГЕНТ ПРОВЕРКИ ПЕРЕД ЛЮБЫМ UI/CSS КОММИТОМ + +**Перед каждым `git commit` с изменениями в `miniapp/` — запустить:** +``` +/project:ui-check +``` +Агент читает изменённые файлы, проходит чеклист и выдаёт вердикт. +**Коммит только после вердикта ✅.** + +--- + +## Детальный чеклист (используется агентом `/project:ui-check`) Перед каждым `git commit` с изменениями в `miniapp/` — пройти все пункты: