@bonesofspring/ai-rules 0.2.1 → 0.2.3

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

@@ -0,0 +1,68 @@
+---
+description: Сквозной чеклист доставки iOS-фичи и матрица «зона → правило». Use when implementing features, adding screens/API, or extending existing iOS flows.
+paths:
+  - .claude/commands/**/*
+  - .claude/team/**/*
+  - .claude/agents/**/*
+  - Features/**/*
+  - **/Presentation/**/*
+  - **/Domain/**/*
+  - **/Data/**/*
+---
+
+# Доставка фичи (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` (+ `tooling-and-review/xcode-tooling.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` (+ `tooling-and-review/xcode-tooling.md`) |
+
+При добавлении или расширении фичи **пройти чеклист** и правила из таблицы для затронутых зон.

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

@@ -0,0 +1,25 @@
+---
+description: SPM / модули — public API, access control, запрет deep-import internals
+paths:
+  - "**/Package.swift"
+  - "**/*Public*.swift"
+  - "**/Sources/**/*.swift"
+---
+
+# Module public API (SPM)
+
+## Рамка
+
+- Потребители модуля импортируют **только public/open** API; `internal`/`fileprivate` — для реализации.
+- Deep-import чужих internal файлов — повод вынести символ в public API или рефакторить границы.
+
+## Правила
+
+- Новый публичный тип/функция — явный `public` + документация/пример использования при необходимости.
+- Barrel-стиль: один входной модуль / umbrella, если так заведено в репо.
+- Не экспортировать DTO сети из Presentation-facing модулей.
+- Версионирование breaking API — осознанно (SemVer пакета / release notes).
+
+## Требование к агенту
+
+Перед `public` на тип — проверить, нужен ли он снаружи. Следовать access control соседних модулей.

package/presets/claude/ios-swift/rules/architecture/reference-features.md

