@bonesofspring/ai-rules 0.2.13 → 0.2.15

package/presets/cursor/ios-swift/rules/design-guidance.mdc

@@ -9,98 +9,98 @@ alwaysApply: false
 
 # Design guidance (smells & patterns)
 
-Словарь **code smells** (Fowler) и **design patterns** (GoF) для агентов при implement / review / debug.
+Glossary of **code smells** (Fowler) and **design patterns** (GoF) for agents during implement / review / debug.
 
-Применять только в scope задачи или MR. Лёгкий refactor — да; «большой» rewrite без явного запроса — нет.
+Apply only within the task or MR scope. Light refactor — yes; a “big” rewrite without an explicit request — no.
 
-Называть паттерн **только если** репозиторий уже так делает или это минимальный match. Иначе — extract/split/move без ярлыка GoF.
+Name a pattern **only if** the repository already does it that way or the match is minimal. Otherwise — extract/split/move without a GoF label.
 
-Не заменяет always-on Principles в `code-quality-and-refactoring` (KISS, DRY + Rule of Three, YAGNI, SOLID, CUPID, composition, Demeter).
+Does not replace always-on Principles in `code-quality-and-refactoring` (KISS, DRY + Rule of Three, YAGNI, SOLID, CUPID, composition, Demeter).
 
 ## When to load
 
-- **Feature delivery / implement** — оценка структуры модулей, границ и дублирования.
-- **Code review** — smells и pattern fit **в диффе MR**, не по всему репо.
-- **Debug** — root-cause похож на wrong abstraction, Feature Envy, Message Chains, Shotgun Surgery.
-- **Light refactor only** — улучшения в рамках boy-scout / MR scope; не расширять задачу ради каталога.
+- **Feature delivery / implement** — assess module structure, boundaries, and duplication.
+- **Code review** — smells and pattern fit **in the MR diff**, not across the whole repo.
+- **Debug** — root cause looks like wrong abstraction, Feature Envy, Message Chains, Shotgun Surgery.
+- **Light refactor only** — improvements within boy-scout / MR scope; do not expand the task for the catalog.
 
-Агенты и skills подгружают stem по one-liner wiring — не копировать этот каталог в промпт агента.
+Agents and skills load this stem via one-liner wiring — do not copy this catalog into the agent prompt.
 
 ## How to use (agent rules of thumb)
 
-1. Сначала сверить с Principles (always-on): проще ли решение, нет ли ранней абстракции, соблюдён ли public API.
-2. Затем отметить smells **в изменённых файлах** задачи/MR; предложить fix только если он укладывается в light refactor.
-3. Паттерн GoF — опциональный ярлык после того, как структура уже ясна; не начинать дизайн с выбора паттерна.
-4. Если smell и паттерн конфликтуют с границами слоёв стека — побеждают stack boundaries и existing repo patterns.
-5. Не требовать переименования «под GoF», если поведение уже корректно и читаемо.
+1. First check against Principles (always-on): is the solution simpler, is there no premature abstraction, is the public API respected.
+2. Then mark smells **in the changed files** of the task/MR; propose a fix only if it fits a light refactor.
+3. A GoF pattern is an optional label after the structure is already clear; do not start design by picking a pattern.
+4. If a smell or pattern conflicts with stack layer boundaries — stack boundaries and existing repo patterns win.
+5. Do not require renaming “for GoF” if behavior is already correct and readable.
 
 ## Code smells (Fowler, curated ≤12)
 
-Таблица: smell → detect hint → fix hint (одна линия каждый). Без механических меню рефакторинга.
+Table: smell → detect hint → fix hint (one line each). No mechanical refactoring menus.
 
 | # | Smell | Detect | Fix hint |
 |---|-------|--------|----------|
