@bonesofspring/ai-rules 0.2.0 → 0.2.2

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

@@ -0,0 +1,44 @@
+# `.claude/rules` (preset ios-swift)
+
+В Claude Code все `.md` под `rules/` **обнаруживаются рекурсивно**. Тела правил **derived** из Cursor SoT; индексы (этот README и папочные) — не второй SoT.
+
+## SoT sync
+
+| Principle | Detail |
+|-----------|--------|
+| **SoT** | `presets/cursor/ios-swift/rules/*.mdc` — edit here first |
+| **Derive** | Claude topic `.md` = body of matching `.mdc` + frontmatter `paths:` (from Cursor `globs:`) |
+| **Drop** | Cursor-only keys (`alwaysApply`); keep short `description` where useful |
+| **Do not** | Maintain independent long-form Claude prose that diverges in meaning |
+
+**Checklist:** change Cursor `.mdc` → update Claude twin `.md` in the **same PR**.
+
+## Cursor → Claude mapping (12/12)
+
+| Cursor `.mdc` (SoT) | Claude topic |
+|---------------------|--------------|
+| `ios-app-core.mdc` | `stack/ios-app-core.md` |
+| `swift-conventions.mdc` | `stack/swift-conventions.md` |
+| `architecture-boundaries.mdc` | `architecture/boundaries.md` |
+| `feature-delivery-workflow.mdc` | `architecture/feature-delivery.md` |
+| `networking-services.mdc` | `api-and-data/networking.md` |
+| `swiftui-ui.mdc` | `ui-and-accessibility/swiftui.md` |
+| `state-and-viewmodels.mdc` | `ui-and-accessibility/viewmodels.md` |
+| `tests-unit.mdc` | `testing/unit.md` |
+| `tests-ui.mdc` | `testing/ui.md` |
+| `code-quality-and-refactoring.mdc` | `tooling-and-review/code-quality.md` |
+| `code-review-mr.mdc` | `tooling-and-review/code-review.md` |
+| `post-change-build.mdc` | `tooling-and-review/post-change-build.md` |
+
+## Folders
+
+| Папка | О чём |
+|-------|--------|
+| `stack/` | Стек, структура проекта, Swift conventions |
+| `architecture/` | Границы слоёв / DI, доставка фичи |
+| `api-and-data/` | URLSession, DTO, Codable, mappers, repositories |
+| `testing/` | unit (XCTest), UI (XCUITest) |
+| `ui-and-accessibility/` | SwiftUI, Design System, ViewModels |
+| `tooling-and-review/` | Качество кода, code review, post-change build |
+
+Path-scoped rules use frontmatter `paths:` (same patterns as Cursor `globs:`). Rules without `paths:` apply broadly (Claude equivalent of Cursor alwaysApply / requestable).

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

@@ -0,0 +1,9 @@
+# API and data
+
+Сетевой слой, DTO, mappers, repository implementations. Index only — тела в topic `.md`.
+
+| File | Cursor SoT |
+|------|------------|
+| [`networking.md`](./networking.md) | `networking-services.mdc` |
+
+Sync: change Cursor → update Claude twin same PR. Full map: [`../README.md`](../README.md).

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

@@ -0,0 +1,49 @@
+---
+description: Конвенции сетевого слоя, API-клиентов и mappers
+paths:
+  - "**/{Data,Network,Networking}/**/*.swift"
+---
+
+# Роль Data / Network слоя
+
+- Инкапсулировать:
+  - HTTP-запросы (`URLSession` или клиент проекта),
+  - URL, headers, status codes,
+  - Codable DTO,
+  - persistence (Core Data, SwiftData, Keychain — по репо).
+- Наружу (Domain, ViewModel через repository) отдавать **доменные типы**, не DTO.
+
+# Структура модулей
+
+- На доменную область — каталог в `Features/<Feature>/Data/` или `Core/Network/<Service>/`.
+- Внутри:
+  - `*APIClient.swift` / `*Service.swift` — вызовы эндпоинтов;
+  - `*DTO.swift` — транспортные модели (`Codable`);
+  - `*Mapper.swift` — DTO ↔ domain;
+  - `*RepositoryImpl.swift` — реализация протокола из Domain.
+- Public surface — протоколы репозиториев в Domain; Data-классы не экспортируются во View.
+
+# DTO, mappers и типы
+
+- DTO **точно** отражают контракт backend (`CodingKeys` при расхождении имён).
+- Доменные entity — в Domain; mapper — **чистые функции** без side effects.
+- В mapper выполнять вычисления (флаги, форматирование, агрегаты), чтобы ViewModel получал готовую модель.
+- Optional и отсутствующие поля обрабатывать явно; не прокидывать «сырой» optional cascade в UI.
+
+# Async, errors и retries
+
+- Сетевые методы — `async throws` с **typed errors** (`NetworkError`, `APIError`) по конвенции репо.
+- Не глотать ошибки; пробрасывать или маппить в domain errors для ViewModel.
+- Retry, auth refresh, logging — централизованно (interceptor, middleware, `URLProtocol`), не в каждом методе.
+
+# Codable и versioning
+
+- Избегать `[String: Any]`; для полиморфизма — enum + associated values или явные DTO.
+- `@MainActor` не ставить на Data-типы без необходимости.
+
+# Требование к агенту
+
+При добавлении/изменении API:
+- Следовать существующим клиентам и mappers как эталону.
+- Добавить/обновить mapper tests для нетривиальных преобразований.
+- ViewModel и View не должны импортировать DTO-файлы.

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

@@ -0,0 +1,10 @@
+# Architecture
+
+Границы слоёв Presentation / Domain / Data, DI, доставка фичи. Index only — тела в topic `.md`.
+
+| File | Cursor SoT |
+|------|------------|
+| [`boundaries.md`](./boundaries.md) | `architecture-boundaries.mdc` |
+| [`feature-delivery.md`](./feature-delivery.md) | `feature-delivery-workflow.mdc` |
+
+Sync: change Cursor → update Claude twin same PR. Full map: [`../README.md`](../README.md).

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

@@ -0,0 +1,33 @@
+---
+description: Архитектурные границы и правила зависимостей iOS приложения
+---
+
+# Границы между слоями
+
+- **Presentation** (Views, ViewModels, DesignSystem):
+  - Может: Domain (entities, use case protocols), DesignSystem, Core (без UI).
+  - Не должен: импортировать Data (репозитории, DTO, API-клиенты); знать HTTP/Codable/эндпоинты; маппить DTO → domain.
+- **Domain**:
+  - Может: Core (базовые типы, протоколы).
+  - Не должен: импортировать SwiftUI, UIKit, сеть; знать конкретные реализации репозиториев.
+- **Data**:
+  - Может: Domain (протоколы, entities), Core.
+  - Не должен: импортировать SwiftUI/UIKit; зависеть от View/ViewModel.
+
+# Зависимости и модули
+
+- Направление: **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 + тесты).
+
+# DI и composition root
+
+- Сборка графа — в `App/` (или `DI/` / CompositionRoot), не во View.
+- ViewModel получает **протоколы** (use case / repository), не конкретные Data-типы.
+- Preview и тесты — mock/stub реализаций.
+
+# Требование к агенту
+
+- Файлы — в соответствующих слоях; протоколы репозиториев в Domain, реализации в Data.
+- Не «коротить» слои (API из View «ради скорости»).

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

@@ -0,0 +1,60 @@
+---
+description: Сквозной чеклист доставки iOS-фичи и матрица «зона → правило». Use when implementing features, adding screens/API, or extending existing iOS flows.
+---
+
+# Доставка фичи (iOS)
+
+Типичная фича с данными и UI. Детали слоёв — `architecture/boundaries.md`, `stack/ios-app-core.md`.
+
+## Чеклист (порядок работ)
+
+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`**: сборка затронутых таргетов + lint/format по конфигу репо.
+
+## Поток данных (ориентир)
+
+```mermaid
+flowchart LR
+  DTO[DTO] --> Mappers[Mappers]
+  Mappers --> Domain[Domain]
+  Domain --> Repo[Repository protocol]
+  Repo --> VM[ViewModel]
+  VM --> View[SwiftUI View]
+  DataImpl[Data impl] -.-> Repo
+```
+
+## Частичные сценарии
+
+| Задача | Минимум |
+|--------|---------|
+| Только API / модель | Domain + DTO + mapper + repo impl; unit на mapper. |
+| Только VM / логика | Протоколы Domain; mock в тестах; без HTTP во View. |
+| Только UI | View + существующий VM/state; без DTO. |
+| Только тесты | Specs по конвенции репо; не менять production без нужды. |
+
+## Антипаттерны
+
+- DTO / `Codable` transport-типы во View или ViewModel.
+- `URLSession` / конкретный API-клиент в ViewModel или View.
+- Domain импортирует SwiftUI / UIKit.
+- Deep-import внутренних файлов другой фичи.
+- Сборка DI внутри View.
+
+## Матрица: зона → правила
+
+| Зона | Правила |
+|------|---------|
+| `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` |
+| `*Tests/**` | `testing/unit.md` |
+| `*UITests/**` | `testing/ui.md` |
+| После правок Swift | `tooling-and-review/post-change-build.md` |
+
+При добавлении или расширении фичи **пройти чеклист** и правила из таблицы для затронутых зон.

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

@@ -0,0 +1,10 @@
+# Stack
+
+Язык, платформа и базовый каркас приложения. Index only — тела в topic `.md`.
+
+| File | Cursor SoT |
+|------|------------|
+| [`ios-app-core.md`](./ios-app-core.md) | `ios-app-core.mdc` |
+| [`swift-conventions.md`](./swift-conventions.md) | `swift-conventions.mdc` |
+
+Sync: change Cursor → update Claude twin same PR. Full map: [`../README.md`](../README.md).

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

@@ -0,0 +1,42 @@
+---
+description: Базовые принципы, стек и структура iOS приложения на Swift (preset)
+---
+
+# Стек и окружение
+
+Версии Swift, iOS SDK, зависимостей и инструментов — **из Xcode-проекта, Package.swift и конфигов целевого репозитория**. Рамка preset:
+
+- **Язык / платформа:** Swift, iOS (min — из таргета).
+- **UI:** SwiftUI — приоритет для нового кода; UIKit — где уже принято в репо.
+- **Сборка:** Xcode; SPM и/или CocoaPods — как в репозитории.
+- **Concurrency:** `async`/`await`, `Task`, `Actor`; UI — `@MainActor`.
+- **Тесты:** XCTest или Swift Testing; UI — XCUITest.
+- **Сеть:** `URLSession` или клиент репо; DTO через `Codable`.
+- **Дизайн-система:** токены/примитивы из `DesignSystem/` (или аналога); без «магических» значений.
+- **Наблюдаемость:** только если уже в проекте — централизованно.
+
+# Структура проекта
+
+Ориентир — **feature-first + слои внутри фичи** или **слои на верхнем уровне** (как в репо):
+
+- `App/` — `@main`, composition root, DI, навигация верхнего уровня.
+- `Features/<FeatureName>/` — `Presentation/` (Views, ViewModels), `Domain/` (entities, use cases, протоколы), `Data/` (repos, API, DTO, mappers).
+- `Core/` — общие утилиты, extensions, базовые ошибки.
+- `DesignSystem/` — UI-примитивы без бизнес-логики.
+- `Tests/` / `*Tests/` — unit и UI по конвенции Xcode.
+
+Новые файлы — в том же слое/модуле, что и аналогичная функциональность.
+
+Границы зависимостей и DI — **`architecture/boundaries.md`**.
+
+# Swift и качество
+
+- Swift API Design Guidelines + SwiftLint/SwiftFormat репо (если есть).
+- Избегать `!` / `try!` в production; `guard` / `if let` / typed errors.
+- Копировать существующие паттерны фичи/слоя.
+
+# Работа агента
+
+- Определить слой (Presentation / Domain / Data / DesignSystem / Tests); повторить паттерн соседних файлов.
+- Не тянуть `URLSession` во View и DTO во ViewModel — детали в `architecture/boundaries.md`.
+- Доставка фичи — `architecture/feature-delivery.md`; после правок Swift — `tooling-and-review/post-change-build.md`.

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

@@ -0,0 +1,51 @@
+---
+description: Swift language conventions and safety (preset)
+paths:
+  - "**/*.swift"
+---
+
+# Naming and API design
+
+- Types: `UpperCamelCase`; methods, properties, enum cases: `lowerCamelCase`.
+- Protocols, описывающие capability: `-able`, `-ing`, или `Protocol` суффикс — как в репо.
+- Избегать аббревиатур в именах, кроме общепринятых (URL, ID, HTTP).
+
+# Optionals and errors
+
+```swift
+// ❌ Плохо
+let name = user!.name
+
+// ✅ Хорошо
+guard let name = user?.name else { return }
+```
+
+- `throws` + typed errors вместо `Result` там, где так принято в слое; быть консistent внутри модуля.
+- `guard` для early exit; не вкладывать глубокие `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.
+- Prefer `async/await` over completion handlers для нового кода.
+
+# Access control
+
+- Минимально необходимый уровень: `private` / `fileprivate` по умолчанию для implementation details.
+- Public API фичи — явные types и protocols; не экспортировать DTO наружу модуля.
+
+# Value semantics
+
+- Предпочитать `struct` для models и state где нет identity semantics.
+- `class` — когда нужен identity, inheritance, или Objective-C interop.
+
+# Extensions
+
+- Группировать extensions по типу; не складывать unrelated helpers в один `Extensions.swift` без структуры.
+- Protocol extensions для shared default behavior.
+
+# Требование к агенту
+
+- Не добавлять `// swiftlint:disable` без явной причины.
+- Новый код — Swift Concurrency-ready (`Sendable` где требует компилятор/линтер проекта).

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

