@bonesofspring/ai-rules 0.2.14 → 0.2.16

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

package/presets/claude/svelte/rules/testing/tests-e2e-structure.md

@@ -1,51 +1,50 @@
 ---
-description: Структура e2e тестов и планов (Playwright)
+description: Structure of e2e tests and plans (Playwright)
 paths:
   - tests/e2e/**/*
 ---
 
-# Структура e2e в проекте
-
-- Папка e2e: `tests/e2e/**`.
-- Планы сценариев:
-  - `*.cases.md` файлы — **канонический источник сценариев**.
-- Тесты:
-  - `*.spec.ts` файлы — реализация сценариев на Playwright.
-- Общие утилиты и абстракции:
-  - `tests/e2e/_shared/**` — константы, fluent‑интерфейсы, хелперы.
-
-# Принципы
-
-- Каждый сценарий из `*.cases.md` должен иметь соответствующий тест (или набор тестов).
-- **Нельзя** ослаблять проверки в тестах, если это противоречит бизнес‑ожиданиям из планов.
-- Предпочтительно использовать:
-  - page‑objects (например, `OrderHistoryPage.ts`);
-  - общие хелперы из `_shared`.
-
-# Именование e2e‑тестов
-
-- Язык:
-  - все названия `test` / `it`, `describe`‑блоков и шагов в `*.cases.md` должны быть сформулированы **на русском языке**, описывая поведение и ожидаемый результат.
-- Формат заголовков e2e‑тестов (`test(...)` / `it(...)`):
-  - перед текстовым описанием сценария указывается **префикс с номером** в формате: `ПРЕФИКС-XXX Описание сценария`.
-  - `ПРЕФИКС` — аббревиатура из **первых букв слов** тестируемой сущности, записанная **латиницей в верхнем регистре**.
-    - пример: `OrderHistory` → `OH`, `BillingReport` → `BR`.
-  - `XXX` — порядковый номер теста **с тремя разрядами и лидирующими нулями**: `001`, `002`, `010`, `123` и т.д.
-  - пример полного названия e2e‑теста:
-    - `test('OH-001 Отображается список заказов', async ({ page }) => { ... })`
-  - внутри одной сущности (`ПРЕФИКС`) номера тестов должны образовывать **непротиворечивую последовательность**, без дубликатов номеров.
-
-# data-testid для e2e
-
-- **Приоритет селекторов:** `data-testid` для стабильных элементов; `getByRole` и `getByLabel` для форм и доступных элементов.
-- **Именование:** схема `{parent}__{element}` (например, `history-page__title`, `history-page__recognition-banner__attach-files-button`).
-- **Где добавлять:** на корневые контейнеры страниц и ключевые интерактивные элементы (кнопки, ссылки, поля), к которым обращаются page objects.
-- **При изменении UI:** обновлять data-testid в компонентах и соответствующие селекторы в page objects; сверять с `*.cases.md`.
-
-# Требование к агенту
-
-При добавлении/изменении e2e‑тестов:
-- Сначала смотреть соответствующий `*.cases.md` и синхронизировать названия сценариев.
-- Размещать спеки рядом с планами в той же директории.
-- Переиспользовать общие page‑objects и хелперы, а не копировать селекторы напрямую в каждый тест.
-
+# E2E structure in the project
+
+- E2E folder: `tests/e2e/**`.
+- Scenario plans:
+  - `*.cases.md` files — **canonical source of scenarios**.
+- Tests:
+  - `*.spec.ts` files — Playwright scenario implementation.
+- Shared utilities and abstractions:
+  - `tests/e2e/_shared/**` — constants, fluent interfaces, helpers.
+
+# Principles
+
+- Every scenario from `*.cases.md` must have a matching test (or set of tests).
+- **Do not** weaken assertions in tests if that contradicts business expectations from the plans.
+- Prefer:
+  - page objects (e.g. `OrderHistoryPage.ts`);
+  - shared helpers from `_shared`.
+
+# E2E test naming
+
+- Language:
+  - all `test` / `it` names, `describe` blocks, and steps in `*.cases.md` must be formulated **in Russian**, describing behavior and the expected result. <!-- i18n-keep: E5 -->
+- E2E title format (`test(...)` / `it(...)`):
+  - before the scenario description, put a **numbered prefix** in the form: `PREFIX-XXX Scenario description`.
+  - `PREFIX` — abbreviation from the **first letters of the words** of the entity under test, written in **Latin uppercase**.
+    - example: `OrderHistory` → `OH`, `BillingReport` → `BR`.
+  - `XXX` — sequential test number **with three digits and leading zeros**: `001`, `002`, `010`, `123`, etc.
+  - full e2e title example:
+    - `test('OH-001 Отображается список заказов', async ({ page }) => { ... })` <!-- i18n-keep: E5 -->
+  - within one entity (`PREFIX`), test numbers must form a **consistent sequence** without duplicate numbers.
+
+# data-testid for e2e
+
+- **Selector priority:** `data-testid` for stable elements; `getByRole` and `getByLabel` for forms and accessible elements.
+- **Naming:** scheme `{parent}__{element}` (e.g. `history-page__title`, `history-page__recognition-banner__attach-files-button`).
+- **Where to add:** on page root containers and key interactive elements (buttons, links, fields) that page objects target.
+- **When UI changes:** update data-testid in components and matching selectors in page objects; align with `*.cases.md`.
+
+# Agent requirement
+
+When adding/changing e2e tests:
+- First look at the matching `*.cases.md` and sync scenario names.
+- Place specs next to plans in the same directory.
+- Reuse shared page objects and helpers; do not copy selectors into every test.