-| 1 | Duplicate Code | одинаковая логика в ≥2 местах | dedupe после Rule of Three |
-| 2 | Long Method / Long Module | единица делает слишком много | extract в рамках scope; без big rewrite |
-| 3 | Feature Envy | метод чаще трогает чужие данные, чем свои | сдвинуть логику к данным / public API |
-| 4 | Data Clumps | одни и те же группы аргументов кочуют вместе | сгруппировать в type / value object |
-| 5 | Primitive Obsession | сырые string/int вместо доменных понятий | typed ids / value objects при нужде домена |
-| 6 | Speculative Generality | неиспользуемые хуки, флаги, абстракции «на будущее» | удалить (YAGNI) |
-| 7 | Message Chains | цепочки `a.b.c.d` | Demeter; facade / public API модуля |
-| 8 | Middle Man | класс почти только прокидывает вызовы | убрать pass-through **или** оставить как boundary |
-| 9 | Divergent Change | один модуль меняется по разным причинам | split по поводам изменения |
-| 10 | Shotgun Surgery | одно смысловое изменение разъезжается по многим файлам | consolidate ответственность |
-| 11 | Inappropriate Intimacy | доступ к чужим internals / private деталям | только public API / ports / facades |
-| 12 | Refused Bequest / Parallel Inheritance | подтип игнорирует базу; зеркальные иерархии классов | composition; не плодить параллельные деревья |
-
-**Skip Fowler (не в core):** Lazy Class, Incomplete Library Class, Comments-as-smell dogma, полный каталог 70+, пошаговые recipe-меню.
-
-Приоритет при конфликте smells: Inappropriate Intimacy и Message Chains (границы модулей) > Duplicate Code (после Rule of Three) > Long Method внутри уже правильного модуля.
+| 1 | Duplicate Code | same logic in ≥2 places | dedupe after Rule of Three |
+| 2 | Long Method / Long Module | unit does too much | extract within scope; no big rewrite |
+| 3 | Feature Envy | method touches foreign data more than its own | move logic toward the data / public API |
+| 4 | Data Clumps | the same argument groups travel together | group into a type / value object |
+| 5 | Primitive Obsession | raw string/int instead of domain concepts | typed ids / value objects when the domain needs them |
+| 6 | Speculative Generality | unused hooks, flags, “for later” abstractions | remove (YAGNI) |
+| 7 | Message Chains | `a.b.c.d` chains | Demeter; facade / module public API |
+| 8 | Middle Man | class almost only forwards calls | remove pass-through **or** keep as a boundary |
+| 9 | Divergent Change | one module changes for different reasons | split by reasons to change |
+| 10 | Shotgun Surgery | one semantic change spreads across many files | consolidate responsibility |
+| 11 | Inappropriate Intimacy | access to foreign internals / private details | public API / ports / facades only |
+| 12 | Refused Bequest / Parallel Inheritance | subtype ignores base; mirrored class hierarchies | composition; do not grow parallel trees |
+
+**Skip Fowler (not in core):** Lazy Class, Incomplete Library Class, Comments-as-smell dogma, full 70+ catalog, step-by-step recipe menus.
+
+Smell conflict priority: Inappropriate Intimacy and Message Chains (module boundaries) > Duplicate Code (after Rule of Three) > Long Method inside an already correct module.
 
 ## Design patterns (GoF, curated ≤8)
 
-Suggest only when repo already uses the shape or the match is minimal. Prefer extract-function over naming Strategy ради ярлыка.
+Suggest only when repo already uses the shape or the match is minimal. Prefer extract-function over naming Strategy for the label alone.
 
-Паттерны ниже — **разрешённый минимум** для агентов; остальной GoF по умолчанию в Skip.
+Patterns below are the **allowed minimum** for agents; the rest of GoF is Skip by default.
 
 | Pattern | When to suggest | Anti-trigger |
 |---------|-----------------|--------------|
-| Strategy | взаимозаменяемые алгоритмы уже (или явно скоро) выбираются политикой | один алгоритм без ветвления политики |
-| Adapter | обернуть внешний / чужой API под локальный port | лишняя обёртка вокруг своего же API |
-| Facade | упростить multi-step subsystem за public API | facade превращается в god-object |
-| Factory Method | полиморфное создание уже принято в стиле репо | factory на каждый тривиальный `new` |
-| Decorator | аддитивное поведение без взрыва subclass-иерархий | decorator «для слоёв» без реальной нужды |
-| Observer | events / subscriptions уже есть в архитектуре | самодельный pub/sub без прецедента в репо |
-| Template Method | общий algorithm skeleton + вариативные hooks | наследование ради пары отличающихся строк |
-| Composite | дерево однородных узлов (UI/domain), как уже в репо | Composite на плоский список без иерархии |
+| Strategy | interchangeable algorithms already (or clearly soon) chosen by policy | one algorithm with no policy branching |
+| Adapter | wrap external / foreign API under a local port | extra wrapper around your own API |
+| Facade | simplify a multi-step subsystem behind a public API | facade turns into a god-object |
+| Factory Method | polymorphic creation already accepted in repo style | factory for every trivial `new` |
+| Decorator | additive behavior without exploding subclass hierarchies | decorator “for layers” with no real need |
+| Observer | events / subscriptions already exist in the architecture | homemade pub/sub with no repo precedent |
+| Template Method | shared algorithm skeleton + variable hooks | inheritance for a couple of differing lines |
+| Composite | tree of homogeneous nodes (UI/domain), as already in the repo | Composite on a flat list with no hierarchy |
 
