@bonesofspring/ai-rules 0.2.1 → 0.2.2

package/presets/cursor/ios-swift/rules/tests-unit.mdc

@@ -0,0 +1,41 @@
+---
+description: Unit и integration тесты (XCTest / Swift Testing)
+globs: "**/*Tests/**/*.swift"
+alwaysApply: false
+---
+
+# Общие правила тестирования
+
+- **Framework** — XCTest или Swift Testing, как в проекте.
+- Цель: проверять **поведение и бизнес-правила**, не детали реализации и private API.
+- Именование:
+  - `test` / `@Test` descriptions и `XCTContext` — **на русском**, как понятные бизнес-фразы.
+  - Описания **с заглавной буквы**.
+
+# ViewModel и use case
+
+- Mock протоколов repositories / use cases; не поднимать реальную сеть.
+- Проверять переходы state: loading → success/failure, validation errors, edge cases.
+- `@MainActor` ViewModel тестировать с `@MainActor` test methods или `await MainActor.run`.
+
+# Mappers и domain
+
+- Mapper functions — unit-тесты с таблицами кейсов: nil fields, empty arrays, граничные значения.
+- Regression на бизнес-правила (скидки, статусы, форматирование дат).
+
+# Изоляция
+
+- Не мокать то, что является предметом теста (например, сам mapper при тесте mapper).
+- Fixtures — в `TestSupport/`, `Mocks/` или рядом по конвенции репо; не дублировать большие JSON inline без нужды.
+
+# Структура файлов
+
+- `FeatureViewModelTests.swift`, `OrderMapperTests.swift` — суффикс `Tests` в имени типа/файла по стилю Xcode.
+- Не создавать глубокую вложенность `Tests/Tests/`; следовать target structure проекта.
+
+# Требование к агенту
+
+При добавлении тестов:
+- Копировать паттерны из существующих test files в репо.
+- Добавлять тесты для новых веток логики и регрессий.
+- Использовать DTO fixtures из Data layer и domain types из Domain, не дублировать типы в тестах.

package/presets/cursor/next/commands/README.md

@@ -1,51 +1,3 @@
 # Cursor commands (next preset)
 
-Slash-команды копируются в `.cursor/commands/` при `ai-rules init cursor --preset next`.
-
-## Команда агентов
-
-| Command | Назначение |
-|---------|------------|
-| **`/task <описание>`** | **Главная точка входа:** router → pipeline.json → нужные роли по порядку |
-| `/task-continue <slug>` | После human gate или паузы |
-| `/feature-start <описание>` | Legacy: только analyst (без router) |
-| `/feature-continue <slug>` | Alias task-continue |
-| `/technical-retro [slug]` | Ретро; с slug — блок «Работа агентов» |
-
-## Примеры `/task`
-
-```
-/task Добавить фильтр по дате в Order History
-→ analyst → developer → reviewer → QA
-
-/task Order History падает при пустом списке
-→ debugger → developer → reviewer → QA (regression)
-
-/task CI упал на lint в PR #142
-→ ci-investigator → developer → reviewer
-
-/task Миграция на Next.js 15
-→ analyst → migration-specialist → developer → reviewer → QA
-
-/task Проверь доступность модалки оплаты
-→ analyst → developer → a11y-reviewer → code-reviewer
-
-/task Покрой unit-тестами mapper orders
-→ unit-planner → unit-generator
-
-/task Напиши README для новой фичи фильтров
-→ analyst → tech-writer
-
-/task Сделай ревью изменений в store/orders
-→ reviewer only
-```
-
-## Связанные файлы
-
-- Subagents: `../agents/` (20 ролей, включая `task-router.md`)
-- Оркестратор: `../rules/agent-team-orchestrator.mdc`
-- Skills: `../skills/` (`feature-delivery`, `code-review`, `debug-investigation`, `ci-investigation`, `unit-testing`, `playwright-e2e`, `technical-retro`)
-- Артефакты: `../team/README.md` (`pipeline.json`, `status.json`)
-- Hooks: `../hooks.json`, `../hooks/chain-team-phases.sh`
-
-Создавать и редактировать команды можно через `/commands` в Cursor или напрямую в этой папке пресета.
+Place command definitions for this preset here. They are copied to `.cursor/commands` when you run `ai-rules init cursor --preset next`.

package/presets/cursor/next/rules/README.md

@@ -10,70 +10,3 @@
 - Cursor интерпретирует его как конфигурацию поведения ассистента для этого репо (автоматически подмешивает содержимое в контекст, когда правило подходит).
 
 - То есть .mdc = “markdown + config для Cursor”, .md = просто текст без управляющего смысла для ассистента.