package/presets/claude/svelte/rules/testing/tests-unit.md

@@ -4,37 +4,37 @@ paths:
   - "**/*.{spec,test}.ts"
 ---
 
-# Общие правила тестирования
+# Shared testing rules
 
-- **Имена файлов:** новые тесты — **`*.spec.ts`**. Существующие `*.test.ts` не переименовывать без задачи.
-- **Runner:** Vitest (или как в проекте). Компоненты — **`@testing-library/svelte`** (не `@vue/test-utils`, не React Testing Library as default).
-- Проверять **поведение**, не внутренности.
-- **Именование** `describe` / `it`: формулировки **на русском**, каждое предложение с заглавной (как в ESLint `jest/valid-title` если включён).
+- **File names:** new tests — **`*.spec.ts`**. Do not rename existing `*.test.ts` without a task.
+- **Runner:** Vitest (or as in the project). Components — **`@testing-library/svelte`** (not `@vue/test-utils`, not React Testing Library as default).
+- Assert **behavior**, not internals.
+- **`describe` / `it` naming:** formulate titles **in Russian**, each sentence capitalized (as with ESLint `jest/valid-title` if enabled). <!-- i18n-keep: E5 -->
 
 ```typescript
 // ✅
-it('Возвращает пустой список. Пользователь не авторизован', () => {})
+it('Возвращает пустой список. Пользователь не авторизован', () => {}) // <!-- i18n-keep: E5 -->
 
 // ❌
 it('Returns empty list when user is guest', () => {})
 ```
 
-# Компоненты
+# Components
 
-- `render` из `@testing-library/svelte`.
-- Взаимодействия: `userEvent` из `@testing-library/user-event` когда принято в репо.
+- `render` from `@testing-library/svelte`.
+- Interactions: `userEvent` from `@testing-library/user-event` when that is the repo convention.
 
-# Изоляция
+# Isolation
 
-- Мокать `$lib/api` / stores по паттерну соседей.
-- Не мокать публичный контракт фичи без нужды.
+- Mock `$lib/api` / stores per neighbor patterns.
+- Do not mock the feature’s public contract without need.
 
 # HTTP / mappers
 
-- Изменения общего HTTP‑клиента — behavior‑тесты рядом с `src/lib/clients/**`.
-- Мапперы DTO→domain — unit‑тесты на edge‑кейсы.
+- Changes to the shared HTTP client — behavior tests next to `src/lib/clients/**`.
+- DTO→domain mappers — unit tests for edge cases.
 
-# Размещение
+# Placement
 
-- UI: соседний `*.spec.ts` (не обязательный `__tests__/` внутри компонента).
-- Другие модули — как у соседей.
+- UI: neighboring `*.spec.ts` (no required `__tests__/` inside the component).
+- Other modules — as neighbors do.