@@ -0,0 +1,50 @@
+---
+description: Эталонные Feature-модули репозитория — копировать структуру при реализации. Заполните пути после init в целевом iOS-репо.
+paths:
+  - Features/**/*
+  - "**/Presentation/**/*"
+  - "**/Domain/**/*"
+  - "**/Data/**/*"
+  - "**/DesignSystem/**/*"
+---
+
+# Эталонные фичи (reference features)
+
+Перед реализацией найди Feature того же типа и **повтори её структуру**, не изобретая новую организацию файлов.
+
+## Таблица эталонов
+
+После `ai-rules init` замени примеры на **реальные** пути consumer-репо. Ниже — conventional placeholders для greenfield / dogfood.
+
+| Слой | Эталон (пример → заменить) | 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` |
+| UI tests | `OrdersUITests/` | `**/*UITests/**/*.swift` |
+
+Если в репо другая раскладка (`Modules/`, `Sources/`) — перепиши таблицу один раз и держи её SoT для агентов.
+
+## Как использовать
+
+1. Определи затронутые слои из `decomposition.md` или задачи.
+2. Открой эталон из таблицы (после заполнения путей).
+3. Зеркаль именование, порядок файлов, DI, паттерны тестов.
+4. Если эталона нет — выбери **самую близкую** существующую фичу того же слоя и зафиксируй выбор в handoff.
+
+## Dogfood checklist (5 сценариев)
+
+1. `/task` новая фича в `Features/<Name>` — analyst → developer → build-verifier (xcodebuild).
+2. Баг в ViewModel — debugger → fix → unit test.
+3. Mapper DTO↔domain — unit-test-planner/generator.
+4. UI flow — `xcuitest-test-planner` → generator (accessibilityIdentifier).
+5. Auth/Keychain touch — security-reviewer + `security-ios`.
+
+## Связанные правила
+
+- `tooling-and-review/code-quality.md` — повторять паттерны.
+- `architecture/feature-delivery.md` — порядок слоёв.
+- skill `feature-delivery` — end-to-end сценарий.

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,43 @@
+---
+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` (requestable).
+- Toolchain перед сборкой — `tooling-and-review/xcode-tooling.md` (requestable).

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,43 @@
+---
+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 как эталону.
+
+- Планирование / генерация / heal — agents `xcuitest-test-{planner,generator,healer}` и skill `xcuitest-e2e` (не Playwright).

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,16 @@
+# Tooling and review
+
+Качество, review, build, security, agent-team, retro. 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` |
+| [`xcode-tooling.md`](./xcode-tooling.md) | `xcode-tooling.mdc` |
+| [`security-ios.md`](./security-ios.md) | `security-ios.mdc` |
+| [`agent-team-intake.md`](./agent-team-intake.md) | `agent-team-intake.mdc` |
+| [`agent-team-orchestrator.md`](./agent-team-orchestrator.md) | `agent-team-orchestrator.mdc` |
+| [`technical-retro.md`](./technical-retro.md) | `technical-retro.mdc` |
+
+Sync: change Cursor → update Claude twin same PR. Full map: [`../README.md`](../README.md).

package/presets/claude/ios-swift/rules/tooling-and-review/agent-team-intake.md

@@ -0,0 +1,18 @@
+---
+description: Use when user posts a work request without /task — suggest or use /task to run the agent team router. Lightweight intake hint only.
+paths:
+  - .claude/commands/**/*
+  - .claude/team/**/*
+---
+
+# Agent team intake
+
+When the user message looks like a **work request** (implement, add, fix, refactor, review MR, write tests, spike) — not a question about how code works:
+
+1. Prefer **`/task <their request>`** or invoke **task-router** first.
+2. Do not jump straight to coding without router + pipeline when scope is non-trivial.
+3. Pure questions («как работает X», «объясни») — answer normally, no `/task`.
+
+Exceptions: user explicitly says «без pipeline», «просто сделай», or continues an active slug.
+
+Scope: iOS/Swift Feature modules (`Features/`, Presentation/Domain/Data) — not `app/src` / Playwright.

package/presets/claude/ios-swift/rules/tooling-and-review/agent-team-orchestrator.md

@@ -0,0 +1,47 @@
+---
+description: Orchestrates the agent team via task-router and pipeline.json. Use for /task, /task-continue, /feature-start, task decomposition, or when the user describes a feature, bug, or review request.
+paths:
+  - .claude/commands/**/*
+  - .claude/team/**/*
+  - .claude/agents/**/*
+---
+
+# Agent team orchestrator
+
+Parent agent = **manager**. Router plans; specialists execute. Artifacts: `.claude/team/tasks/<slug>/`.
+
+Work request без `/task` — см. **`tooling-and-review/agent-team-intake.md`**.
+
+## Entry points
+
+| Command | When |
+|---------|------|
+| **`/task <desc>`** | **Preferred** — router → dynamic pipeline → first agent |
+| `/task-continue <slug>` | After human gate or pause |
+| `/feature-start <desc>` | Legacy: analyst-only start (no router) |
+| `/feature-continue <slug>` | Alias of task-continue |
+| `/technical-retro [slug]` | Retro with agent team block |
+
+## Roles (iOS)
+
+Same stems as Cursor ios-swift agents. **Never Playwright** — use `xcuitest-test-{planner,generator,healer}`. `build-verifier` runs xcodebuild + SwiftLint/Format + unit smoke.
+
+Full prompts: `.claude/agents/*.md`. Artifacts: `.claude/team/README.md`.
+
+## Dynamic pipeline
+
+**Source of truth:** `pipeline.json` → `steps[]`.
+
+## Rules (strict)
+
+1. **`/task` always starts with task-router**.
+2. Read `pipeline.json` before every subagent invocation.
+3. One role per invocation — except parallel steps.
+4. **Never** skip `humanGates` without continue/approval.
+5. Persist handoffs under `.claude/team/tasks/<slug>/`.
+6. On `validation_failed`: developer → build-verifier.
+7. When complete, suggest `/technical-retro <slug>`.
+
+## Skip pipeline when
+
+Pure questions; trivial one-file; user «без pipeline»; docs-only one-liner.

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,46 @@
+---
+description: Требования к code review для iOS merge requests. Use when reviewing MR/diff/PR, evaluating a branch, or when the user asks for code review.
+paths:
+  - .claude/commands/**/*
+  - .claude/team/**/*
+  - .claude/agents/**/*
+  - .claude/skills/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,36 @@
+---
+description: Сборка и lint после изменений Swift/iOS кода. Use after editing iOS/Swift sources, Xcode targets, or Package.swift.
+paths:
+  - .claude/commands/**/*
+  - .claude/agents/**/*
+  - **/*.{swift,xcodeproj,xcworkspace,pbxproj}
+  - **/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/tooling-and-review/security-ios.md

