chore: добавить агент /project:ui-check — обязательная проверка перед UI-коммитами

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
wasrusgen 2026-05-17 15:00:45 +03:00
parent dbcd2f37c5
commit a1892f11a7
2 changed files with 70 additions and 1 deletions

View File

@ -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-проверка пройдена».**

View File

@ -1,6 +1,17 @@
# Claude — правила работы с проектом zov-tech # Claude — правила работы с проектом zov-tech
## ⚠️ ОБЯЗАТЕЛЬНЫЙ PRE-COMMIT CHECKLIST для любых UI/CSS изменений ## ⚠️ ОБЯЗАТЕЛЬНЫЙ АГЕНТ ПРОВЕРКИ ПЕРЕД ЛЮБЫМ UI/CSS КОММИТОМ
**Перед каждым `git commit` с изменениями в `miniapp/` — запустить:**
```
/project:ui-check
```
Агент читает изменённые файлы, проходит чеклист и выдаёт вердикт.
**Коммит только после вердикта ✅.**
---
## Детальный чеклист (используется агентом `/project:ui-check`)
Перед каждым `git commit` с изменениями в `miniapp/` — пройти все пункты: Перед каждым `git commit` с изменениями в `miniapp/` — пройти все пункты: