@bonesofspring/ai-rules 0.2.13 → 0.2.15

package/presets/cursor/next/commands/technical-retro.md

@@ -3,82 +3,82 @@ name: technical-retro
 description: Facilitate a technical retrospective for a period, incident, release, or completed agent-team task slug.
 ---
 
-# Техническое ретро
+# Technical retrospective
 
-Агент выступает как **нейтральный фасилитатор технической ретроспективы**, а не как ревьюер кода или оценщик людей. Используй skill **`technical-retro`** как основной сценарий.
+The agent acts as a **neutral facilitator of a technical retrospective**, not as a code reviewer or people evaluator. Use skill **`technical-retro`** as the primary scenario.
 
-## Когда включать
+## When to use
 
-- Пользователь просит: «ретро», «техническое ретро», «разбор спринта/итерации», «action items после релиза».
-- После завершения пайплайна команды агентов (`/feature-start` → `/feature-continue`).
-- Есть контекст: период, тема (релиз, инцидент), slug задачи, заметки.
+- User asks: "retro", "technical retro", "sprint/iteration review", "action items after release" — also common RU phrasing: «ретро» (retro), «техническое ретро» (technical retro), «разбор спринта/итерации» (sprint/iteration review) <!-- i18n-keep: E4 -->.
+- After completing the agent-team pipeline (`/feature-start` → `/feature-continue`).
+- Context available: period, topic (release, incident), task slug, notes.
 
-## Входные данные (собрать, не выдумывать)
+## Inputs (gather; do not invent)
 
-Запросить при нехватке:
+Request when missing:
 
-- **Период и фокус**.
-- **Slug задачи** (если ретро по работе команды агентов).
-- **Участники/роли** (если важно).
-- **Ограничения**: время, формат (async vs синхрон).
+- **Period and focus**.
+- **Task slug** (if retro is about agent-team work).
+- **Participants/roles** (if relevant).
+- **Constraints**: time, format (async vs sync).
 
-### Артефакты команды агентов (если есть slug)
+### Agent-team artifacts (if slug present)
 
-Прочитать из репозитория:
+Read from the repository:
 
 - `.cursor/team/tasks/<slug>/pipeline.json`
 - `.cursor/team/tasks/<slug>/brief.md`
 - `.cursor/team/tasks/<slug>/decomposition.md`
 - `.cursor/team/tasks/<slug>/status.json`
-- Git diff / `git status` для изменённых файлов
+- Git diff / `git status` for changed files
 
-Не приписывать факты, которых нет в артефактах, diff или сообщении пользователя.
+Do not attribute facts not present in artifacts, diff, or the user's message.
 
-## Принципы фасилитации
+## Facilitation principles
 
-- **Безопасность**: процесс и система, не «виноватые».
-- **Конкретика**: от абстракций к наблюдаемым событиям.
-- **Баланс**: позитив и зоны роста.
-- **Action items**: владелец и срок у каждого.
-- **Не смешивать с code review** — развести блоки, если запросили оба.
+- **Safety**: process and system, not "blame".
+- **Specificity**: from abstractions to observable events.
+- **Balance**: positives and growth areas.
+- **Action items**: owner and deadline for each.
+- **Do not mix with code review** — separate blocks if both were requested.
 
-## Структура сессии (по умолчанию)
+## Default session structure
 
-1. **Цель и рамки**.
-2. **Сбор фактов**: хорошо / мешало / сюрпризы.
-3. **Группировка тем** (3–7).
-4. **Корневые причины** для 1–2 болезненных тем.
-5. **Эксперименты** (1–3 изменения процесса).
-6. **Action items**: что / владелец / до когда / критерий успеха.
+1. **Goal and scope**.
+2. **Fact gathering**: went well / blocked / surprises.
+3. **Theme grouping** (3–7).
+4. **Root causes** for 1–2 painful themes.
+5. **Experiments** (1–3 process changes).
+6. **Action items**: what / owner / by when / success criteria.
 
-## Блок «Работа агентов» (обязателен при slug)
+## "Agent work" block (required when slug present)
 
-Если ретро связано с пайплайном `/feature-start`:
+If retro is tied to a `/feature-start` pipeline:
 
-| Вопрос | Что фиксировать |
+| Question | What to capture |
 |--------|-----------------|
