@bonesofspring/ai-rules 0.2.14 → 0.2.15

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

@@ -1,77 +1,77 @@
 ---
-description: Сквозной чеклист новой фичи и матрица «слой → правило Cursor». Use when implementing features via feature-developer or feature-delivery skill.
+description: End-to-end checklist for a new feature and the “layer → Cursor rule” matrix. Use when implementing features via feature-developer or feature-delivery skill.
 alwaysApply: false
 ---
 
 <!-- shared-core: architecture/feature-delivery-workflow.md -->
 
-# Доставка фичи (сквозной порядок)
+# Feature delivery (end-to-end order)
 
 ## Stack notes
 
-Типичная фича с данными с backend и общим состоянием. Детали слоёв — `architecture-boundaries.mdc`, `next-app-core.mdc`.
+Typical feature with backend data and shared state. Layer details — `architecture-boundaries.mdc`, `next-app-core.mdc`.
 
-## Чеклист (порядок работ)
+## Checklist (work order)
 
-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`.
+1. **Domain types** — `app/src/types/**`, export via barrel (`public-imports.mdc`, **`layer-barrel-exports.mdc`**); JSDoc — `types-jsdoc.mdc`.
+2. **API contract** — DTOs where the repo uses them; domain types in `@/types`.
+3. **Mappers** — DTO → domain in `*responseMappers.ts` (`api-services.mdc`).
+4. **Services** — clients `app/src/api/clients/**`, barrel `@/api` (`api-services.mdc`, `http-client.mdc`, **`layer-barrel-exports.mdc`**). No `fetch` from UI/store.
+5. **State** — `createSlice` / `createAsyncThunk` (`store-rtk.mdc`); thunk → services from `@/api`.
+6. **UI** — types from `@/types`, no DTOs (`react-ui.mdc`, `architecture-boundaries-ui.mdc`, `no-props-spread.mdc`).
+7. **Mocks** — per repo layout; register in `app/src/mocks/handlers.ts` (see below).
+8. **Tests** — unit for mappers (`tests-unit.mdc`); e2e from `*.cases.md` (`tests-e2e-structure.mdc`, `playwright-agents.mdc`).
+9. **Completion** — **`post-change-lint.mdc`**: `lint:js` + `lint:css` + `type-check`; package manager — `package-manager.mdc`.
 
-## Поток данных (ориентир)
+## Data flow (orientation)
 
 ```mermaid
 flowchart LR
-  subgraph transport [Транспорт]
+  subgraph transport [Transport]
     HttpClient[HttpClient]
   end
-  DTO[DTO] --> Mappers[Мапперы]
-  Mappers --> Domain[Доменные типы]
-  Domain --> Service[API сервис]
+  DTO[DTO] --> Mappers[Mappers]
+  Mappers --> Domain[Domain types]
+  Domain --> Service[API service]
   Service --> HttpClient
   Service --> Thunk[Thunk]
   Thunk --> Store[Store]
   Store --> UI[UI]
 ```
 
-## Регистрация по слоям
+## Registration by layer
 
-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)`; мапперы и нетривиальная логика — обязательно.
+1. **Types** — `app/src/types/**`; domain model is the source of truth for UI and store.
+2. **API** — `app/src/api/services/<ServiceRoot>/<Segment>/`; public exports (incl. **path constants** for mocks) → **`app/src/api/index.ts`**.
+3. **Mocks (MSW)** — `app/src/mocks/data/<feature>/`; handlers in **`app/src/mocks/handlers.ts`**. Paths from `@/api`; do not duplicate URL strings. Check browser worker and Node `setupServer` if both are used.
+4. **Store** — `app/src/store/slices/<FeatureName>/`; reducer in **`app/src/store/reducers.ts`**. Middleware → `app/src/store/middleware/**`, register in **`app/src/store/index.ts`**.
+5. **UI** — `app/src/ui/pages/<FeatureName>Page/**` and/or `components/**`; data via store/hooks.
+6. **Unit** — `*.spec.ts(x)`; mappers and non-trivial logic are required.
 7. **E2E** — `app/__tests__/e2e/<Area>/<plan>.cases.md` + `*.spec.ts`.
 
-## Частичные сценарии
+## Partial scenarios
 
-| Задача | Минимум действий |
-|--------|------------------|
-| Только 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. |
+| Task | Minimum actions |
+|------|-----------------|
+| API + types only | Types, service, mappers, `@/api` barrel; unit for mapper. |
+| Mocks only | Path in `@/api`; handlers + `mocks/handlers.ts`. |
+| Store only | Thunk via `@/api`; slice + `reducers.ts`. |
+| UI only | Store state; no HTTP/DTO. |
+| E2E only | `*.cases.md` + spec; page object. |
 
-## Антипаттерны
+## Anti-patterns
 
-- DTO в UI или нетипизированном store.
-- HTTP-клиент из компонента/thunk в обход сервиса.
-- Deep-import `@/api/services/**` из UI/store.
-- `{...props}` в компоненты — `no-props-spread.mdc`.
-- **Ubiquitous language:** имена Domain/типов отражают предметную область фичи — не смешивать транспорт/фреймворк-термины в домен без нужды.
+- DTO in UI or untyped store.
+- HTTP client from a component/thunk bypassing the service.
+- Deep-import `@/api/services/**` from UI/store.
+- `{...props}` into components — `no-props-spread.mdc`.
+- **Ubiquitous language:** Domain/type names reflect the feature’s subject domain — do not mix transport/framework terms into the domain without need.
 - Load `design-guidance` (rule stem) when assessing structure, smells, or pattern fit.
 
-## Матрица: зона → правила
+## Matrix: zone → rules
 
-| Зона | Правила |
-|------|---------|
+| Zone | 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`, `public-imports.mdc` |
@@ -79,4 +79,4 @@ flowchart LR
 | `app/src/types/**` | `public-imports.mdc`, `types-jsdoc.mdc`, `layer-barrel-exports.mdc` |
 | `app/__tests__/e2e/**` | `tests-e2e-structure.mdc`, `playwright-agents.mdc` |
 
-При добавлении или расширении фичи **пройти чеклист** и правила из таблицы для затронутых зон.
+When adding or extending a feature, **walk the checklist** and the rules from the table for affected zones.

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

@@ -1,5 +1,5 @@
 ---
-description: Единый HTTP-клиент, типы ошибок и ответов
+description: Shared HTTP client, error types, and response types
 globs:
   - app/src/lib/clients/HttpClient/**/*.ts
   - app/src/api/clients/**/*.ts
