@bonesofspring/ai-rules 0.2.14 → 0.2.16

package/presets/claude/ios-swift/rules/README.md

@@ -1,6 +1,6 @@
 # `.claude/rules` (preset ios-swift)
 
-В Claude Code все `.md` под `rules/` **обнаруживаются рекурсивно**. Тела **derived** из Cursor SoT; индексы — не второй SoT.
+In Claude Code all `.md` files under `rules/` are **discovered recursively**. Bodies are **derived** from Cursor SoT; indexes are not a second SoT.
 
 ## SoT sync
 
@@ -13,9 +13,9 @@
 
 ## Loading budget
 
-- **Session-start (no `paths:`):** ровно **3** — `ios-app-core`, `boundaries`, `code-quality` (≤140 body lines total)
-- **Все остальные** — с `paths:` (commands/team/agents и/или Feature/Swift globs)
-- **Soft twin depth:** domain rules ≥15 body lines; thin aliases (`agent-team-intake`, `technical-retro`) могут быть короче (как next)
+- **Session-start (no `paths:`):** exactly **3** — `ios-app-core`, `boundaries`, `code-quality` (≤140 body lines total)
+- **Everything else** — with `paths:` (commands/team/agents and/or Feature/Swift globs)
+- **Soft twin depth:** domain rules ≥15 body lines; thin aliases (`agent-team-intake`, `technical-retro`) may be shorter (as in next)
 
 ## Cursor → Claude mapping
 
@@ -69,10 +69,10 @@ Shared taxonomy: `presets/_shared/README.md`. Sync marker: `<!-- shared-core:
 
 ## Folders
 
-| Папка | О чём |
+| Folder | About |
 |-------|--------|
-| `stack/` | Стек, Swift conventions |
-| `architecture/` | Границы, feature-delivery, reference-features, SPM public API |
+| `stack/` | Stack, Swift conventions |
+| `architecture/` | Boundaries, feature-delivery, reference-features, SPM public API |
 | `api-and-data/` | Networking, persistence |
 | `testing/` | XCTest, XCUITest |
 | `ui-and-accessibility/` | SwiftUI, ViewModels, navigation |

package/presets/claude/ios-swift/rules/api-and-data/README.md

@@ -1,6 +1,6 @@
 # API and data
 
-Сетевой слой, persistence, DTO, mappers. Index only — тела в topic `.md`.
+Networking layer, persistence, DTOs, mappers. Index only — bodies live in topic `.md` files.
 
 | File | Cursor SoT |
 |------|------------|

package/presets/claude/ios-swift/rules/api-and-data/networking.md

@@ -1,49 +1,49 @@
 ---
-description: Конвенции сетевого слоя, API-клиентов и mappers
+description: Networking layer, API clients, and mapper conventions
 paths:
   - "**/{Data,Network,Networking}/**/*.swift"
 ---
 
-# Роль 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.md`**, не смешивать с HTTP-клиентом без фасада-репозитория.
-- Наружу (Domain, ViewModel через repository) отдавать **доменные типы**, не DTO.
+  - Codable DTOs (transport).
+- Local storage / Keychain — **`api-and-data/persistence.md`**; 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/claude/ios-swift/rules/api-and-data/persistence.md

@@ -1,5 +1,5 @@
 ---
-description: Persistence — SwiftData / Core Data / файлы / Keychain (не HTTP)
+description: Persistence — SwiftData / Core Data / files / Keychain (not HTTP)
 paths:
   - "**/Persistence/**/*.swift"
   - "**/Keychain/**/*.swift"
@@ -10,21 +10,21 @@ paths:
 
 # Persistence (Data)
 
-Отделить от HTTP (`api-and-data/networking.md`): здесь локальное хранение и секреты на диске/Keychain.
+Separate from HTTP (`api-and-data/networking.md`): 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/claude/ios-swift/rules/architecture/README.md

@@ -1,6 +1,6 @@
 # Architecture
 
-Границы слоёв, DI, доставка фичи, SPM public API. Index only — тела в topic `.md`.
+Layer boundaries, DI, feature delivery, SPM public API. Index only — bodies live in topic `.md` files.
 
 | File | Cursor SoT |
 |------|------------|

package/presets/claude/ios-swift/rules/architecture/boundaries.md

@@ -1,33 +1,33 @@
 ---
-description: Архитектурные границы и правила зависимостей iOS приложения
+description: Architectural boundaries and dependency rules for an iOS app
 ---
 
-# Границы между слоями
+# Layer boundaries
 
 - **Presentation** (Views, ViewModels, DesignSystem):
