@bonesofspring/ai-rules 0.2.14 → 0.2.15

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

@@ -1,5 +1,5 @@
 ---
-description: Избегать приведения типов через as на границах модулей (импорт/экспорт)
+description: Avoid type assertions via as at module boundaries (import/export)
 globs:
   - api/**/*
   - stores/**/*
@@ -7,54 +7,54 @@ globs:
 alwaysApply: false
 ---
 
-# Не использовать `as` для приведения типов при экспорте и импорте (кроме необходимых случаев)
+# Do not use `as` for type assertion on export and import (except necessary cases)
 
-## О чём речь
+## What this is about
 
-Речь о **type assertion** в TypeScript: выражение вида `значение as Тип`.
+This is about TypeScript **type assertion**: expressions like `value as Type`.
 
-**Не относится к правилу** (это не assertion, а синтаксис модулей):
+**Not covered by this rule** (not assertion — module syntax):
 
-- переименование при экспорте: `export { foo as bar }`, `export { default as Baz } from '...'`;
-- переименование при импорте: `import { foo as bar } from '...'`;
-- `import type { Foo as Bar }` — алиас типа в импорте типов.
+- rename on export: `export { foo as bar }`, `export { default as Baz } from '...'`;
+- rename on import: `import { foo as bar } from '...'`;
+- `import type { Foo as Bar }` — type alias in a type import.
 
-## Требование
+## Requirement
 
-- На **публичной границе модуля** (то, что **экспортируется** из файла / barrel, и то, что сразу **присваивается импортированным символам** с принудительным приведением) **не использовать** `as Тип` для «подгонки» типов, если можно обойтись нормальной типизацией.
+- On the **public module boundary** (what is **exported** from a file / barrel, and what is immediately **assigned from imported symbols** with a forced cast) **do not use** `as Type` to “force-fit” types when normal typing would work.
 
-## Предпочитать вместо `as`
+## Prefer instead of `as`
 
-- явную аннотацию: `const x: T = ...` / `function f(): T`;
-- **дженерики** у функций и классов;
-- **`satisfies`** (когда нужно проверить совместимость без сужения до `any`);
-- сужение **`unknown`** после проверки (type guards, `zod` и т.п.);
-- правку **исходных типов/DTO/мапперов**, а не assertion на выходе.
+- an explicit annotation: `const x: T = ...` / `function f(): T`;
+- **generics** on functions and classes;
+- **`satisfies`** (when you need to check compatibility without narrowing to `any`);
+- narrowing **`unknown`** after checks (type guards, `zod`, etc.);
+- fixing **source types/DTOs/mappers**, not an assertion on the way out.
 
-## Когда `as` допустим
+## When `as` is allowed
 
-- взаимодействие с **не типизированными** или некорректно типизированными внешними модулями, где нет разумной альтернативы;
-- узкие места после **валидации** данных, если типовый гард всё ещё не выразить без шума (предпочтительно всё же guard/`satisfies`);
-- **`as const`** — когда нужны литеральные типы и широкий вывод ломает контракт (это отдельный механизм; применять по делу, не как замену типизации API).
-- блок **`catch (error)`** после вызова HTTP через общий клиент: по возможности сужать через **`instanceof`** на **класс ошибки транспорта** из `@/types` (какой именно — по существующей реализации) и работать с уже суженным типом; голый **`as` к тому же типу** — только если `instanceof` недоступен (иной источник выброса) и осознанно.
+- interaction with **untyped** or incorrectly typed external modules where there is no reasonable alternative;
+- narrow spots after **validation**, if a type guard still cannot be expressed without noise (prefer guard/`satisfies` anyway);
+- **`as const`** — when literal types are needed and wide inference breaks the contract (a separate mechanism; use on purpose, not as a substitute for API typing).
+- a **`catch (error)`** block after HTTP via the shared client: prefer narrowing with **`instanceof`** on the **transport error class** from `@/types` (which one — follow the existing implementation) and work with the narrowed type; bare **`as` to the same type** — only if `instanceof` is unavailable (different throw source) and deliberately.
 