@@ -0,0 +1,10 @@
+# Testing
+
+Unit (XCTest / Swift Testing) и UI (XCUITest). Index only — тела в topic `.md`.
+
+| File | Cursor SoT |
+|------|------------|
+| [`unit.md`](./unit.md) | `tests-unit.mdc` |
+| [`ui.md`](./ui.md) | `tests-ui.mdc` |
+
+Sync: change Cursor → update Claude twin same PR. Full map: [`../README.md`](../README.md).

package/presets/claude/ios-swift/rules/testing/ui.md

@@ -0,0 +1,41 @@
+---
+description: UI-тесты XCUITest и accessibility identifiers
+paths:
+  - "**/*UITests/**/*.swift"
+---
+
+# Структура UI-тестов
+
+- UI Test target: `*UITests/` — сценарии пользовательских потоков.
+- Page Object (или Screen Object) — класс на экран: селекторы + действия (`LoginScreen`, `OrderHistoryScreen`).
+- Общие хелперы — `UITestSupport/`, base classes, launch arguments.
+
+# Селекторы и стабильность
+
+- **Приоритет:** `accessibilityIdentifier` для ключевых элементов; затем label/trait где устойчиво.
+- Идентификаторы согласовать с Presentation-слоем (`ui-and-accessibility/swiftui.md`): `{screen}__{element}`.
+  - Пример: `order-history__submit-button`, `login__email-field`.
+- Избегать привязки к абсолютным координатам и хрупким XPath-подобным цепочкам.
+
+# Сценарии и именование
+
+- Названия тестов — **на русском**, с префиксом сущности:
+  - `OH-001 Отображается список заказов` (префикс — первые буквы сущности, номер — три цифры).
+- Один тест — один пользовательский сценарий; не объединять несвязанные проверки.
+
+# Launch и окружение
+
+- `-UITesting`, mock server URL, сброс state — через `launchArguments` / `launchEnvironment`, как в репо.
+- Не зависеть от прод-backend в CI; использовать staging/mock.
+
+# Синхронизация с UI
+
+- При изменении UI обновлять identifiers в View и селекторы в page objects.
+- Не ослаблять assertions против бизнес-ожиданий ради «зелёного» CI.
+
+# Требование к агенту
+
+При добавлении UI-тестов:
+- Переиспользовать page objects, не дублировать query в каждом тесте.
+- Добавлять `accessibilityIdentifier` в SwiftUI через `.accessibilityIdentifier(...)` для новых интерактивных элементов.
+- Следовать существующим UITest files как эталону.