-Если сомневаешься между двумя паттернами — выбери более простой extract/compose без имени; ярлык можно добавить на review, если репо уже так говорит.
+If unsure between two patterns — choose the simpler extract/compose without a name; the label may be added on review if the repo already speaks that way.
 
 ## Skip / avoid by default
 
 | Catalog | Skip |
 |---------|------|
 | GoF | Singleton, Abstract Factory, Flyweight, Memento, Interpreter, Visitor, Bridge, Prototype |
-| GoF (conditional) | Command, Chain of Responsibility, State — упоминать **только если** репо уже использует |
-| Fowler | всё сверх 12 smells выше |
-| DDD | Aggregates, bounded-context maps, event sourcing, CQRS — **не в core** |
-| DDD (pointer) | ubiquitous language anti-pattern — расширять в `feature-delivery-workflow`, не здесь |
-| GRASP | список Larman как отдельные правила — skip (перекрывается SOLID/CUPID) |
-| Clean Code dogma | жёсткие caps на строки функции / «ровно один assert» — skip |
+| GoF (conditional) | Command, Chain of Responsibility, State — mention **only if** the repo already uses them |
+| Fowler | everything beyond the 12 smells above |
+| DDD | Aggregates, bounded-context maps, event sourcing, CQRS — **not in core** |
+| DDD (pointer) | ubiquitous language anti-pattern — expand in `feature-delivery-workflow`, not here |
+| GRASP | Larman list as separate rules — skip (covered by SOLID/CUPID) |
+| Clean Code dogma | hard caps on function lines / “exactly one assert” — skip |
 
-Не вводить второй stem (`refactoring-smells` / `design-patterns-for-agents`) — один каталог: `design-guidance`.
+Do not introduce a second stem (`refactoring-smells` / `design-patterns-for-agents`) — one catalog: `design-guidance`.
 
 ## Out of scope for this stem
 
-- Полный GoF (23) и полный Fowler catalog.
-- Stack-specific рецепты (пути модулей, lint-команды) — только в **Stack notes** адаптера.
-- Security, a11y, perf — отдельные review-правила; здесь только структурные smells/patterns.
-- Четвёртое always-on правило — запрещено; этот stem только requestable / agent-load.
+- Full GoF (23) and full Fowler catalog.
+- Stack-specific recipes (module paths, lint commands) — only in the adapter **Stack notes**.
+- Security, a11y, perf — separate review rules; here only structural smells/patterns.
+- A fourth always-on rule — forbidden; this stem is requestable / agent-load only.
 
 ## Cross-refs
 
 - Always-on Principles: `code-quality-and-refactoring`.
-- DIP / ports vs adapters: stack `architecture-boundaries` (детали стека — в Stack notes адаптеров).
+- DIP / ports vs adapters: stack `architecture-boundaries` (stack details — in adapter Stack notes).
 - Ubiquitous language: `feature-delivery-workflow` (lineage).
 - MR checklist (smells in scope; pattern name only if repo uses it): `code-review-mr`.
 - Token / twin policy for authors: `preset-token-budget`, `preset-twin-sync` (meta, not consumer always-on).

package/presets/cursor/ios-swift/rules/feature-delivery-workflow.mdc

@@ -1,26 +1,26 @@
 ---
-description: Сквозной чеклист доставки iOS-фичи и матрица «зона → правило». Use when implementing features, adding screens/API, or extending existing iOS flows.
+description: End-to-end iOS feature delivery checklist and zone→rule matrix. Use when implementing features, adding screens/API, or extending existing iOS flows.
 alwaysApply: false
 ---
 
 <!-- shared-core: architecture/feature-delivery-workflow.md -->
 
-# Доставка фичи (iOS)
+# Feature delivery (iOS)
 
 ## Stack notes
 