-
-### С чего начать новую задачу
-
-- **Команда агентов (рекомендуется):** `/task <описание>` — router выберет роли и порядок; при human gate — `/task-continue <slug>`. См. **`agent-team-orchestrator.mdc`** и `.cursor/team/README.md`.
-- **Legacy:** `/feature-start` → `/feature-continue`.
-- **Сквозной чеклист слоёв (для developer):** **`feature-delivery-workflow.mdc`**.
-
-### Loading strategy
-
-- **`alwaysApply: true`** (Cursor) / **без `paths:`** (Claude) — только базовые инварианты:
-  - `next-app-core`, `post-change-lint`, `package-manager`, `code-quality-and-refactoring`
-- **On-demand** — `agent-team-intake` (через orchestrator/commands), `agent-team-orchestrator`, architecture, imports, UI, tests, feature-delivery-workflow, reference-features, next-app-router, react-a11y-coding
-- **Skills** — длинные процедуры (`feature-delivery`, `code-review`, …)
-
-### UI edit bundle (consolidated globs)
-
-При правке `app/src/ui/**/*.tsx` подгружается **уменьшенный** набор (не весь `app/src/**`):
-
-| Rule | Globs | Назначение |
-|------|-------|------------|
-| `react-ui.mdc` | `app/src/ui/**` | Структура, стили, пропсы |
-| `architecture-boundaries-ui.mdc` | `app/src/ui/**` | Slim границы UI-слоя |
-| `react-a11y-coding.mdc` | `app/src/ui/**` | A11y |
-| `navigation-router-ui.mdc` | `app/src/ui/**/*.tsx` | Краткий ориентир навигации |
-| `no-props-spread.mdc` | `app/src/**/*.tsx` | Явные пропсы |
-| `arrow-functions.mdc` | `app/src/**` | Синтаксис |
-
-**Не грузятся на типичный UI edit:** `architecture-boundaries` (api/store/types/lib), `layer-barrel-exports` (только `index.ts`), `navigation-router-stack` (только `app/src/app/**`), `no-cross-component-styles-import` (consolidated в `react-ui`).
-
-`css-property-order-stylelint.mdc` — только на `styles.ts` / `.css`.
-
-### Эталонные фичи
-
-Заполните **`reference-features.mdc`** (TBD → реальные пути) после `init` в целевом репо.
-
-### Каталог ключевых правил
-
-| Файл | Назначение |
-|------|------------|
-| `reference-features.mdc` | Эталонные пути UI/store/API/types/tests |
-| `next-app-router.mdc` | App Router, RSC, loading/error |
-| `react-a11y-coding.mdc` | A11y при написании UI |
-| `feature-delivery-workflow.mdc` | Сквозной чеклист (on-demand, не always-on) |
-| `agent-team-intake.mdc` | Подсказка `/task` при work-запросе (on-demand, через orchestrator) |
-| `package-manager.mdc` | Перед `install` / `run` в терминале определить менеджер пакетов репо (lockfile, `packageManager`) и использовать только его |
-| `agent-team-orchestrator.mdc` | `/task`, router, `pipeline.json`, build-verifier, parallel steps |
-| `next-app-core.mdc` | Стек, слои, карта каталогов (alwaysApply) |
-| `post-change-lint.mdc` | **Обязательный** прогон ESLint + Stylelint после любых изменений кода |
-| `architecture-boundaries-ui.mdc` | Slim границы UI при правках компонентов |
-| `architecture-boundaries.mdc` | Полная карта UI / store / API (api, store, types, lib) |
-| `navigation-router-ui.mdc` | Навигация в UI-компонентах (slim) |
-| `navigation-router-stack.mdc` | Полный аудит стека навигации (App Router / SPA) |
-| `http-client.mdc` | Один HTTP‑стек, контракты из `@/types`, без разбросанного низкоуровневого API |
-| `api-services.mdc` | Сервисы, мапперы, вызовы через прикладные API‑клиенты |
-| `store-rtk.mdc` | Redux Toolkit, thunk’и, типизация ошибок/ответов как в коде репо |
-| `public-imports.mdc` | Импорты `@/types`, `@/types/enums`, `@/api` (вне `app/src/api/**`); stubs: `types-public-imports.mdc`, `api-public-imports.mdc` |
-| `layer-barrel-exports.mdc` | Двухуровневые barrel для слоёв с public API (`@/api`, `@/types`, `@/core`, …) |
-| `types-jsdoc.mdc` | JSDoc для типов в `app/src/types` (русский текст, `[computed]`, без `@param`/`@returns`) |
-| `no-type-assertion-as-import-export.mdc` | Ограничение `as`, в т.ч. `instanceof` для ошибок транспорта в `catch` |
-| `code-review-mr.mdc` | Чеклист ревью MR, в т.ч. HTTP‑клиент и тесты |
-| `tests-unit.mdc` | Unit‑тесты и behavior‑тесты HTTP‑клиента |
-| `playwright-agents.mdc`, `tests-e2e-structure.mdc` | E2E |
-| `react-ui.mdc` | React/Next UI: структура компонентов, соседние `ComponentName.data.ts` / `.utils.ts`, стили, пропсы |
-
-**Коллизии формулировок:** импорт типов и API — источник правды **`public-imports.mdc`**; дублирует ESLint `no-restricted-imports` в `app/eslint.config.mjs`.
-
-Задачи на **сеть, замену HTTP‑библиотеки, новые эндпоинты**: опираться на **`http-client.mdc`** + **`api-services.mdc`** + **`store-rtk.mdc`**.