@@ -7,40 +7,41 @@ alwaysApply: false
 impact: HIGH
 ---
 
-# HTTP-транспорт
+# HTTP transport
 
-**Имена** фабрик, классов ошибок, типов ответа и конфига — **как в текущем коде репозитория** и в barrel `app/src/types/index.ts`. Ниже — **архитектурные правила**, а не спецификация переименований.
+**Names** of factories, error classes, response types, and config — **as in the current repo code** and in the barrel `app/src/types/index.ts`. Below are **architectural rules**, not a rename specification.
 
-## Роль слоя
+## Layer role
 
-- Обычные 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` (`public-imports.mdc`).
-- **Исключения** (узкие протоколы, отдельный транспорт) — только там, где в репозитории уже есть образец; повторять его, не плодить произвольные обходы общего клиента.
+- Ordinary REST calls to the backend go through **one implementation** in `app/src/lib/clients/**` (shared client module) and **preconfigured instances** in `app/src/api/clients/**`, following the pattern already adopted in the project.
+- Where transport sits in the overall **ports and adapters** picture — see `architecture-boundaries.mdc` (section **“Ports and adapters”**).
+- **Do not** call `fetch` directly from `app/src/api/services/**`, store, or UI (see `architecture-boundaries.mdc`, `api-services.mdc`); from store/UI — only calls through services from `@/api` (`public-imports.mdc`).
+- **Exceptions** (narrow protocols, separate transport) — only where the repo already has an example; repeat it, do not invent arbitrary bypasses of the shared client.
 
-## Типы
+## Types
 
-- Всё, что относится к **контракту запроса/ответа/ошибки** приложения и реэкспортируется для HTTP‑слоя, импортировать **только** из barrel `@/types`, без deep‑импортов из внутренних файлов `app/src/types/**` (см. `public-imports.mdc`).
-- Не поднимать в новом коде **типы и зависимости от внешнего HTTP‑клиента**, от которого проект ушёл; ориентир — **`package.json`** и существующие вызовы.
+- Everything related to the **request/response/error contract** of the app and re-exported for the HTTP layer must be imported **only** from the `@/types` barrel, without deep imports from internal `app/src/types/**` files (see `public-imports.mdc`).
+- Do not introduce **types or dependencies on an external HTTP client** the project has moved away from; use **`package.json`** and existing calls as the guide.
 
-## Контракт ошибок
+## Error contract
 
-- Ошибки сети и HTTP должны приходить в **едином виде**, который задаёт общий клиент (обычно класс/обёртка с полем вроде `response` для тела и статуса).
-- В **`catch`** ориентироваться на **фактическую форму** ошибки в этом репозитории (как в соседних слайсах/сервисах): доступ к телу ошибки, статусу, диагностическому коду — **по полям текущей реализации**, без выдумывания второго формата.
+- Network and HTTP errors must arrive in the **single shape** defined by the shared client (usually a class/wrapper with a field like `response` for body and status).
+- In **`catch`**, align with the **actual error shape** in this repo (as in neighboring slices/services): access body, status, diagnostic code — **via fields of the current implementation**, without inventing a second format.
 
-## Поведение, которое остаётся в клиенте
+## Behavior that stays in the client
 
-- Общие заголовки, `credentials`, загрузка файлов (**FormData** / снятие лишних заголовков), бинарные ответы (**blob** и аналоги), единообразный разбор JSON и прочих тел.
-- Перехват **401 / refresh**, обработка **404** и т.п. — **централизованно**, если так уже сделано в клиенте; не дублировать ту же логику в каждом сервисе.
+- Common headers, `credentials`, file uploads (**FormData** / stripping extra headers), binary responses (**blob** and equivalents), uniform parsing of JSON and other bodies.
+- Intercepting **401 / refresh**, handling **404**, etc. — **centrally**, if the client already does so; do not duplicate the same logic in every service.
 
-## Связь со store
+## Store relationship
 
-- Thunk может возвращать **тип обёртки успешного ответа**, если сервис так устроен; в **state** по возможности класть **доменные** типы после маппинга. Подробнее — `store-rtk.mdc`.
+- A thunk may return the **successful response wrapper type** if the service is structured that way; in **state**, prefer **domain** types after mapping. See `store-rtk.mdc`.
 
-## Требование к агенту
+## Agent requirement
+
+- When changing the shared client implementation — **update or add behavior tests** next to the client module (`tests-unit.mdc`).
+- Do not introduce a **second full HTTP stack** without an explicit task and alignment with repo architecture.
 
-- Меняя реализацию общего клиента — **обновить или добавить behavior‑тесты** рядом с модулем клиента (`tests-unit.mdc`).
-- Не вводить **второй полноценный HTTP‑стек** без явной задачи и согласования с архитектурой репозитория.
 ## Incorrect
 
 ```ts

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

@@ -1,63 +1,64 @@
 ---
-description: Двухуровневые barrel-экспорты для слоёв с регламентированным public API
+description: Two-level barrel exports for layers with a regulated public API
 globs: app/src/**/index.ts
 alwaysApply: false
 impact: MEDIUM
 ---
 
