@bonesofspring/ai-rules 0.2.14 → 0.2.15

package/presets/claude/svelte/rules/architecture/layer-barrel-exports.md

@@ -1,62 +1,62 @@
 ---
-description: Двухуровневые barrel-экспорты для слоёв с регламентированным public API
+description: Two-level barrel exports for layers with a regulated public API
 paths:
   - **/index.ts
 ---
 
-# Barrel-экспорты слоёв с public API
+# Barrel exports for layers with a 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 point for external consumers;
+- deep imports into 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 across projects: `@/api`, `@/types`, `@/core`, `@/store`, `packages/foo`.
 
-## Два уровня barrel
+## Two barrel levels
 
-1. **Локальный** — `index.ts` модуля/фичи внутри слоя.
-2. **Корневой public API** — barrel слоя (например `src/<layer>/index.ts`).
+1. **Local** — `index.ts` of a module/feature 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 outward
 
-Только символы, которые **должны быть доступны** потребителям слоя: публичные функции/сервисы/фасады, типы контракта, константы и 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 repository convention** (orient on neighboring modules of the same layer).
 
-## Чеклист агента (обязателен)
+## Agent checklist (required)
 
-При добавлении или существенном расширении **модуля внутри регламентированного слоя**:
+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 extra entry points (`public-imports.mdc`).
+2. Create/update the **local** `index.ts` — public symbols only.
+3. If the layer has a **facade/aggregator** (`*ApiService.ts`, `rootReducer`, …) — wire the module there.
+4. Add a **re-export** of new public symbols in the layer’s **root barrel**.
+5. **Verify:** grep for the symbol name or path `./<Module>` in the root barrel; no deep imports from outside the layer.
 
-Модуль **не готов**, пока чеклист не пройден.
+The module is **not ready** until the checklist passes.
 
-## Как найти регламентированные слои в репозитории
+## How to find regulated layers in the repository
 
-1. Правила `public-imports.mdc` в `.cursor/rules/`.
-2. ESLint `no-restricted-imports` — паттерны `@/<layer>/*` с исключением barrel.
-3. `architecture-boundaries.mdc`, README проекта.
+1. `public-imports.mdc` rules in `.claude/rules/`.
+2. ESLint `no-restricted-imports` — `@/<layer>/*` patterns with barrel exception.
+3. `architecture-boundaries.mdc`, project README.
 
-## В этом репозитории
+## In this repository
 
-| Слой | Корневой barrel | Правило импортов |
-|------|-------------------|------------------|
+| Layer | Root barrel | Import rule |
+|-------|-------------|-------------|
 | API | `api/index.ts` | `public-imports.mdc` |
 | Types | `types/index.ts` | `public-imports.mdc` (+ `@/types/enums`) |
 | Core | `core/index.ts` | ESLint: `@/core/index` |
 