-## Примеры
+## Examples
 
 ```typescript
-// ❌ Плохо: assertion на экспортируемом API
+// ❌ Bad: assertion on exported API
 export const config = loadRaw() as AppConfig
 
-// ✅ Лучше: аннотация + проверка или маппер
+// ✅ Better: annotation + check or mapper
 export const config: AppConfig = mapToAppConfig(loadRaw())
 
-// ❌ Плохо: сразу после импорта «ломаем» тип
+// ❌ Bad: immediately after import we “break” the type
 import { getData } from './api'
 export const data = getData() as MyDto[]
 
-// ✅ Лучше: типизировать getData / обернуть типобезопасной функцией
+// ✅ Better: type getData / wrap with a type-safe function
 ```
 
-## Требование к агенту
+## Agent requirement
 
-При ревью и генерации кода **не добавлять** новые `as Тип` на экспортируемые сущности и на цепочку import → export без явной необходимости; по возможности исправлять контракт типов в источнике.
-- В слайсах и сервисах при обработке ошибок API сначала рассматривать **`instanceof`** на класс ошибки транспорта из `@/types` по образцу существующего кода (`http-client.mdc`, `store-pinia.mdc`).
+On review and code generation **do not add** new `as Type` on exported entities and on the import → export chain without clear need; when possible fix the type contract at the source.
+- In stores and services when handling API errors, first consider **`instanceof`** on the transport error class from `@/types` following existing code (`http-client.mdc`, `store-pinia.mdc`).

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

@@ -1,16 +1,16 @@
 ---
-description: Базовые принципы, стек и архитектура Nuxt 3 приложения (preset)
+description: Baseline principles, stack, and architecture for a Nuxt 3 application (preset)
 alwaysApply: true
 ---
 
-# Стек и окружение
+# Stack and environment
 
-Конкретные версии — **из `package.json` и конфигов целевого репозитория**. Рамка preset: Nuxt 3, Vue 3, TypeScript; runner/e2e/mocks/UI/APM — как заведено в репо.
+Concrete versions — **from `package.json` and configs of the target repository**. Preset frame: Nuxt 3, Vue 3, TypeScript; runner/e2e/mocks/UI/APM — as established in the repo.
 
-# Структура проекта
+# Project structure
 
-| Путь | Назначение |
-|------|------------|
+| Path | Purpose |
+|------|---------|
 | `pages/**` | File-based routes |
 | `components/**` | UI components (SFC) |
 | `composables/**` | Vue `use*` facades |
@@ -21,12 +21,12 @@ alwaysApply: true
 | `types/**` | Domain types (barrel) |
 | `tests/e2e/**` | Playwright e2e |
 
-**Aliases:** prefer `~/`, accept `@/`, respect `#imports` (не изобретать auto-import символы). Scripts cwd — **корень репозитория** (где `nuxt.config.*`), не Next-обёртка `app/`.
+**Aliases:** prefer `~/`, accept `@/`, respect `#imports` (do not invent auto-import symbols). Scripts cwd — **repository root** (where `nuxt.config.*` lives), not a Next-style `app/` wrapper.
 
-# Архитектурные слои
+# Architectural layers
 
-| Слой | Каталог | Детали |
-|------|---------|--------|
+| Layer | Directory | Details |
+|-------|-----------|---------|
 | UI | `pages/**`, `components/**`, `layouts/**` | `vue-ui`, `architecture-boundaries-ui` |
 | Composables | `composables/**` | thin orchestration; no raw HTTP |
 | Store | `stores/**` | `store-pinia` — `defineStore` only |
@@ -35,11 +35,11 @@ alwaysApply: true
 | Server | `server/api/**` | `security-nuxt`; not a substitute for `api/**` |
 | Types | `types/**` | `public-imports`, `types-jsdoc` |
 
-Границы — **`architecture-boundaries`**. Импорты `~/types` / `@/types`, `~/api` / `@/api` — **`public-imports`**. **Запрещено:** RTK / `store-rtk`, React/RSC defaults, пути `app/src/**` как канон.
+Boundaries — **`architecture-boundaries`**. Imports `~/types` / `@/types`, `~/api` / `@/api` — **`public-imports`**. **Forbidden:** RTK / `store-rtk`, React/RSC defaults, `app/src/**` paths as the canon.
 