-  - Может: Domain (entities, use case protocols), DesignSystem, Core (без UI).
-  - Не должен: импортировать Data (репозитории, DTO, API-клиенты); знать HTTP/Codable/эндпоинты; маппить DTO → domain.
+  - May: Domain (entities, use case protocols), DesignSystem, Core (non-UI).
+  - Must not: import Data (repositories, DTOs, API clients); know HTTP/Codable/endpoints; map DTO → domain.
 - **Domain**:
-  - Может: Core (базовые типы, протоколы).
-  - Не должен: импортировать SwiftUI, UIKit, сеть; знать конкретные реализации репозиториев.
+  - May: Core (base types, protocols).
+  - Must not: import SwiftUI, UIKit, networking; know concrete repository implementations.
 - **Data**:
-  - Может: Domain (протоколы, entities), Core.
-  - Не должен: импортировать SwiftUI/UIKit; зависеть от View/ViewModel.
+  - May: Domain (protocols, entities), Core.
+  - Must not: import SwiftUI/UIKit; depend on View/ViewModel.
 
-# Зависимости и модули
+# Dependencies and modules
 
-- Направление: **Presentation → Domain ← Data**.
-- Переиспользуемое — в Core / DesignSystem; к другой фиче — только **public API** (протокол, facade, coordinator), не deep-import.
-- SPM: Domain не линкуется с Data; реализации Data подключаются через DI в `App/`.
-- Раскладка фичи — как в `stack/ios-app-core.md` / соседних `Features/*` репо (Presentation / Domain / Data + тесты).
+- Direction: **Presentation → Domain ← Data**.
+- Shared code — in Core / DesignSystem; to another feature — only **public API** (protocol, facade, coordinator), not deep-import.
+- SPM: Domain does not link Data; Data implementations are wired via DI in `App/`.
+- Feature layout — as in `stack/ios-app-core.md` / neighboring `Features/*` in the repo (Presentation / Domain / Data + tests).
 
-# DI и composition root
+# DI and composition root
 
-- Сборка графа — в `App/` (или `DI/` / CompositionRoot), не во View.
-- ViewModel получает **протоколы** (use case / repository), не конкретные Data-типы.
-- Preview и тесты — mock/stub реализаций.
+- Graph assembly — in `App/` (or `DI/` / CompositionRoot), not in the View.
+- ViewModel receives **protocols** (use case / repository), not concrete Data types.
+- Previews and tests — mock/stub implementations.
 
-# Требование к агенту
+# Agent requirement
 
-- Файлы — в соответствующих слоях; протоколы репозиториев в Domain, реализации в Data.
-- Не «коротить» слои (API из View «ради скорости»).
+- Place files in the matching layers; repository protocols in Domain, implementations in Data.
+- Do not “short-circuit” layers (API from a View “for speed”).

package/presets/claude/ios-swift/rules/architecture/feature-delivery.md

@@ -1,5 +1,5 @@
 ---
-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.
 paths:
   - .claude/commands/**/*
   - .claude/team/**/*
@@ -12,21 +12,22 @@ paths:
 
 <!-- shared-core: architecture/feature-delivery-workflow.md -->
 
+# Feature delivery (iOS)
 
-# Доставка фичи (iOS)
+## Stack notes
 
-Типичная фича с данными и UI. Детали слоёв — `architecture/boundaries.md`, `stack/ios-app-core.md`.
+Typical feature with data and UI. Layer details — `architecture/boundaries.md`, `stack/ios-app-core.md`.
 
-## Чеклист (порядок работ)
+## Checklist (work order)
 
-1. **Domain** — entities, value types, протоколы репозиториев / use cases (`Features/**/Domain/**`).
-2. **Data** — DTO (`Codable`), mappers Domain ↔ DTO, реализации репозиториев, API-клиент (`api-and-data/networking.md`).
-3. **ViewModel** — состояние, вызовы use case / протоколов; DI из App; без DTO и URL (`ui-and-accessibility/viewmodels.md`).
-4. **View / navigation** — тонкие SwiftUI Views, Design System; навигация как в репо (`ui-and-accessibility/swiftui.md`).
-5. **Тесты** — unit на mappers / use cases / VM (`testing/unit.md`); UI-потоки — XCUITest (`testing/ui.md`).
-6. **Завершение** — **вызвать** `tooling-and-review/post-change-build.md` (+ `tooling-and-review/xcode-tooling.md`): сборка затронутых таргетов + lint/format по конфигу репо.
+1. **Domain** — entities, value types, repository / use case protocols (`Features/**/Domain/**`).
+2. **Data** — DTOs (`Codable`), Domain ↔ DTO mappers, repository implementations, API client (`api-and-data/networking.md`).
+3. **ViewModel** — state, use case / protocol calls; DI from App; no DTOs or URLs (`ui-and-accessibility/viewmodels.md`).
+4. **View / navigation** — thin SwiftUI Views, Design System; navigation as in the repo (`ui-and-accessibility/swiftui.md`).
+5. **Tests** — unit for mappers / use cases / VM (`testing/unit.md`); UI flows — XCUITest (`testing/ui.md`).
+6. **Completion** — **invoke** `tooling-and-review/post-change-build.md` (+ `tooling-and-review/xcode-tooling.md` for schemes/commands): build touched targets + lint/format per repo config.
 