-Типичная фича с данными и UI. Детали слоёв — `architecture-boundaries.mdc`, `ios-app-core.mdc`.
+Typical feature with data and UI. Layer details — `architecture-boundaries.mdc`, `ios-app-core.mdc`.
 
-## Чеклист (порядок работ)
+## Checklist (work order)
 
-1. **Domain** — entities, value types, протоколы репозиториев / use cases (`Features/**/Domain/**`).
-2. **Data** — DTO (`Codable`), mappers Domain ↔ DTO, реализации репозиториев, API-клиент (`networking-services.mdc`).
-3. **ViewModel** — состояние, вызовы use case / протоколов; DI из App; без DTO и URL (`state-and-viewmodels.mdc`).
-4. **View / navigation** — тонкие SwiftUI Views, Design System; навигация как в репо (`swiftui-ui.mdc`).
-5. **Тесты** — unit на mappers / use cases / VM (`tests-unit.mdc`); UI-потоки — XCUITest (`tests-ui.mdc`).
-6. **Завершение** — **вызвать** `post-change-build.mdc` (+ `xcode-tooling.mdc` для схем/команд): сборка затронутых таргетов + lint/format по конфигу репо.
+1. **Domain** — entities, value types, repository / use case protocols (`Features/**/Domain/**`).
+2. **Data** — DTOs (`Codable`), Domain ↔ DTO mappers, repository implementations, API client (`networking-services.mdc`).
+3. **ViewModel** — state, use case / protocol calls; DI from App; no DTOs or URLs (`state-and-viewmodels.mdc`).
+4. **View / navigation** — thin SwiftUI Views, Design System; navigation as in the repo (`swiftui-ui.mdc`).
+5. **Tests** — unit for mappers / use cases / VM (`tests-unit.mdc`); UI flows — XCUITest (`tests-ui.mdc`).
+6. **Completion** — **invoke** `post-change-build.mdc` (+ `xcode-tooling.mdc` for schemes/commands): build touched targets + lint/format per repo config.
 
-## Поток данных (ориентир)
+## Data flow (orientation)
 
 ```mermaid
 flowchart LR
@@ -32,36 +32,36 @@ flowchart LR
   DataImpl[Data impl] -.-> Repo
 ```
 
-## Частичные сценарии
+## Partial scenarios
 
-| Задача | Минимум |
-|--------|---------|
-| Только API / модель | Domain + DTO + mapper + repo impl; unit на mapper. |
-| Только VM / логика | Протоколы Domain; mock в тестах; без HTTP во View. |
-| Только UI | View + существующий VM/state; без DTO. |
-| Только тесты | Specs по конвенции репо; не менять production без нужды. |
+| Task | Minimum |
+|------|---------|
+| API / model only | Domain + DTO + mapper + repo impl; unit for mapper. |
+| VM / logic only | Domain protocols; mocks in tests; no HTTP in View. |
+| UI only | View + existing VM/state; no DTOs. |
+| Tests only | Specs per repo convention; do not change production without need. |
 
-## Антипаттерны
+## Anti-patterns
 
-- DTO / `Codable` transport-типы во View или ViewModel.
-- `URLSession` / конкретный API-клиент в ViewModel или View.
-- Domain импортирует SwiftUI / UIKit.
-- Deep-import внутренних файлов другой фичи.
-- Сборка DI внутри View.
-- **Ubiquitous language:** имена Domain/типов отражают предметную область фичи — не смешивать транспорт/фреймворк-термины в домен без нужды.
+- DTO / `Codable` transport types in View or ViewModel.
+- `URLSession` / concrete API client in ViewModel or View.
+- Domain imports SwiftUI / UIKit.
+- Deep-import of another feature’s internal files.
+- Assembling DI inside a View.
+- **Ubiquitous language:** Domain/type names reflect the feature domain — do not mix transport/framework terms into domain without need.
 - Load `design-guidance` (rule stem) when assessing structure, smells, or pattern fit.
 
-## Матрица: зона → правила
+## Matrix: zone → rules
 
-| Зона | Правила |
+| Zone | Rules |
 |------|---------|
 | `Features/**/Domain/**`, `Core/Domain/**` | `architecture-boundaries.mdc`, `ios-app-core.mdc` |
 | `Features/**/Data/**`, `**/Network*/**` | `networking-services.mdc`, `architecture-boundaries.mdc` |
 | `*ViewModel*.swift`, Presentation state | `state-and-viewmodels.mdc` |
 | `Presentation/**`, `DesignSystem/**` | `swiftui-ui.mdc`, `architecture-boundaries.mdc` |