package/presets/claude/ios-swift/rules/testing/unit.md

@@ -0,0 +1,41 @@
+---
+description: Unit и integration тесты (XCTest / Swift Testing)
+paths:
+  - "**/*Tests/**/*.swift"
+---
+
+# Общие правила тестирования
+
+- **Framework** — XCTest или Swift Testing, как в проекте.
+- Цель: проверять **поведение и бизнес-правила**, не детали реализации и private API.
+- Именование:
+  - `test` / `@Test` descriptions и `XCTContext` — **на русском**, как понятные бизнес-фразы.
+  - Описания **с заглавной буквы**.
+
+# ViewModel и use case
+
+- Mock протоколов repositories / use cases; не поднимать реальную сеть.
+- Проверять переходы state: loading → success/failure, validation errors, edge cases.
+- `@MainActor` ViewModel тестировать с `@MainActor` test methods или `await MainActor.run`.
+
+# Mappers и domain
+
+- Mapper functions — unit-тесты с таблицами кейсов: nil fields, empty arrays, граничные значения.
+- Regression на бизнес-правила (скидки, статусы, форматирование дат).
+
+# Изоляция
+
+- Не мокать то, что является предметом теста (например, сам mapper при тесте mapper).
+- Fixtures — в `TestSupport/`, `Mocks/` или рядом по конвенции репо; не дублировать большие JSON inline без нужды.
+
+# Структура файлов
+
+- `FeatureViewModelTests.swift`, `OrderMapperTests.swift` — суффикс `Tests` в имени типа/файла по стилю Xcode.
+- Не создавать глубокую вложенность `Tests/Tests/`; следовать target structure проекта.
+
+# Требование к агенту
+
+При добавлении тестов:
+- Копировать паттерны из существующих test files в репо.
+- Добавлять тесты для новых веток логики и регрессий.
+- Использовать DTO fixtures из Data layer и domain types из Domain, не дублировать типы в тестах.

package/presets/claude/ios-swift/rules/tooling-and-review/README.md

@@ -0,0 +1,11 @@
+# Tooling and review
+
+Качество кода, code review MR, сборка/lint после правок. Index only — тела в topic `.md`.
+
+| File | Cursor SoT |
+|------|------------|
+| [`code-quality.md`](./code-quality.md) | `code-quality-and-refactoring.mdc` |
+| [`code-review.md`](./code-review.md) | `code-review-mr.mdc` |
+| [`post-change-build.md`](./post-change-build.md) | `post-change-build.mdc` |
+
+Sync: change Cursor → update Claude twin same PR. Full map: [`../README.md`](../README.md).

package/presets/claude/ios-swift/rules/tooling-and-review/code-quality.md

@@ -0,0 +1,38 @@
+---
+description: Поддержка и улучшение качества кода и архитектуры iOS
+---
+
+# Поддержка существующего стиля
+
+- Новые изменения должны:
+  - следовать существующим паттернам (имена, структура, DI, error handling);
+  - минимизировать «стилистический шум» (лишний reformat, rename без нужды).
+- Перед новым решением:
+  - искать аналог в коде и **повторять подход**;
+  - проверять DesignSystem и существующие компоненты перед новым UI-контролом;
+  - обращаться к другим фичам только через public API (протоколы, facades).
+
+# Рефакторинг при изменениях
+
+- Допустим лёгкий refactor, если он:
+  - уменьшает дублирование;
+  - повышает читаемость;
+  - не ломает публичные контракты.
+- Примеры:
+  - вынести дублирующийся mapper или validation;
+  - заменить force unwrap на безопасные конструкции;
+  - разбить перегруженный ViewModel на use cases;
+  - заменить magic numbers/colors на design tokens;
+  - убрать прямую зависимость View от Data в пользу протокола.
+
+# Ограничения
+
+- Не делать «большой» рефакторинг при точечной задаче:
+  - не менять структуру модулей/таргетов;
+  - не переименовывать public API без запроса.
+- Крупные изменения — минимальными шагами, код остаётся компилируемым.
+
+# Требование к агенту
+
+- **Boy scout rule:** оставлять модуль чуть лучше (безопасность optional, typed errors, tests).
+- Не жертвовать слоями ради краткости.

