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
@@ -1,83 +1,97 @@
 ---
 name: feature-pipeline
-description: Implementation → Review → Tests → Verify
+description: Dev → autotests → code review → scenario verify → repo verify (все кодовые репо)
 ---

 # Workflow

-Контекст воркспейса: **`AGENTS.md`** (обзор продукта), затем **`WORKSPACE.md`** (пути, сборка, junction). Основной код плеера — репозиторий **`dnd_player/`** (рядом с корнем воркспейса `cursorAi`).
+Контекст: **`AGENTS.md`**, **`WORKSPACE.md`**. Целевой репозиторий задачи: **`dnd_player/`**, **`project-converter/`** или **`DndGamePlayerLicenseServer/`**. В **`pipeline-state.json`** задай **`verify_repo`** под хук **`stop`** (см. **`project.mdc`**); для правок только в **`cursorAi`** — **`verify_repo`: `none`** (пайплайн 4 этапов не обязателен).

-## Stage 1 — Implementation
+Порядок этапов: **`agents-pipeline-order.mdc`**, отчёт: **`pipeline-execution-template.mdc`**, чек-листы: **`.cursor/rules/agent-*.mdc`**.

-Используй subagent: frontend-senior
+## Stage 1 — Разработчик

- реализуй задачу
- сделай minimal diff
+Subagent: **frontend-developer** (`.cursor/agents/frontend-developer.md`)

-Обнови state:
+- реализация, **minimal diff**, паттерны **целевого** репозитория;
+- **i18n** — только при работе в **`dnd_player`**; после внедрения — **ru**/**en** (см. `frontend-development-standards.mdc`).

+```json
 {
-  "implementation": "done"
+  "frontend_development": "done",
+  "ui_autotests": "pending",
+  "code_review": "pending",
+  "ui_browser_verification": "pending"
 }
+```

 ---

-## Stage 2 — Review
+## Stage 2 — Автотесты

-Используй subagent: reviewer
+Subagent: **ui-test-developer** (`.cursor/agents/ui-test-developer.md`)

- проверь изменения
- найди проблемы
- исправь минимально
-
-Обнови state:
+- тесты под изменённое поведение, стек **этого** репозитория (`dnd_player`: `npm run test`; остальные — по `package.json` или добавить в задаче).

+```json
 {
-  "implementation": "done",
-  "review": "done"
+  "frontend_development": "done",
+  "ui_autotests": "done",
+  "code_review": "pending",
+  "ui_browser_verification": "pending"
 }
+```

 ---

-## Stage 3 — Tests
+## Stage 3 — Ревью кода

-Используй subagent: unit-tests
-
- добавь/обнови tests
- добейся green status
-
-Обнови state:
+Subagent: **code-reviewer** (`.cursor/agents/code-reviewer.md`)

+```json
 {
-  "implementation": "done",
-  "review": "done",
-  "tests": "done"
+  "frontend_development": "done",
+  "ui_autotests": "done",
+  "code_review": "done",
+  "ui_browser_verification": "pending"
 }
+```

 ---

-## Stage 4 — Verify
+## Stage 4 — Верификация сценариев

-Выполни из каталога **`dnd_player/`** (см. также хук `.cursor/hooks/final-verify.cjs`):
+Subagent: **ui-tester** (`.cursor/agents/ui-tester.md`)

- `npm run lint`
- `npm run typecheck`
- `npm run test`
+- **`dnd_player`**, **`project-converter`**: Electron / браузер по сценарию;
+- **`DndGamePlayerLicenseServer`**: HTTP-сценарии к запущенному сервису;
+- отчёт: **`pipeline-execution-template.mdc`**.

-Если ошибка:
+```json
+{
+  "frontend_development": "done",
+  "ui_autotests": "done",
+  "code_review": "done",
+  "ui_browser_verification": "done"
+}
+```

- исправь
- повтори
+---
+
+## Stage 5 — Verify (команды целевого репо)
+
+Выполни **все** проверки из **`package.json`** репозитория задачи до **green**. Для **`dnd_player`** после четырёх `"done"` в `pipeline-state.json` хук **`stop`** запускает `lint` / `typecheck` / `test`. Для **`project-converter`** и **`DndGamePlayerLicenseServer`** — в том числе обязательный **`npm run test`** (**вариант A**: тесты и скрипт `test` в том же PR, что и изменение поведения). Не подменять verify другим репозиторием.

 ---

 ## Final Output

- implementation summary
- review summary
- test summary
- verification status
+- implementation summary  
+- autotests summary  
+- code review summary  
+- scenario verification (UI или API)  
+- verify status по **целевому** репо  

-## PR-чеклисты (приёмка по задаче)
+## PR-чеклисты

-Готовые чеклисты с критериями по стадиям лежат в `.cursor/pr-checklists/`. Для UI-выравнивания под макеты: `ui-mock-alignment.md`. Пути к файлам в чеклистах — относительно **`dnd_player/`**.
+`.cursor/pr-checklists/`; пути в `ui-mock-alignment.md` — относительно **`dnd_player/`**.