@bonesofspring/ai-rules 0.1.42 → 0.2.0

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

@@ -7,18 +7,18 @@ alwaysApply: false
 # Границы между слоями
 
 - **UI (app/src/ui/**)**:
-  - Может импортировать: `@/ui/**`, `@/store/**`, типы из `@/types` и enum из `@/types/enums` (**только как в `types-public-imports.mdc`**), контракт к API — **только** `import … from '@/api'` (**`api-public-imports.mdc`**).
+  - Может импортировать: `@/ui/**`, `@/store/**`, типы из `@/types` и enum из `@/types/enums` (**только как в `public-imports.mdc`**), контракт к API — **только** `import … from '@/api'` (**`public-imports.mdc`**).
   - Не должен:
     - обращаться к HTTP‑клиенту напрямую;
     - знать детали DTO backend — только доменные типы.
 - **Store (app/src/store/**)**:
-  - Может импортировать: `@/store/**`, сервисы и публичные сущности API — **только** из `@/api` (**`api-public-imports.mdc`**), типы из `@/types` и enum из `@/types/enums` (**`types-public-imports.mdc`**).
+  - Может импортировать: `@/store/**`, сервисы и публичные сущности API — **только** из `@/api` (**`public-imports.mdc`**), типы из `@/types` и enum из `@/types/enums` (**`public-imports.mdc`**).
   - Не должен:
     - зависеть от конкретных 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` (**`types-public-imports.mdc`**); импорты `@/api/services/**`, `@/api/clients/**`, относительные пути между файлами слоя (`http-client.mdc`, `api-services.mdc`).
+  - Внутри слоя: типы из `@/types` и enum из `@/types/enums` (**`public-imports.mdc`**); импорты `@/api/services/**`, `@/api/clients/**`, относительные пути между файлами слоя (`http-client.mdc`, `api-services.mdc`).
   - Не должен:
     - тянуть в себя UI или store;
     - смешивать HTTP‑слой и доменный слой — использовать мапперы.
@@ -33,7 +33,7 @@ alwaysApply: false
 
 - **Входящий адаптер**: UI — ввод пользователя, отображение; зависит от store и доменных типов, не от транспорта.
 - **Оркестрация сценариев**: store (slices, thunk) — вызывает сервисы, кладёт в state **доменные** модели после маппинга.
-- **Исходящий порт (контракт к backend)**: публичный API **`@/api`** (barrel `app/src/api/index.ts`; реализация — в `app/src/api/services/**` и т.д., см. `api-public-imports.mdc`).
+- **Исходящий порт (контракт к 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/**`**.
 
 ## Фича как срез
@@ -44,7 +44,7 @@ alwaysApply: false
 
 - Всегда использовать алиас `@/...` для импортов между слоями.
 - Внутри одного модуля/фичи можно использовать относительные импорты, но **без подъёма выше корня фичи** (избегать `../../../`).
-- При обращении из компонентов, хуков, утилит и других модулей к чужому слою или фиче использовать только **public API** (barrel/index‑файлы и явно экспортируемые сущности), не делать deep‑импорты внутренних файлов других фич; для регламентированных слоёв — **`layer-barrel-exports.mdc`** и `*-public-imports.mdc`; для API‑слоя снаружи `app/src/api/**` — **`api-public-imports.mdc`** (только `@/api`).
+- При обращении из компонентов, хуков, утилит и других модулей к чужому слою или фиче использовать только **public API** (barrel/index‑файлы и явно экспортируемые сущности), не делать deep‑импорты внутренних файлов других фич; для регламентированных слоёв — **`layer-barrel-exports.mdc`** и `public-imports.mdc`; для API‑слоя снаружи `app/src/api/**` — **`public-imports.mdc`** (только `@/api`).
 - При добавлении нового кода проверять:
   - если модуль переиспользуемый — он должен зависеть только от более "низких" слоёв (types, utils, api), но не от страниц.
 
@@ -55,7 +55,7 @@ alwaysApply: false
   - Локальные компоненты: поддиректории `components/**` внутри страницы.
   - Связанный store: `app/src/store/slices/OrderCheckout/**`.
   - API: `app/src/api/services/OrdersApi/OrderCheckout/**` (имя корневого сервиса взять из принятой в проекте схемы).
-  - Типы: `app/src/types/**` с экспортом через barrel **`app/src/types/index.ts`** (`types-public-imports.mdc`).
+  - Типы: `app/src/types/**` с экспортом через barrel **`app/src/types/index.ts`** (`public-imports.mdc`).
 
 # Требование к агенту
 

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

@@ -35,19 +35,11 @@ alwaysApply: true
   - сначала локально улучшить архитектуру минимальными шагами;
   - оставить код в консистентном состоянии.
 
-# ESLint, Stylelint и плагины
+# Линтеры
 
-- Учитывать **все активные правила ESLint** и **подключённые плагины** проекта (конфиг: `app/eslint.config.mjs`, базовые пресеты в т.ч. `@sh/eslint-config-react`, `@sh/eslint-config-boundaries` и локальные overrides).
-- Учитывать **Stylelint** для CSS и CSS-in-JS (конфиг: `app/.stylelintrc`; порядок свойств — `css-property-order-stylelint.mdc`).
-- Новый или изменённый код не должен нарушать эти правила.
-- После **каждого** изменения кода агент **обязан** выполнить **`post-change-lint.mdc`**: полный прогон **`lint:js`** и **`lint:css`**, анализ вывода, исправление срабатываний в зоне задачи.
-- Отключение правила (`eslint-disable`) — только **точечно** (строка/небольшой блок) и с **кратким комментарием**, зачем это нужно; отключать «на весь файл» без веской причины не следует.
+Lint/stylelint — только **`post-change-lint.mdc`**; ESLint config: `app/eslint.config.mjs`. Отключение правила (`eslint-disable`) — только **точечно** (строка/небольшой блок) с кратким комментарием «зачем».
 
 # Требование к агенту
 
-При каждом изменении:
-- Поддерживать принцип **“boy scout rule”**:
-  - оставлять модуль в немного лучшем состоянии, чем до изменения (простые, безопасные улучшения).
+- **Boy scout rule:** оставлять модуль немного лучше, чем до изменения (простые, безопасные улучшения).
 - Не жертвовать архитектурой и слоями ради краткости реализации.
-- **Не завершать задачу**, пока не пройдены обязательные линтеры (`post-change-lint.mdc`).
-

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

@@ -17,11 +17,11 @@ alwaysApply: false
       - API (`app/src/api/**`) не тянет UI/store, использует мапперы; без прямого `fetch` в сервисах (кроме оговорённых исключений).
   - **Импорты и организация кода**:
     - Использование алиаса `@/...` вместо относительных импортов выше по дереву.
-    - Отсутствие deep‑импортов во внешние фичи; использование только public API; в файлах вне `app/src/api/**` импорты из API — только `from '@/api'` (`api-public-imports.mdc`, дублирует ESLint).
+    - Отсутствие deep‑импортов во внешние фичи; использование только public API; в файлах вне `app/src/api/**` импорты из API — только `from '@/api'` (`public-imports.mdc`, дублирует ESLint).
     - При новых/изменённых модулях в регламентированных слоях — реэкспорт публичных символов в корневой barrel по **`layer-barrel-exports.mdc`**.
     - Размещение новых файлов в корректных слоях и директориях фич.
   - **Типы и TS‑строгость**:
-    - Не допускать новых `any`; предпочитать доменные типы из `@/types` (barrel, см. `types-public-imports.mdc`).
+    - Не допускать новых `any`; предпочитать доменные типы из `@/types` (barrel, см. `public-imports.mdc`).
     - Проверять корректность пропсов/возвращаемых типов, особенно в UI и API‑слое.
   - **UI и стили**:
     - Для компонентов и стилей сверяться с `react-ui.mdc` и `next-app-core.mdc`:

package/presets/cursor/next/rules/css-property-order-stylelint.mdc

@@ -1,28 +1,16 @@
 ---
 description: Порядок CSS-свойств по Stylelint (idiomatic-order) — для любых стилей в проекте
 globs:
-  - app/src/**/*.{css,ts,tsx}
+  - app/src/ui/**/*.styles.ts
+  - app/src/ui/**/*.styles.tsx
+  - app/src/ui/**/styles.ts
+  - app/src/ui/**/styles.tsx
   - app/**/*.css
 alwaysApply: false
 ---
 
 # Порядок CSS-свойств (как в Stylelint)
 
-Действует для **любого** CSS в репозитории: `.css`, стилевые блоки в `styles.ts` / `styles.tsx`, `styled` / Linaria и другой CSS-in-JS в `.ts` / `.tsx`, если этот код попадает под `yarn lint:css`.
+Для CSS в `.css`, `styles.ts(x)`, `styled` / Linaria — порядок свойств как в **`app/.stylelintrc`** (`@sh/stylelint-config-react` → `stylelint-config-idiomatic-order`).
 
-Источник: `app/.stylelintrc` → `@sh/stylelint-config-react` → пакет **`stylelint-config-idiomatic-order`** (правило `order/properties-order`). Свойства, не попавшие в список, идут **в конце блока в алфавитном порядке** (`unspecified: bottomAlphabetical`).
-
-Пиши объявления в **одном** блоке в такой последовательности групп:
-
-1. **`composes`** — только для CSS Modules (если есть).
-2. **`all`**
-3. **Позиционирование:** `position`, `z-index`, затем `top`, `right`, `bottom`, `left`.
-4. **Отображение и раскладка:** `display`, `overflow`.
-5. **Размеры:** `width`, `min-width`, `max-width`, `height`, `min-height`, `max-height`, `box-sizing`.
-6. **Flex:** `flex`, `flex-basis`, `flex-direction`, `flex-flow`, `flex-grow`, `flex-shrink`, `flex-wrap`, `align-content`, `align-items`, `align-self`, `justify-content`, `order`.
-7. **Внутренние отступы:** `padding-top`, `padding-right`, `padding-bottom`, `padding-left`.
-8. **Рамка:** общие `border`, `border-width`, `border-style`, `border-color`, `border-radius`; затем для сторон **сверху по часовой** — `border-top` и его `-width`, `-style`, `-color`, `-radius`, то же для `right`, `bottom`, `left`.
-9. **Внешние отступы:** `margin-top`, `margin-right`, `margin-bottom`, `margin-left`.
-10. **Остальные свойства** — после перечисленных, **по алфавиту** (типографика, фон, анимации, `cursor`, и т.д.).
-
-Автоисправление из каталога `app`: `yarn lint:css --fix` (проверяет `**/*.{css,ts}`).
+Не дублировать список свойств вручную. Автоисправление из `app/`: **`yarn lint:css --fix`** (или менеджер пакетов репо). Полный прогон — **`post-change-lint.mdc`**.

package/presets/cursor/next/rules/feature-delivery-workflow.mdc

@@ -5,19 +5,19 @@ alwaysApply: false
 
 # Доставка фичи (сквозной порядок)
 
-Типичная фича с данными с backend и общим состоянием. Детали слоёв — в `architecture-boundaries.mdc`, `next-app-core.mdc`.
+Типичная фича с данными с backend и общим состоянием. Детали слоёв — `architecture-boundaries.mdc`, `next-app-core.mdc`.
 
 ## Чеклист (порядок работ)
 
-1. **Доменные типы** — `app/src/types/**`, экспорт через barrel `app/src/types/index.ts` (`types-public-imports.mdc`, **`layer-barrel-exports.mdc`**); JSDoc полей — `types-jsdoc.mdc`.
-2. **Контракт API** — DTO ответов/запросов там, где принято в репо; целевые доменные типы в `@/types`.
-3. **Мапперы** — DTO → домен в `*responseMappers.ts` или аналоге; чистые функции (`api-services.mdc`).
-4. **Сервисы** — вызовы только через прикладные клиенты `app/src/api/clients/**`, public API модуля (`api-services.mdc`, `http-client.mdc`, **`layer-barrel-exports.mdc`**). Без `fetch` из UI/store.
-5. **Состояние** — `createSlice` / `createAsyncThunk`, доменные модели в state (`store-rtk.mdc`); thunk вызывает сервисы, импортированные из `@/api` (`api-public-imports.mdc`).
-6. **UI** — тонкие компоненты, типы из `@/types`, без DTO (`react-ui.mdc`, `architecture-boundaries.mdc`, `no-props-spread.mdc`).
-7. **Моки** — по схеме репозитория, точка входа регистрации моков (например `app/src/mocks/index.js`).
-8. **Тесты** — unit для мапперов и критичной логики (`tests-unit.mdc`); при смене HTTP‑клиента — behavior‑тесты клиента (`http-client.mdc`); e2e по `*.cases.md` (`tests-e2e-structure.mdc`, `playwright-agents.mdc`).
-9. **Завершение** — **`post-change-lint.mdc`**: из каталога `app/` обязательно `lint:js` + `lint:css` (полный прогон, исправить срабатывания), затем `type-check`; менеджер пакетов — `package-manager.mdc`.
+1. **Доменные типы** — `app/src/types/**`, экспорт через barrel (`public-imports.mdc`, **`layer-barrel-exports.mdc`**); JSDoc — `types-jsdoc.mdc`.
+2. **Контракт API** — DTO там, где принято; доменные типы в `@/types`.
+3. **Мапперы** — DTO → домен в `*responseMappers.ts` (`api-services.mdc`).
+4. **Сервисы** — клиенты `app/src/api/clients/**`, barrel `@/api` (`api-services.mdc`, `http-client.mdc`, **`layer-barrel-exports.mdc`**). Без `fetch` из UI/store.
+5. **Состояние** — `createSlice` / `createAsyncThunk` (`store-rtk.mdc`); thunk → сервисы из `@/api`.
+6. **UI** — типы из `@/types`, без DTO (`react-ui.mdc`, `architecture-boundaries.mdc`, `no-props-spread.mdc`).
+7. **Моки** — по схеме репо; регистрация в `app/src/mocks/handlers.ts` (см. ниже).
+8. **Тесты** — unit для мапперов (`tests-unit.mdc`); e2e по `*.cases.md` (`tests-e2e-structure.mdc`, `playwright-agents.mdc`).
+9. **Завершение** — **`post-change-lint.mdc`**: `lint:js` + `lint:css` + `type-check`; менеджер — `package-manager.mdc`.
 
 ## Поток данных (ориентир)
 
@@ -35,19 +35,42 @@ flowchart LR
   Store --> UI[UI]
 ```
 
-## Матрица: что меняю → какие правила перечитать
+## Регистрация по слоям
 
-| Зона в репозитории | Правила Cursor (`.cursor/rules/`) |
-|--------------------|-----------------------------------|
-| `app/src/api/clients/**`, `app/src/lib/clients/**` | `http-client.mdc`; при изменении клиента — `tests-unit.mdc` (behavior‑тесты) |
-| `app/src/api/services/**` | `api-services.mdc`, `layer-barrel-exports.mdc`; при необходимости `http-client.mdc` |
-| `app/src/store/**` | `store-rtk.mdc`, `architecture-boundaries.mdc`, `api-public-imports.mdc` |
-| `app/src/ui/**` | `react-ui.mdc`, `no-props-spread.mdc`, `types-public-imports.mdc`, `api-public-imports.mdc` |
-| `app/src/types/**` | `types-public-imports.mdc`, `types-jsdoc.mdc`, `layer-barrel-exports.mdc` |
-| `app/__tests__/e2e/**` | `tests-e2e-structure.mdc`, `playwright-agents.mdc` |
+1. **Типы** — `app/src/types/**`; доменная модель — источник правды для UI и store.
+2. **API** — `app/src/api/services/<ServiceRoot>/<Segment>/`; публичные экспорты (в т.ч. **константы путей** для моков) → **`app/src/api/index.ts`**.
+3. **Моки (MSW)** — `app/src/mocks/data/<feature>/`; хендлеры в **`app/src/mocks/handlers.ts`**. Пути из `@/api`, не дублировать URL-строки. Проверить браузерный worker и Node `setupServer`, если оба используются.
+4. **Store** — `app/src/store/slices/<FeatureName>/`; редюсер в **`app/src/store/reducers.ts`**. Middleware → `app/src/store/middleware/**`, регистрация в **`app/src/store/index.ts`**.
+5. **UI** — `app/src/ui/pages/<FeatureName>Page/**` и/или `components/**`; данные через store/hooks.
+6. **Unit** — `*.spec.ts(x)`; мапперы и нетривиальная логика — обязательно.
+7. **E2E** — `app/__tests__/e2e/<Area>/<plan>.cases.md` + `*.spec.ts`.
+
+## Частичные сценарии
+
+| Задача | Минимум действий |
+|--------|------------------|
+| Только API + типы | Типы, сервис, мапперы, `@/api` barrel; unit на маппер. |
+| Только моки | Путь в `@/api`; handlers + `mocks/handlers.ts`. |
+| Только store | Thunk на `@/api`; slice + `reducers.ts`. |
+| Только UI | Store state; без HTTP/DTO. |
+| Только e2e | `*.cases.md` + spec; page object. |
 
-Специализированные `.mdc` с `globs` подмешиваются при работе с соответствующими файлами; эта матрица нужна, когда открыт другой файл или идёт общий чат.
+## Антипаттерны
 
-## Требование к агенту
+- DTO в UI или нетипизированном store.
+- HTTP-клиент из компонента/thunk в обход сервиса.
+- Deep-import `@/api/services/**` из UI/store.
+- `{...props}` в компоненты — `no-props-spread.mdc`.
+
+## Матрица: зона → правила
+
+| Зона | Правила |
+|------|---------|
+| `app/src/api/clients/**`, `app/src/lib/clients/**` | `http-client.mdc`, `tests-unit.mdc` (behavior) |
+| `app/src/api/services/**` | `api-services.mdc`, `layer-barrel-exports.mdc`, `http-client.mdc` |
+| `app/src/store/**` | `store-rtk.mdc`, `architecture-boundaries.mdc`, `public-imports.mdc` |
+| `app/src/ui/**` | `react-ui.mdc`, `no-props-spread.mdc`, `public-imports.mdc` |
+| `app/src/types/**` | `public-imports.mdc`, `types-jsdoc.mdc`, `layer-barrel-exports.mdc` |
+| `app/__tests__/e2e/**` | `tests-e2e-structure.mdc`, `playwright-agents.mdc` |
 
-При добавлении или существенном расширении фичи **пройти чеклист сверху** и при правках в зоне из таблицы **ориентироваться на указанные правила**, не смешивать слои и не обходить public API модулей.
+При добавлении или расширении фичи **пройти чеклист** и правила из таблицы для затронутых зон.

package/presets/cursor/next/rules/http-client.mdc

@@ -14,12 +14,12 @@ alwaysApply: false
 
 - Обычные REST‑вызовы к backend идут через **одну реализацию** в `app/src/lib/clients/**` (модуль общего клиента) и **преднастроенные экземпляры** в `app/src/api/clients/**`, по тому же паттерну, что уже принят в проекте.
 - Место транспорта в общей картине **порты и адаптеры** — в `architecture-boundaries.mdc` (раздел **«Порты и адаптеры»**).
-- **Не** вызывать `fetch` напрямую из `app/src/api/services/**`, store и UI (см. `architecture-boundaries.mdc`, `api-services.mdc`); из store/UI — только вызовы через сервисы из `@/api` (`api-public-imports.mdc`).
+- **Не** вызывать `fetch` напрямую из `app/src/api/services/**`, store и UI (см. `architecture-boundaries.mdc`, `api-services.mdc`); из store/UI — только вызовы через сервисы из `@/api` (`public-imports.mdc`).
 - **Исключения** (узкие протоколы, отдельный транспорт) — только там, где в репозитории уже есть образец; повторять его, не плодить произвольные обходы общего клиента.
 
 ## Типы
 
-- Всё, что относится к **контракту запроса/ответа/ошибки** приложения и реэкспортируется для HTTP‑слоя, импортировать **только** из barrel `@/types`, без deep‑импортов из внутренних файлов `app/src/types/**` (см. `types-public-imports.mdc`).
+- Всё, что относится к **контракту запроса/ответа/ошибки** приложения и реэкспортируется для HTTP‑слоя, импортировать **только** из barrel `@/types`, без deep‑импортов из внутренних файлов `app/src/types/**` (см. `public-imports.mdc`).
 - Не поднимать в новом коде **типы и зависимости от внешнего HTTP‑клиента**, от которого проект ушёл; ориентир — **`package.json`** и существующие вызовы.
 
 ## Контракт ошибок

package/presets/cursor/next/rules/layer-barrel-exports.mdc

@@ -11,7 +11,7 @@ alwaysApply: false
 Для **любого слоя** (каталога, пакета, bounded context), у которого:
 
 - есть **корневой barrel** — единая точка импорта для внешних потребителей;
-- deep-импорты внутрь слоя **запрещены** снаружи (ESLint `no-restricted-imports`, правила `*-public-imports.mdc`).
+- deep-импорты внутрь слоя **запрещены** снаружи (ESLint `no-restricted-imports`, правила `public-imports.mdc`).
 
 Примеры alias/entry point в разных проектах: `@/api`, `@/types`, `@/core`, `@/store`, `packages/foo`.
 
@@ -34,7 +34,7 @@ alwaysApply: false
 
 При добавлении или существенном расширении **модуля внутри регламентированного слоя**:
 
-1. Определить слой, его **корневой barrel** и доп. entry points (`*-public-imports.mdc`).
+1. Определить слой, его **корневой barrel** и доп. entry points (`public-imports.mdc`).
 2. Создать/обновить **локальный** `index.ts` — только публичные символы.
 3. Если в слое есть **фасад/агрегатор** (`*ApiService.ts`, `rootReducer`, …) — подключить модуль там.
 4. Добавить **реэкспорт** новых публичных символов в **корневой barrel** слоя.
@@ -44,7 +44,7 @@ alwaysApply: false
 
 ## Как найти регламентированные слои в репозитории
 
-1. Правила `*-public-imports.mdc` в `.cursor/rules/`.
+1. Правила `public-imports.mdc` в `.cursor/rules/`.
 2. ESLint `no-restricted-imports` — паттерны `@/<layer>/*` с исключением barrel.
 3. `architecture-boundaries.mdc`, README проекта.
 
@@ -52,8 +52,8 @@ alwaysApply: false
 
 | Слой | Корневой barrel | Правило импортов |
 |------|-------------------|------------------|
-| API | `app/src/api/index.ts` | `api-public-imports.mdc` |
-| Types | `app/src/types/index.ts` | `types-public-imports.mdc` (+ `@/types/enums`) |
+| API | `app/src/api/index.ts` | `public-imports.mdc` |
+| Types | `app/src/types/index.ts` | `public-imports.mdc` (+ `@/types/enums`) |
 | Core | `app/src/core/index.ts` | ESLint: `@/core/index` |
 
 Иллюстрация двух уровней (API): локальный `services/.../<Feature>/index.ts` → фасад `*ApiService.ts` → `app/src/api/index.ts`.

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

@@ -5,83 +5,30 @@ alwaysApply: true
 
 # Стек и окружение
 
-Конкретные версии пакетов и инструментов — **из `package.json` и конфигов целевого репозитория**. Ниже — рамка preset (Next.js + React + TypeScript), без привязки к конкретному вендору UI, моков или APM:
+Конкретные версии — **из `package.json` и конфигов целевого репозитория**. Рамка preset: Next.js, React, TypeScript; runner/e2e/mocks/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/**`):
-  - `app/src/ui/pages/**` — страницы и контейнеры.
-  - `app/src/ui/components/**` — переиспользуемые компоненты.
-- **Store слой** (`app/src/store/**`):
-  - `app/src/store/slices/**` — модули состояния (в этом preset — Redux Toolkit; подробности в `store-rtk.mdc`).
-  - `app/src/store/middleware/**` — middleware для сайд‑эффектов (например, файлы, аналитика).
-- **API слой** (`app/src/api/**` — прежде всего `services/**`, плюс `clients/**`, корневой barrel `index.ts`):
-  - Сервисы и мапперы, инкапсулирующие HTTP‑логику; **потребители вне этого каталога** импортируют только через `@/api` (`api-public-imports.mdc`).
-- **HTTP‑транспорт** (модуль общего клиента под `app/src/lib/clients/**`, экземпляры под `app/src/api/clients/**` — как в репозитории):
-  - Один механизм запросов, без разбросанного «сырого» `fetch`/`XMLHttpRequest` по фичам. Детали и исключения — **`http-client.mdc`**.
-- **Типы** (`app/src/types/**`):
-  - Доменные модели и при необходимости транспортные контракты; **потребители** импортируют только через **`types-public-imports.mdc`** (`@/types`, `@/types/enums`).
-- **Моки и тестовые данные** (`app/src/mocks/**`):
-  - По структуре и назначению — как принято в репозитории.
-
-## Порты и адаптеры (сопоставление с каталогами)
-
-Та же идея, что в `architecture-boundaries.mdc` (раздел **«Порты и адаптеры»**): UI и store зависят от **контракта** к backend (публичный API `@/api` + доменные типы), а **реализация HTTP** изолирована в **`app/src/lib/clients/**`** и **`app/src/api/clients/**`**. Детали транспорта — `http-client.mdc`; импорты `@/api` — `api-public-imports.mdc`.
+| Слой | Каталог | Детали |
+|------|---------|--------|
+| UI | `app/src/ui/**` (pages, components) | `react-ui.mdc`, `architecture-boundaries.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 знает о доменных типах (из `@/types` / `@/types/enums`) и публичных API store и при необходимости импортирует из **`@/api`** — см. `api-public-imports.mdc` и `architecture-boundaries.mdc` (**«UI и обращение к API»**).
-  - Store знает о доменных типах и вызывает API‑сервисы через импорты из **`@/api`**.
-  - API‑сервисы знают о DTO, мапперах и вызовах через клиенты из `app/src/api/clients/**` (`http-client.mdc`).
-- **Никаких "проникновений" слоёв**:
-  - UI не вызывает HTTP‑клиент и не работает с DTO; сценарии с записью в общий state — через store; узкие исключения для вызова сервисов из UI — только по правилам `architecture-boundaries.mdc`.
-  - Store не собирает запросы сам и не обходит API‑сервисы; данные для state — доменные модели после маппинга. Допустимые **транспортные** типы ответа/ошибки во thunk — как в `@/types` и согласованно с `http-client.mdc`, `store-rtk.mdc`.
-- **Доменная логика и state**:
-  - Нетривиальные правила предметной области и преобразования **DTO → домен** — в **мапперах** и чистых функциях/модулях фичи (`api-services.mdc`); **редюсеры и селекторы** держать узкими (обновление state и проекции), без дублирования тяжёлой бизнес‑логики, если её место в маппере или доменном помощнике. Подробности — `store-rtk.mdc`.
-- **Типы — источник правды**:
-  - При коллизии с другими правилами по **импорту типов** — ориентир **`types-public-imports.mdc`**.
-  - Новые сущности описывать в `app/src/types/**` и экспортировать через barrel; потребители не обходят `types-public-imports.mdc`.
-  - Не использовать `any`; при необходимости — `unknown` + безопасное сужение типа.
-
-# Кодстайл и качества кода
-
-- Следовать конфигам линтеров и форматтера **проекта** (`eslint`, `prettier`, `stylelint` — какие есть в репо).
-- Поддерживать:
-  - KISS, DRY, SOLID (в разумных пределах для фронта).
-  - Модульность и переиспользование через компоненты, хуки, слайсы, сервисы.
-  - Визуальную консистентность за счёт принятых в проекте UI‑примитивов и токенов, а не разовых литералов в стилях.
-- При добавлении нового кода **искать и копировать существующие паттерны**:
-  - Для страниц — аналогичные файлы в `app/src/ui/pages/**`.
-  - Для блоков — компоненты в `app/src/ui/components/**`.
-  - Для API — сервисы в `app/src/api/services/**`.
-  - Для состояния — слайсы в `app/src/store/slices/**`.
+Границы слоёв, порты/адаптеры, UI→API — **`architecture-boundaries.mdc`**. Импорты `@/types`, `@/api` — **`public-imports.mdc`**.
 
 # Работа агента
 
-При генерации кода:
-- При добавлении или существенном расширении фичи следовать **`feature-delivery-workflow.mdc`** (чеклист слоёв и матрица «зона → правило»).
-- Определить целевой слой (UI/store/API/типизация/тесты).
-- Найти в соответствующей директории похожие примеры и **копировать архитектурный паттерн** (структура файлов, типы, именование).
-- Не упрощать архитектуру в ущерб существующим слоям (не тянуть DTO и HTTP в UI; вызовы сервисов из UI — только в рамках `architecture-boundaries.mdc`).
-- Избегать использования `any` при типизации кода; при необходимости использовать `unknown` с последующим безопасным сужением типов.
-- После **любых** изменений кода — **`post-change-lint.mdc`**: из каталога `app/` обязательно запустить **`lint:js`** и **`lint:css`** (полный прогон), проанализировать вывод, исправить errors/warnings в зоне задачи; задача не завершена, пока оба линтера не проходят. Дополнительно — **`type-check`** при правках TypeScript. Менеджер пакетов — **`package-manager.mdc`**.
-
+- Архитектура и импорты: `architecture-boundaries.mdc`, `public-imports.mdc`
+- Фичи: `feature-delivery-workflow.mdc` + skill `feature-delivery`
+- После правок: `post-change-lint.mdc`; менеджер пакетов: `package-manager.mdc`
+- Копировать паттерны соседних файлов в целевом слое; не использовать `any` (предпочитать `unknown` + сужение)

package/presets/cursor/next/rules/no-type-assertion-as-import-export.mdc

@@ -1,6 +1,9 @@
 ---
 description: Избегать приведения типов через as на границах модулей (импорт/экспорт)
-globs: app/src/**/*.ts,app/src/**/*.tsx
+globs:
+  - app/src/api/**/*
+  - app/src/store/**/*
+  - app/src/types/**/*
 alwaysApply: false
 ---
 

package/presets/cursor/next/rules/package-manager.mdc

@@ -5,21 +5,12 @@ alwaysApply: true
 
 # Менеджер пакетов (терминал)
 
-Перед **`npm install` / `yarn` / `pnpm` / `bun`** и любыми **`… run …`** (lint, test, dev, build) **сначала определи**, какой менеджер закреплён в этом репозитории, и **используй только его** — не подставляй npm или другой инструмент «по привычке».
+Перед **`npm install` / `yarn` / `pnpm` / `bun`** и **`… run …`** определи менеджер репозитория и **используй только его**.
 
-## Как определить (по убыванию надёжности)
+## Как определить
 
-1. Поле **`packageManager`** в `package.json` у корня монорепо или в каталоге приложения (например `app/package.json`) — строка вида `yarn@…`, `pnpm@…`, `npm@…`, `bun@…` (Corepack).
-2. **Lockfile** рядом с тем `package.json`, откуда ставятся зависимости:
-   - `yarn.lock` → **yarn**
-   - `pnpm-lock.yaml` → **pnpm**
-   - `package-lock.json` → **npm**
-   - `bun.lock` / `bun.lockb` → **bun**
-3. Если структура неоднозначна — критерий: где лежат **`node_modules`** и какой lockfile обновляют в CI / документации репо.
+1. **`packageManager`** в `package.json` (корень или `app/package.json`).
+2. **Lockfile** рядом: `yarn.lock` → yarn; `pnpm-lock.yaml` → pnpm; `package-lock.json` → npm; `bun.lock(b)` → bun.
+3. Если неоднозначно — где `node_modules` и какой lockfile в CI.
 
-## Как запускать
-
-- Рабочий каталог — тот, где **`package.json`** с нужными **scripts** (в этом репозитории зависимости и скрипты в **`app/`**).
-- Примеры: `yarn lint`, `pnpm run test` — **в соответствии с обнаруженным менеджером**, без смешения разных CLI в одной задаче.
-
-Если менеджер неочевиден — **посмотри файлы** (`package.json`, lockfile) инструментами чтения/списка каталога, **не угадывай**.
+Рабочий каталог для scripts — **`app/`**. Примеры: `yarn lint`, `pnpm run test`. Не угадывай — проверь файлы.

package/presets/cursor/next/rules/post-change-lint.mdc

@@ -7,42 +7,32 @@ alwaysApply: true
 
 ## Когда применять
 
-После **любого** изменения исходников в репозитории: правка, создание или удаление файлов в `app/**` (TS/TSX/JS/MJS, CSS, styled/Linaria в `.ts`/`.tsx`, markdown с ESLint и т.д.).
+После **любого** изменения исходников в `app/**` (TS/TSX/JS/MJS, CSS, styled/Linaria в `.ts`/`.tsx`).
 
-Исключения без прогона линтеров: только правки **документации вне `app/`**, конфигов CI, `.cursor/rules/**`, если **не** менялся исполняемый код приложения.
+Исключения: правки документации вне `app/`, конфигов CI, `.cursor/rules/**`, если исполняемый код приложения не менялся.
+
+**Pipeline exception:** если задача идёт через agent team и следующий шаг — `build-verifier`, developer может ограничиться lint/type-check **изменённых файлов**; полный прогон — обязанность `build-verifier`. В single-agent режиме (без pipeline) — всегда полный прогон.
 
 ## Обязательные команды
 
-Рабочий каталог — **`app/`** (там `package.json` со скриптами). Менеджер пакетов — **`package-manager.mdc`**.
+Рабочий каталог — **`app/`**. Менеджер пакетов — **`package-manager.mdc`**.
 
-1. **`lint:js`** — полный ESLint по проекту (`eslint .` с расширениями из скрипта).
+1. **`lint:js`** — полный ESLint по проекту.
 2. **`lint:css`** — полный Stylelint (`**/*.{css,ts}`).
 
-**Всегда запускать обе команды**, даже если задача не касалась стилей: Stylelint проверяет и CSS-in-JS в `.ts`.
-
-Точечный ESLint/Stylelint только на один файл **не заменяет** полный прогон перед завершением задачи.
+Точечный lint на один файл **не заменяет** полный прогон перед завершением задачи (кроме pipeline exception выше).
 
-## Алгоритм для агента
+## Алгоритм
 
 1. Завершить правки кода.
-2. Запустить **`lint:js`** и **`lint:css`** из `app/` (через терминал, не «на глаз»).
-3. **Проанализировать весь вывод**: errors и warnings.
-4. **Исправить** все срабатывания в **изменённых файлах** и связанных с задачей; для Stylelint сначала пробовать **`lint:css --fix`**, если правило автоисправимо.
-5. При ненулевом exit code — повторить шаги 2–4 до успешного прогона или явного блокера.
-6. **Не считать задачу выполненной**, пока оба линтера не завершились с кодом 0 **или** в ответе пользователю не зафиксирован блокер (например, легаси вне скоупа) с перечислением оставшихся замечаний.
+2. Запустить **`lint:js`** и **`lint:css`** из `app/`.
+3. Проанализировать весь вывод; исправить errors/warnings в изменённых файлах; для Stylelint — **`lint:css --fix`** если автоисправимо.
+4. Повторить до exit code 0 или зафиксировать блокер в ответе пользователю.
+5. **`type-check`** при изменениях TypeScript. CI-уровень: **`lint`** (= `lint:js` + `lint:css` + `type-check`).
 
 ## Что исправлять
 
 - **Errors** — обязательно.
-- **Warnings** — обязательно в файлах из текущей задачи; вне скоупа — не чинить «заодно», но **упомянуть** в ответе, если мешают нулевому exit code.
-- **`eslint-disable`** — только точечно, с кратким комментарием «зачем» (`code-quality-and-refactoring.mdc`).
-
-## Связанные проверки
-
-- **`type-check`** — обязателен при изменениях TypeScript (`next-app-core.mdc`); не подменяет ESLint/Stylelint.
-- Полная валидация как в CI: **`lint`** (= `lint:js` + `lint:css` + `type-check`) — уместна перед крупным MR.
-
-## Конфиги
+- **Warnings** — обязательно в файлах задачи; вне скоупа — упомянуть, если мешают нулевому exit code.
 
-- ESLint: `app/eslint.config.mjs`
-- Stylelint: `app/.stylelintrc` (порядок свойств — `css-property-order-stylelint.mdc`)
+Конфиги: `app/eslint.config.mjs`, `app/.stylelintrc` (порядок CSS — `css-property-order-stylelint.mdc`).

package/presets/cursor/next/rules/public-imports.mdc

@@ -0,0 +1,48 @@
+---
+description: Импорт доменных типов и API только через публичные barrel @/types и @/api
+globs:
+  - app/src/ui/**/*
+  - app/src/store/**/*
+  - app/src/lib/**/*
+  - app/src/types/**/*
+  - app/src/api/**/*
+alwaysApply: false
+---
+
+# Публичные импорты (`@/types`, `@/api`)
+
+**Коллизии:** импорт типов — раздел `@/types` ниже; API вне `app/src/api/**` — раздел `@/api` ниже (дублирует ESLint `no-restricted-imports` в `app/eslint.config.mjs`).
+
+## `@/types`
+
+- **Публичный API типов** — barrel `app/src/types/index.ts`; импортировать типы только как `@/types` (или `@/types/index`).
+- **Запрещено** обходить barrel: `@/types/<что‑угодно>`, кроме enum.
+- **Enum** — только `@/types/enums` / `@/types/enums.ts`.
+- Внутри `app/src/types/**` — относительные импорты между файлами слоя.
+
+```typescript
+// ✅
+import type { TUserProfile } from '@/types'
+import { SomeEnum } from '@/types/enums'
+
+// ❌
+import type { TUserProfile } from '@/types/User.types'
+```
+
+Новые публичные типы — реэкспорт в `app/src/types/index.ts` по **`layer-barrel-exports.mdc`**.
+
+## `@/api`
+
+- **Публичный API** — barrel `app/src/api/index.ts`. Вне `app/src/api/**` — только `import … from '@/api'` (или `@/api/index`).
+- **Запрещено** снаружи слоя: `@/api/<что‑угодно>`, кроме `@/api/index`.
+- Внутри `app/src/api/**` — относительные импорты и `@/api/services/**`, `@/api/clients/**`.
+
+```typescript
+// ✅ в store, UI, lib вне app/src/api
+import { MedcardApiService } from '@/api'
+
+// ❌ снаружи app/src/api
+import { MedcardApiService } from '@/api/services/MedcardApiService/MedcardApiService'
+```
+
+Новые публичные символы API — реэкспорт в `app/src/api/index.ts` по **`layer-barrel-exports.mdc`**.

package/presets/cursor/next/rules/react-ui.mdc

@@ -71,7 +71,7 @@ alwaysApply: false
 - Описывать пропсы через `type Props = { ... }` или `interface Props { ... }`.
 - Не использовать `any`; при необходимости:
   - обобщения (`<T>`), `unknown`, тип‑предикаты и user‑defined type guards.
-- Для доменных сущностей использовать типы из `@/types` (и enum из `@/types/enums`), а не описывать их заново (`types-public-imports.mdc`).
+- Для доменных сущностей использовать типы из `@/types` (и enum из `@/types/enums`), а не описывать их заново (`public-imports.mdc`).
 
 # Логика и side effects
 

package/presets/cursor/next/rules/reference-features.mdc

@@ -1,6 +1,10 @@
 ---
 description: Эталонные фичи репозитория — копировать структуру при реализации новых задач. Заполните пути после init в целевом репо.
-globs: app/src/**/*
+globs:
+  - app/src/ui/**/*
+  - app/src/store/**/*
+  - app/src/api/**/*
+  - app/src/types/**/*
 alwaysApply: false
 ---
 

package/presets/cursor/next/rules/store-rtk.mdc

@@ -30,7 +30,7 @@ alwaysApply: false
 - Асинхронные запросы:
   - через `createAsyncThunk` или RTK Query.
   - внутри thunk:
-    - вызывать API через сервисы, импортированные из `@/api` (**`api-public-imports.mdc`**);
+    - вызывать API через сервисы, импортированные из `@/api` (**`public-imports.mdc`**);
     - не вызывать HTTP‑клиент напрямую — только через эти сервисы.
 - Сайд‑эффекты (логирование, аналитика, работа с файлами):
   - выносить в middleware (`app/src/store/middleware/**`) или специализированные слайсы.
@@ -44,7 +44,7 @@ alwaysApply: false
   - при ошибках после вызова сервиса — опираться на **тот же класс/контракт ошибки транспорта**, что использует общий клиент (из `@/types`), и разбирать тело/статус **по полям текущей реализации**, а не по воображаемому API;
   - в **`catch`** предпочитать **`instanceof`** на класс ошибки транспорта из `@/types` (если он есть в коде) вместо голого `as`, когда это выразимо без шума (см. `no-type-assertion-as-import-export.mdc`).
 - Для сущностей:
-  - доменные типы (включая вычисляемые поля) определять в `app/src/types/**`, экспортировать через barrel и импортировать в слайсы из `@/types` как **источник правды** для структуры данных (`types-public-imports.mdc`);
+  - доменные типы (включая вычисляемые поля) определять в `app/src/types/**`, экспортировать через barrel и импортировать в слайсы из `@/types` как **источник правды** для структуры данных (`public-imports.mdc`);
   - избегать дублирования описаний сущностей в нескольких местах.
 - **Граница домена**: в **state** хранить доменные модели; тип **обёртки ответа клиента** допустим как тип **возвращаемого значения thunk** или промежуточно до маппинга — без дублирования DTO в полях state без нужды (согласовано с `api-services.mdc` и `http-client.mdc`).