-# Работа агента
+# Agent work
 
-- Архитектура и импорты: `architecture-boundaries`, `public-imports`
-- Фичи: `feature-delivery-workflow` + skill `feature-delivery`
-- После правок: **вызвать** `post-change-lint` (requestable); менеджер пакетов: `package-manager`
-- Копировать паттерны соседей; предпочитать `unknown` вместо `any`
+- Architecture and imports: `architecture-boundaries`, `public-imports`
+- Features: `feature-delivery-workflow` + skill `feature-delivery`
+- After edits: **invoke** `post-change-lint` (requestable); package manager: `package-manager`
+- Copy neighbor patterns; prefer `unknown` over `any`

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

@@ -1,18 +1,18 @@
 ---
-description: Перед командами в терминале определять менеджер пакетов репозитория и использовать только его
+description: Before terminal commands, detect the repository package manager and use only that one
 alwaysApply: true
 ---
 
-# Менеджер пакетов (терминал)
+# Package manager (terminal)
 
-Перед **`npm install` / `yarn` / `pnpm` / `bun`** и **`… run …`** определи менеджер репозитория и **используй только его**.
+Before **`npm install` / `yarn` / `pnpm` / `bun`** and **`… run …`**, detect the repository package manager and **use only that one**.
 
-## Как определить
+## How to detect
 
-1. **`packageManager`** в `package.json` (корень репозитория; в монорепо — workspace root, где живут scripts / `nuxt.config.*`).
-2. **Lockfile** рядом: `yarn.lock` → yarn; `pnpm-lock.yaml` → pnpm; `package-lock.json` → npm; `bun.lock(b)` → bun.
-3. Если неоднозначно — где `node_modules` и какой lockfile в CI.
+1. **`packageManager`** in `package.json` (repository root; in a monorepo — the workspace root where scripts / `nuxt.config.*` live).
+2. **Lockfile** nearby: `yarn.lock` → yarn; `pnpm-lock.yaml` → pnpm; `package-lock.json` → npm; `bun.lock(b)` → bun.
+3. If ambiguous — where `node_modules` lives and which lockfile CI uses.
 
 ## Stack notes
 
-Рабочий каталог для scripts — **корень репозитория** (каталог с `nuxt.config.*`), **не** Next `app/`. Примеры: `yarn lint:js`, `pnpm run typecheck`. Не угадывай — проверь файлы.
+Working directory for scripts — **repository root** (directory with `nuxt.config.*`), **not** Next `app/`. Examples: `yarn lint:js`, `pnpm run typecheck`. Do not guess — check the files.

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

@@ -1,42 +1,42 @@
 ---