-# Barrel-экспорты слоёв с public API
+# Layer barrel exports with public API
 
-## Когда применять
+## When to apply
 
-Для **любого слоя** (каталога, пакета, bounded context), у которого:
+For **any layer** (directory, package, bounded context) that has:
 
-- есть **корневой barrel** — единая точка импорта для внешних потребителей;
-- deep-импорты внутрь слоя **запрещены** снаружи (ESLint `no-restricted-imports`, правила `public-imports.mdc`).
+- a **root barrel** — single import entry for external consumers;
+- deep imports inside the layer **forbidden** from outside (ESLint `no-restricted-imports`, `public-imports.mdc` rules).
 
-Примеры alias/entry point в разных проектах: `@/api`, `@/types`, `@/core`, `@/store`, `packages/foo`.
+Example alias/entry points in different projects: `@/api`, `@/types`, `@/core`, `@/store`, `packages/foo`.
 
-## Два уровня barrel
+## Two barrel levels
 
-1. **Локальный** — `index.ts` модуля/фичи внутри слоя.
-2. **Корневой public API** — barrel слоя (например `src/<layer>/index.ts`).
+1. **Local** — module/feature `index.ts` inside the layer.
+2. **Root public API** — layer barrel (e.g. `src/<layer>/index.ts`).
 
-**Внутри** слоя — относительные импорты и пути между подмодулями. **Снаружи** — только корневой barrel и **явно разрешённые** вторичные entry points (если зафиксированы в правилах проекта, напр. `@/types/enums`).
+**Inside** the layer — relative imports and paths between submodules. **Outside** — only the root barrel and **explicitly allowed** secondary entry points (if fixed in project rules, e.g. `@/types/enums`).
 
-## Что реэкспортировать наружу
+## What to re-export externally
 
-Только символы, которые **должны быть доступны** потребителям слоя: публичные функции/сервисы/фасады, типы контракта, константы и helpers, нужные другим слоям или тестам.
+Only symbols that **must be available** to layer consumers: public functions/services/facades, contract types, constants and helpers needed by other layers or tests.
 
-**Не реэкспортировать:** внутренние адаптеры, мапперы, детали транспорта, промежуточные объекты для сборки фасада внутри слоя.
+**Do not re-export:** internal adapters, mappers, transport details, intermediate objects used to assemble a facade inside the layer.
 
-Группировка в корневом barrel — **по конвенции репозитория** (ориентир — соседние модули того же слоя).
+Grouping in the root barrel — **per repo convention** (guide — neighboring modules in the same layer).
 
-## Чеклист агента (обязателен)
+## Agent checklist (must)
 
-При добавлении или существенном расширении **модуля внутри регламентированного слоя**:
+When adding or substantially extending a **module inside a regulated layer**:
 
-1. Определить слой, его **корневой barrel** и доп. entry points (`public-imports.mdc`).
-2. Создать/обновить **локальный** `index.ts` — только публичные символы.
-3. Если в слое есть **фасад/агрегатор** (`*ApiService.ts`, `rootReducer`, …) — подключить модуль там.
-4. Добавить **реэкспорт** новых публичных символов в **корневой barrel** слоя.
-5. **Проверка:** grep по имени символа или пути `./<Module>` в корневом barrel; снаружи слоя нет deep-импортов.
+1. Identify the layer, its **root barrel**, and additional entry points (`public-imports.mdc`).
+2. Create/update **local** `index.ts` — public symbols only.
+3. If the layer has a **facade/aggregator** (`*ApiService.ts`, `rootReducer`, …) — wire the module there.
+4. Add **re-export** of new public symbols in the layer **root barrel**.
+5. **Check:** grep for the symbol name or path `./<Module>` in the root barrel; no deep imports from outside the layer.
 
-Модуль **не готов**, пока чеклист не пройден.
+The module is **not done** until the checklist passes.
 
-## Как найти регламентированные слои в репозитории
+## How to find regulated layers in the repo
 
-1. Правила `public-imports.mdc` в `.cursor/rules/`.
-2. ESLint `no-restricted-imports` — паттерны `@/<layer>/*` с исключением barrel.
-3. `architecture-boundaries.mdc`, README проекта.
+1. `public-imports.mdc` rules in `.cursor/rules/`.
+2. ESLint `no-restricted-imports` — patterns `@/<layer>/*` with barrel exception.
+3. `architecture-boundaries.mdc`, project README.
 
-## В этом репозитории
+## In this repo
 
-| Слой | Корневой barrel | Правило импортов |
+| Layer | Root barrel | Import rule |
 |------|-------------------|------------------|
 | 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`.
+Two-level illustration (API): local `services/.../<Feature>/index.ts` → facade `*ApiService.ts` → `app/src/api/index.ts`.
+
 ## Incorrect
 
 ```ts

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

@@ -1,62 +1,62 @@
 ---