-Иллюстрация двух уровней (API): локальный `services/.../<Feature>/index.ts` → фасад `*ApiService.ts` → `api/index.ts`.
+Two-level illustration (API): local `services/.../<Feature>/index.ts` → facade `*ApiService.ts` → `api/index.ts`.
 ## Incorrect
 
 ```ts

package/presets/claude/svelte/rules/architecture/public-imports.md

@@ -1,5 +1,5 @@
 ---
-description: Импорт доменных типов и API только через публичные barrels ($lib/types, $lib/api)
+description: Import domain types and API only through public barrels ($lib/types, $lib/api)
 paths:
   - src/lib/components/**/*
   - src/lib/stores/**/*
@@ -9,15 +9,15 @@ paths:
   - src/lib/api/**/*
 ---
 
-# Публичные импорты (`$lib/types`, `$lib/api`)
+# Public imports (`$lib/types`, `$lib/api`)
 
 Preferred alias: **`$lib`**. Accept **`@/`** if consumer vite/tsconfig maps it. Respect `$app/*` / `$env/*` — do not invent modules.
 
 ## `$lib/types` (or `@/types`)
 
-- Публичный API типов — barrel `src/lib/types/index.ts`; снаружи слоя — только `$lib/types` / `@/types`.
-- Запрещено обходить barrel deep-импортами внутренних файлов типов (кроме project enum convention if present).
-- Внутри `src/lib/types/**` — относительные импорты.
+- Public types API — barrel `src/lib/types/index.ts`; outside the layer — only `$lib/types` / `@/types`.
+- Forbidden to bypass the barrel via deep imports of internal type files (except a project enum convention if present).
+- Inside `src/lib/types/**` — relative imports.
 
 ```typescript
 // ✅
@@ -29,8 +29,8 @@ import type { TUserProfile } from '$lib/types/User.types'
 
 ## `$lib/api` (or `@/api`)
 
-- Публичный API — barrel `src/lib/api/index.ts`. Вне `src/lib/api/**` — только `$lib/api` / `@/api`.
-- Внутри слоя — относительные импорты и `$lib/api/services/**` / `$lib/clients/**` as neighbors do.
+- Public API — barrel `src/lib/api/index.ts`. Outside `src/lib/api/**` — only `$lib/api` / `@/api`.
+- Inside the layer — relative imports and `$lib/api/services/**` / `$lib/clients/**` as neighbors do.
 
 ```typescript
 // ✅
@@ -40,4 +40,4 @@ import { ordersApi } from '$lib/api'
 import { ordersApi } from '$lib/api/services/orders/orders.service'
 ```
 
-Новые публичные символы — реэкспорт в barrel по **`layer-barrel-exports`**.
+New public symbols — re-export in the barrel per **`layer-barrel-exports`**.

package/presets/claude/svelte/rules/architecture/reference-features.md

@@ -1,5 +1,5 @@
 ---
-description: Эталонные фичи репозитория — копировать структуру при реализации новых задач. Заполните пути после init в целевом репо.
+description: Repository reference features — mirror their structure when implementing new work. Fill in paths after init in the target repo.
 paths:
   - src/lib/components/**/*
   - src/lib/stores/**/*
@@ -10,41 +10,41 @@ paths:
 
 <!-- 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 route / page | **TBD** `src/routes/<example>/` | `+page.svelte`, `+page.ts`, layout nesting |
 | UI component | **TBD** `src/lib/components/<Example>/` | `.svelte`, styles, barrel |
 | Store | **TBD** `src/lib/stores/<example>.ts` | writable/derived or runes module, actions |
 | API service | **TBD** `src/lib/api/services/<example>/` | service, mappers, barrel |
 | Types module | **TBD** `src/lib/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 in).
+3. Mirror naming, file order, import patterns, and tests.
+4. If there is no reference — pick the **closest** existing feature in 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.
+Post-init gotchas / patterns / decisions: **`.claude/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/claude/svelte/rules/stack/README.md

@@ -1,12 +1,12 @@
 # Stack (SvelteKit, Svelte 5, TypeScript)
 
-Правила уровня фреймворка и языка.
+Framework- and language-level rules.
 
-| Файл | Содержание | Загрузка |
-|------|------------|----------|
-| `svelte-app-core.md` | Стек, структура `src/routes/**` / `src/lib/**`, слои | session start |
+| File | Contents | Loading |
+|------|----------|---------|
+| `svelte-app-core.md` | Stack, `src/routes/**` / `src/lib/**` structure, layers | session start |
 | `svelte-script-conventions.md` | `<script lang="ts">` conventions | `paths: **/*.{svelte,ts}` |