-description: Прогон ESLint и Stylelint после изменений кода. Requestable — подгружать после правок pages/components/stores/api/**; агенты обязаны запускать после code edits.
+description: Run ESLint and Stylelint after code changes. Requestable — load after edits under pages/components/stores/api/**; agents must run after code edits.
 alwaysApply: false
 ---
 
-# Линтеры после изменений кода
+# Linters after code changes
 
-**Requestable, но обязателен при изменениях кода:** правило не always-on (экономия контекста); после правок исходников агент **должен** следовать этому чеклисту.
+**Requestable, but required on code changes:** the rule is not always-on (context savings); after source edits the agent **must** follow this checklist.
 
-## Когда применять
+## When to apply
 
-После **любого** изменения исходников в `pages/**`, `components/**`, `composables/**`, `stores/**`, `api/**`, `lib/**`, `server/**`, `types/**`, `layouts/**`, `middleware/**` (Vue/TS/JS, CSS, scoped/CSS modules).
+After **any** source change under `pages/**`, `components/**`, `composables/**`, `stores/**`, `api/**`, `lib/**`, `server/**`, `types/**`, `layouts/**`, `middleware/**` (Vue/TS/JS, CSS, scoped/CSS modules).
 
-Исключения: правки документации, конфигов CI, `.cursor/rules/**`, если исполняемый код приложения не менялся.
+Exceptions: docs, CI configs, `.cursor/rules/**`, when application executable code did not change.
 
-**Pipeline exception:** если задача идёт через agent team и следующий шаг — `build-verifier`, developer может ограничиться lint/typecheck **изменённых файлов**; полный прогон — обязанность `build-verifier`. В single-agent режиме (без pipeline) — всегда полный прогон.
+**Pipeline exception:** if the task goes through the agent team and the next step is `build-verifier`, the developer may limit lint/typecheck to **changed files**; the full run is `build-verifier`’s duty. In single-agent mode (no pipeline) — always a full run.
 
-## Обязательные команды
+## Required commands
 
-Рабочий каталог — **корень репозитория** (где `nuxt.config.*`). Менеджер пакетов — **`package-manager`**.
+Working directory — **repository root** (where `nuxt.config.*` lives). Package manager — **`package-manager`**.
 
-1. **`lint:js`** — полный ESLint по проекту.
-2. **`lint:css`** — полный Stylelint.
+1. **`lint:js`** — full project ESLint.
+2. **`lint:css`** — full Stylelint.
 
-Точечный lint на один файл **не заменяет** полный прогон перед завершением задачи (кроме pipeline exception выше).
+Point lint on a single file **does not replace** a full run before finishing the task (except the pipeline exception above).
 
-## Алгоритм
+## Algorithm
 
-1. Завершить правки кода.
-2. Запустить **`lint:js`** и **`lint:css`** из корня репозитория.
-3. Проанализировать весь вывод; исправить errors/warnings в изменённых файлах; для Stylelint — autofix если доступен.
-4. Повторить до exit code 0 или зафиксировать блокер в ответе пользователю.
-5. **`typecheck`** (`nuxt typecheck`) при изменениях TypeScript / Vue SFC. CI-уровень: **`lint`** (= `lint:js` + `lint:css` + `typecheck`).
+1. Finish code edits.
+2. Run **`lint:js`** and **`lint:css`** from the repository root.
+3. Analyze the full output; fix errors/warnings in changed files; for Stylelint — autofix if available.
+4. Repeat until exit code 0 or record a blocker in the user reply.
+5. **`typecheck`** (`nuxt typecheck`) when TypeScript / Vue SFC changed. CI-level: **`lint`** (= `lint:js` + `lint:css` + `typecheck`).
 
-**Имя скрипта type gate — `typecheck`**, не next-овский `type-check`.
+**Type gate script name is `typecheck`**, not Next’s `type-check`.
 
-## Что исправлять
+## What to fix
 
-- **Errors** — обязательно.
-- **Warnings** — обязательно в файлах задачи; вне скоупа — упомянуть, если мешают нулевому exit code.
+- **Errors** — required.
+- **Warnings** — required in task files; outside scope — mention if they block a zero exit code.
 
-Конфиги: `eslint.config.mjs` / `.eslintrc*`, `.stylelintrc*` (порядок CSS — `css-property-order-stylelint`).
+Configs: `eslint.config.js` / `eslint.config.mjs` / `.eslintrc*`, `.stylelintrc*` (CSS property order — `css-property-order-stylelint`).

package/presets/cursor/nuxt/rules/preset-layering.mdc

@@ -9,29 +9,28 @@ alwaysApply: false
 
 <!-- shared-core: meta/preset-layering.md -->
 
-
 # Preset layering
 
-Правила для **авторов пресетов** (`packages/ai-rules/presets/**`). Не always-on в consumer apps.
+Rules for **preset authors** (`packages/ai-rules/presets/**`). Not always-on in consumer apps.
 
-## Слои
+## Layers
 
-| Слой | Где | Что класть |
-|------|-----|------------|
-| **Core** | `presets/_shared/core/**` | Stack-agnostic prose + checklists; без frontmatter; без путей `app/**`, `Features/**`, Playwright, xcodebuild |
-| **Stack** | `presets/{cursor\|claude}/<stack>/` | Domain/tooling, always-on trio стека, stack examples в **Stack notes** |
+| Layer | Where | What to put |
+|-------|-------|-------------|
+| **Core** | `presets/_shared/core/**` | Stack-agnostic prose + checklists; no frontmatter; no paths `app/**`, `Features/**`, Playwright, xcodebuild |
+| **Stack** | `presets/{cursor\|claude}/<stack>/` | Domain/tooling, stack always-on trio, stack examples in **Stack notes** |
 | **Platform** | Cursor `.mdc` / Claude `.md` | Frontmatter (`alwaysApply`/`globs` vs `paths:`), platform-only (`BUGBOT.md`, `CLAUDE.md`) |
 
-## Куда класть новое правило
+## Where to put a new rule
 
-1. Общие принципы для всех стеков → **core** + адаптеры с `<!-- shared-core: … -->`.
-2. Только один из installable стеков (`next` / `nuxt` / `svelte` / `ios-swift` / `go` / `java` / `mcp-ts` / `php-hexagonal` / `php-laravel`) → **stack-specific** (не в `_shared`).
-3. Только Cursor или только Claude packaging → platform artifact / frontmatter, не дублировать семантику.
+1. Shared principles for all stacks → **core** + adapters with `<!-- shared-core: … -->`.
+2. Only one of the installable stacks (`next` / `nuxt` / `svelte` / `ios-swift` / `go` / `java` / `mcp-ts` / `php-hexagonal` / `php-laravel`) → **stack-specific** (not in `_shared`).
+3. Only Cursor or only Claude packaging → platform artifact / frontmatter; do not duplicate semantics.
 
 ## SoT
 
 - Packages path — SoT; root `.cursor/` — dogfood sync.
 - Per stack: **Cursor** `presets/cursor/<stack>/` → Claude twin same PR.
-- `_shared` **не** `--preset` и не копируется CLI `init`.
+- `_shared` is **not** a `--preset` and is not copied by CLI `init`.
 
-См. также: `preset-twin-sync`, `preset-token-budget`, `preset-pr-checklist`, `preset-no-cross-stack-leakage`.
+See also: `preset-twin-sync`, `preset-token-budget`, `preset-pr-checklist`, `preset-no-cross-stack-leakage`.

package/presets/cursor/nuxt/rules/preset-no-cross-stack-leakage.mdc

@@ -9,10 +9,9 @@ alwaysApply: false
 
 <!-- shared-core: meta/preset-no-cross-stack-leakage.md -->
 
-
 # Preset no cross-stack leakage
 
-Запрет протекания stack-specific имён, путей и handoff stems между пресетами.
+Ban leakage of stack-specific names, paths, and handoff stems across presets.
 
 ## Principles
 

package/presets/cursor/nuxt/rules/preset-pr-checklist.mdc

@@ -9,19 +9,18 @@ alwaysApply: false
 
 <!-- shared-core: meta/preset-pr-checklist.md -->
 
-
 # Preset PR checklist
 
-Чеклист для PR, затрагивающих `packages/ai-rules/presets/**` (и dogfood `.cursor/` sync).
+Checklist for PRs that touch `packages/ai-rules/presets/**` (and dogfood `.cursor/` sync).
 
 ## Before merge
 
-- [ ] **SoT:** правки в `packages/…` (не только root `.cursor/`)
-- [ ] **Core:** если менялся `_shared/core/**` — обновлены все `<!-- shared-core: … -->` consumers (или documented intentional fork)
-- [ ] **Twin:** Cursor change → Claude twin **same PR** (**FAIL** if missing on next, nuxt, svelte, ios-swift, go, java, mcp-ts, php-hexagonal, and php-laravel — см. `preset-twin-sync`)
-- [ ] **Mapping:** `claude/<stack>/rules/README.md` mapping table актуален
+- [ ] **SoT:** edits in `packages/…` (not only root `.cursor/`)
+- [ ] **Core:** if `_shared/core/**` changed — all `<!-- shared-core: … -->` consumers updated (or documented intentional fork)
+- [ ] **Twin:** Cursor change → Claude twin **same PR** (**FAIL** if missing on next, nuxt, svelte, ios-swift, go, java, mcp-ts, php-hexagonal, and php-laravel — see `preset-twin-sync`)
+- [ ] **Mapping:** `claude/<stack>/rules/README.md` mapping table is current
 - [ ] **Token budget:** alwaysApply / session-start ≤ 3; meta rules not always-on
-- [ ] **Leakage:** нет чужих stack agent stems / handoff strings (`preset-no-cross-stack-leakage`)
+- [ ] **Leakage:** no foreign stack agent stems / handoff strings (`preset-no-cross-stack-leakage`)
 - [ ] **Twin depth:** domain ≥15 lines; thin aliases documented
 - [ ] **README:** stack `rules/README.md` core→stack mapping / catalog updated if stems added
 - [ ] **CHANGELOG / package README:** note when public preset paths or install surface change

package/presets/cursor/nuxt/rules/preset-token-budget.mdc

@@ -9,21 +9,20 @@ alwaysApply: false
 
 <!-- shared-core: meta/preset-token-budget.md -->
 
-
 # Preset token budget
 
-Инварианты загрузки правил в **установленном** пресете (consumer app).
+Invariants for rule loading in an **installed** preset (consumer app).
 
 ## Hard caps
 
 | Platform | Always-on | Cap |
 |----------|-----------|-----|
 | Cursor | `alwaysApply: true` | **≤ 3** |
-| Claude | rules **without** `paths:` | **ровно 3** |
+| Claude | rules **without** `paths:` | **exactly 3** |
 
 **Claude Option A (README exclusion):** when counting Claude rules without `paths:` / session-start, **exclude `**/README.md`** (topic indexes are not session-start rules). The intended session-start trio remains **exactly 3**; body budget sums **only those 3** rules.
 
-Session-start body budget (где задокументировано): ≤140 строк суммарно (stretch ≤120).
+Session-start body budget (where documented): ≤140 lines total (stretch ≤120).
 
 ## Meta / author rules
 

package/presets/cursor/nuxt/rules/preset-twin-sync.mdc

@@ -9,7 +9,6 @@ alwaysApply: false
 
 <!-- shared-core: meta/preset-twin-sync.md -->
 
-
 # Preset twin sync
 
 Cursor `.mdc` — **SoT per stack**. Claude topic `.md` — derived twin.

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

@@ -1,5 +1,5 @@
 ---
-description: Импорт доменных типов и API только через публичные barrel @/types и @/api
+description: Import domain types and API only through public barrels @/types and @/api
 globs:
   - components/**/*
   - stores/**/*
@@ -10,16 +10,16 @@ alwaysApply: false
 impact: HIGH
 ---
 
-# Публичные импорты (`@/types`, `@/api`)
+# Public imports (`@/types`, `@/api`)
 
-**Коллизии:** импорт типов — раздел `@/types` ниже; API вне `api/**` — раздел `@/api` ниже (дублирует ESLint `no-restricted-imports` в `eslint.config.mjs`).
+**Collisions:** type imports — `@/types` section below; API outside `api/**` — `@/api` section below (mirrors ESLint `no-restricted-imports` in `eslint.config.mjs`).
 
 ## `@/types`
 
-- **Публичный API типов** — barrel `types/index.ts`; импортировать типы только как `@/types` (или `@/types/index`).
-- **Запрещено** обходить barrel: `@/types/<что‑угодно>`, кроме enum.
-- **Enum** — только `@/types/enums` / `@/types/enums.ts`.
-- Внутри `types/**` — относительные импорты между файлами слоя.
+- **Public types API** — barrel `types/index.ts`; import types only as `@/types` (or `@/types/index`).
+- **Forbidden** to bypass the barrel: `@/types/<anything>`, except enums.
+- **Enums** — only `@/types/enums` / `@/types/enums.ts`.
+- Inside `types/**` — relative imports between layer files.
 
 ```typescript
 // ✅
@@ -30,23 +30,23 @@ import { SomeEnum } from '@/types/enums'
 import type { TUserProfile } from '@/types/User.types'
 ```
 
-Новые публичные типы — реэкспорт в `types/index.ts` по **`layer-barrel-exports.mdc`**.
+New public types — re-export in `types/index.ts` per **`layer-barrel-exports.mdc`**.
 
 ## `@/api`
 
-- **Публичный API** — barrel `api/index.ts`. Вне `api/**` — только `import … from '@/api'` (или `@/api/index`).
-- **Запрещено** снаружи слоя: `@/api/<что‑угодно>`, кроме `@/api/index`.
-- Внутри `api/**` — относительные импорты и `@/api/services/**`, `@/api/clients/**`.
+- **Public API** — barrel `api/index.ts`. Outside `api/**` — only `import … from '@/api'` (or `@/api/index`).
+- **Forbidden** from outside the layer: `@/api/<anything>`, except `@/api/index`.
+- Inside `api/**` — relative imports and `@/api/services/**`, `@/api/clients/**`.
 
 ```typescript
-// ✅ в store, UI, lib вне api
+// ✅ in store, UI, lib outside api
 import { MedcardApiService } from '@/api'
 
-// ❌ снаружи api
+// ❌ outside api
 import { MedcardApiService } from '@/api/services/MedcardApiService/MedcardApiService'
 ```
 
-Новые публичные символы API — реэкспорт в `api/index.ts` по **`layer-barrel-exports.mdc`**.
+New public API symbols — re-export in `api/index.ts` per **`layer-barrel-exports.mdc`**.
 ## Incorrect
 
 ```ts

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

@@ -1,5 +1,5 @@
 ---
-description: Эталонные фичи репозитория — копировать структуру при реализации новых задач. Заполните пути после init в целевом репо.
+description: Repository reference features — copy structure when implementing new tasks. Fill paths after init in the target repo.
 globs:
   - components/**/*
   - stores/**/*
