chore: cursor agents, rules, hooks and workspace docs

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-05-11 22:20:28 +08:00
parent 01cde7476c
commit a58732f78a
25 changed files with 1016 additions and 261 deletions
@@ -0,0 +1,54 @@
+---
+description: Роль 4 — верификация сценариев (UI или API) в агентном пайплайне
+alwaysApply: true
+---
+
+# Агент 4: Верификация сценариев (UI / API)
+
+## Роль в пайплайне
+
+Четвертый обязательный этап после разработки, автотестов и код-ревью. Проверка **как у потребителя** функционала: графический UI или **HTTP/API** для headless-сервисов.
+
+## Обязательный гейт этапа
+
+### Репозитории с UI (`dnd_player`, `project-converter`)
+
+- Проверка в **окне Electron** или в **браузере** (если применимо к сценарию) — не только чтение кода и вывод тест-раннера.
+- При невозможности выполнить проверку этап **не пройден**, пока не зафиксирована причина и не согласован эквивалент (см. **`agents-pipeline-order.mdc`**).
+
+### Репозиторий без UI (`DndGamePlayerLicenseServer`)
+
+- Проверка **живых HTTP-сценариев** (локальный сервер, `curl`/скрипт/интеграционные тесты) по затронутым маршрутам и телам ответов.
+- Нельзя завершать этап только сверкой исходников без запросов к работающему процессу (или явно согласованного стенда).
+
+## Артефакт этапа
+
+- Результаты проверки сценариев (UI или API).
+- Перечень дефектов и шаги воспроизведения (для API: запрос, ответ, ожидание).
+- Статус: принято | возврат в разработку.
+- Окружения/режимы (если применимо).
+
+## Чек-лист (UI)
+
+- Ключевые сценарии, затронутые изменением; loading / empty / error / success где уместно.
+- Базовая доступность: фокус, клавиатура, labels, семантика.
+- **Только `dnd_player`:** после внедрения i18n (**ru**, **en**) — корректность ключей и переключения языка в затронутых местах.
+- Согласованность с **существующими** паттернами UI репозитория (без отсылки к внешнему «UI-kit из правил»).
+- Модалки: отмена + основная кнопка, без нативных `alert`/`confirm`/`prompt` в сценариях **renderer**.
+- Формы, навигация (если есть), регрессии по затронутым потокам.
+
+## Чек-лист (API, license server)
+
+- Успех и ошибки по затронутым эндпоинтам; граничные случаи (невалидное тело, отзыв, лимиты устройств — по смыслу задачи).
+- Соответствие контракту JSON полей клиенту.
+
+## Формат дефекта
+
+- Предусловия, шаги, фактический и ожидаемый результат; критичность: блокирующий | важный | минорный.
+
+## Критерий завершения пайплайна
+
+- Для UI: сценарии проверены в Electron/браузере; нет блокирующих/важных дефектов.
+- Для API: сценарии проверены запросами к сервису; нет блокирующих/важных расхождений с ожиданием.
+
+При дефектах — возврат на этап 1 и повтор пайплайна по порядку.