-description: Выбор API навигации по стеку проекта (Next.js vs React Router)
+description: Choose navigation API by project stack (Next.js vs React Router)
 globs: app/src/app/**/*,app/**/app/**/*
 alwaysApply: false
 ---
 
-# Навигация и роутинг: сначала стек проекта
+# Navigation and routing: project stack first
 
-**При любой задаче, связанной с навигацией, переходами между страницами, URL, редиректами, хлебными крошками, защищёнными маршрутами или программной сменой маршрута** — перед предложением кода или импортов **нельзя** опираться на «типичный React» по умолчанию. Нужно **явно свериться со стеком целевого репозитория** и использовать **один** согласованный с проектом механизм.
+**For any task involving navigation, page transitions, URLs, redirects, breadcrumbs, protected routes, or programmatic route changes** — before proposing code or imports you **must not** default to “typical React”. **Explicitly verify the target repo stack** and use **one** mechanism consistent with the project.
 
-## Зависимости: что проверить в первую очередь
+## Dependencies: what to check first
 
-1. **`package.json`** в корне приложения (например `app/package.json` в монорепо — тот пакет, который реально собирается и деплоится). Смотреть **`dependencies`** и при необходимости **`peerDependencies`**:  
-   - **`next`** — Next.js; версия важна для нюансов API (сверяться с документацией под эту major).  
-   - **`react-router-dom`**, **`@remix-run/*`**, **`@tanstack/react-router`** и т.д. — отдельный роутинг; не подменять их API вызовами Next без проверки, что в проекте действительно используется этот стек.  
-   - **`next`** и **`react-router-dom`** одновременно — возможно легаси или гибрид; **не** выбирать API по умолчанию — смотреть раздел «Реализация в коде» ниже.
+1. **`package.json`** at the app root (e.g. `app/package.json` in a monorepo — the package that is actually built and deployed). Check **`dependencies`** and if needed **`peerDependencies`**:
+   - **`next`** — Next.js; version matters for API nuances (cross-check docs for that major).
+   - **`react-router-dom`**, **`@remix-run/*`**, **`@tanstack/react-router`**, etc. — separate routing; do not substitute their API with Next calls without verifying that stack is actually used.
+   - **`next`** and **`react-router-dom`** together — possible legacy or hybrid; **do not** pick API by default — see “Implementation in code” below.
 
-2. **Монорепо / workspaces** — роутинг может жить не в корневом `package.json`. Открыть **`package.json` того workspace**, где лежат страницы и `next.config.*` / точка входа SPA.
+2. **Monorepo / workspaces** — routing may live outside the root `package.json`. Open the **`package.json` of the workspace** where pages and `next.config.*` / SPA entry live.
 
-3. **Факт установки** — при сомнениях смотреть lockfile (`bun.lock`, `package-lock.json`, `pnpm-lock.yaml`, `yarn.lock`) или каталог `node_modules` у соответствующего пакета: убедиться, что заявленный пакет реально установлен, а не только прописан в документации.
+3. **Actual installation** — when in doubt, check the lockfile (`bun.lock`, `package-lock.json`, `pnpm-lock.yaml`, `yarn.lock`) or `node_modules` for the relevant package: confirm the declared package is installed, not only documented.
 
-## Реализация роутинга в проекте (код и структура)
+## Routing implementation in the project (code and structure)
 
-Перед предложением паттерна навигации **свериться с тем, как уже сделано в репозитории**:
+Before proposing a navigation pattern **align with how the repo already does it**:
 
-1. **Дерево маршрутов**  
-   - Next **App Router**: каталог **`app/`** (или `src/app/`) с `layout.tsx`, `page.tsx`, сегменты `[id]` и т.п.  
-   - Next **Pages Router**: каталог **`pages/`** с `_app`, динамические `[slug].tsx`.  
-   - Наличие **обоих** `app/` и `pages/` — уточнить по `next.config` и документации проекта, какой слой основной.
+1. **Route tree**
+   - Next **App Router**: **`app/`** (or `src/app/`) with `layout.tsx`, `page.tsx`, segments `[id]`, etc.
+   - Next **Pages Router**: **`pages/`** with `_app`, dynamic `[slug].tsx`.
+   - Both **`app/`** and **`pages/`** present — clarify via `next.config` and project docs which layer is primary.
 