-| Router | Ошибка intent, лишние/пропущенные steps в pipeline |
-| Аналитик | Ошибки в assumptions, пропущенные AC, лишние/недостающие таски |
-| Декомпозиция | Неполное покрытие слоёв, неверный порядок, blocked-зависимости |
-| Developer | Scope creep, пропущенные правила, lint/type gaps |
-| Reviewer | Пропущенные дефекты, false positives, качество чеклиста |
-| QA | Покрытие AC тестами, flakiness, пробелы в e2e планах |
+| Router | Intent error, extra/missing pipeline steps |
+| Analyst | Assumption errors, missed AC, extra/missing tasks |
+| Decomposition | Incomplete layer coverage, wrong order, blocked dependencies |
+| Developer | Scope creep, missed rules, lint/type gaps |
+| Reviewer | Missed defects, false positives, checklist quality |
+| QA | AC test coverage, flakiness, e2e plan gaps |
 
-**Action items** в этом блоке — на улучшение **промптов, subagents и rules** (не только кода).
+**Action items** in this block — improve **prompts, subagents, and rules** (not only code).
 
-## Формат ответа
+## Response format
 
-- Шапка: период, фокус, slug (если есть), допущения.
-- Повестка по этапам.
-- Блок **«Работа агентов»** (если применимо).
-- Темы — буллеты; спорное — **вопросы команде**.
-- **Action items** в конце.
+- Header: period, focus, slug (if any), assumptions.
+- Agenda by stage.
+- **"Agent work"** block (if applicable).
+- Themes — bullets; disputed points — **questions for the team**.
+- **Action items** at the end.
 
-## Ограничения
+## Constraints
 
-- Не приписывать цитаты и факты без входа.
-- Не выдавать HR‑рекомендации.
-- Если просят только шаблон — **шаблон повестки** без выдуманного контента.
+- Do not attribute quotes or facts without input.
+- No HR recommendations.
+- If only a template is requested — **agenda template** without invented content.
 
 ### Metrics evidence
 

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

@@ -1,29 +1,29 @@
-### Разница .mdc и .md в .cursor/rules
+### Difference between .mdc and .md in .cursor/rules
 
 #### .md
-Обычный markdown‑файл. Cursor видит его как документацию/контент, но не как правило, которое нужно автоматически применять.
+Plain markdown file. Cursor treats it as documentation/content, not as a rule to apply automatically.
 
 #### .mdc
-Специальный формат Cursor Rule:
-- сверху обязателен YAML‑frontmatter с полями вроде description, globs, alwaysApply;
-- файл лежит в .cursor/rules/;
-- Cursor интерпретирует его как конфигурацию поведения ассистента для этого репо (автоматически подмешивает содержимое в контекст, когда правило подходит).
+Special Cursor Rule format:
+- YAML frontmatter at the top with fields like description, globs, alwaysApply;
+- file lives in .cursor/rules/;
+- Cursor interprets it as assistant behavior configuration for this repo (automatically merges content into context when the rule matches).
 
-- То есть .mdc = “markdown + config для Cursor”, .md = просто текст без управляющего смысла для ассистента.
+- So .mdc = "markdown + config for Cursor", .md = plain text without assistant control semantics.
 
-### С чего начать новую задачу
+### Starting a new task
 
-- **Команда агентов (рекомендуется):** `/task <описание>` — router выберет роли и порядок; при human gate — `/task-continue <slug>`. См. **`agent-team-orchestrator.mdc`** и `.cursor/team/README.md`.
+- **Agent team (recommended):** `/task <description>` — router picks roles and order; on human gate — `/task-continue <slug>`. See **`agent-team-orchestrator.mdc`** and `.cursor/team/README.md`.
 - **Legacy:** `/feature-start` → `/feature-continue`.
-- **Сквозной чеклист слоёв (для developer):** **`feature-delivery-workflow.mdc`**.
+- **End-to-end layer checklist (for developer):** **`feature-delivery-workflow.mdc`**.
 
 ### Loading strategy
 
-- **`alwaysApply: true`** (Cursor) / **без `paths:`** (Claude) — только базовые инварианты (**3**):
+- **`alwaysApply: true`** (Cursor) / **without `paths:`** (Claude) — only base invariants (**3**):
   - `next-app-core`, `package-manager`, `code-quality-and-refactoring`
