@bonesofspring/ai-rules 0.2.14 → 0.2.16

package/presets/cursor/ios-swift/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.
@@ -27,6 +26,7 @@ Cursor `.mdc` — **SoT per stack**. Claude topic `.md` — derived twin.
 | `mcp-ts` | `presets/cursor/mcp-ts/rules/*.mdc` | `presets/claude/mcp-ts/rules/<topic>/` | Keep in `claude/mcp-ts/rules/README.md` |
 | `php-hexagonal` | `presets/cursor/php-hexagonal/rules/*.mdc` | `presets/claude/php-hexagonal/rules/<topic>/` | Keep in `claude/php-hexagonal/rules/README.md` |
 | `php-laravel` | `presets/cursor/php-laravel/rules/*.mdc` | `presets/claude/php-laravel/rules/<topic>/` | Keep in `claude/php-laravel/rules/README.md` |
+| `android-kotlin` | `presets/cursor/android-kotlin/rules/*.mdc` | `presets/claude/android-kotlin/rules/<topic>/` | Keep in `claude/android-kotlin/rules/README.md` |
 
 ## Same-PR checklist
 
@@ -51,5 +51,6 @@ Cursor `.mdc` — **SoT per stack**. Claude topic `.md` — derived twin.
 - **mcp-ts:** missing Claude twin for a changed Cursor rule → **FAIL** (same as next / ios-swift / go / java; mapping table required).
 - **php-hexagonal:** missing Claude twin for a changed Cursor rule → **FAIL** (same as next / ios-swift / go / java / mcp-ts; mapping table required).
 - **php-laravel:** missing Claude twin for a changed Cursor rule → **FAIL** (same as next / ios-swift / go / java / mcp-ts / php-hexagonal; mapping table required).
+- **android-kotlin:** missing Claude twin for a changed Cursor rule → **FAIL** (same as next / ios-swift / go / java / mcp-ts / php-*; mapping table required).
 
 Dogfood: sync packages → root `.cursor/` after Cursor SoT changes (not the reverse). Use `packages/ai-rules/scripts/sync-dogfood-cursor.sh`.

package/presets/cursor/ios-swift/rules/reference-features.mdc

@@ -1,5 +1,5 @@
 ---
-description: Эталонные Feature-модули репозитория — копировать структуру при реализации. Заполните пути после init в целевом iOS-репо.
+description: Reference Feature modules of the repository — copy structure when implementing. Fill in paths after init in the target iOS repo.
 globs:
   - Features/**/*
   - "**/Presentation/**/*"
@@ -11,44 +11,44 @@ alwaysApply: false
 
 <!-- shared-core: architecture/reference-features.template.md -->
 
-# Эталонные фичи (reference features)
+# Reference features
 
 ## Stack notes
 
-Перед реализацией найди Feature того же типа и **повтори её структуру**, не изобретая новую организацию файлов.
+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
 
-После `ai-rules init` замени примеры на **реальные** пути consumer-репо. Ниже — conventional placeholders для greenfield / dogfood.
+After `ai-rules init`, replace examples with **real** consumer-repo paths. Below — conventional placeholders for greenfield / dogfood.
 
-| Слой | Эталон (пример → заменить) | Conventional glob / path |
+| Layer | Reference (example → replace) | Conventional glob / path |
 |------|----------------------------|--------------------------|
 | Feature module | `Features/Orders/` | `Features/**` |
 | Presentation / UI | `Features/Orders/Presentation/` | `**/Presentation/**`, `**/DesignSystem/**` |
 | Domain | `Features/Orders/Domain/` | `**/Domain/**` |
 | Data / Network | `Features/Orders/Data/` | `**/Data/**`, `**/Network*/**` |
 | Persistence | `Features/Orders/Data/Persistence/` | `**/Persistence/**`, `**/Keychain/**` |
-| Unit tests | `Features/OrdersTests/` или `*Tests` рядом | `**/*Tests/**/*.swift` |
+| Unit tests | `Features/OrdersTests/` or colocated `*Tests` | `**/*Tests/**/*.swift` |
 | UI tests | `OrdersUITests/` | `**/*UITests/**/*.swift` |
 
-Если в репо другая раскладка (`Modules/`, `Sources/`) — перепиши таблицу один раз и держи её SoT для агентов.
+If the repo uses another layout (`Modules/`, `Sources/`) — rewrite the table once and keep it as SoT for agents.
 