-2. **Точки входа и обёртки**  
-   - Поиск по коду импортов: **`from 'next/navigation'`**, **`from 'next/router'`**, **`from 'next/link'`**, **`from 'react-router-dom'`**, **`createBrowserRouter`**, **`RouterProvider`**, **`BrowserRouter`**.  
-   - Где объявлены маршруты (файловая структура Next vs конфиг маршрутов / `routes.tsx` в SPA).
+2. **Entry points and wrappers**
+   - Code search for imports: **`from 'next/navigation'`**, **`from 'next/router'`**, **`from 'next/link'`**, **`from 'react-router-dom'`**, **`createBrowserRouter`**, **`RouterProvider`**, **`BrowserRouter`**.
+   - Where routes are declared (Next file structure vs SPA route config / `routes.tsx`).
 
-3. **Общие абстракции проекта**  
-   - Обертки над ссылками (`@/ui/...`, `Link` из дизайн-системы), хелперы путей, константы роутов — **использовать их**, а не дублировать сырой роутер.
+3. **Project abstractions**
+   - Link wrappers (`@/ui/...`, design-system `Link`), path helpers, route constants — **use them**, do not duplicate raw router.
 
-4. **Соседние файлы фичи**  
-   - Новый код навигации — в том же стиле, что страницы/хуки той же области (`next/navigation` vs `react-router-dom` как в соседних импортах).
+4. **Neighboring feature files**
+   - New navigation code — same style as pages/hooks in that area (`next/navigation` vs `react-router-dom` as in neighboring imports).
 
-## Как определить, что использовать (сводка)
+## How to decide what to use (summary)
 
-1. **Зависимости** — см. раздел выше; по ним задаётся допустимый набор пакетов.  
-2. **Структура** — App Router vs Pages vs SPA по каталогам и конфигу.  
-3. **Фактический код** — какие импорты и обёртки уже доминируют в приложении.
+1. **Dependencies** — see above; they define the allowed package set.
+2. **Structure** — App Router vs Pages vs SPA by directories and config.
+3. **Actual code** — which imports and wrappers dominate in the app.
 
-## Что использовать (краткая матрица)
+## What to use (quick matrix)
 
-| Стек | Программная навигация / чтение пути | Ссылки |
+| Stack | Programmatic navigation / path read | Links |
 |------|-------------------------------------|--------|
-| **Next.js App Router** | `next/navigation` (`useRouter`, `usePathname`, `useSearchParams`, `redirect` и т.д. по документации Next для вашей версии) | `next/link` |
+| **Next.js App Router** | `next/navigation` (`useRouter`, `usePathname`, `useSearchParams`, `redirect`, etc. per Next docs for your version) | `next/link` |
 | **Next.js Pages Router** | `next/router` | `next/link` |
-| **SPA + React Router** | `react-router-dom` (`useNavigate`, `useParams`, `useLocation`, …) | `<Link>` из `react-router-dom` |
+| **SPA + React Router** | `react-router-dom` (`useNavigate`, `useParams`, `useLocation`, …) | `<Link>` from `react-router-dom` |
 
-**Не делать:** подключать `react-router-dom` в проект на Next.js «по привычке»; импортировать хуки из `next/router` в компонентах App Router без проверки; смешивать два роутера в одном приложении без явной архитектурной причины в кодовой базе.
+**Do not:** add `react-router-dom` to a Next.js project “by habit”; import hooks from `next/router` in App Router components without checking; mix two routers in one app without an explicit architectural reason in the codebase.
 
-## Требование к агенту
+## Agent requirement
 