package/presets/cursor/next/rules/api-services.mdc

@@ -1,41 +1,40 @@
 ---
 description: Конвенции API сервисов и мапперов
-globs: app/src/api/services/**/*.ts
+globs: src/api/services/**/*.ts
 alwaysApply: false
 ---
 
 # Роль API слоя
 
 - Инкапсулировать всё, что связано с:
-  - HTTP‑запросами через **экземпляры прикладных API‑клиентов** в `app/src/api/clients/**`, собранные на **общей реализации** из `app/src/lib/clients/**` (как в существующем коде); подробности — **`http-client.mdc`**; положение слоя в схеме **порты и адаптеры** — `architecture-boundaries.mdc`;
+  - HTTP‑запросами (через принятый в проекте клиент),
   - URL/путями,
   - заголовками и кодами ответов,
   - DTO backend.
 - Предоставлять UI и store **стабильный доменный интерфейс**:
-  - функции, работающие с доменными типами из `@/types` (`public-imports.mdc`).
+  - функции, работающие с доменными типами из `@/types/**`.
   - мапперы между DTO и доменными типами.
 
 # Структура модулей
 
 - Для каждой доменной области (например, заказы, биллинг, настройки аккаунта):
-  - отдельный каталог в `app/src/api/services/<ИмяСервиса или фичи>/**` по конвенции репозитория.
+  - отдельный каталог в `src/api/services/<ИмяСервиса или фичи>/**` по конвенции репозитория.
 - Внутри модуля:
   - файлы с вызовами API (`index.ts` или `*.service.ts`);
   - файлы мапперов (`*responseMappers.ts`);
-  - специфичные типы запросов/ответов (если не вынесены в `app/src/types/**` с экспортом через barrel `@/types`).
-  - при необходимости — локальные `index.ts` / barrel внутри модуля для структуры **внутри** `app/src/api/**`; **снаружи** этого слоя UI, store и остальной код импортируют только из корневого barrel `app/src/api/index.ts` (`import … from '@/api'`, **`public-imports.mdc`**).
+  - специфичные типы запросов/ответов (если не вынесены в `@/types/**`).
+  - один или несколько **public API** файлов (`index.ts` или barrel‑файлы), через которые к модулю обращаются UI, store и другие слои.
 
 # Мапперы и типы
 
 - Для каждого запроса/эндпоинта:
   - описывать **response‑тип (DTO)**, точно соответствующий контракту backend;
-  - определять **целевой доменный тип** в `app/src/types/**`, с которым будет работать приложение (включая вычисляемые/агрегированные поля).
+  - определять **целевой доменный тип** в `src/types/**`, с которым будет работать приложение (включая вычисляемые/агрегированные поля).
 - Мапперы (например, `*responseMappers.ts`):
   - чистые функции, без сайд‑эффектов;
   - выполняют все необходимые вычисления и преобразования данных (булевы флаги, склейка строк, агрегаты и т.п.) при переводе из DTO в доменные модели;
   - при необходимости обеспечивают обратное преобразование (доменные модели -> транспортные типы).
-- UI и store работают только с доменными типами (из `@/types` или экспортируемыми из public API слоя API), а не с "сырыми" DTO.
-- **Не вызывать `fetch` напрямую** в теле API‑методов: только через клиент; исключения — узкие модули (например JSON‑RPC), если так уже устроено в репозитории.
+- UI и store работают только с доменными типами (из `@/types/**` или экспортируемыми из API слоя), а не с "сырыми" DTO.
 
 # Обработка ошибок
 