-## Как использовать
+## How to use
 
-1. Определи затронутые слои из `decomposition.md` или задачи.
-2. Открой эталон из таблицы (после заполнения путей).
-3. Зеркаль именование, порядок файлов, DI, паттерны тестов.
-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, DI, and test patterns.
+4. If there is no reference — pick the **closest** existing feature of the same layer and record the choice in the handoff.
 
-## Dogfood checklist (5 сценариев)
+## Dogfood checklist (5 scenarios)
 
-Прогон после init пресета (ручной smoke для агентов):
+Run after preset init (manual smoke for agents):
 
-1. `/task` новая фича в `Features/<Name>` — analyst → developer → build-verifier (xcodebuild).
-2. Баг в ViewModel — debugger → fix → unit test.
-3. Mapper DTO↔domain — unit-test-planner/generator.
+1. `/task` new feature under `Features/<Name>` — analyst → developer → build-verifier (xcodebuild).
+2. ViewModel bug — debugger → fix → unit test.
+3. DTO↔domain mapper — unit-test-planner/generator.
 4. UI flow — `xcuitest-test-planner` → generator (accessibilityIdentifier).
 5. Auth/Keychain touch — security-reviewer + `security-ios.mdc`.
 
@@ -56,8 +56,8 @@ Taxonomy / shared core: [`presets/_shared/README.md`](../../../../_shared/README
 
 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` — повторять паттерны.
-- `feature-delivery-workflow.mdc` — порядок слоёв.
-- skill `feature-delivery` — end-to-end сценарий.
+- `code-quality-and-refactoring.mdc` — repeat patterns.
+- `feature-delivery-workflow.mdc` — layer order.
+- skill `feature-delivery` — end-to-end scenario.

package/presets/cursor/ios-swift/rules/security-ios.mdc

@@ -1,5 +1,5 @@
 ---
-description: ATS, Keychain, PII, секреты, безопасное логирование iOS
+description: ATS, Keychain, PII, secrets, safe iOS logging
 globs:
   - "**/*Keychain*.swift"
   - "**/*Auth*.swift"
@@ -11,25 +11,25 @@ alwaysApply: false
 
 # Security (iOS)
 
-## Секреты и конфиг
+## Secrets and config
 
-- Нет API keys / tokens в исходниках и git; использовать Keychain, xcconfig (не в VCS), CI secrets.
-- Debug-only bypass ATS / SSL — только `#if DEBUG` и никогда в Release.
+- No API keys / tokens in sources or git; use Keychain, xcconfig (not in VCS), CI secrets.
+- Debug-only ATS / SSL bypass — `#if DEBUG` only and never in Release.
 
-## ATS и сеть
+## ATS and networking
 
-- ATS exceptions в Info.plist — минимальные, с обоснованием; предпочитать HTTPS.
-- Certificate pinning — только если уже принято в репо.
+- ATS exceptions in Info.plist — minimal, with rationale; prefer HTTPS.
+- Certificate pinning — only if already adopted in the repo.
 
-## PII и логи
+## PII and logs
 
-- Не логировать токены, пароли, полные номера карт/документов.
-- Crash/APM: scrub PII по политике репо.
+- Do not log tokens, passwords, full card/document numbers.
+- Crash/APM: scrub PII per repo policy.
 
-## Keychain / биометрия
+## Keychain / biometrics
 
-- Accessible уровни и `kSecAttrAccessible` — осознанно; Face ID/Touch ID — через LocalAuthentication как в репо.
+- Accessibility levels and `kSecAttrAccessible` — intentional; Face ID/Touch ID — via LocalAuthentication as in the repo.
 
-## Требование к агенту
+## Agent requirement
 
-При auth/формах/платежах — сверить с этим правилом и `code-review-mr.mdc`. Security-reviewer подключать для чувствительных фич.
+For auth/forms/payments — check this rule and `code-review-mr.mdc`. Involve security-reviewer for sensitive features.

package/presets/cursor/ios-swift/rules/state-and-viewmodels.mdc

@@ -1,43 +1,43 @@
 ---
-description: ViewModels, состояние экрана и domain flow
+description: ViewModels, screen state, and domain flow
 globs: "**/{Presentation,Domain}/**/*ViewModel*.swift"
 alwaysApply: false
 ---
 
-# Общие принципы
+# General principles
 
-- ViewModel — **единственная точка** orchestration для экрана: load, submit, validation, navigation intents.
-- Хранить и отдавать во View **domain models** и UI-specific state (loading, error message, selected tab).
-- `@MainActor` на ViewModel; тяжёлую работу — в use case / repository (`async`), не блокировать main thread.
+- ViewModel is the **single orchestration point** for a screen: load, submit, validation, navigation intents.
+- Store and expose to the View **domain models** and UI-specific state (loading, error message, selected tab).
+- `@MainActor` on ViewModel; heavy work — in use case / repository (`async`); do not block the main thread.
 - Unidirectional flow: View → intent → ViewModel → use case → state update → View.
 
 # State
 
-- Явный enum или struct для UI state где уместно:
-  - `idle`, `loading`, `loaded(Data)`, `failed(Error)` — или аналог из репо.
-- Избегать множества несинхронизированных `@Published` флагов, если один enum покрывает сценарий.
-- `@Observable` / `ObservableObject` — как в проекте; не смешивать стили в одной фиче без причины.
+- Explicit enum or struct for UI state where appropriate:
+  - `idle`, `loading`, `loaded(Data)`, `failed(Error)` — or the repo’s analog.
+- Avoid many unsynchronized `@Published` flags when one enum covers the scenario.
+- `@Observable` / `ObservableObject` — as in the project; do not mix styles in one feature without reason.
 
-# Use cases и repositories
+# Use cases and repositories
 
-- ViewModel зависит от **протоколов** (`LoadOrdersUseCase`, `OrderRepository`), не от `*RepositoryImpl`.
-- Один use case — одна бизнес-операция; не раздувать ViewModel сотнями строк — выносить use cases в Domain.
-- Кэширование и offline — в repository/Data, не во ViewModel.
+- ViewModel depends on **protocols** (`LoadOrdersUseCase`, `OrderRepository`), not `*RepositoryImpl`.
+- One use case — one business operation; do not inflate ViewModels to hundreds of lines — extract use cases into Domain.
+- Caching and offline — in repository/Data, not in ViewModel.
 
 # Side effects
 
-- Analytics, haptics, deep links — через injected services или middleware-паттерн, не hardcode синглтонов.
-- `Task` в ViewModel: отмена при `deinit` / `onDisappear` где нужно (`task(id:)`, хранение `Task?` с cancel).
+- Analytics, haptics, deep links — via injected services or a middleware pattern, not hardcoded singletons.
+- `Task` in ViewModel: cancel on `deinit` / `onDisappear` when needed (`task(id:)`, store `Task?` with cancel).
 
-# Тестируемость
+# Testability
 
-- Инициализатор ViewModel принимает протоколы (DI); без скрытых singleton для сети/БД.
-- Бизнес-ветки покрывать unit-тестами с mock use cases.
+- ViewModel initializer takes protocols (DI); no hidden network/DB singletons.
+- Cover business branches with unit tests using mock use cases.
 
-# Требование к агенту
+# Agent requirement
 
-При создании ViewModel:
-- Не вызывать `URLSession` / API client напрямую.
-- Не парсить JSON и не объявлять DTO во ViewModel.
-- Именование: `FeatureViewModel`, методы — глаголы (`loadOrders()`, `submitOrder()`).
-- Следовать стилю существующих ViewModels в той же фиче.
+When creating a ViewModel:
+- Do not call `URLSession` / API client directly.
+- Do not parse JSON or declare DTOs in the ViewModel.
+- Naming: `FeatureViewModel`, methods as verbs (`loadOrders()`, `submitOrder()`).
+- Follow the style of existing ViewModels in the same feature.

package/presets/cursor/ios-swift/rules/swift-conventions.mdc

@@ -7,28 +7,28 @@ alwaysApply: false
 # Naming and API design
 
 - Types: `UpperCamelCase`; methods, properties, enum cases: `lowerCamelCase`.
-- Protocols, описывающие capability: `-able`, `-ing`, или `Protocol` суффикс — как в репо.
-- Избегать аббревиатур в именах, кроме общепринятых (URL, ID, HTTP).
+- Protocols that describe a capability: `-able`, `-ing`, or `Protocol` suffix — as in the repo.
+- Avoid abbreviations in names except common ones (URL, ID, HTTP).
 
 # Optionals and errors
 
 ```swift
-// ❌ Плохо
+// ❌ Bad
 let name = user!.name
 
-// ✅ Хорошо
+// ✅ Good
 guard let name = user?.name else { return }
 ```
 
-- `throws` + typed errors вместо `Result` там, где так принято в слое; быть консistent внутри модуля.
-- `guard` для early exit; не вкладывать глубокие `if let` pyramids.
+- `throws` + typed errors instead of `Result` where that is the layer convention; stay consistent within a module.
+- `guard` for early exit; do not nest deep `if let` pyramids.
 
 # Concurrency
 
 - UI types — `@MainActor`.
-- Shared mutable state — `actor` или isolation через queue; document thread expectations.
-- `Task { }` в ViewModel: учитывать cancellation; `[weak self]` в escaping closures при retain cycles (default when capturing `self` in escaping work).
-- Prefer `async/await` over completion handlers для нового кода.
+- Shared mutable state — `actor` or isolation via a queue; document thread expectations.
+- `Task { }` in ViewModel: account for cancellation; `[weak self]` in escaping closures when retain cycles are possible (default when capturing `self` in escaping work).
+- Prefer `async/await` over completion handlers for new code.
 
 ## Anti-hallucination (Swift / concurrency)
 
@@ -42,20 +42,20 @@ guard let name = user?.name else { return }
 
 # Access control
 
-- Минимально необходимый уровень: `private` / `fileprivate` по умолчанию для implementation details.
-- Public API фичи — явные types и protocols; не экспортировать DTO наружу модуля.
+- Minimum necessary level: `private` / `fileprivate` by default for implementation details.
+- Feature public API — explicit types and protocols; do not export DTOs outside the module.
 
 # Value semantics
 
-- Предпочитать `struct` для models и state где нет identity semantics.
-- `class` — когда нужен identity, inheritance, или Objective-C interop.
+- Prefer `struct` for models and state where there is no identity semantics.
+- `class` — when identity, inheritance, or Objective-C interop is required.
 
 # Extensions
 
-- Группировать extensions по типу; не складывать unrelated helpers в один `Extensions.swift` без структуры.
-- Protocol extensions для shared default behavior.
+- Group extensions by type; do not dump unrelated helpers into one unstructured `Extensions.swift`.
+- Protocol extensions for shared default behavior.
 
-# Требование к агенту
+# Agent requirement
 
 - Style gate: **SwiftLint** (and SwiftFormat when configured) — prefer fixing lint over prose style essays; `// swiftlint:disable` only with an explicit reason.
-- Новый код — Swift Concurrency-ready (`Sendable` где требует компилятор/линтер проекта).
+- New code — Swift Concurrency-ready (`Sendable` where the project compiler/linter requires it).

package/presets/cursor/ios-swift/rules/swiftui-ui.mdc

@@ -1,24 +1,24 @@
 ---
-description: Паттерны SwiftUI, View и Design System (preset)
+description: SwiftUI, View, and Design System patterns (preset)
 globs: "**/{Presentation,DesignSystem}/**/*.swift"
 alwaysApply: false
 ---
 
-# Общие правила View
+# General View rules
 
-- **SwiftUI** — приоритет; UIKit — только по конвенции репо (wrapper, legacy).
-- View должна быть **тонкой**:
-  - отображает state из ViewModel;
-  - делегирует действия через методы/closures ViewModel;
-  - не содержит бизнес-логики, маппинга DTO, сетевых вызовов.
-- Перед новым кастомным контролом — искать компонент в `DesignSystem/` или существующих фичах.
-- Повторяемую UI-логику выносить в `ViewModifier`, `@ViewBuilder` helpers или subviews.
+- **SwiftUI** preferred; UIKit only by repo convention (wrapper, legacy).
+- Views must be **thin**:
+  - render state from the ViewModel;
+  - delegate actions through ViewModel methods/closures;
+  - contain no business logic, DTO mapping, or network calls.
+- Before a new custom control — look for a component in `DesignSystem/` or existing features.
+- Extract repeated UI logic into `ViewModifier`, `@ViewBuilder` helpers, or subviews.
 
-# ViewModel и binding
+# ViewModel and binding
 
-- ViewModel — `@MainActor`, `@Observable` (iOS 17+) или `ObservableObject` — как принято в проекте.
-- View читает state и вызывает **явные методы** ViewModel (`submit()`, `load()`), а не мутирует внутреннее состояние напрямую.
-- Для навигации — coordinator/router или enum route в ViewModel, не размазанные `NavigationLink` с бизнес-условиями в View.
+- ViewModel — `@MainActor`, `@Observable` (iOS 17+) or `ObservableObject` — as adopted in the project.
+- The View reads state and calls **explicit ViewModel methods** (`submit()`, `load()`); it does not mutate internal state directly.
+- For navigation — coordinator/router or a route enum in the ViewModel, not scattered `NavigationLink`s with business conditions in the View.
 
 # Lifecycle, ownership, hit testing
 
@@ -28,42 +28,42 @@ alwaysApply: false
 - Transparent stacks that should receive taps: `.contentShape(Rectangle())`.
 - High-frequency visual updates — prefer `TimelineView` (or repo pattern) over ad-hoc `Timer` in Views.
 
-# Структура файлов
+# File structure
 
-Для экрана фичи:
-- `FeatureView.swift` — композиция subviews.
+For a feature screen:
+- `FeatureView.swift` — subview composition.
 - `FeatureViewModel.swift` — state + intents.
-- `FeatureView+Subviews.swift` — при большом дереве (опционально).
-- `FeatureRoute.swift` — навигация (если используется).
+- `FeatureView+Subviews.swift` — for a large tree (optional).
+- `FeatureRoute.swift` — navigation (when used).
 
-Для компонента Design System:
-- Папка `ComponentName/`:
+For a Design System component:
+- Folder `ComponentName/`:
   - `ComponentName.swift`
-  - `ComponentName+Preview.swift` (опционально)
-  - `ComponentNameStyle.swift` — стили/варианты (опционально)
+  - `ComponentName+Preview.swift` (optional)
+  - `ComponentNameStyle.swift` — styles/variants (optional)
 
-# Стили и Design System
+# Styles and Design System
 
-- Цвета, шрифты, отступы — из **токенов/Theme** проекта (`DesignSystem`, `Assets`, generated tokens).
-- Избегать:
-  - «магических» литералов (`.padding(17)`, `Color(red: 0.2, ...)`), если есть токены;
-  - дублирования стилей, уже закрытых примитивами.
-- `Preview` — для компонентов и экранов с mock ViewModel.
+- Colors, fonts, spacing — from project **tokens/Theme** (`DesignSystem`, `Assets`, generated tokens).
+- Avoid:
+  - “magic” literals (`.padding(17)`, `Color(red: 0.2, ...)`) when tokens exist;
+  - duplicating styles already covered by primitives.
+- `Preview` — for components and screens with a mock ViewModel.
 
 # Accessibility
 
-- Интерактивные элементы: осмысленные `accessibilityLabel`, `accessibilityHint` где нужно.
-- Для UI-тестов — стабильные `accessibilityIdentifier` на ключевых элементах (согласовать с `tests-ui.mdc`).
-- Поддерживать Dynamic Type и контраст, не ломать layout при крупном шрифте.
+- Interactive elements: meaningful `accessibilityLabel`, `accessibilityHint` where needed.
+- For UI tests — stable `accessibilityIdentifier` on key elements (align with `tests-ui.mdc`).
+- Support Dynamic Type and contrast; do not break layout at large text sizes.
 
-# Previews и локализация
+# Previews and localization
 
-- Строки UI — через `String(localized:)` / `LocalizedStringKey`, не hardcoded в production без причины.
-- `#Preview` с реалистичными mock-данными; для ViewModel — stub use cases.
+- UI strings via `String(localized:)` / `LocalizedStringKey`, not hardcoded in production without reason.
+- `#Preview` with realistic mock data; for ViewModels — stub use cases.
 
-# Требование к агенту
+# Agent requirement
 
-При создании/изменении UI:
-- Следовать существующим экранам и компонентам как эталону.
-- Не импортировать Data-слой во View/ViewModel.
-- Subview выделять, когда body превышает ~40–60 строк или повторяется.
+When creating/changing UI:
+- Follow existing screens and components as the reference.
+- Do not import the Data layer into View/ViewModel.
+- Extract a subview when body exceeds ~40–60 lines or repeats.

package/presets/cursor/ios-swift/rules/technical-retro.mdc

@@ -1,16 +1,16 @@
 ---
-description: Роль агента для проведения технического ретроспективы (retro) команды / спринта. On-demand — предпочтительнее slash-команда /technical-retro.
+description: Agent role for a technical retrospective (retro) of the team / sprint. On-demand — prefer the /technical-retro slash command.
 alwaysApply: false
 ---
 
 <!-- shared-core: review/technical-retro.md -->
 
-# Техническое ретро — rule alias
+# Technical retro — rule alias
 
-Полный сценарий (включая блок **«Работа агентов»** для slug из team tasks) — в slash-команде:
+Full scenario (including the **“Agent work”** block for a slug from team tasks) lives in the slash command:
 
 **`commands/technical-retro.md`** → `/technical-retro`
 
 When a task has `metrics.json`, use the local aggregation script and state the cohort, sample size, incomplete artifacts, attribution confidence, active attempt duration, and human-gate wait separately. Do not score malformed artifacts or gate wait as agent work.
 
-Используй rule только если command недоступен. Не дублируй содержимое command в ответе — следуй command-файлу и skill `technical-retro`.
+Use this rule only if the command is unavailable. Do not duplicate the command contents in the response — follow the command file and skill `technical-retro`.

package/presets/cursor/ios-swift/rules/tests-ui.mdc

@@ -1,42 +1,43 @@
 ---
-description: UI-тесты XCUITest и accessibility identifiers
+description: XCUITest UI tests and accessibility identifiers
 globs: "**/*UITests/**/*.swift"
 alwaysApply: false
 ---
 
-# Структура UI-тестов
+# UI test structure
 
-- UI Test target: `*UITests/` — сценарии пользовательских потоков.
-- Page Object (или Screen Object) — класс на экран: селекторы + действия (`LoginScreen`, `OrderHistoryScreen`).
-- Общие хелперы — `UITestSupport/`, base classes, launch arguments.
+- UI Test target: `*UITests/` — end-user flow scenarios.
+- Page Object (or Screen Object) — one class per screen: selectors + actions (`LoginScreen`, `OrderHistoryScreen`).
+- Shared helpers — `UITestSupport/`, base classes, launch arguments.
 
-# Селекторы и стабильность
+# Selectors and stability
 
-- **Приоритет:** `accessibilityIdentifier` для ключевых элементов; затем label/trait где устойчиво.
-- Идентификаторы согласовать с Presentation-слоем (`swiftui-ui.mdc`): `{screen}__{element}`.
-  - Пример: `order-history__submit-button`, `login__email-field`.
-- Избегать привязки к абсолютным координатам и хрупким XPath-подобным цепочкам.
+- **Priority:** `accessibilityIdentifier` for key elements; then label/trait where stable.
+- Align identifiers with the Presentation layer (`swiftui-ui.mdc`): `{screen}__{element}`.
+  - Example: `order-history__submit-button`, `login__email-field`.
+- Avoid absolute coordinates and brittle XPath-like chains.
 
-# Сценарии и именование
+# Scenarios and naming
 
-- Названия тестов — **на русском**, с префиксом сущности:
-  - `OH-001 Отображается список заказов` (префикс — первые буквы сущности, номер — три цифры).
-- Один тест — один пользовательский сценарий; не объединять несвязанные проверки.
+- Test names — **in the product locale** (Russian when UI copy is Russian), with an entity prefix:
+  <!-- i18n-keep: E5 -->
+  - `OH-001 Отображается список заказов` (prefix — entity initials, number — three digits).
+- One test — one user scenario; do not combine unrelated checks.
 
-# Launch и окружение
+# Launch and environment
 
-- `-UITesting`, mock server URL, сброс state — через `launchArguments` / `launchEnvironment`, как в репо.
-- Не зависеть от прод-backend в CI; использовать staging/mock.
+- `-UITesting`, mock server URL, state reset — via `launchArguments` / `launchEnvironment`, as in the repo.
+- Do not depend on production backend in CI; use staging/mock.
 
-# Синхронизация с UI
+# Sync with UI
 
-- При изменении UI обновлять identifiers в View и селекторы в page objects.
-- Не ослаблять assertions против бизнес-ожиданий ради «зелёного» CI.
+- When UI changes, update identifiers in Views and selectors in page objects.
+- Do not weaken assertions against business expectations just to keep CI green.
 
-# Требование к агенту
+# Agent requirement
 
-При добавлении UI-тестов:
-- Переиспользовать page objects, не дублировать query в каждом тесте.
-- Добавлять `accessibilityIdentifier` в SwiftUI через `.accessibilityIdentifier(...)` для новых интерактивных элементов.
-- Следовать существующим UITest files как эталону.
-- Планирование / генерация / heal — agents `xcuitest-test-{planner,generator,healer}` и skill `xcuitest-e2e` (не Playwright).
+When adding UI tests:
+- Reuse page objects; do not duplicate queries in every test.
+- Add `accessibilityIdentifier` in SwiftUI via `.accessibilityIdentifier(...)` for new interactive elements.
+- Follow existing UITest files as the reference.
+- Planning / generation / heal — agents `xcuitest-test-{planner,generator,healer}` and skill `xcuitest-e2e` (not Playwright).

package/presets/cursor/ios-swift/rules/tests-unit.mdc

@@ -1,41 +1,41 @@
 ---
-description: Unit и integration тесты (XCTest / Swift Testing)
+description: Unit and integration tests (XCTest / Swift Testing)
 globs: "**/*Tests/**/*.swift"
 alwaysApply: false
 ---
 
-# Общие правила тестирования
+# General testing rules
 
-- **Framework** — XCTest или Swift Testing, как в проекте.
-- Цель: проверять **поведение и бизнес-правила**, не детали реализации и private API.
-- Именование:
-  - `test` / `@Test` descriptions и `XCTContext` — **на русском**, как понятные бизнес-фразы.
-  - Описания **с заглавной буквы**.
+- **Framework** — XCTest or Swift Testing, as in the project.
+- Goal: verify **behavior and business rules**, not implementation details and private API.
+- Naming:
+  - `test` / `@Test` descriptions and `XCTContext` — **in the product locale** (Russian when UI copy is Russian), as clear business phrases.
+  - Descriptions **start with a capital letter**.
 
-# ViewModel и use case
+# ViewModel and use case
 
-- Mock протоколов repositories / use cases; не поднимать реальную сеть.
-- Проверять переходы state: loading → success/failure, validation errors, edge cases.
-- `@MainActor` ViewModel тестировать с `@MainActor` test methods или `await MainActor.run`.
+- Mock repository / use case protocols; do not hit the real network.
+- Assert state transitions: loading → success/failure, validation errors, edge cases.
+- Test `@MainActor` ViewModels with `@MainActor` test methods or `await MainActor.run`.
 
-# Mappers и domain
+# Mappers and domain
 
-- Mapper functions — unit-тесты с таблицами кейсов: nil fields, empty arrays, граничные значения.
-- Regression на бизнес-правила (скидки, статусы, форматирование дат).
+- Mapper functions — unit tests with case tables: nil fields, empty arrays, boundary values.
+- Regressions on business rules (discounts, statuses, date formatting).
 
-# Изоляция
+# Isolation
 
-- Не мокать то, что является предметом теста (например, сам mapper при тесте mapper).
-- Fixtures — в `TestSupport/`, `Mocks/` или рядом по конвенции репо; не дублировать большие JSON inline без нужды.
+- Do not mock the subject under test (e.g. the mapper itself when testing the mapper).
+- Fixtures — in `TestSupport/`, `Mocks/`, or colocated per repo convention; do not inline large JSON without need.
 
-# Структура файлов
+# File structure
 
-- `FeatureViewModelTests.swift`, `OrderMapperTests.swift` — суффикс `Tests` в имени типа/файла по стилю Xcode.
-- Не создавать глубокую вложенность `Tests/Tests/`; следовать target structure проекта.
+- `FeatureViewModelTests.swift`, `OrderMapperTests.swift` — `Tests` suffix on type/file name per Xcode style.
+- Do not create deep `Tests/Tests/` nesting; follow the project target structure.
 
-# Требование к агенту
+# Agent requirement
 
-При добавлении тестов:
-- Копировать паттерны из существующих test files в репо.
-- Добавлять тесты для новых веток логики и регрессий.
-- Использовать DTO fixtures из Data layer и domain types из Domain, не дублировать типы в тестах.
+When adding tests:
+- Copy patterns from existing test files in the repo.
+- Add tests for new logic branches and regressions.
+- Use DTO fixtures from the Data layer and domain types from Domain; do not duplicate types in tests.