@@ -10,40 +10,40 @@ alwaysApply: false
 
 <!-- shared-core: architecture/reference-features.template.md -->
 
-# Эталонные фичи (reference features)
+# Reference features
 
 ## Stack notes
 
-Перед реализацией найди фичу того же типа и **повтори её структуру**, не изобретая новую организацию файлов.
+Before implementing, find a feature of the same type and **mirror its structure**; do not invent a new file organization.
 
 Taxonomy / shared core: [`presets/_shared/README.md`](../../../../_shared/README.md) · [Preset contribution guide](../../../../docs/PRESET-CONTRIBUTION.md).
 
-## Таблица эталонов
+## Reference table
 
-Замени **TBD** на реальные пути после договорённости в команде (или при `ai-rules init` в целевом репо):
+Replace **TBD** with real paths after team agreement (or on `ai-rules init` in the target repo):
 
-| Слой | Эталон | Что копировать |
-|------|--------|----------------|
+| Layer | Reference | What to copy |
+|-------|-----------|--------------|
 | UI page | **TBD** `components/pages/<Example>/` | `components/`, `*.data.ts`, `styles.ts`, barrel |
 | Store | **TBD** `stores/<example>.ts` | `defineStore`, actions, getters, types |
 | API service | **TBD** `api/services/<example>/` | service, mappers, barrel |
 | Types module | **TBD** `types/<example>/` | domain types, JSDoc, barrel export |