@@ -50,9 +49,8 @@ alwaysApply: false
 
 При добавлении/изменении API‑метода:
 - Следовать существующим сервисам и мапперам как эталону.
-- Пройти чеклист barrel-экспортов (**`layer-barrel-exports.mdc`**): локальный `index.ts` → фасад слоя → корневой barrel.
 - Не смешивать слой API и UI/store:
   - компоненты не должны зависеть от DTO;
-  - store не должен сам собирать URL/коды эндпоинтов и не обходить сервисы; **транспортный тип ответа** и **контракт ошибки** из `@/types` (как у прикладного клиента) допустимы во thunk при разборе `catch`/payload, если так выстроен сервис (см. `store-rtk.mdc`, `http-client.mdc`).
-- При использовании API‑сервисов в UI, store и утилитах **вне** `app/src/api/**` импортировать **только** из `@/api` (корневой barrel), см. **`public-imports.mdc`**; внутри слоя API — по относительным путям или `@/api/services/**` / `@/api/clients/**`, не дублируя публичный контракт мимо корневого barrel для внешних потребителей.
+  - store не должен знать о HTTP‑деталях (URL, коды).
+- При использовании API‑сервисов в UI, store и утилитах импортировать только из public API файлов модуля (например, `@/api/services/OrdersApi/.../index`), а не из внутренних файлов‑реализаций.
 

package/presets/cursor/next/rules/architecture-boundaries.mdc

@@ -1,61 +1,42 @@
 ---
 description: Архитектурные границы и правила импортов
-globs: app/src/api/**/*,app/src/store/**/*,app/src/types/**/*,app/src/lib/**/*
-alwaysApply: false
+alwaysApply: true
 ---
 
 # Границы между слоями
 