-| `**/*.swift` (стиль) | `swift-conventions.mdc` |
+| `**/*.swift` (style) | `swift-conventions.mdc` |
 | `*Tests/**` | `tests-unit.mdc` |
 | `*UITests/**` | `tests-ui.mdc` |
-| После правок Swift | `post-change-build.mdc` |
+| After Swift edits | `post-change-build.mdc` |
 
-При добавлении или расширении фичи **пройти чеклист** и правила из таблицы для затронутых зон.
+When adding or extending a feature, **walk the checklist** and the table rules for touched zones.

package/presets/cursor/ios-swift/rules/ios-app-core.mdc

@@ -1,21 +1,21 @@
 ---
-description: Базовые принципы, стек и структура iOS приложения на Swift (preset)
+description: Core principles, stack, and structure for an iOS Swift app (preset)
 alwaysApply: true
 ---
 
-# Стек и окружение
+# Stack and environment
 
-Версии — **из Xcode / Package.swift / конфигов репо**. Рамка: Swift, iOS; SwiftUI приоритет (UIKit где принято); Xcode + SPM/CocoaPods как в репо; `async`/`await`, `@MainActor`; XCTest/Swift Testing + XCUITest; сеть — `URLSession`/`Codable`; UI — токены `DesignSystem/`; наблюдаемость — только если уже в проекте.
+Versions come **from Xcode / Package.swift / repo configs**. Frame: Swift, iOS; SwiftUI preferred (UIKit where the repo already uses it); Xcode + SPM/CocoaPods as in the repo; `async`/`await`, `@MainActor`; XCTest/Swift Testing + XCUITest; networking — `URLSession`/`Codable`; UI — `DesignSystem/` tokens; observability — only if already in the project.
 
-# Структура проекта
+# Project structure
 
-Feature-first или слои сверху (как в репо): `App/` (composition root), `Features/<Name>/` (Presentation / Domain / Data), `Core/`, `DesignSystem/`, `Tests/`. Новые файлы — рядом с аналогами. Границы/DI — **`architecture-boundaries.mdc`**.
+Feature-first or top-level layers (as in the repo): `App/` (composition root), `Features/<Name>/` (Presentation / Domain / Data), `Core/`, `DesignSystem/`, `Tests/`. Place new files next to analogs. Boundaries/DI — **`architecture-boundaries.mdc`**.
 
-# Swift и качество
+# Swift and quality
 
-API Design Guidelines + SwiftLint/SwiftFormat репо; без `!`/`try!` в production; `guard` / typed errors; паттерны соседних файлов.
+API Design Guidelines + the repo’s SwiftLint/SwiftFormat; no `!`/`try!` in production; `guard` / typed errors; follow neighboring-file patterns.
 
-# Работа агента
+# Agent work
 
-- Слой → паттерн соседей; без `URLSession` во View и DTO во ViewModel (`architecture-boundaries.mdc`).
-- Фичи: `feature-delivery-workflow.mdc`; после Swift — **вызвать** `post-change-build.mdc`; toolchain — `xcode-tooling.mdc`.
+- Layer → neighbor patterns; no `URLSession` in Views and no DTOs in ViewModels (`architecture-boundaries.mdc`).
+- Features: `feature-delivery-workflow.mdc`; after Swift edits — **invoke** `post-change-build.mdc`; toolchain — `xcode-tooling.mdc`.

package/presets/cursor/ios-swift/rules/module-public-api.mdc

@@ -1,5 +1,5 @@
 ---
-description: SPM / модули — public API, access control, запрет deep-import internals
+description: SPM / modules — public API, access control, ban deep-import of internals
 globs:
   - "**/Package.swift"
   - "**/*Public*.swift"
@@ -9,18 +9,18 @@ alwaysApply: false
 
 # Module public API (SPM)
 
-## Рамка
+## Frame
 
-- Потребители модуля импортируют **только public/open** API; `internal`/`fileprivate` — для реализации.
-- Deep-import чужих internal файлов — повод вынести символ в public API или рефакторить границы.
+- Module consumers import **only public/open** API; `internal`/`fileprivate` — for implementation.
+- Deep-import of another module’s internal files — reason to promote the symbol to public API or refactor boundaries.
 