-| Unit tests | **TBD** рядом с эталонным mapper/service | `*.spec.ts`, describe/it naming |
+| Unit tests | **TBD** next to the reference mapper/service | `*.spec.ts`, describe/it naming |
 | E2E area | **TBD** `tests/e2e/<Area>/` | `*.cases.md`, page objects, `_shared/` |
 
-## Как использовать
+## How to use
 
-1. Определи затронутые слои из `decomposition.md` или задачи.
-2. Открой эталон из таблицы (после заполнения путей).
-3. Зеркаль именование, порядок файлов, паттерны импортов и тестов.
-4. Если эталона нет — выбери **самую близкую** существующую фичу того же слоя и зафиксируй выбор в handoff.
+1. Identify affected layers from `decomposition.md` or the task.
+2. Open the reference from the table (after paths are filled).
+3. Mirror naming, file order, import patterns, and tests.
+4. If there is no reference — pick the **closest** existing feature of the same layer and record the choice in the handoff.
 
 ## Living conventions
 
 Post-init gotchas / patterns / decisions: **`.cursor/team/conventions.md`** (and the twin tool path if both Cursor and Claude are installed). Consumer-owned; not always-on. See root `AGENTS.md` § Living conventions.
 
-## Связанные правила
+## Related rules
 
-- `code-quality-and-refactoring.mdc` — повторять паттерны, не deep-import.
-- `feature-delivery-workflow.mdc` — порядок слоёв.
-- skill `feature-delivery` — end-to-end сценарий.
+- `code-quality-and-refactoring.mdc` — repeat patterns, no deep-import.
+- `feature-delivery-workflow.mdc` — layer order.
+- skill `feature-delivery` — end-to-end scenario.

