@bonesofspring/ai-rules 0.1.42 → 0.2.1

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-ui.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

@@ -1,6 +1,6 @@
 ---
 description: Двухуровневые barrel-экспорты для слоёв с регламентированным public API
-globs: app/src/**/*
+globs: app/src/**/index.ts
 alwaysApply: false
 ---
 
@@ -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/navigation-router-stack.mdc

@@ -1,6 +1,6 @@
 ---
 description: Выбор API навигации по стеку проекта (Next.js vs React Router)
-globs: app/src/ui/**/*
+globs: app/src/app/**/*,app/**/app/**/*
 alwaysApply: false
 ---
 

package/presets/cursor/next/rules/navigation-router-ui.mdc

@@ -0,0 +1,16 @@
+---
+description: Навигация в UI-компонентах — краткий ориентир (полный аудит стека — navigation-router-stack.mdc)
+globs: app/src/ui/**/*.tsx
+alwaysApply: false
+---
+
+# Navigation in UI components
+
+Перед ссылками, программной навигацией или работой с URL в UI:
+
+1. **`package.json`** workspace приложения — `next` vs `react-router-dom`.
+2. **Соседние импорты** той же фичи (`next/navigation`, `next/link` vs `react-router-dom`).
+3. **Обёртки проекта** (`@/ui/...` Link) — предпочтительнее сырого API роутера.
+4. **По умолчанию (preset):** Next.js App Router → `next/navigation` + `next/link` (`next-app-core.mdc`, `next-app-router.mdc`).
+
+Полный аудит (дерево маршрутов, гибриды, lockfile): **`navigation-router-stack.mdc`** — при правках `app/src/app/**`.

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-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 знает о доменных типах (из `@/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-cross-component-styles-import.mdc

@@ -1,58 +1,8 @@
 ---
-description: Стили компонентов — колокация, импорты, корневой styled как Root
-globs:
-  - app/src/ui/**/*.ts
-  - app/src/ui/**/*.tsx
+description: Стили компонентов — consolidated into react-ui.mdc
 alwaysApply: false
 ---
 
-# Стили только рядом с компонентом
+# Moved to react-ui.mdc
 
-## Имя корневого styled-элемента: `Root`
-
-- В `styles.ts` (или аналоге) **корневой** styled-элемент — тот, что оборачивает весь JSX компонента — экспортируется как **`Root`**.
-- В разметке: `<s.Root>...</s.Root>` при `import * as s from './styles'`.
-- Вложенные и соседние примитивы именуются по смыслу: `Title`, `List`, `Item`, `Header` и т.д.
-- Если нет одной styled-обёртки на весь компонент (только фрагмент или один нативный тег без своего styled), экспорта `Root` может не быть. Когда вводится **одна** внешняя styled-обёртка всего JSX — она называется **`Root`**, а не `Container`, `Wrapper`, `Block` и т.п.
-
-```tsx
-// ✅ Хорошо
-export const Root = styled.div` ... `
-// в компоненте: <s.Root>...</s.Root>
-
-// ❌ Плохо для единственной обёртки всего компонента
-export const Service = styled.div` ... `
-```
-
-## Правило
-
-**Запрещено** импортировать модули стилей, которые лежат в каталоге **другого** UI-компонента или блока (не в том же каталоге, что и текущий файл).
-
-Под «модулями стилей» имеются в виду в первую очередь:
-
-- `styles.ts` / `styles.tsx` рядом с компонентом;
-- `*.module.css`, `*.module.scss` и аналоги, принадлежащие конкретному компоненту;
-- любые файлы, которые **экспортируют только styled-примитивы** для одного компонента.
-
-## Разрешено
-
-- `import * as s from './styles'` — стили **в той же папке**, что и компонент.
-- Импорты **общих** примитивов дизайн-системы, токенов, общих UI из `@/ui/components/...` или пакетов, если это **не** приватный `styles` чужой фичи.
-- Повторное использование визуала через **сам компонент** (композиция), а не через его `styles`.
-
-## Примеры
-
-```tsx
-// ✅ Хорошо — локальный styles
-import * as s from './styles'
-
-// ❌ Плохо — стили родителя/соседа
-import * as s from '../../styles'
-import * as s from '../RequestForAnalysisServices/styles'
-```
-
-## Почему
-
-- Единое имя **`Root`** ускоряет чтение: сразу видно входную точку разметки компонента.
-- Стили и разметка компонента должны меняться вместе, без скрытой связи через чужие файлы.
-- Упрощается рефакторинг и поиск владельца стилей.
+Правила колокации стилей, имени **`Root`** и запрета импорта чужих `styles` — в **`react-ui.mdc`** § «Стили и дизайн‑токены». Правило подгружается автоматически при правках `app/src/ui/**`.

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

@@ -27,7 +27,7 @@ alwaysApply: false
 - Локальные подкомпоненты, используемые только этим блоком, выносятся в **`./components/<ComponentName>/`** относительно папки родительского компонента (не оставлять крупные куски JSX и «внутренние» компоненты в том же файле, что и родитель).
 - У каждого такого подкомпонента — **своя** папка с тем же именем, что и публичное имя компонента:
   - `ComponentName.tsx` — разметка и композиция;
-  - `styles.ts` — только стили этого подкомпонента (см. `no-cross-component-styles-import.mdc`: не тянуть `styles` соседних компонентов);
+  - `styles.ts` — только стили этого подкомпонента (не тянуть `styles` соседних компонентов — см. § Стили ниже);
   - при необходимости — `ComponentName.data.ts`, `ComponentName.utils.ts`, `ComponentName.hooks.ts` по тем же правилам префикса, что и у родителя;
   - опционально `index.ts` с реэкспортом.
 - Родитель импортирует подкомпонент из `./components/...`, а не держит его реализацию inline.
@@ -56,8 +56,9 @@ alwaysApply: false
 
 # Стили и дизайн‑токены
 
-- **Корневой** styled-элемент компонента в соседнем `styles` — **`Root`** (`<s.Root>`). Подробнее: `no-cross-component-styles-import.mdc`.
-- Порядок объявлений в CSS / `styled` — как требует Stylelint: см. `css-property-order-stylelint.mdc`.
+- **Корневой** styled в соседнем `styles` — экспорт **`Root`**; в JSX: `<s.Root>` при `import * as s from './styles'`. Вложенные — `Title`, `List` и т.д. Не `Container`/`Wrapper` для единственной обёртки.
+- **Запрещено** импортировать `styles` другого компонента (`../Other/styles`, `../../styles`). Разрешено: `./styles`, общие примитивы из `@/ui/components/...` или пакетов дизайн-системы.
+- Порядок CSS / `styled` — Stylelint idiomatic-order: `css-property-order-stylelint.mdc` (грузится на `styles.ts` / `.css`).
 - Для визуала использовать **тот стек стилей и токенов, который уже в проекте** (переменные, тема, общие классы, дизайн‑пакет).
 - Избегать:
   - inline‑стилей, кроме простых случаев;
@@ -71,7 +72,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
 ---