-## Правила
+## Rules
 
-- Новый публичный тип/функция — явный `public` + документация/пример использования при необходимости.
-- Barrel-стиль: один входной модуль / umbrella, если так заведено в репо.
-- Не экспортировать DTO сети из Presentation-facing модулей.
-- Версионирование breaking API — осознанно (SemVer пакета / release notes).
+- New public type/function — explicit `public` + documentation/usage example when needed.
+- Barrel style: one entry module / umbrella when that is how the repo is set up.
+- Do not export network DTOs from Presentation-facing modules.
+- Breaking API versioning — intentional (package SemVer / release notes).
 
-## Требование к агенту
+## Agent requirement
 
-Перед `public` на тип — проверить, нужен ли он снаружи. Следовать access control соседних модулей.
+Before marking a type `public` — check whether it is needed externally. Follow neighboring modules’ access control.

package/presets/cursor/ios-swift/rules/navigation-coordinators.mdc

@@ -1,5 +1,5 @@
 ---
-description: NavigationStack, координаторы, deep links — границы Presentation
+description: NavigationStack, coordinators, deep links — Presentation boundaries
 globs:
   - "**/Presentation/**/*Navigator*.swift"
   - "**/Presentation/**/*Coordinator*.swift"
@@ -9,21 +9,21 @@ globs:
 alwaysApply: false
 ---
 
-# Навигация (iOS)
+# Navigation (iOS)
 
-## Рамка
+## Frame
 
-- **SwiftUI-first:** `NavigationStack` / `navigationDestination` / sheet / fullScreenCover — как в репо.
-- UIKit / coordinator — только если уже принят в модуле; не смешивать два стиля в одном Feature без причины.
-- Маршруты и deep links — **Presentation** (или App shell); Domain не знает о `NavigationPath`.
+- **SwiftUI-first:** `NavigationStack` / `navigationDestination` / sheet / fullScreenCover — as in the repo.
+- UIKit / coordinator — only if already adopted in the module; do not mix two styles in one Feature without reason.
+- Routes and deep links — **Presentation** (or App shell); Domain does not know about `NavigationPath`.
 
-## Правила
+## Rules
 
-- Один Feature — один явный «вход» навигации (root view / coordinator), не размазывать `NavigationLink` по Data.
-- Параметры экрана — typed (enum route / struct), не «магические» строки без реестра.
-- Deep link → route mapping централизован (App или Navigation hub); ViewModel не парсит URL напрямую.
-- Модалки: владелец presentation state — родительский VM/coordinator, не глобальный singleton без нужды.
+- One Feature — one explicit navigation entry (root view / coordinator); do not scatter `NavigationLink` through Data.
+- Screen parameters — typed (route enum / struct), not “magic” strings without a registry.
+- Deep link → route mapping is centralized (App or Navigation hub); ViewModel does not parse URLs directly.
+- Modals: presentation-state owner — parent VM/coordinator, not a global singleton without need.
 
-## Требование к агенту
+## Agent requirement
 
-Копировать паттерн ближайшего Feature из `reference-features.mdc`. Не тащить networking в навигационный слой.
+Copy the pattern of the nearest Feature from `reference-features.mdc`. Do not drag networking into the navigation layer.

package/presets/cursor/ios-swift/rules/networking-services.mdc

@@ -1,49 +1,49 @@
 ---
-description: Конвенции сетевого слоя, API-клиентов и mappers
+description: Networking layer, API clients, and mapper conventions
 globs: "**/{Data,Network,Networking}/**/*.swift"
 alwaysApply: false
 ---
 
-# Роль Data / Network слоя
+# Role of the Data / Network layer
 
-- Инкапсулировать:
-  - HTTP-запросы (`URLSession` или клиент проекта),
+- Encapsulate:
+  - HTTP requests (`URLSession` or the project client),
   - URL, headers, status codes,
-  - Codable DTO (транспорт).
-- Локальное хранение / Keychain — **`persistence-data.mdc`**, не смешивать с HTTP-клиентом без фасада-репозитория.
-- Наружу (Domain, ViewModel через repository) отдавать **доменные типы**, не DTO.
+  - Codable DTOs (transport).
+- Local storage / Keychain — **`persistence-data.mdc`**; do not mix with the HTTP client without a repository facade.
+- Externally (Domain, ViewModel via repository) expose **domain types**, not DTOs.
 
