@bonesofspring/ai-rules 0.2.1 → 0.2.2

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

@@ -1,16 +1,3 @@
 # Tooling and review
 
-Lint, package manager, качество кода, code review MR.
-
-| Файл | Содержание |
-|------|------------|
-| `package-manager.md` | yarn / pnpm / npm / bun — определить по lockfile |
-| `agent-team-intake.md` | Когда предлагать `/task` и router pipeline |
-| `agent-team-orchestrator.md` | Dynamic agent team workflow: router, pipeline, gates |
-| `post-change-lint.md` | Обязательный `lint:js` + `lint:css` после изменений |
-| `code-quality.md` | Boy scout rule, рефакторинг, ESLint |
-| `code-review-mr.md` | Чеклист ревью merge request |
-
-Все — **session start**.
-
-On-demand: **`commands/technical-retro.md`** (фасилитация ретро, не грузится как rule).
+Рефакторинг, качество кода, процесс ревью MR.

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

@@ -1,9 +1,3 @@
 # UI and accessibility
 
-Компоненты, стили, пропсы.
-
-| Файл | Содержание | Загрузка |
-|------|------------|----------|
-| `no-props-spread.md` | Явные пропсы, без `{...props}` | session start |
-| `css-property-order.md` | Порядок CSS (Stylelint idiomatic-order) | `paths: styles.ts`, `.css` |
-| `react-ui.md` | Структура компонентов, `.data.ts`, хуки | `paths: app/src/ui/**` |
+Компоненты, стили, доступность, паттерны React UI.

package/presets/claude/next/skills/README.md

@@ -1,15 +1,5 @@
 # `.claude/skills` (preset next)
 