package/presets/cursor/nuxt/rules/store-pinia.mdc

@@ -1,31 +1,31 @@
 ---
-description: Pinia stores и клиентское состояние приложения (Nuxt)
+description: Pinia stores and client application state (Nuxt)
 globs: stores/**/*.ts,stores/**/*.js
 alwaysApply: false
 impact: HIGH
 ---
 
-# Общие принципы
+# General principles
 
-- Использовать **Pinia** (`defineStore`) — setup или options store, как у соседей в репо.
-- Модуль: `@pinia/nuxt` (или установленный эквивалент) — проверить `package.json` / `nuxt.config`.
-- В store хранить **доменные модели**, не сырые DTO из API.
-- Маппинг DTO → domain — в `api/**` (или server mappers) **до** записи в store.
-- Разделять серверное состояние (данные API) и локальное UI‑состояние (фильтры/флаги) — UI-only можно в composable/`ref` страницы, если так принято в репо.
+- Use **Pinia** (`defineStore`) — setup or options store, as neighbors do in the repo.
+- Module: `@pinia/nuxt` (or the installed equivalent) — check `package.json` / `nuxt.config`.
+- Store **domain models**, not raw API DTOs.
+- DTO → domain mapping — in `api/**` (or server mappers) **before** writing to the store.
+- Separate server state (API data) from local UI state (filters/flags) — UI-only may live in a composable/`ref` on the page if that is the repo convention.
 