-# Структура модулей
+# Module structure
 
-- На доменную область — каталог в `Features/<Feature>/Data/` или `Core/Network/<Service>/`.
-- Внутри:
-  - `*APIClient.swift` / `*Service.swift` — вызовы эндпоинтов;
-  - `*DTO.swift` — транспортные модели (`Codable`);
+- Per domain area — a folder under `Features/<Feature>/Data/` or `Core/Network/<Service>/`.
+- Inside:
+  - `*APIClient.swift` / `*Service.swift` — endpoint calls;
+  - `*DTO.swift` — transport models (`Codable`);
   - `*Mapper.swift` — DTO ↔ domain;
-  - `*RepositoryImpl.swift` — реализация протокола из Domain.
-- Public surface — протоколы репозиториев в Domain; Data-классы не экспортируются во View.
+  - `*RepositoryImpl.swift` — implementation of a Domain protocol.
+- Public surface — repository protocols in Domain; Data types are not exported to Views.
 
-# DTO, mappers и типы
+# DTOs, mappers, and types
 
-- DTO **точно** отражают контракт backend (`CodingKeys` при расхождении имён).
-- Доменные entity — в Domain; mapper — **чистые функции** без side effects.
-- В mapper выполнять вычисления (флаги, форматирование, агрегаты), чтобы ViewModel получал готовую модель.
-- Optional и отсутствующие поля обрабатывать явно; не прокидывать «сырой» optional cascade в UI.
+- DTOs **exactly** mirror the backend contract (`CodingKeys` when names diverge).
+- Domain entities — in Domain; mappers — **pure functions** with no side effects.
+- Perform computations in the mapper (flags, formatting, aggregates) so the ViewModel receives a ready model.
+- Handle optionals and missing fields explicitly; do not push a raw optional cascade into the UI.
 
-# Async, errors и retries
+# Async, errors, and retries
 
-- Сетевые методы — `async throws` с **typed errors** (`NetworkError`, `APIError`) по конвенции репо.
-- Не глотать ошибки; пробрасывать или маппить в domain errors для ViewModel.
-- Retry, auth refresh, logging — централизованно (interceptor, middleware, `URLProtocol`), не в каждом методе.
+- Network methods — `async throws` with **typed errors** (`NetworkError`, `APIError`) per repo convention.
+- Do not swallow errors; rethrow or map to domain errors for the ViewModel.
+- Retry, auth refresh, logging — centralized (interceptor, middleware, `URLProtocol`), not in every method.
 
-# Codable и versioning
+# Codable and versioning
 
-- Избегать `[String: Any]`; для полиморфизма — enum + associated values или явные DTO.
-- `@MainActor` не ставить на Data-типы без необходимости.
+- Avoid `[String: Any]`; for polymorphism — enum + associated values or explicit DTOs.
+- Do not put `@MainActor` on Data types without need.
 
-# Требование к агенту
+# Agent requirement
 
-При добавлении/изменении API:
-- Следовать существующим клиентам и mappers как эталону.
-- Добавить/обновить mapper tests для нетривиальных преобразований.
-- ViewModel и View не должны импортировать DTO-файлы.
+When adding/changing an API:
+- Follow existing clients and mappers as the reference.
+- Add/update mapper tests for non-trivial transforms.
+- ViewModel and View must not import DTO files.

package/presets/cursor/ios-swift/rules/persistence-data.mdc

@@ -1,5 +1,5 @@
 ---
-description: Persistence — SwiftData / Core Data / файлы / Keychain (не HTTP)
+description: Persistence — SwiftData / Core Data / files / Keychain (not HTTP)
 globs:
   - "**/Persistence/**/*.swift"
   - "**/Keychain/**/*.swift"
@@ -11,21 +11,21 @@ alwaysApply: false
 
 # Persistence (Data)
 
-Отделить от HTTP (`networking-services.mdc`): здесь локальное хранение и секреты на диске/Keychain.
+Separate from HTTP (`networking-services.mdc`): local storage and secrets on disk/Keychain live here.
 
-## Рамка
+## Frame
 