-[Skills](https://code.claude.com/docs/en/skills) в Claude Code — сценарии, которые подгружаются по необходимости, а не в каждой сессии целиком. Они синхронизированы по смыслу с `.cursor/skills` из Cursor-пресета.
-
-| Skill | Когда использовать |
-|-------|--------------------|
-| `feature-delivery` | End-to-end feature work across types, API, store, UI, tests |
-| `code-review` | MR/diff review using project architecture and test standards |
-| `debug-investigation` | Reproducing and fixing bugs with root-cause evidence |
-| `ci-investigation` | Diagnosing and fixing failing CI checks on PRs/branches |
-| `unit-testing` | Planning, generating, or healing unit test coverage |
-| `playwright-e2e` | Planning, generating, or healing Playwright e2e coverage |
-| `technical-retro` | Technical retrospective for a task, sprint, incident, or agent pipeline |
+[Skills](https://code.claude.com/docs/en/skills) в Claude Code — сценарии, которые подгружаются по необходимости, а не в каждой сессии целиком. Добавьте сюда `SKILL.md` или структуру skills по документации инструмента.
 
 Папка копируется в `.claude/skills/` при `ai-rules init claude --preset next`, если существует.

package/presets/cursor/ios-swift/README.md

@@ -0,0 +1,17 @@
+# iOS Swift preset (Cursor)
+
+Правила для разработки iOS-приложений на Swift (SwiftUI, MVVM/Clean Architecture).
+
+Установка:
+
+```bash
+npx @bonesofspring/ai-rules init cursor --preset ios-swift
+```
+
+См. `rules/README.md` — карта `.mdc` и бюджет alwaysApply.
+
+Ключевые requestable-правила доставки:
+
+- `feature-delivery-workflow.mdc` — порядок слоёв при реализации фичи
+- `post-change-build.mdc` — сборка / lint после правок Swift
+- `code-review-mr.mdc` — ревью MR/diff (не always-on)

package/presets/cursor/ios-swift/commands/README.md

@@ -0,0 +1,3 @@
+# Cursor commands (ios-swift preset)
+
+Place command definitions for this preset here. They are copied to `.cursor/commands` when you run `ai-rules init cursor --preset ios-swift`.

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

@@ -0,0 +1,33 @@
+### Разница .mdc и .md в .cursor/rules
+
+#### .md
+Обычный markdown‑файл. Cursor видит его как документацию/контент, но не как правило, которое нужно автоматически применять.
+
+#### .mdc
+Специальный формат Cursor Rule:
+- сверху обязателен YAML‑frontmatter с полями вроде description, globs, alwaysApply;
+- файл лежит в .cursor/rules/;
+- Cursor интерпретирует его как конфигурацию поведения ассистента для этого репо (автоматически подмешивает содержимое в контекст, когда правило подходит).
+
+- То есть .mdc = “markdown + config для Cursor”, .md = просто текст без управляющего смысла для ассистента.
+
+### Пресет ios-swift — карта правил
+
+**alwaysApply budget:** целевой потолок — **≤3** always-on правила и **≤130** строк тела (после YAML) суммарно. Новые alwaysApply только вместе с сокращением существующего бюджета.
+
+| Файл | Скоуп | Тема |
+|------|--------|------|
+| `ios-app-core.mdc` | always | Стек, структура проекта, tips агента |
+| `architecture-boundaries.mdc` | always | Границы Presentation / Domain / Data, DI |
+| `code-quality-and-refactoring.mdc` | always | Качество и лёгкий refactor |
+| `code-review-mr.mdc` | requestable / on review | Ревью MR/diff/PR |
+| `feature-delivery-workflow.mdc` | requestable / on feature | Чеклист доставки фичи |
+| `post-change-build.mdc` | requestable / after Swift edits | Сборка, SwiftLint/Format |
+| `swiftui-ui.mdc` | Presentation, DesignSystem | SwiftUI, a11y, Design System |
+| `networking-services.mdc` | Data, Network | API, DTO, mappers |
+| `state-and-viewmodels.mdc` | ViewModels | State, use cases, DI |
+| `swift-conventions.mdc` | `**/*.swift` | Swift style, concurrency |
+| `tests-unit.mdc` | `*Tests` | Unit / integration |
+| `tests-ui.mdc` | `*UITests` | XCUITest |
+
+Установка: `npx @bonesofspring/ai-rules init cursor --preset ios-swift`

package/presets/cursor/ios-swift/rules/architecture-boundaries.mdc

@@ -0,0 +1,34 @@
+---
+description: Архитектурные границы и правила зависимостей iOS приложения
+alwaysApply: true
+---
+
+# Границы между слоями
+
+- **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/`.
+- Раскладка фичи — как в `ios-app-core.mdc` / соседних `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/cursor/ios-swift/rules/code-quality-and-refactoring.mdc

@@ -0,0 +1,39 @@
+---
+description: Поддержка и улучшение качества кода и архитектуры iOS
+alwaysApply: true
+---
+
+# Поддержка существующего стиля
+
+- Новые изменения должны:
+  - следовать существующим паттернам (имена, структура, 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/cursor/ios-swift/rules/code-review-mr.mdc

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

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

@@ -0,0 +1,61 @@
+---
+description: Сквозной чеклист доставки iOS-фичи и матрица «зона → правило». Use when implementing features, adding screens/API, or extending existing iOS flows.
+alwaysApply: false
+---
+
+# Доставка фичи (iOS)
+
+Типичная фича с данными и UI. Детали слоёв — `architecture-boundaries.mdc`, `ios-app-core.mdc`.
+
+## Чеклист (порядок работ)
+
+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`**: сборка затронутых таргетов + 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.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` |
+| `*Tests/**` | `tests-unit.mdc` |
+| `*UITests/**` | `tests-ui.mdc` |
+| После правок Swift | `post-change-build.mdc` |
+
+При добавлении или расширении фичи **пройти чеклист** и правила из таблицы для затронутых зон.

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

@@ -0,0 +1,43 @@
+---
+description: Базовые принципы, стек и структура iOS приложения на Swift (preset)
+alwaysApply: true
+---
+
+# Стек и окружение
+
+Версии 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.mdc`**.
+
+# 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.mdc`.
+- Доставка фичи — `feature-delivery-workflow.mdc`; после правок Swift — `post-change-build.mdc`.

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

@@ -0,0 +1,49 @@
+---
+description: Конвенции сетевого слоя, API-клиентов и mappers
+globs: "**/{Data,Network,Networking}/**/*.swift"
+alwaysApply: false
+---
+
+# Роль 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/cursor/ios-swift/rules/post-change-build.mdc

@@ -0,0 +1,32 @@
+---
+description: Сборка и lint после изменений Swift/iOS кода. Use after editing iOS/Swift sources, Xcode targets, or Package.swift.
+alwaysApply: false
+---
+
+# Сборка и 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/cursor/ios-swift/rules/state-and-viewmodels.mdc

@@ -0,0 +1,43 @@
+---
+description: ViewModels, состояние экрана и domain flow
+globs: "**/{Presentation,Domain}/**/*ViewModel*.swift"
+alwaysApply: false
+---
+
+# Общие принципы
+
+- 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.
+- 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` — как в проекте; не смешивать стили в одной фиче без причины.
+
+# Use cases и repositories
+
+- ViewModel зависит от **протоколов** (`LoadOrdersUseCase`, `OrderRepository`), не от `*RepositoryImpl`.
+- Один use case — одна бизнес-операция; не раздувать ViewModel сотнями строк — выносить use cases в Domain.
+- Кэширование и offline — в repository/Data, не во ViewModel.
+
+# Side effects
+
+- Analytics, haptics, deep links — через injected services или middleware-паттерн, не hardcode синглтонов.
+- `Task` в ViewModel: отмена при `deinit` / `onDisappear` где нужно (`task(id:)`, хранение `Task?` с cancel).
+
+# Тестируемость
+
+- Инициализатор ViewModel принимает протоколы (DI); без скрытых singleton для сети/БД.
+- Бизнес-ветки покрывать unit-тестами с mock use cases.
+
+# Требование к агенту
+
+При создании ViewModel:
+- Не вызывать `URLSession` / API client напрямую.
+- Не парсить JSON и не объявлять DTO во ViewModel.
+- Именование: `FeatureViewModel`, методы — глаголы (`loadOrders()`, `submitOrder()`).
+- Следовать стилю существующих ViewModels в той же фиче.

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

@@ -0,0 +1,51 @@
+---
+description: Swift language conventions and safety (preset)
+globs: "**/*.swift"
+alwaysApply: false
+---
+
+# 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/cursor/ios-swift/rules/swiftui-ui.mdc

@@ -0,0 +1,61 @@
+---
+description: Паттерны SwiftUI, View и Design System (preset)
+globs: "**/{Presentation,DesignSystem}/**/*.swift"
+alwaysApply: false
+---
+
+# Общие правила 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` на ключевых элементах (согласовать с `tests-ui.mdc`).
+- Поддерживать Dynamic Type и контраст, не ломать layout при крупном шрифте.
+
+# Previews и локализация
+
+- Строки UI — через `String(localized:)` / `LocalizedStringKey`, не hardcoded в production без причины.
+- `#Preview` с реалистичными mock-данными; для ViewModel — stub use cases.
+
+# Требование к агенту
+
+При создании/изменении UI:
+- Следовать существующим экранам и компонентам как эталону.
+- Не импортировать Data-слой во View/ViewModel.
+- Subview выделять, когда body превышает ~40–60 строк или повторяется.

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

@@ -0,0 +1,41 @@
+---
+description: UI-тесты XCUITest и accessibility identifiers
+globs: "**/*UITests/**/*.swift"
+alwaysApply: false
+---
+
+# Структура UI-тестов
+
+- UI Test target: `*UITests/` — сценарии пользовательских потоков.
+- Page Object (или Screen Object) — класс на экран: селекторы + действия (`LoginScreen`, `OrderHistoryScreen`).
+- Общие хелперы — `UITestSupport/`, base classes, launch arguments.
+
+# Селекторы и стабильность
+
+- **Приоритет:** `accessibilityIdentifier` для ключевых элементов; затем label/trait где устойчиво.
+- Идентификаторы согласовать с Presentation-слоем (`swiftui-ui.mdc`): `{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 как эталону.