-| `no-type-assertion.md` | Ограничение `as` на границах модулей | on-demand |
-| `navigation-router-ui.md` | Навигация в UI-компонентах (slim) | `paths: src/routes/**,src/hooks.server.ts,src/lib/components/**` |
-| `navigation-router.md` | Полный аудит стека навигации (SvelteKit file-based routing) | `paths: src/routes/**,src/hooks.server.ts,svelte.config.*` |
-| `types-jsdoc.md` | JSDoc в `types` | `paths: types/**/*.ts` |
+| `no-type-assertion.md` | Limit `as` on module boundaries | on-demand |
+| `navigation-router-ui.md` | Navigation in UI components (slim) | `paths: src/routes/**,src/hooks.server.ts,src/lib/components/**` |
+| `navigation-router.md` | Full navigation stack audit (SvelteKit file-based routing) | `paths: src/routes/**,src/hooks.server.ts,svelte.config.*` |
+| `types-jsdoc.md` | JSDoc in `types` | `paths: types/**/*.ts` |

package/presets/claude/svelte/rules/stack/navigation-router-ui.md

@@ -5,7 +5,7 @@ paths:
   - src/routes/**/*
 ---
 
-# Навигация (UI)
+# Navigation (UI)
 
 - Prefer native **`<a href="…">`** (and design-system Link wrappers that render anchors).
 - Active state: follow repo pattern (`page.url`, `$app/state` / `$app/stores` as version allows — verify).

package/presets/claude/svelte/rules/stack/navigation-router.md

@@ -5,15 +5,15 @@ paths:
   - svelte.config.*
 ---
 
-# Навигация (stack)
+# Navigation (stack)
 
-Для этого пресета канон — **SvelteKit** (`svelte-app-core`, `sveltekit-routing`).
+For this preset the canon is **SvelteKit** (`svelte-app-core`, `sveltekit-routing`).
 
-## Проверить в репо
+## Check in the repo
 
-1. `package.json` workspace с `svelte.config.*` — `@sveltejs/kit` / `svelte` majors.
-2. Как уже навигируют соседи: `goto`, `invalidate`, `beforeNavigate`, `<a href>`, wrappers.
-3. Не подмешивать Next (`next/navigation`) или Nuxt (`navigateTo`, `<NuxtLink>`) по умолчанию.
+1. `package.json` workspace with `svelte.config.*` — `@sveltejs/kit` / `svelte` majors.
+2. How neighbors already navigate: `goto`, `invalidate`, `beforeNavigate`, `<a href>`, wrappers.
+3. Do not mix in Next (`next/navigation`) or Nuxt (`navigateTo`, `<NuxtLink>`) by default.
 
 ## API
 

package/presets/claude/svelte/rules/stack/no-type-assertion.md

@@ -1,59 +1,59 @@
 ---
-description: Избегать приведения типов через as на границах модулей (импорт/экспорт)
+description: Avoid type assertions via as at module boundaries (import/export)
 paths:
   - api/**/*
   - src/lib/stores/**/*
   - types/**/*
 ---
 
-# Не использовать `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-svelte.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 slices and services when handling API errors, first consider **`instanceof`** on the transport error class from `@/types` following existing code (`http-client.mdc`, `store-svelte.mdc`).

package/presets/claude/svelte/rules/stack/svelte-app-core.md

@@ -1,15 +1,15 @@
 ---
-description: Базовые принципы, стек и архитектура SvelteKit приложения (preset)
+description: Core principles, stack, and architecture for a SvelteKit app (preset)
 ---
 
-# Стек и окружение
+# Stack and environment
 
-Конкретные версии — **из `package.json` и конфигов целевого репозитория**. Рамка preset: SvelteKit, Svelte 5 (primary), TypeScript; runner/e2e/mocks/UI/APM — как заведено в репо.
+Concrete versions — **from `package.json` and configs in the target repository**. Preset frame: SvelteKit, Svelte 5 (primary), TypeScript; runner/e2e/mocks/UI/APM — as established in the repo.
 
-# Структура проекта
+# Project structure
 
-| Путь | Назначение |
-|------|------------|
+| Path | Purpose |
+|------|---------|
 | `src/routes/**` | Routes, layouts, load, form actions (`+page`, `+layout`, `+server`) |
 | `src/lib/components/**` | UI components (`.svelte`) |
 | `src/lib/**` | Facades / utils (no Vue-style `composables/` tree) |