-- Выбор стека (**SwiftData / Core Data / UserDefaults / files**) — **как в репо**; не внедрять второй persistence-стек без задачи.
-- Public API — протоколы в Domain (`…Repository` / `…Store`); реализации в Data.
-- **Keychain** — только для credentials/токенов; не класть PII «для удобства» в UserDefaults.
+- Stack choice (**SwiftData / Core Data / UserDefaults / files**) — **as in the repo**; do not introduce a second persistence stack without a task.
+- Public API — protocols in Domain (`…Repository` / `…Store`); implementations in Data.
+- **Keychain** — credentials/tokens only; do not put PII in UserDefaults “for convenience”.
 
-## Правила
+## Rules
 
-- DTO/Entity persistence ≠ network DTO; маппинг явный.
-- Миграции схемы — по принятому в репо процессу; не ломать silently.
-- `@MainActor` на store — только если UI-facing; тяжёлый I/O — off-main + hop обратно.
-- Ошибки — typed; не глотать `try?` на критичном persist.
+- Persistence DTO/Entity ≠ network DTO; mapping is explicit.
+- Schema migrations — follow the repo’s process; do not break silently.
+- `@MainActor` on a store — only if UI-facing; heavy I/O — off-main + hop back.
+- Errors — typed; do not swallow `try?` on critical persist.
 
-## Требование к агенту
+## Agent requirement
 
-Не смешивать URLSession и persistence в одном типе без фасада-репозитория. Тесты — in-memory / fake store.
+Do not mix URLSession and persistence in one type without a repository facade. Tests — in-memory / fake store.

package/presets/cursor/ios-swift/rules/post-change-build.mdc

@@ -1,32 +1,32 @@
 ---
-description: Сборка и lint после изменений Swift/iOS кода. Use after editing iOS/Swift sources, Xcode targets, or Package.swift.
+description: Build and lint after Swift/iOS code changes. Use after editing iOS/Swift sources, Xcode targets, or Package.swift.
 alwaysApply: false
 ---
 
-# Сборка и lint после изменений
+# Build and lint after changes
 
-## Когда применять
+## When to apply
 
-После изменений исходников Swift / проектных файлов Xcode / `Package.swift`, влияющих на компиляцию или стиль.
+After changes to Swift sources / Xcode project files / `Package.swift` that affect compilation or style.
 
-Исключения: только документация, README, `.cursor/rules/**` без правок app-кода.
+Exceptions: docs-only, README, `.cursor/rules/**` without app-code edits.
 
-**Pipeline:** если следующий шаг — отдельный verifier/CI-агент, достаточно затронутых таргетов; в single-agent режиме — полный разумный прогон как в репо.
+**Pipeline:** if the next step is a separate verifier/CI agent, touched targets are enough; in single-agent mode — a full reasonable run as in the repo.
 
-## Как определить команды
+## How to determine commands
 
-1. Схемы / таргеты — из `.xcodeproj` / `.xcworkspace` / `Package.swift` (как в CI или соседних скриптах).
-2. Lint — `SwiftLint` / `.swiftlint.yml`, если есть.
-3. Format — `SwiftFormat` / конфиг, если принято в репо.
-4. Тесты — XCTest или Swift Testing — только если задача их затрагивает.
+1. Schemes / targets — from `.xcodeproj` / `.xcworkspace` / `Package.swift` (as in CI or neighboring scripts).
+2. Lint — `SwiftLint` / `.swiftlint.yml` when present.
+3. Format — `SwiftFormat` / config when adopted in the repo.
+4. Tests — XCTest or Swift Testing — only if the task touches them.
 
-Не угадывать чужой toolchain: копировать флаги/`xcodebuild` из Makefile, scripts, CI.
+Do not invent a foreign toolchain: copy flags/`xcodebuild` from Makefile, scripts, CI.
 
-## Алгоритм
+## Algorithm
 
-1. Завершить правки.
-2. Собрать **затронутые** таргеты (`xcodebuild` / `swift build` — как в репо).
-3. Прогнать lint/format при наличии конфигов; исправить ошибки в файлах задачи.
-4. Повторить до чистой сборки или зафиксировать блокер пользователю.
+1. Finish edits.
+2. Build **touched** targets (`xcodebuild` / `swift build` — as in the repo).
+3. Run lint/format when configs exist; fix errors in task files.
+4. Repeat until a clean build or report a blocker to the user.
 
-**Errors** — обязательно; warnings в файлах задачи — по возможности до нуля.
+**Errors** — must fix; warnings in task files — drive to zero when possible.