-- Перед генерацией или ревью кода навигации **коротко зафиксировать вывод** (например: «зависимости: `next` без `react-router-dom`; в коде везде `next/navigation` → используем то же») и следовать ему.  
-- **Обязательная проверка:** актуальные **`dependencies`** в `package.json` нужного workspace + **как в проекте уже реализованы** маршруты и импорты (поиск по репозиторию, соседние файлы). Не полагаться только на предположение по одному признаку (например, только на наличие папки `app/`).  
-- Если стек неочевиден (два роутера в зависимостях, гибрид) — **сверить lockfile / установленные пакеты** и **доминирующие импорты** в `src`/`app`, затем выбрать API.  
-- Для **этого** репозитория базовый ориентир — **`next-app-core.mdc`**: Next.js; предпочитать **`next/navigation`** и **`next/link`** там, где используется App Router.
+- Before generating or reviewing navigation code **briefly record the conclusion** (e.g. “dependencies: `next` without `react-router-dom`; code uses `next/navigation` everywhere → use the same”) and follow it.
+- **Mandatory check:** current **`dependencies`** in the relevant workspace `package.json` + **how routes and imports are already implemented** (repo search, neighboring files). Do not rely on a single signal alone (e.g. only the presence of an `app/` folder).
+- If the stack is unclear (two routers in dependencies, hybrid) — **cross-check lockfile / installed packages** and **dominant imports** in `src`/`app`, then choose the API.
+- For **this** repo the baseline guide is **`next-app-core.mdc`**: Next.js; prefer **`next/navigation`** and **`next/link`** where App Router is used.

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

@@ -1,16 +1,16 @@
 ---
-description: Навигация в UI-компонентах — краткий ориентир (полный аудит стека — navigation-router-stack.mdc)
+description: Navigation in UI components — short guide (full stack audit — navigation-router-stack.mdc)
 globs: app/src/ui/**/*.tsx
 alwaysApply: false
 ---
 
 # Navigation in UI components
 
-Перед ссылками, программной навигацией или работой с URL в UI:
+Before links, programmatic navigation, or URL work in 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`).
+1. **`package.json`** of the app workspace — `next` vs `react-router-dom`.
+2. **Neighboring imports** in the same feature (`next/navigation`, `next/link` vs `react-router-dom`).
+3. **Project wrappers** (`@/ui/...` Link) — preferred over raw router API.
+4. **Default (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/**`.
+Full audit (route tree, hybrids, lockfile): **`navigation-router-stack.mdc`** — when editing `app/src/app/**`.

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

@@ -1,34 +1,34 @@
 ---
-description: Базовые принципы, стек и архитектура Next.js приложения (preset)
+description: Core principles, stack, and architecture of a Next.js application (preset)
 alwaysApply: true
 ---
 
-# Стек и окружение
+# Stack and environment
 
-Конкретные версии — **из `package.json` и конфигов целевого репозитория**. Рамка preset: Next.js, React, TypeScript; runner/e2e/mocks/UI/APM — как заведено в репо.
+Concrete versions come **from `package.json` and configs of the target repository**. Preset frame: Next.js, React, TypeScript; runner/e2e/mocks/UI/APM — as established in the repo.
 
-# Структура проекта
+# Project structure
 
-- `app/` — корень Next.js; `app/src/**` — код; `app/__tests__/e2e/**` — e2e.
+- `app/` — Next.js root; `app/src/**` — code; `app/__tests__/e2e/**` — e2e.
 - `app/tsconfig.json`: `baseUrl: "."`, `paths: { "@/*": ["./src/*"] }`.
-- **Требование:** `@/*` вместо относительных импортов выше по дереву.
+- **Requirement:** `@/*` instead of relative imports that climb the tree.
 
-# Архитектурные слои
+# Architectural layers
 