-- **On-demand / requestable** — `post-change-lint` (**обязателен после правок кода**, не always-on), `agent-team-intake` (через orchestrator/commands), `agent-team-orchestrator`, architecture, imports, UI, tests, feature-delivery-workflow, `design-guidance`, `anti-sycophancy-discipline`, `react-next-anti-hallucination`, reference-features, next-app-router, `security-next`, react-a11y-coding, `technical-retro`
+- **On-demand / requestable** — `post-change-lint` (**required after code edits**, not always-on), `agent-team-intake` (via orchestrator/commands), `agent-team-orchestrator`, architecture, imports, UI, tests, feature-delivery-workflow, `design-guidance`, `anti-sycophancy-discipline`, `react-next-anti-hallucination`, reference-features, next-app-router, `security-next`, react-a11y-coding, `technical-retro`
 - **Preset author meta** (globs `packages/ai-rules/presets/**`, never alwaysApply): `preset-layering`, `preset-twin-sync`, `preset-token-budget`, `preset-pr-checklist`, `preset-no-cross-stack-leakage`
-- **Skills** — длинные процедуры (`feature-delivery`, `code-review`, …)
+- **Skills** — long procedures (`feature-delivery`, `code-review`, …)
 
 ### Shared core → stack mapping
 
@@ -46,60 +46,60 @@ Claude twins + Cursor→Claude map: `presets/claude/next/rules/README.md`.
 
 ### UI edit bundle (consolidated globs)
 
-При правке `app/src/ui/**/*.tsx` подгружается **уменьшенный** набор (не весь `app/src/**`):
+When editing `app/src/ui/**/*.tsx`, a **reduced** set loads (not all of `app/src/**`):
 
-| Rule | Globs | Назначение |
-|------|-------|------------|
-| `react-ui.mdc` | `app/src/ui/**` | Структура, стили, пропсы |
-| `architecture-boundaries-ui.mdc` | `app/src/ui/**` | Slim границы UI-слоя |
+| Rule | Globs | Purpose |
+|------|-------|---------|
+| `react-ui.mdc` | `app/src/ui/**` | Structure, styles, props |
+| `architecture-boundaries-ui.mdc` | `app/src/ui/**` | Slim UI layer boundaries |
 | `react-a11y-coding.mdc` | `app/src/ui/**` | A11y |
-| `navigation-router-ui.mdc` | `app/src/ui/**/*.tsx` | Краткий ориентир навигации |
-| `no-props-spread.mdc` | `app/src/**/*.tsx` | Явные пропсы |
-| `arrow-functions.mdc` | `app/src/**` | Синтаксис |
+| `navigation-router-ui.mdc` | `app/src/ui/**/*.tsx` | Brief navigation guide |
+| `no-props-spread.mdc` | `app/src/**/*.tsx` | Explicit props |
+| `arrow-functions.mdc` | `app/src/**` | Syntax |
 
-**Не грузятся на типичный UI edit:** `architecture-boundaries` (api/store/types/lib), `layer-barrel-exports` (только `index.ts`), `navigation-router-stack` (только `app/src/app/**`). Стили колокации — в `react-ui.mdc` (deprecated stub `no-cross-component-styles-import` removed).
+**Not loaded on typical UI edit:** `architecture-boundaries` (api/store/types/lib), `layer-barrel-exports` (only `index.ts`), `navigation-router-stack` (only `app/src/app/**`). Colocated styles — in `react-ui.mdc` (deprecated stub `no-cross-component-styles-import` removed).
 
-`css-property-order-stylelint.mdc` — только на `styles.ts` / `.css`.
+`css-property-order-stylelint.mdc` — only on `styles.ts` / `.css`.
 
-### Эталонные фичи
+### Reference features
 
-Заполните **`reference-features.mdc`** (TBD → реальные пути) после `init` в целевом репо.
+Fill **`reference-features.mdc`** (TBD → real paths) after `init` in the target repo.
 
-### Каталог ключевых правил
+### Key rules catalog
 
-| Файл | Назначение |
-|------|------------|
-| `reference-features.mdc` | Эталонные пути UI/store/API/types/tests |
+| File | Purpose |
+|------|---------|
+| `reference-features.mdc` | Reference paths UI/store/API/types/tests |
 | `next-app-router.mdc` | App Router, RSC, loading/error, focused anti-hallucination banlist |
 | `react-next-anti-hallucination.mdc` | Requestable Next/React/RTK phantom-import banlist (≥15 ❌/✅ rows) |
 | `security-next.mdc` | Secrets, auth, XSS, Server Actions (coding-time) |