package/presets/claude/ios-swift/rules/tooling-and-review/code-review.md

@@ -0,0 +1,41 @@
+---
+description: Требования к code review для iOS merge requests. Use when reviewing MR/diff/PR, evaluating a branch, or when the user asks for code review.
+---
+
+# Code review merge requests
+
+On-demand правило для review-потоков (не always-on).
+
+- **Когда применять**
+  - Запросы: «проведи ревью», «оцени MR/ветку/дифф», «посмотри изменения».
+  - Опираться на локальный репозиторий: ветка, `git diff`, открытые файлы.
+
+- **Что обязан проверить агент**
+  - **Архитектура и слои** (`architecture/boundaries.md`, `stack/ios-app-core.md`):
+    - View не вызывает API и не знает DTO.
+    - ViewModel не зависит от Data-реализаций напрямую.
+    - Domain не импортирует SwiftUI/UIKit.
+    - Data не тянет Presentation.
+  - **Зависимости и модули**:
+    - DI через протоколы; composition root в App.
+    - Нет deep-import между фичами.
+    - Файлы в правильных слоях (`Presentation`, `Domain`, `Data`, `DesignSystem`).
+  - **Swift и concurrency** (`stack/swift-conventions.md`):
+    - `@MainActor` на UI; нет необоснованных force unwrap.
+    - Typed errors; корректная отмена Task где нужно.
+  - **UI** (`ui-and-accessibility/swiftui.md`):
+    - Тонкие Views; Design System tokens; accessibility identifiers для тестируемых элементов.
+  - **Сеть и data** (`api-and-data/networking.md`):
+    - DTO отделены от domain; mappers покрывают edge cases.
+  - **Тесты**:
+    - Нетривиальная логика — unit (`testing/unit.md`); пользовательские потоки — UI (`testing/ui.md`).
+    - Указать, какие тесты добавить или обновить.
+
+- **Глубина и формат**
+  - Фокус на **диффе MR**, не на всём проекте.
+  - Сначала обзор (цель MR, риски), затем конкретные комментарии с файлом и предложением fix по паттернам репо.
+  - Без «больших рефакторингов» без запроса (`tooling-and-review/code-quality.md`).
+
+- **Ограничения**
+  - Не выдумывать метаданные CI/MR с хостинга без локальных данных.
+  - Boy scout rule в рамках MR.

package/presets/claude/ios-swift/rules/tooling-and-review/post-change-build.md

@@ -0,0 +1,31 @@
+---
+description: Сборка и lint после изменений Swift/iOS кода. Use after editing iOS/Swift sources, Xcode targets, or Package.swift.
+---
+
+# Сборка и lint после изменений
+
+## Когда применять
+
+После изменений исходников Swift / проектных файлов Xcode / `Package.swift`, влияющих на компиляцию или стиль.
+
+Исключения: только документация, README, `.cursor/rules/**` без правок app-кода.
+
+**Pipeline:** если следующий шаг — отдельный verifier/CI-агент, достаточно затронутых таргетов; в single-agent режиме — полный разумный прогон как в репо.
+
+## Как определить команды
+
+1. Схемы / таргеты — из `.xcodeproj` / `.xcworkspace` / `Package.swift` (как в CI или соседних скриптах).
+2. Lint — `SwiftLint` / `.swiftlint.yml`, если есть.
+3. Format — `SwiftFormat` / конфиг, если принято в репо.
+4. Тесты — XCTest или Swift Testing — только если задача их затрагивает.
+
+Не угадывать чужой toolchain: копировать флаги/`xcodebuild` из Makefile, scripts, CI.
+
+## Алгоритм
+
+1. Завершить правки.
+2. Собрать **затронутые** таргеты (`xcodebuild` / `swift build` — как в репо).
+3. Прогнать lint/format при наличии конфигов; исправить ошибки в файлах задачи.
+4. Повторить до чистой сборки или зафиксировать блокер пользователю.
+
+**Errors** — обязательно; warnings в файлах задачи — по возможности до нуля.