-| Слой | Каталог | Детали |
-|------|---------|--------|
+| Layer | Directory | Details |
+|-------|-----------|---------|
 | 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/**` | по схеме репозитория |
+| Mocks | `app/src/mocks/**` | per repository layout |
 
-Границы слоёв, порты/адаптеры, UI→API — **`architecture-boundaries.mdc`**. Импорты `@/types`, `@/api` — **`public-imports.mdc`**.
+Layer boundaries, ports/adapters, UI→API — **`architecture-boundaries.mdc`**. Imports of `@/types`, `@/api` — **`public-imports.mdc`**.
 
-# Работа агента
+# Agent work
 
-- Архитектура и импорты: `architecture-boundaries.mdc`, `public-imports.mdc`
-- Фичи: `feature-delivery-workflow.mdc` + skill `feature-delivery`
-- После правок: **вызвать** `post-change-lint.mdc` (requestable, обязателен после code edits); менеджер пакетов: `package-manager.mdc`
-- Копировать паттерны соседних файлов в целевом слое; не использовать `any` (предпочитать `unknown` + сужение)
+- Architecture and imports: `architecture-boundaries.mdc`, `public-imports.mdc`
+- Features: `feature-delivery-workflow.mdc` + skill `feature-delivery`
+- After edits: **invoke** `post-change-lint.mdc` (requestable, required after code edits); package manager: `package-manager.mdc`
+- Copy patterns from neighboring files in the target layer; do not use `any` (prefer `unknown` + narrowing)

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

@@ -6,34 +6,34 @@ alwaysApply: false
 
 # Next.js App Router
 
-Применять при работе с `app/src/app/**` или маршрутами App Router в целевом репо.
+Apply when working with `app/src/app/**` or App Router routes in the target repo.
 
 ## Server vs Client
 
-- **Server Components по умолчанию** — без `'use client'`, если не нужны hooks, browser API, event handlers.
-- **`'use client'`** — только для интерактива, `useState`/`useEffect`, browser-only API.
-- Не тянуть store/RTK и тяжёлый client-state в Server Components без необходимости.
+- **Server Components by default** — no `'use client'` unless hooks, browser APIs, or event handlers are required.
+- **`'use client'`** — only for interactivity, `useState`/`useEffect`, and browser-only APIs.
+- Do not pull store/RTK and heavy client state into Server Components without need.
 
 ## Data fetching
 
-- Предпочитать fetch/data-loader на **server** (RSC, route handlers, server actions — по принятому в репо паттерну).
-- **Не дублировать** один запрос в RSC и client без причины.
-- Кеш и revalidate — как в существующих страницах репо (`fetch` options, `revalidate`, tags).
+- Prefer fetch/data-loader on the **server** (RSC, route handlers, server actions — per the repo’s established pattern).
+- **Do not duplicate** the same request in RSC and client without reason.
+- Cache and revalidate — match existing pages in the repo (`fetch` options, `revalidate`, tags).
 
-## Маршруты и UX
+## Routes and UX
 
-- Для async data routes **обязательны** sibling **`loading.tsx`** и **`error.tsx`** (и `not-found.tsx` где уместно) — по образцу соседних routes.
-- **Suspense** — для медленных client/server секций; fallback согласован с дизайн-системой.
-- Навигация — `navigation-router-stack.mdc` + router/link паттерны проекта.
+- For async data routes, sibling **`loading.tsx`** and **`error.tsx`** are **required** (and `not-found.tsx` where appropriate) — follow neighboring routes.
+- **Suspense** — for slow client/server sections; fallback aligned with the design system.
+- Navigation — `navigation-router-stack.mdc` + project router/link patterns.
 
-## Границы слоёв
+## Layer boundaries
 
-- RSC/route handlers **не импортируют UI-компоненты с client-only зависимостями** напрямую в server tree без `'use client'` границы.
-- Доменные типы — `@/types`; вызовы backend — через `@/api` / services, не raw `fetch` из page.tsx без слоя API.
+- RSC/route handlers **must not import UI components with client-only dependencies** directly into the server tree without a `'use client'` boundary.
+- Domain types — `@/types`; backend calls — via `@/api` / services, not raw `fetch` from `page.tsx` without an API layer.
 
 ## Anti-hallucination (App Router)
 
-Меньше угаданного кода лучше, чем больше. Сверяй API с версией Next в `package.json` и соседними routes.
+Less guessed code is better than more. Cross-check APIs against the Next version in `package.json` and neighboring routes.
 
 | ❌ Avoid | ✅ Prefer |
 |---------|----------|
@@ -45,6 +45,6 @@ alwaysApply: false
 
 See also: **`react-next-anti-hallucination`** — broader React / RTK / Next phantom-import banlist (requestable).
 
-## Эталон
+## Reference
 
-Смотри существующий route той же сложности в `app/src/app/**` и повтори структуру (`reference-features.mdc`).
+Look at an existing route of similar complexity in `app/src/app/**` and repeat its structure (`reference-features.mdc`).