-| `react-a11y-coding.mdc` | A11y при написании UI |
-| `feature-delivery-workflow.mdc` | Сквозной чеклист (on-demand, не always-on) |
-| `agent-team-intake.mdc` | Подсказка `/task` при work-запросе (on-demand, через orchestrator) |
-| `package-manager.mdc` | Перед `install` / `run` в терминале определить менеджер пакетов репо (lockfile, `packageManager`) и использовать только его |
+| `react-a11y-coding.mdc` | A11y when writing UI |
+| `feature-delivery-workflow.mdc` | End-to-end checklist (on-demand, not always-on) |
+| `agent-team-intake.mdc` | `/task` hint on work requests (on-demand, via orchestrator) |
+| `package-manager.mdc` | Before `install` / `run` in terminal, detect repo package manager (lockfile, `packageManager`) and use only that |
 | `agent-team-orchestrator.mdc` | `/task`, router, `pipeline.json`, build-verifier, parallel steps |
-| `preset-pr-checklist.mdc` (+ sibling `preset-*`) | Чеклист PR авторов пресетов (twin, budget, leakage) |
-| `next-app-core.mdc` | Стек, слои, карта каталогов (alwaysApply) |
-| `post-change-lint.mdc` | Прогон ESLint + Stylelint после изменений кода (**requestable**, обязателен после code edits) |
-| `architecture-boundaries-ui.mdc` | Slim границы UI при правках компонентов |
-| `architecture-boundaries.mdc` | Полная карта UI / store / API (api, store, types, lib) |
-| `navigation-router-ui.mdc` | Навигация в UI-компонентах (slim) |
-| `navigation-router-stack.mdc` | Полный аудит стека навигации (App Router / SPA) |
-| `http-client.mdc` | Один HTTP‑стек, контракты из `@/types`, без разбросанного низкоуровневого API |
-| `api-services.mdc` | Сервисы, мапперы, вызовы через прикладные API‑клиенты |
-| `store-rtk.mdc` | Redux Toolkit, thunk’и, типизация ошибок/ответов как в коде репо |
-| `public-imports.mdc` | Импорты `@/types`, `@/types/enums`, `@/api` (вне `app/src/api/**`) |
-| `layer-barrel-exports.mdc` | Двухуровневые barrel для слоёв с public API (`@/api`, `@/types`, `@/core`, …) |
-| `types-jsdoc.mdc` | JSDoc для типов в `app/src/types` (русский текст, `[computed]`, без `@param`/`@returns`) |
-| `no-type-assertion-as-import-export.mdc` | Ограничение `as`, в т.ч. `instanceof` для ошибок транспорта в `catch` |
-| `code-review-mr.mdc` | Чеклист ревью MR + output contract (`path:line`, severity, verdict) |
-| `tests-unit.mdc` | Unit‑тесты и behavior‑тесты HTTP‑клиента |
+| `preset-pr-checklist.mdc` (+ sibling `preset-*`) | Preset author PR checklist (twin, budget, leakage) |
+| `next-app-core.mdc` | Stack, layers, directory map (alwaysApply) |
+| `post-change-lint.mdc` | ESLint + Stylelint after code changes (**requestable**, required after code edits) |
+| `architecture-boundaries-ui.mdc` | Slim UI boundaries when editing components |
+| `architecture-boundaries.mdc` | Full UI / store / API map (api, store, types, lib) |
+| `navigation-router-ui.mdc` | Navigation in UI components (slim) |
+| `navigation-router-stack.mdc` | Full stack navigation audit (App Router / SPA) |
+| `http-client.mdc` | Single HTTP stack, contracts from `@/types`, no scattered low-level API |
+| `api-services.mdc` | Services, mappers, calls via application API clients |
+| `store-rtk.mdc` | Redux Toolkit, thunks, error/response typing as in repo code |
+| `public-imports.mdc` | Imports `@/types`, `@/types/enums`, `@/api` (outside `app/src/api/**`) |
+| `layer-barrel-exports.mdc` | Two-level barrels for layers with public API (`@/api`, `@/types`, `@/core`, …) |
+| `types-jsdoc.mdc` | JSDoc for types in `app/src/types` (locale text per project, `[computed]`, no `@param`/`@returns`) |
+| `no-type-assertion-as-import-export.mdc` | Limit `as`, including `instanceof` for transport errors in `catch` |
+| `code-review-mr.mdc` | MR review checklist + output contract (`path:line`, severity, verdict) |
+| `tests-unit.mdc` | Unit tests and HTTP client behavior tests |
 | `playwright-agents.mdc`, `tests-e2e-structure.mdc` | E2E |