@@ -20,12 +20,12 @@ description: Базовые принципы, стек и архитектура
 | `src/lib/types/**` | Domain types (barrel) |
 | `tests/e2e/**` | Playwright e2e |
 
-**Aliases:** prefer `$lib`; respect `$app/*` / `$env/*` (не изобретать символы); accept `@/` если настроен. Scripts cwd — **корень SvelteKit** (где `svelte.config.*`), не Next-обёртка `app/`.
+**Aliases:** prefer `$lib`; respect `$app/*` / `$env/*` (do not invent symbols); accept `@/` if configured. Scripts cwd — **SvelteKit root** (where `svelte.config.*` lives), not a Next-style `app/` wrapper.
 
-# Архитектурные слои
+# Architectural layers
 
-| Слой | Каталог | Детали |
-|------|---------|--------|
+| Layer | Directory | Details |
+|-------|-----------|---------|
 | UI | `src/routes/**`, `src/lib/components/**` | `svelte-ui`, `architecture-boundaries-ui` |
 | Facades | `src/lib/**` | thin orchestration; no raw HTTP |
 | Store | `src/lib/stores/**` | `store-svelte` — writable/derived/readable + runes |
@@ -34,11 +34,11 @@ description: Базовые принципы, стек и архитектура
 | Server | `+server.ts`, hooks | `security-sveltekit`; not a substitute for `src/lib/api/**` |
 | Types | `src/lib/types/**` | `public-imports`, `types-jsdoc` |
 
-Границы — **`architecture-boundaries`**. Импорты `$lib/types`, `$lib/api` (или `@/…` если aliased) — **`public-imports`**. **Запрещено:** RTK / Pinia / stems `store-rtk` / `store-pinia`, React/RSC, Vue/Nuxt defaults, пути `app/src/**` / `pages/**` / `composables/**` как канон.
+Boundaries — **`architecture-boundaries`**. Imports `$lib/types`, `$lib/api` (or `@/…` if aliased) — **`public-imports`**. **Forbidden:** RTK / Pinia / stems `store-rtk` / `store-pinia`, React/RSC, Vue/Nuxt defaults, paths `app/src/**` / `pages/**` / `composables/**` as 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/claude/svelte/rules/stack/types-jsdoc.md

@@ -1,42 +1,42 @@
 ---
-description: Стиль JSDoc для доменных и транспортных типов в types
+description: JSDoc style for domain and transport types under types
 paths:
   - src/lib/types/**/*.ts
 ---
 
-# Документация типов в `types`
+# Type documentation in `types`
 
-При добавлении или существенном изменении типов в этом слое **следовать уже принятому в репозитории стилю JSDoc** (см. примеры: `User.types.ts`, `Common.types.ts`, `ServerValidation.types.ts`, `TreatmentPlan/*.types.ts`).
+When adding or substantially changing types in this layer **follow the JSDoc style already used in the repository** (see examples: `User.types.ts`, `Common.types.ts`, `ServerValidation.types.ts`, `TreatmentPlan/*.types.ts`).
 
-## Язык и форма
+## Language and form
 
-- Текст комментариев — **на русском**, кратко и по делу: что означает тип или поле в предметной области или в контракте с API.
-- **Не опираться** на теги в духе `@param`, `@returns`, `@see`, `@deprecated` для описания типов — в этом слое они **не используются**; достаточно обычного текста в `/** … */`.
+- Comment text — **in Russian**, short and to the point: what the type or field means in the domain or API contract.
+- **Do not rely** on tags like `@param`, `@returns`, `@see`, `@deprecated` for type descriptions — they are **not used** in this layer; plain `/** … */` text is enough.
 
-## Экспортируемый `type` / `interface`
+## Exported `type` / `interface`
 