-- **UI (app/src/ui/**)**:
-  - Может импортировать: `@/ui/**`, `@/store/**`, типы из `@/types` и enum из `@/types/enums` (**только как в `public-imports.mdc`**), контракт к API — **только** `import … from '@/api'` (**`public-imports.mdc`**).
+- **UI (src/ui/**)**:
+  - Может импортировать: `@/ui/**`, `@/store/**`, `@/types/**`, `@/api/services/**` (через публичные интерфейсы).
   - Не должен:
     - обращаться к HTTP‑клиенту напрямую;
     - знать детали DTO backend — только доменные типы.
-- **Store (app/src/store/**)**:
-  - Может импортировать: `@/store/**`, сервисы и публичные сущности API — **только** из `@/api` (**`public-imports.mdc`**), типы из `@/types` и enum из `@/types/enums` (**`public-imports.mdc`**).
+- **Store (src/store/**)**:
+  - Может импортировать: `@/store/**`, `@/api/services/**`, `@/types/**`.
   - Не должен:
     - зависеть от конкретных UI‑компонентов;
     - напрямую работать с global/window API.
-  - Вызовы к backend — только через сервисы, импортируемые из `@/api`; **транспортные** типы ответа и ошибки (из `@/types`, в том же виде, что у прикладного HTTP‑клиента) во thunk допустимы, если так выстроен API‑слой (`http-client.mdc`, `store-rtk.mdc`).
-- **API (`app/src/api/**`)** — реализация в `services/**`, `clients/**`, реэкспорт в `app/src/api/index.ts`:
-  - Внутри слоя: типы из `@/types` и enum из `@/types/enums` (**`public-imports.mdc`**); импорты `@/api/services/**`, `@/api/clients/**`, относительные пути между файлами слоя (`http-client.mdc`, `api-services.mdc`).
+- **API (src/api/services/**)**:
+  - Может импортировать: `@/types/**`, общие утилиты.
   - Не должен:
     - тянуть в себя UI или store;
     - смешивать HTTP‑слой и доменный слой — использовать мапперы.
 
-## UI и обращение к API (`@/api`)
-
-- По умолчанию сценарии с **изменением серверного состояния** и координация нескольких шагов — через **store** (`createAsyncThunk`, dispatch, паттерн фичи в репозитории).
-- Прямой вызов методов сервисов, импортированных из **`@/api`**, из UI допустим только в **узких случаях**: преимущественно **чтение** или действие **без необходимости держать результат в Redux**; те же **доменные типы**, что использовал бы thunk; **не** дублировать уже существующий сценарий из store и **не** протаскивать DTO в компоненты.
-- Предпочтительно оформлять такие вызовы так же, как в **соседних фичах** репозитория (хук‑фасад, отдельный хук и т.д.).
-
-## Порты и адаптеры (краткая карта)
-
-- **Входящий адаптер**: UI — ввод пользователя, отображение; зависит от store и доменных типов, не от транспорта.
-- **Оркестрация сценариев**: store (slices, thunk) — вызывает сервисы, кладёт в state **доменные** модели после маппинга.
-- **Исходящий порт (контракт к backend)**: публичный API **`@/api`** (barrel `app/src/api/index.ts`; реализация — в `app/src/api/services/**` и т.д., см. `public-imports.mdc`).
-- **Исходящий адаптер**: общая реализация HTTP в **`app/src/lib/clients/**`** и экземпляры в **`app/src/api/clients/**`**.
-
-## Фича как срез
-
-- Для сложной фичи выравниваются имена и термины (**единый язык** предметной области) в типах, селекторах, сервисах и UI; структура папок — как в соседних фичах репозитория.
-
 # Правила импортов
 
 - Всегда использовать алиас `@/...` для импортов между слоями.
 - Внутри одного модуля/фичи можно использовать относительные импорты, но **без подъёма выше корня фичи** (избегать `../../../`).
-- При обращении из компонентов, хуков, утилит и других модулей к чужому слою или фиче использовать только **public API** (barrel/index‑файлы и явно экспортируемые сущности), не делать deep‑импорты внутренних файлов других фич; для регламентированных слоёв — **`layer-barrel-exports.mdc`** и `public-imports.mdc`; для API‑слоя снаружи `app/src/api/**` — **`public-imports.mdc`** (только `@/api`).
+- При обращении из компонентов, хуков, утилит и других модулей к чужому слою или фиче использовать только **public API** (barrel/index‑файлы и явно экспортируемые сущности), не делать deep‑импорты внутренних файлов других фич.
 - При добавлении нового кода проверять:
   - если модуль переиспользуемый — он должен зависеть только от более "низких" слоёв (types, utils, api), но не от страниц.
 
 # Организация фич
 
 - Для сложных фич (например, `OrderCheckout`):
-  - Страница: `app/src/ui/pages/OrderCheckoutPage/**`.
+  - Страница: `src/ui/pages/OrderCheckoutPage/**`.
   - Локальные компоненты: поддиректории `components/**` внутри страницы.
-  - Связанный store: `app/src/store/slices/OrderCheckout/**`.
-  - API: `app/src/api/services/OrdersApi/OrderCheckout/**` (имя корневого сервиса взять из принятой в проекте схемы).
-  - Типы: `app/src/types/**` с экспортом через barrel **`app/src/types/index.ts`** (`public-imports.mdc`).
+  - Связанный store: `src/store/slices/OrderCheckout/**`.
+  - API: `src/api/services/OrdersApi/OrderCheckout/**` (имя корневого сервиса взять из принятой в проекте схемы).
+  - Типы: `src/types/OrderCheckout.types.ts` или аналогичный файл.
 
 # Требование к агенту
 

package/presets/cursor/next/rules/code-quality-and-refactoring.mdc

@@ -35,11 +35,10 @@ alwaysApply: true
   - сначала локально улучшить архитектуру минимальными шагами;
   - оставить код в консистентном состоянии.
 
-# Линтеры
-
-Lint/stylelint — только **`post-change-lint.mdc`**; ESLint config: `app/eslint.config.mjs`. Отключение правила (`eslint-disable`) — только **точечно** (строка/небольшой блок) с кратким комментарием «зачем».
-
 # Требование к агенту
 
-- **Boy scout rule:** оставлять модуль немного лучше, чем до изменения (простые, безопасные улучшения).
+При каждом изменении:
+- Поддерживать принцип **“boy scout rule”**:
+  - оставлять модуль в немного лучшем состоянии, чем до изменения (простые, безопасные улучшения).
 - Не жертвовать архитектурой и слоями ради краткости реализации.
+

package/presets/cursor/next/rules/code-review-mr.mdc

@@ -1,28 +1,47 @@
 ---
 description: Требования к code review агентами Cursor для merge requests
-alwaysApply: false
+alwaysApply: true
 ---
 
 # Code review merge requests
 
-On-demand rule for review flows. **Procedure and output format:** skill `code-review`.
+- **Когда применять**
+  - Если пользователь просит: "проведи ревью", "оценить MR/ветку/дифф", "посмотри изменения".
+  - Опираться на локальный репозиторий: текущую ветку, `git diff` и открытые файлы, а не на данные внешнего API хостинга.
+
+- **Что обязан проверить агент**
+  - **Архитектура и слои**:
+    - Соблюдение правил из `architecture-boundaries.mdc` и `next-app-core.mdc`:
+      - UI (`src/ui/**`) не ходит напрямую в HTTP‑клиент и не знает DTO.
+      - Store (`src/store/**`) не зависит от UI и не работает с "сырыми" HTTP.
+      - API (`src/api/services/**`) не тянет UI/store, использует мапперы.
+  - **Импорты и организация кода**:
+    - Использование алиаса `@/...` вместо относительных импортов выше по дереву.
+    - Отсутствие deep‑импортов во внешние фичи; использование только public API.
+    - Размещение новых файлов в корректных слоях и директориях фич.
+  - **Типы и TS‑строгость**:
+    - Не допускать новых `any`; предпочитать доменные типы из `src/types/**`.
+    - Проверять корректность пропсов/возвращаемых типов, особенно в UI и API‑слое.
+  - **UI и стили**:
+    - Для компонентов и стилей сверяться с `react-ui.mdc` и `next-app-core.mdc`:
+      - Соблюдать принятый в проекте способ стилей и общие UI‑примитивы/токены, а не "магические" значения.
+      - Сохранять консистентность с существующими компонентами и паттернами.
+  - **Тесты**:
+    - Проверять, что для нетривиальных изменений:
+      - либо обновлены/добавлены unit‑тесты (`tests-unit.mdc`),
+      - либо e2e‑сценарии/спеки отражают новую логику (`playwright-agents.mdc`, `tests-e2e-structure.mdc`).
+    - Указывать, какие именно тесты стоит добавить или поправить.
+
+- **Глубина и формат ревью**
+  - Фокус на **изменениях MR** (дифф относительно целевой ветки), а не на всём проекте.
+  - Сначала дать **высокоуровневый обзор** (что делает MR, риски, архитектурные замечания), затем список конкретных комментариев.
+  - Каждый комментарий делать:
+    - **конкретным** (указать файл/участок и проблему),
+    - **практичным** (предложить вариант исправления, опираясь на существующие паттерны),
+    - без "больших рефакторингов" в духе `code-quality-and-refactoring.mdc`, если задача локальная.
+
+- **Ограничения для агента**
+  - Не придумывать несуществующие метаданные из хостинга (лейблы MR, авторов, статусы CI), если их нет в локальных данных.
+  - Не менять общую архитектуру фичи без прямого запроса пользователя.
+  - Следовать принципу "boy scout rule": предлагать улучшения, которые реально можно внести в рамках MR.
 
-## Checklist references
-
-- Architecture layers: `architecture-boundaries.mdc`, `next-app-core.mdc`; network: `http-client.mdc`
-- Imports: `public-imports.mdc`, `layer-barrel-exports.mdc`
-- UI: `react-ui.mdc`
-- Tests: `tests-unit.mdc`, `playwright-agents.mdc`, `tests-e2e-structure.mdc`
-- Lint gate before final report: `post-change-lint.mdc`
-
-## When to load
-
-- User asks for review/MR/diff
-- Pipeline step `code-reviewer`
-- BUGBOT automated review
-
-## Constraints
-
-- Focus on MR diff, not the whole repo.
-- Use local `git diff` — do not invent hosting metadata.
-- Boy scout rule: suggest fixes feasible within the MR scope.

package/presets/cursor/next/rules/next-app-core.mdc

@@ -5,30 +5,73 @@ alwaysApply: true
 
 # Стек и окружение
 
-Конкретные версии — **из `package.json` и конфигов целевого репозитория**. Рамка preset: Next.js, React, TypeScript; runner/e2e/mocks/UI/APM — как заведено в репо.
+Конкретные версии пакетов и инструментов — **из `package.json` и конфигов целевого репозитория**. Ниже — рамка preset (Next.js + React + TypeScript), без привязки к конкретному вендору UI, моков или APM:
 
-# Структура проекта
+- **Фреймворк:** Next.js, React, TypeScript (strict — если включён в проекте).
+- **Сборка и Node:** как задано в репозитории.
+- **Тесты:** unit/integration — runner и библиотеки проекта; e2e — инструмент проекта (правила для агентов Playwright — в отдельных файлах preset).
+- **Моки HTTP/API:** если приняты в репо — повторять существующую схему (каталоги, регистрация, точка входа).
+- **Стили и UI:** способ стилизации и **дизайн‑система / токены** — как уже заведено в коде; приоритет общим примитивам и токенам вместо разрозненных «магических» значений.
+- **Наблюдаемость:** только если уже подключена в проекте — централизованно (клиент, обёртки), без дублирования в каждом методе.
 
-- `app/` — корень Next.js; `app/src/**` — код; `app/__tests__/e2e/**` — e2e.
-- `app/tsconfig.json`: `baseUrl: "."`, `paths: { "@/*": ["./src/*"] }`.
-- **Требование:** `@/*` вместо относительных импортов выше по дереву.
+# Структура проекта (верхний уровень)
+
+- `app/` — корень Next.js приложения.
+  - `app/src/**` — исходный код приложения.
+  - `app/__tests__/e2e/**` — e2e‑тесты и планы.
+- `app/tsconfig.json`:
+  - `baseUrl: "."`
+  - `paths: { "@/*": ["./src/*"] }`
+
+**Требование:** во всех новых изменениях использовать алиас `@/*` вместо относительных импортов выше по дереву.
 
 # Архитектурные слои
 
-| Слой | Каталог | Детали |
-|------|---------|--------|
-| UI | `app/src/ui/**` (pages, components) | `react-ui.mdc`, `architecture-boundaries-ui.mdc` |
-| Store | `app/src/store/**` (slices, middleware) | `store-rtk.mdc` |
-| API | `app/src/api/**` (services, clients, barrel) | `api-services.mdc`, `http-client.mdc` |
-| HTTP | `app/src/lib/clients/**`, `app/src/api/clients/**` | `http-client.mdc` |
-| Types | `app/src/types/**` | `public-imports.mdc`, `types-jsdoc.mdc` |
-| Mocks | `app/src/mocks/**` | по схеме репозитория |
+- **UI слой** (`src/ui/**`):
+  - `src/ui/pages/**` — страницы и контейнеры.
+  - `src/ui/components/**` — переиспользуемые компоненты.
+- **Store слой** (`src/store/**`):
+  - `src/store/slices/**` — модули состояния (в этом preset — Redux Toolkit; подробности в `store-rtk.mdc`).
+  - `src/store/middleware/**` — middleware для сайд‑эффектов (например, файлы, аналитика).
+- **API слой** (`src/api/services/**`):
+  - Сервисы и мапперы, инкапсулирующие HTTP‑логику.
+- **Типы** (`src/types/**`):
+  - Общие доменные типы продукта (сущности предметной области, агрегаты и т.д.).
+- **Моки и тестовые данные** (`src/mocks/**`):
+  - По структуре и назначению — как принято в репозитории.
+
+# Общие архитектурные принципы
 
-Границы слоёв, порты/адаптеры, UI→API — **`architecture-boundaries.mdc`**. Импорты `@/types`, `@/api` — **`public-imports.mdc`**.
+- **Чёткое разделение слоёв**:
+  - UI знает только о доменных типах и публичных интерфейсах store/API.
+  - Store знает о доменных типах и API‑сервисах.
+  - API знает о транспортном слое (HTTP, выбранный клиент) и DTO.
+- **Никаких "проникновений" слоёв**:
+  - UI не обращается к API напрямую — только через store или абстракции сервисов.
+  - Store не работает напрямую с "сырыми" HTTP‑ответами — только через мапперы.
+- **Типы — источник правды**:
+  - Новые сущности описывать в `src/types/**`, переиспользовать, а не дублировать типы по слоям.
+  - Не использовать `any`; при необходимости — `unknown` + безопасное сужение типа.
+
+# Кодстайл и качества кода
+
+- Следовать конфигам линтеров и форматтера **проекта** (`eslint`, `prettier`, `stylelint` — какие есть в репо).
+- Поддерживать:
+  - KISS, DRY, SOLID (в разумных пределах для фронта).
+  - Модульность и переиспользование через компоненты, хуки, слайсы, сервисы.
+  - Визуальную консистентность за счёт принятых в проекте UI‑примитивов и токенов, а не разовых литералов в стилях.
+- При добавлении нового кода **искать и копировать существующие паттерны**:
+  - Для страниц — аналогичные файлы в `src/ui/pages/**`.
+  - Для блоков — компоненты в `src/ui/components/**`.
+  - Для API — сервисы в `src/api/services/**`.
+  - Для состояния — слайсы в `src/store/slices/**`.
 
 # Работа агента
 
-- Архитектура и импорты: `architecture-boundaries.mdc`, `public-imports.mdc`
-- Фичи: `feature-delivery-workflow.mdc` + skill `feature-delivery`
-- После правок: `post-change-lint.mdc`; менеджер пакетов: `package-manager.mdc`
-- Копировать паттерны соседних файлов в целевом слое; не использовать `any` (предпочитать `unknown` + сужение)
+При генерации кода:
+- Определить целевой слой (UI/store/API/типизация/тесты).
+- Найти в соответствующей директории похожие примеры и **копировать архитектурный паттерн** (структура файлов, типы, именование).
+- Не упрощать архитектуру в ущерб существующим слоям (не тянуть API в UI, не описывать "DTO" прямо в компонентах).
+ - Избегать использования `any` при типизации кода; при необходимости использовать `unknown` с последующим безопасным сужением типов.
+ - После создания или редактирования любых файлов **обязательно проверять проект на ошибки TypeScript и ESLint** (либо точечно по изменённым файлам, либо по всему проекту) и устранять найденные проблемы, если это возможно без изменения бизнес‑логики).
+

package/presets/cursor/next/rules/no-props-spread.mdc

@@ -1,14 +1,11 @@
 ---
 description: Избегать спред-а пропов при передаче в компоненты
-globs: app/src/**/*.tsx
-alwaysApply: false
+alwaysApply: true
 ---
 
 # Не использовать спред пропов при передаче в компоненты
 
-При вызове **пользовательских** React-компонентов (имя с заглавной буквы: `IconBox`, `TextField`, ваши `FooBar`) **передавать пропы явно**, а не через spread (`{...props}`, `{...obj}`).
-
-**Агентам и при ревью:** не «упрощать» JSX через объект с последующим spread — это нарушение. Если ветвление по пропам длинное, используйте два явных JSX-блока (`condition ? <A … /> : <B … />`) или отдельные маленькие компоненты, а не `{...mergedProps}`.
+При вызове React-компонентов **передавать пропы явно**, а не через spread (`{...props}`).
 
 ## Почему
 
@@ -16,11 +13,6 @@ alwaysApply: false
 - Упрощает рефакторинг и поиск использований.
 - Снижает риск случайно пробросить лишние или устаревшие пропы.
 
-## Проверка в репозитории
-
-- Для файлов `app/src/ui/**/*.tsx` включено ESLint-правило `react/jsx-props-no-spreading` (`app/eslint.config.mjs`): несоблюдение увидит линтер и CI.
-- Легитимное исключение в конкретном месте — **однострочный** `eslint-disable-next-line react/jsx-props-no-spreading` с кратким комментарием «почему»; для редких обёрток допустим disable на файл (как в `PromocodeInput`).
-
 ## Примеры
 
 ```tsx
@@ -31,10 +23,6 @@ return <Child {...commonProps} />
 // ❌ Плохо
 return <Child {...props} />
 
-// ❌ Плохо (spread из соседнего модуля стилей тоже не оправдание)
-const iconProps = cond ? { name, size: 'm' } : { name, size: 'm', ...styles.IconBoxAccent }
-return <IconBox {...iconProps} />
-
 // ✅ Хорошо
 return (
   <Child
@@ -43,20 +31,9 @@ return (
     c={c}
   />
 )
-
-// ✅ Хорошо — явные пропсы по веткам
-return cond ? (
-  <IconBox name={name} size="m" variant="warning" />
-) : (
-  <IconBox
-    customColors={styles.IconBoxAccent.customColors}
-    name={name}
-    size="m"
-  />
-)
 ```
 
 ## Исключения
 
-- Передача пропов в **нативный** DOM-элемент (`<div {...rest} />`) допустима, если `rest` содержит только валидные HTML-атрибуты.
-- Делегирование пропов в обёртку (wrapper) допустимо, если это явно документировано и обосновано; при необходимости пометьте файл или строку через ESLint-disable, как выше.
+- Передача всех пропов в нативный DOM-элемент (`<div {...rest} />`) допустима, если `rest` содержит только валидные HTML-атрибуты.
+- Делегирование пропов в обёртку (wrapper) допустимо, если это явно документировано и обосновано.

package/presets/cursor/next/rules/playwright-agents.mdc

@@ -1,7 +1,6 @@
 ---
 description: Playwright Agents (planner/generator/healer) configuration for e2e structure in app/__tests__/e2e
-globs: app/__tests__/e2e/**/*
-alwaysApply: false
+alwaysApply: true
 ---
 
 # Playwright Agents in this project