@@ -0,0 +1,36 @@
+---
+description: ATS, Keychain, PII, секреты, безопасное логирование iOS
+paths:
+  - "**/*Keychain*.swift"
+  - "**/*Auth*.swift"
+  - "**/*Token*.swift"
+  - "**/*Credential*.swift"
+  - "**/Info.plist"
+  - .claude/commands/**/*
+  - .claude/agents/**/*
+---
+
+# Security (iOS)
+
+## Секреты и конфиг
+
+- Нет API keys / tokens в исходниках и git; использовать Keychain, xcconfig (не в VCS), CI secrets.
+- Debug-only bypass ATS / SSL — только `#if DEBUG` и никогда в Release.
+
+## ATS и сеть
+
+- ATS exceptions в Info.plist — минимальные, с обоснованием; предпочитать HTTPS.
+- Certificate pinning — только если уже принято в репо.
+
+## PII и логи
+
+- Не логировать токены, пароли, полные номера карт/документов.
+- Crash/APM: scrub PII по политике репо.
+
+## Keychain / биометрия
+
+- Accessible уровни и `kSecAttrAccessible` — осознанно; Face ID/Touch ID — через LocalAuthentication как в репо.
+
+## Требование к агенту
+
+При auth/формах/платежах — сверить с этим правилом и `code-review`. Security-reviewer подключать для чувствительных фич.

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

@@ -0,0 +1,14 @@
+---
+description: Роль агента для проведения технического ретроспективы (retro). On-demand — предпочтительнее slash-команда /technical-retro.
+paths:
+  - .claude/commands/**/*
+  - .claude/team/**/*
+---
+
+# Техническое ретро — rule alias
+
+Полный сценарий — в slash-команде:
+
+**`.claude/commands/technical-retro.md`** → `/technical-retro`
+
+Используй rule только если command недоступен. Не дублируй содержимое — следуй command-файлу и skill `technical-retro`.

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

@@ -0,0 +1,24 @@
+---
+description: Перед xcodebuild / SwiftLint / SwiftFormat определять toolchain и схемы репозитория и использовать только их
+paths:
+  - .claude/commands/**/*
+  - .claude/agents/**/*
+  - "**/*.{swift,xcodeproj,xcworkspace,pbxproj}"
+  - "**/Package.swift"
+---
+
+# Xcode tooling (терминал)
+
+Перед **`xcodebuild` / `swift build` / `swift test` / SwiftLint / SwiftFormat / `simctl`** определи toolchain репозитория и **используй только его**.
+
+## Как определить
+
+1. **Workspace / project:** `.xcworkspace` (CocoaPods) → workspace; иначе `.xcodeproj`; SPM-only — `Package.swift`.
+2. **Scheme / destination:** как в CI, `Makefile`, `fastlane`, `scripts/` — не угадывать.
+3. **Lint:** `.swiftlint.yml` / `SwiftLint` в PATH или Mint/mise — если конфига нет, не запускать «чужой» lint.
+4. **Format:** `.swiftformat` / SwiftFormat — только если принято в репо.
+5. **Simulator:** `xcrun simctl list` + destination из CI; не хардкодить UDID.
+
+Примеры: `xcodebuild -scheme App -destination 'platform=iOS Simulator,name=iPhone 16' build`, `swiftlint lint --quiet`, `swiftformat . --lint`.
+
+Долгие сборки и DerivedData — нормальны; не блокировать `xcodebuild`/`simctl`/`xcrun`.