-## Поток данных (ориентир)
+## Data flow (orientation)
 
 ```mermaid
 flowchart LR
@@ -38,36 +39,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.md`, `stack/ios-app-core.md` |
 | `Features/**/Data/**`, `**/Network*/**` | `api-and-data/networking.md`, `architecture/boundaries.md` |
 | `*ViewModel*.swift`, Presentation state | `ui-and-accessibility/viewmodels.md` |
 | `Presentation/**`, `DesignSystem/**` | `ui-and-accessibility/swiftui.md`, `architecture/boundaries.md` |
-| `**/*.swift` (стиль) | `stack/swift-conventions.md` |
+| `**/*.swift` (style) | `stack/swift-conventions.md` |
 | `*Tests/**` | `testing/unit.md` |
 | `*UITests/**` | `testing/ui.md` |
-| После правок Swift | `tooling-and-review/post-change-build.md` (+ `tooling-and-review/xcode-tooling.md`) |
+| After Swift edits | `tooling-and-review/post-change-build.md` |
 
-При добавлении или расширении фичи **пройти чеклист** и правила из таблицы для затронутых зон.
+When adding or extending a feature, **walk the checklist** and the table rules for touched zones.

package/presets/claude/ios-swift/rules/architecture/module-public-api.md

@@ -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
 paths:
   - "**/Package.swift"
   - "**/*Public*.swift"
@@ -8,18 +8,18 @@ paths:
 
 # 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/claude/ios-swift/rules/architecture/reference-features.md

@@ -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.
 paths:
   - Features/**/*
   - "**/Presentation/**/*"
@@ -10,50 +10,53 @@ paths:
 
 <!-- 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)
 
-1. `/task` новая фича в `Features/<Name>` — analyst → developer → build-verifier (xcodebuild).
-2. Баг в ViewModel — debugger → fix → unit test.
-3. Mapper DTO↔domain — unit-test-planner/generator.
+Run after preset init (manual smoke for agents):
+
+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`.
+5. Auth/Keychain touch — security-reviewer + `tooling-and-review/security-ios.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
 
-- `tooling-and-review/code-quality.md` — повторять паттерны.
-- `architecture/feature-delivery.md` — порядок слоёв.
-- skill `feature-delivery` — end-to-end сценарий.
+- `tooling-and-review/code-quality.md` — repeat patterns.
+- `architecture/feature-delivery.md` — layer order.
+- skill `feature-delivery` — end-to-end scenario.

package/presets/claude/ios-swift/rules/stack/README.md

@@ -1,6 +1,6 @@
 # Stack
 
-Язык, платформа и базовый каркас приложения. Index only — тела в topic `.md`.
+Language, platform, and app scaffold. Index only — bodies live in topic `.md` files.
 
 | File | Cursor SoT |
 |------|------------|

package/presets/claude/ios-swift/rules/stack/ios-app-core.md

@@ -1,20 +1,20 @@
 ---
-description: Базовые принципы, стек и структура iOS приложения на Swift (preset)
+description: Core principles, stack, and structure for an iOS Swift app (preset)
 ---
 
-# Стек и окружение
+# 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.md`**.
+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.md`**.
 
-# 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.md`).
-- Фичи: `architecture/feature-delivery.md`; после Swift — **вызвать** `tooling-and-review/post-change-build.md`; toolchain — `tooling-and-review/xcode-tooling.md`.
+- Layer → neighbor patterns; no `URLSession` in Views and no DTOs in ViewModels (`architecture/boundaries.md`).
+- Features: `architecture/feature-delivery.md`; after Swift edits — **invoke** `tooling-and-review/post-change-build.md`; toolchain — `tooling-and-review/xcode-tooling.md`.

package/presets/claude/ios-swift/rules/stack/swift-conventions.md

@@ -7,28 +7,28 @@ paths:
 # 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/claude/ios-swift/rules/testing/README.md

@@ -1,6 +1,6 @@
 # Testing
 
-Unit (XCTest / Swift Testing) и UI (XCUITest). Index only — тела в topic `.md`.
+Unit (XCTest / Swift Testing) and UI (XCUITest). Index only — bodies live in topic `.md` files.
 
 | File | Cursor SoT |
 |------|------------|