-- Сразу **перед объявлением** — блок `/** … */`.
-- Если нужно пояснить источник данных, ограничения или неочевидности — **второй абзац** в том же блоке (в JSDoc для абзаца — пустая строка между строками текста).
-- Для **вложенных** объектов в том же файле каждый такой тип документируется отдельным блоком над своим объявлением.
+- Immediately **before the declaration** — a `/** … */` block.
+- If you need to explain data source, constraints, or non-obvious bits — a **second paragraph** in the same block (blank line between paragraphs in JSDoc).
+- For **nested** objects in the same file, each such type gets its own block above its declaration.
 
-## Поля
+## Fields
 
-- У **каждого** публичного свойства — **однострочный** `/** … */` на строке непосредственно **над** полем.
-- Если поле **не приходит с бэкенда «как есть»**, а вычисляется или дополняется на фронте (маппер, селектор, UI) — начать описание с префикса **`[computed]`** (как в `TUserProfile`, типах плана лечения).
-- Для форматов данных указывать это **в тексте**: например дата `YYYY-MM-DD`, пример отображаемой строки в кавычках.
+- Every **public** property — a **one-line** `/** … */` on the line immediately **above** the field.
+- If a field **does not come from the backend “as is”** but is computed or enriched on the frontend (mapper, selector, UI) — start the description with the **`[computed]`** prefix (as in `TUserProfile`, treatment-plan types).
+- For data formats, state that **in the text**: e.g. date `YYYY-MM-DD`, example display string in quotes.
 
-## Классы и прочие объявления
+## Classes and other declarations
 
-- Для **классов** (например ошибки транспорта) при изменении публичного API — краткий блок над классом и **комментарии к публичным полям** по тем же правилам, что у свойств интерфейса.
+- For **classes** (e.g. transport errors), when changing the public API — a short block above the class and **comments on public fields** by the same rules as interface properties.
 
 ## `enum`
 
-- В `enums.ts` исторически часто **без JSDoc** на каждом члене; для новых enum допустимо короткое описание **над самим enum**, если назначение неочевидно из имени. Подписи для UI — как принято, через объекты `*Names` рядом с enum.
+- In `enums.ts` historically often **without JSDoc** on each member; for new enums a short description **above the enum itself** is OK if purpose is not obvious from the name. UI labels — as usual, via `*Names` objects next to the enum.
 
-## Практика для агента
+## Agent practice
 
-- Добавляя новый тип или поле, **не оставлять** новые публичные поля без пояснения, если смысл не равен имени на 100%.
-- Правя файл, где уже есть такие комментарии, **поддерживать тот же стиль**, а не смешивать с англоязычными или «теговыми» блоками.
-- Не раздувать комментарии: одна-две фразы на тип, одна строка на поле — норма; исключение — действительно сложная доменная оговорка.
+- When adding a new type or field, **do not leave** new public fields unexplained if the meaning is not 100% equal to the name.
+- When editing a file that already has such comments, **keep the same style**, do not mix with English or “tag-style” blocks.
+- Do not inflate comments: one–two phrases per type, one line per field — normal; exception — a truly complex domain caveat.
 
-См. также импорты и barrel: `public-imports.mdc`.
+See also imports and barrel: `public-imports.mdc`.

package/presets/claude/svelte/rules/testing/README.md

@@ -2,10 +2,10 @@
 
 Unit, e2e, Playwright agents.
 
-| Файл | Содержание | Загрузка |
-|------|------------|----------|
-| `playwright-agents.md` | Planner / generator / healer — структура e2e | session start |
-| `tests-unit.md` | Unit/integration, именование на русском | `paths: **/*.spec.*`, `*.test.*` |
+| File | Contents | Loading |
+|------|----------|---------|
+| `playwright-agents.md` | Planner / generator / healer — e2e structure | session start |
+| `tests-unit.md` | Unit/integration; titles in Russian (locale convention) | `paths: **/*.spec.*`, `*.test.*` |
 | `tests-e2e-structure.md` | `*.cases.md`, page objects, data-testid | `paths: tests/e2e/**` |
 
-См. также `.claude/agents/playwright-test-*.md` после `ai-rules init`.
+See also `.claude/agents/playwright-test-*.md` after `ai-rules init`.