-# Запрещено в этом пресете
+# Forbidden in this preset
 
 - RTK / Redux: `createSlice`, `createAsyncThunk`, RTK Query, `useDispatch` / `useSelector`, stem `store-rtk`.
-- Сырой `$fetch` / `fetch` из store в обход `~/api` / `@/api` сервисов (кроме узких documented исключений репо).
+- Raw `$fetch` / `fetch` from the store bypassing `~/api` / `@/api` services (except narrow documented repo exceptions).
 
-# Структура
+# Structure
 
-- Один доменный модуль — свой файл в `stores/**` (например `stores/profile.ts`).
-- Экспорт: `useXStore` через `defineStore('x', …)`.
-- State: явный тип; аккуратная инициализация.
-- Getters — производные от domain state; actions вызывают сервисы из `~/api` / `@/api` (`public-imports`).
+- One domain module — its own file under `stores/**` (e.g. `stores/profile.ts`).
+- Export: `useXStore` via `defineStore('x', …)`.
+- State: explicit type; careful initialization.
+- Getters — derived from domain state; actions call services from `~/api` / `@/api` (`public-imports`).
 
-# Асинхронность
+# Async
 
 ```ts
 // Incorrect — raw HTTP + DTO in state
@@ -50,19 +50,19 @@ export const useProfileStore = defineStore('profile', {
 })
 ```
 
-# Типизация и ошибки
+# Typing and errors
 
-- Доменные типы из `~/types` / `@/types`.
-- Ошибки транспорта — контракты из `@/types` / принятый класс ошибки клиента (`http-client`), не выдуманные axios shapes.
-- В UI: `storeToRefs` для state; actions вызывать напрямую с store.
+- Domain types from `~/types` / `@/types`.
+- Transport errors — contracts from `@/types` / the accepted client error class (`http-client`), not invented axios shapes.
+- In UI: `storeToRefs` for state; call actions directly on the store.
 
-# Тестирование
+# Testing
 
-- Покрывать важные stores (инициализация, переходы, actions с моком API).
-- Unit: Vitest; мокать `~/api` сервисы.
+- Cover important stores (init, transitions, actions with mocked API).
+- Unit: Vitest; mock `~/api` services.
 
-# Требование к агенту
+# Agent requirement
 
-- Не класть HTTP/transport в компоненты.
-- Строго типизировать state/actions.
-- Следовать стилю соседних stores.
+- Do not put HTTP/transport in components.
+- Strictly type state/actions.
+- Follow neighboring store style.