-| `react-ui.mdc` | React/Next UI: структура компонентов, соседние `ComponentName.data.ts` / `.utils.ts`, стили, пропсы |
+| `react-ui.mdc` | React/Next UI: component structure, adjacent `ComponentName.data.ts` / `.utils.ts`, styles, props |
 
-**Коллизии формулировок:** импорт типов и API — источник правды **`public-imports.mdc`**; дублирует ESLint `no-restricted-imports` в `app/eslint.config.mjs`.
+**Wording collisions:** type and API imports — source of truth **`public-imports.mdc`**; duplicates ESLint `no-restricted-imports` in `app/eslint.config.mjs`.
 
-Задачи на **сеть, замену HTTP‑библиотеки, новые эндпоинты**: опираться на **`http-client.mdc`** + **`api-services.mdc`** + **`store-rtk.mdc`**.
+Tasks involving **network, HTTP library replacement, new endpoints**: rely on **`http-client.mdc`** + **`api-services.mdc`** + **`store-rtk.mdc`**.
 
 ## Metrics policy mapping
 

package/presets/cursor/next/rules/agent-team-intake.mdc

@@ -11,6 +11,6 @@ When the user message looks like a **work request** (implement, add, fix, refact
 
 1. Prefer **`/task <their request>`** or invoke **task-router** first.
 2. Do not jump straight to coding without router + pipeline when scope is non-trivial.
-3. Pure questions («как работает X», «объясни») — prefer agent **`codebase-analyzer`** (explain-as-is); trivial one-liners may be answered inline. Do not open `/task`.
+3. Pure questions (“how does X work”, “explain”) — prefer agent **`codebase-analyzer`** (explain-as-is); trivial one-liners may be answered inline. Do not open `/task`.
 
-Exceptions: user explicitly says «без pipeline», «просто сделай», or continues an active slug.
+Exceptions: user explicitly says “no pipeline”, “just do it”, or continues an active slug.

package/presets/cursor/next/rules/agent-team-orchestrator.mdc

@@ -9,7 +9,7 @@ alwaysApply: false
 
 Parent agent = **manager**. Router plans; specialists execute. Artifacts: `.cursor/team/tasks/<slug>/`.
 
-Work request без `/task` — см. **`agent-team-intake.mdc`** (когда предлагать router вместо прямого кодинга).
+Work request without `/task` — see **`agent-team-intake.mdc`** (when to suggest the router instead of coding directly).
 
 ## Entry points
 
@@ -180,12 +180,12 @@ If `pipeline.json` is missing (old `/feature-start` tasks), fall back to fixed p
 
 Do **not** run `/task` + router for:
 
-- Pure questions («как работает X», «объясни») — prefer agent **`codebase-analyzer`** for deep traces; inline OK for trivial one-liners.
+- Pure questions («как работает X» (how does X work), «объясни» (explain)) — prefer agent **`codebase-analyzer`** for deep traces; inline OK for trivial one-liners. <!-- i18n-keep: E4 -->
 - Typo / one-file fix / trivial config with no architecture risk.
-- User explicitly says «без pipeline», «просто сделай», or continues an active slug.
+- User explicitly says «без pipeline» (no pipeline), «просто сделай» (just do it), or continues an active slug. <!-- i18n-keep: E4 -->
 - Single-line `docs-only` with no code impact.
 
-Borderline work requests — см. **`agent-team-intake.mdc`**.
+Borderline work requests — see **`agent-team-intake.mdc`**.
 
 ## Auto-detection (optional)
 

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

@@ -1,61 +1,61 @@
 ---
-description: Конвенции API сервисов и мапперов
+description: API services and mapper conventions
 globs: app/src/api/services/**/*.ts
 alwaysApply: false
 impact: HIGH
 ---
 
-# Роль API слоя
+# Role of the API layer
 
-- Инкапсулировать всё, что связано с:
-  - HTTP‑запросами через **экземпляры прикладных API‑клиентов** в `app/src/api/clients/**`, собранные на **общей реализации** из `app/src/lib/clients/**` (как в существующем коде); подробности — **`http-client.mdc`**; положение слоя в схеме **порты и адаптеры** — `architecture-boundaries.mdc`;
-  - URL/путями,
-  - заголовками и кодами ответов,
-  - DTO backend.
-- Предоставлять UI и store **стабильный доменный интерфейс**:
-  - функции, работающие с доменными типами из `@/types` (`public-imports.mdc`).
-  - мапперы между DTO и доменными типами.
+- Encapsulate everything related to:
+  - HTTP requests through **application API client instances** in `app/src/api/clients/**`, built on the **shared implementation** from `app/src/lib/clients/**` (as in existing code); details — **`http-client.mdc`**; layer placement in the **ports and adapters** scheme — `architecture-boundaries.mdc`;
+  - URLs/paths,
+  - headers and response codes,
+  - backend DTOs.
+- Provide UI and store with a **stable domain interface**:
+  - functions that work with domain types from `@/types` (`public-imports.mdc`).
+  - mappers between DTOs and domain types.
 
-# Структура модулей
+# Module structure
 
-- Для каждой доменной области (например, заказы, биллинг, настройки аккаунта):
-  - отдельный каталог в `app/src/api/services/<ИмяСервиса или фичи>/**` по конвенции репозитория.
-- Внутри модуля:
-  - файлы с вызовами API (`index.ts` или `*.service.ts`);
-  - файлы мапперов (`*responseMappers.ts`);
-  - специфичные типы запросов/ответов (если не вынесены в `app/src/types/**` с экспортом через barrel `@/types`).
-  - при необходимости — локальные `index.ts` / barrel внутри модуля для структуры **внутри** `app/src/api/**`; **снаружи** этого слоя UI, store и остальной код импортируют только из корневого barrel `app/src/api/index.ts` (`import … from '@/api'`, **`public-imports.mdc`**).
+- For each domain area (for example, orders, billing, account settings):
+  - a separate directory in `app/src/api/services/<ServiceName or feature>/**` following repository convention.
+- Inside a module:
+  - files with API calls (`index.ts` or `*.service.ts`);
+  - mapper files (`*responseMappers.ts`);
+  - request/response-specific types (if not moved to `app/src/types/**` with export through the `@/types` barrel).
+  - when needed — local `index.ts` / barrel inside the module for structure **within** `app/src/api/**`; **outside** this layer UI, store, and other code import only from the root barrel `app/src/api/index.ts` (`import … from '@/api'`, **`public-imports.mdc`**).
 
-# Мапперы и типы
+# Mappers and types
 
-- Для каждого запроса/эндпоинта:
-  - описывать **response‑тип (DTO)**, точно соответствующий контракту backend;
-  - определять **целевой доменный тип** в `app/src/types/**`, с которым будет работать приложение (включая вычисляемые/агрегированные поля).
-- Мапперы (например, `*responseMappers.ts`):
-  - чистые функции, без сайд‑эффектов;
-  - выполняют все необходимые вычисления и преобразования данных (булевы флаги, склейка строк, агрегаты и т.п.) при переводе из DTO в доменные модели;
-  - при необходимости обеспечивают обратное преобразование (доменные модели -> транспортные типы).
-- UI и store работают только с доменными типами (из `@/types` или экспортируемыми из public API слоя API), а не с "сырыми" DTO.
-- **Не вызывать `fetch` напрямую** в теле API‑методов: только через клиент; исключения — узкие модули (например JSON‑RPC), если так уже устроено в репозитории.
+- For each request/endpoint:
+  - describe the **response type (DTO)** that exactly matches the backend contract;
+  - define the **target domain type** in `app/src/types/**` that the application will use (including computed/aggregated fields).
+- Mappers (for example, `*responseMappers.ts`):
+  - pure functions, no side effects;
+  - perform all necessary data computations and transformations (boolean flags, string concatenation, aggregates, etc.) when converting from DTO to domain models;
+  - when needed, provide reverse conversion (domain models → transport types).
+- UI and store work only with domain types (from `@/types` or exported from the API layer public API), not with "raw" DTOs.
+- **Do not call `fetch` directly** in API method bodies: only through the client; exceptions — narrow modules (for example JSON-RPC), if that is how the repository is already structured.
 
-# Обработка ошибок
+# Error handling
 
-- API‑слой:
-  - не должен "глотать" ошибки без следа;
-  - либо бросает доменные/унифицированные ошибки;
-  - либо возвращает результат в `Result<T, E>`‑подобной форме (если такой паттерн принят в проекте).
-- Интеграция с APM/трассировкой (если есть в проекте):
-  - централизованно (HTTP‑клиент, обёртки), а не в каждом методе сервиса.
+- The API layer:
+  - must not "swallow" errors without a trace;
+  - either throws domain/unified errors;
+  - or returns a result in a `Result<T, E>`-like form (if that pattern is adopted in the project).
+- APM/tracing integration (if present in the project):
+  - centrally (HTTP client, wrappers), not in every service method.
 
-# Требование к агенту
+# Agent requirement
 
-При добавлении/изменении API‑метода:
-- Следовать существующим сервисам и мапперам как эталону.
-- Пройти чеклист barrel-экспортов (**`layer-barrel-exports.mdc`**): локальный `index.ts` → фасад слоя → корневой barrel.
-- Не смешивать слой API и UI/store:
-  - компоненты не должны зависеть от DTO;
-  - store не должен сам собирать URL/коды эндпоинтов и не обходить сервисы; **транспортный тип ответа** и **контракт ошибки** из `@/types` (как у прикладного клиента) допустимы во thunk при разборе `catch`/payload, если так выстроен сервис (см. `store-rtk.mdc`, `http-client.mdc`).
-- При использовании API‑сервисов в UI, store и утилитах **вне** `app/src/api/**` импортировать **только** из `@/api` (корневой barrel), см. **`public-imports.mdc`**; внутри слоя API — по относительным путям или `@/api/services/**` / `@/api/clients/**`, не дублируя публичный контракт мимо корневого barrel для внешних потребителей.
+When adding/changing an API method:
+- Follow existing services and mappers as the reference.
+- Complete the barrel-export checklist (**`layer-barrel-exports.mdc`**): local `index.ts` → layer facade → root barrel.
+- Do not mix the API layer and UI/store:
+  - components must not depend on DTOs;
+  - store must not assemble URLs/endpoint codes itself or bypass services; **transport response type** and **error contract** from `@/types` (as with the application client) are acceptable in thunks when parsing `catch`/payload, if the service is structured that way (see `store-rtk.mdc`, `http-client.mdc`).
+- When using API services in UI, store, and utilities **outside** `app/src/api/**`, import **only** from `@/api` (root barrel), see **`public-imports.mdc`**; inside the API layer — via relative paths or `@/api/services/**` / `@/api/clients/**`, without duplicating the public contract around the root barrel for external consumers.
 ## Incorrect
 
 ```ts

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

@@ -1,15 +1,15 @@
 ---
-description: Границы слоя UI — slim rule для правок компонентов (без полной карты store/API)
+description: UI layer boundaries — slim rule for component edits (without the full store/API map)
 globs: app/src/ui/**/*.tsx,app/src/ui/**/*.ts
 alwaysApply: false
 ---
 
 # UI layer boundaries (slim)
 
-- **Импорты:** `@/ui/**`, `@/store/**`, типы из `@/types` и enum из `@/types/enums`, API — только `from '@/api'` (`public-imports.mdc`).
-- **Запрещено:** прямой HTTP‑клиент; знание DTO — только доменные типы.
-- **Состояние:** сценарии с записью и координация шагов — через store/thunk; узкие прямые вызовы `@/api` для чтения — только как в соседних фичах.
-- **Организация:** алиас `@/`; без deep‑импортов в чужие фичи; только public API.
-- **Barrel:** при новых публичных символах — реэкспорт по `layer-barrel-exports.mdc` (правило грузится на `index.ts`).
+- **Imports:** `@/ui/**`, `@/store/**`, types from `@/types` and enums from `@/types/enums`, API — only `from '@/api'` (`public-imports.mdc`).
+- **Forbidden:** direct HTTP client; DTO knowledge — domain types only.
+- **State:** write scenarios and multi-step coordination — via store/thunk; narrow direct `@/api` reads — only as in neighboring features.
+- **Organization:** `@/` alias; no deep imports into other features; public API only.
+- **Barrel:** for new public symbols — re-export per `layer-barrel-exports.mdc` (rule loads on `index.ts`).
 
-Полная карта слоёв (store, API, порты‑адаптеры): **`architecture-boundaries.mdc`** — при правках `app/src/api`, `store`, `types`, `lib`.
+Full layer map (store, API, ports/adapters): **`architecture-boundaries.mdc`** — when editing `app/src/api`, `store`, `types`, `lib`.