@bonesofspring/ai-rules 0.1.41 → 0.2.0

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`).
 

package/presets/cursor/next/rules/types-jsdoc.mdc

@@ -39,4 +39,4 @@ alwaysApply: false
 - Правя файл, где уже есть такие комментарии, **поддерживать тот же стиль**, а не смешивать с англоязычными или «теговыми» блоками.
 - Не раздувать комментарии: одна-две фразы на тип, одна строка на поле — норма; исключение — действительно сложная доменная оговорка.
 
-См. также импорты и barrel: `types-public-imports.mdc`.
+См. также импорты и barrel: `public-imports.mdc`.

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

@@ -1,31 +1,8 @@
 ---
-description: Импорт доменных типов только через публичный API @/types
-globs: app/src/**/*.ts,app/src/**/*.tsx
+description: Moved to public-imports.mdc — read that file instead
 alwaysApply: false
 ---
 
-# Импорты из `@/types`
+# Deprecated
 
-- **Публичный API типов** — barrel `app/src/types/index.ts`, импортировать типы и интерфейсы только как `@/types` (или `@/types/index` при необходимости явного пути).
-- **Запрещено** для потребителей слоя обходить barrel: любой импорт вида `@/types/<что‑угодно>`, кроме перечисленного ниже исключения для enum.
-- Отдельно **нельзя** импортировать из вложенных файлов `*.types.ts` по путям `@/types/**/…*.types.ts` (типичный deep‑импорт).
-- **Исключение — enum**: перечисления можно импортировать только из `@/types/enums` / `@/types/enums.ts` (не из других файлов под `@/types`).
-
-## Внутри слоя `app/src/types/**`
-
-- При реализации и поддержке barrel‑файла допустимы **относительные** импорты между файлами внутри `app/src/types` (например `from './User.types'`). Это не относится к потребителям слоя.
-
-## Примеры
-
-```typescript
-// ✅ Допустимо — доменные и транспортные сущности с теми именами, что экспортирует barrel
-import type { TUserProfile } from '@/types'
-import { SomeEnum } from '@/types/enums'
-
-// ❌ Запрещено (обход публичного API)
-import type { TUserProfile } from '@/types/User.types'
-import { TransportError } from '@/types/TransportError'
-```
-
-При ревью и правках кода **не добавлять** новые импорты типов из `@/types/...` кроме `@/types` и `@/types/enums`.
-- Новые публичные типы — реэкспорт в `app/src/types/index.ts` по **`layer-barrel-exports.mdc`**.
+Содержимое перенесено в **`public-imports.mdc`** (раздел `@/types`).

package/presets/cursor/next/skills/feature-delivery/SKILL.md

@@ -5,26 +5,11 @@ description: Delivers Next.js frontend features end-to-end across domain types,
 
 # Feature Delivery
 
-## Workflow
-
-1. Read the task brief, acceptance criteria, and decomposition if present.
-2. Read **`reference-features.mdc`** and mirror the closest reference feature.
-3. Work in layer order: types -> API contract/mappers -> services -> store -> UI -> mocks -> **unit tests** -> e2e (if in scope).
-4. Keep DTOs out of UI/store; expose domain types through `@/types` and API calls through `@/api`.
-5. Prefer small, reviewable edits; update barrels when adding public symbols.
-6. Add or update focused tests for changed behavior.
-7. Run project validation from `app/`: `lint:js`, `lint:css`, and `type-check` when TypeScript changed.
-
-## Rule Map
-
-- Core stack and layers: `next-app-core.mdc`, `architecture-boundaries.mdc`.
-- Data/API: `http-client.mdc`, `api-services.mdc`, `store-rtk.mdc`.
-- Public imports: `types-public-imports.mdc`, `api-public-imports.mdc`, `layer-barrel-exports.mdc`.
-- UI: `react-ui.mdc`, `react-a11y-coding.mdc`, `no-props-spread.mdc`, `no-cross-component-styles-import.mdc`.
-- App Router: `next-app-router.mdc`.
-- Tests: `tests-unit.mdc`, `tests-e2e-structure.mdc`, `playwright-agents.mdc`.
-- Finish: `post-change-lint.mdc`, `package-manager.mdc`.
+1. Read task brief, acceptance criteria, and decomposition if present.
+2. Read **`feature-delivery-workflow.mdc`** and **`reference-features.mdc`** — follow layer order and mirror closest reference feature.
+3. Add or update focused tests for changed behavior.
+4. Validation from `app/`: see **`post-change-lint.mdc`** (pipeline: scoped lint OK if next step is `build-verifier`).
 
 ## Handoff
 
-Summarize completed work by layer, validation results, and known gaps. If this is part of an agent team task, update `.cursor/team/tasks/<slug>/status.json`.
+Summarize by layer, validation results, and known gaps. Agent team: update `.cursor/team/tasks/<slug>/status.json`.