package/presets/claude/ios-swift/rules/ui-and-accessibility/README.md

@@ -0,0 +1,10 @@
+# UI and accessibility
+
+SwiftUI Views, Design System, ViewModels. Index only — тела в topic `.md`.
+
+| File | Cursor SoT |
+|------|------------|
+| [`swiftui.md`](./swiftui.md) | `swiftui-ui.mdc` |
+| [`viewmodels.md`](./viewmodels.md) | `state-and-viewmodels.mdc` |
+
+Sync: change Cursor → update Claude twin same PR. Full map: [`../README.md`](../README.md).

package/presets/claude/ios-swift/rules/ui-and-accessibility/swiftui.md

@@ -0,0 +1,61 @@
+---
+description: Паттерны SwiftUI, View и Design System (preset)
+paths:
+  - "**/{Presentation,DesignSystem}/**/*.swift"
+---
+
+# Общие правила View
+
+- **SwiftUI** — приоритет; UIKit — только по конвенции репо (wrapper, legacy).
+- View должна быть **тонкой**:
+  - отображает state из ViewModel;
+  - делегирует действия через методы/closures ViewModel;
+  - не содержит бизнес-логики, маппинга DTO, сетевых вызовов.
+- Перед новым кастомным контролом — искать компонент в `DesignSystem/` или существующих фичах.
+- Повторяемую UI-логику выносить в `ViewModifier`, `@ViewBuilder` helpers или subviews.
+
+# ViewModel и binding
+
+- ViewModel — `@MainActor`, `@Observable` (iOS 17+) или `ObservableObject` — как принято в проекте.
+- View читает state и вызывает **явные методы** ViewModel (`submit()`, `load()`), а не мутирует внутреннее состояние напрямую.
+- Для навигации — coordinator/router или enum route в ViewModel, не размазанные `NavigationLink` с бизнес-условиями в View.
+
+# Структура файлов
+
+Для экрана фичи:
+- `FeatureView.swift` — композиция subviews.
+- `FeatureViewModel.swift` — state + intents.
+- `FeatureView+Subviews.swift` — при большом дереве (опционально).
+- `FeatureRoute.swift` — навигация (если используется).
+
+Для компонента Design System:
+- Папка `ComponentName/`:
+  - `ComponentName.swift`
+  - `ComponentName+Preview.swift` (опционально)
+  - `ComponentNameStyle.swift` — стили/варианты (опционально)
+
+# Стили и Design System
+
+- Цвета, шрифты, отступы — из **токенов/Theme** проекта (`DesignSystem`, `Assets`, generated tokens).
+- Избегать:
+  - «магических» литералов (`.padding(17)`, `Color(red: 0.2, ...)`), если есть токены;
+  - дублирования стилей, уже закрытых примитивами.
+- `Preview` — для компонентов и экранов с mock ViewModel.
+
+# Accessibility
+
+- Интерактивные элементы: осмысленные `accessibilityLabel`, `accessibilityHint` где нужно.
+- Для UI-тестов — стабильные `accessibilityIdentifier` на ключевых элементах (согласовать с `testing/ui.md`).
+- Поддерживать Dynamic Type и контраст, не ломать layout при крупном шрифте.
+
+# Previews и локализация
+
+- Строки UI — через `String(localized:)` / `LocalizedStringKey`, не hardcoded в production без причины.
+- `#Preview` с реалистичными mock-данными; для ViewModel — stub use cases.
+
+# Требование к агенту
+
+При создании/изменении UI:
+- Следовать существующим экранам и компонентам как эталону.
+- Не импортировать Data-слой во View/ViewModel.
+- Subview выделять, когда body превышает ~40–60 строк или повторяется.