@bonesofspring/ai-rules 0.2.14 → 0.2.16

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

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

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

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

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

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

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

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

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

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

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

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

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

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

package/presets/cursor/ios-swift/rules/preset-layering.mdc

@@ -9,29 +9,28 @@ alwaysApply: false
 
 <!-- shared-core: meta/preset-layering.md -->
 
-
 # Preset layering
 
-Правила для **авторов пресетов** (`packages/ai-rules/presets/**`). Не always-on в consumer apps.
+Rules for **preset authors** (`packages/ai-rules/presets/**`). Not always-on in consumer apps.
 
-## Слои
+## Layers
 
-| Слой | Где | Что класть |
-|------|-----|------------|
-| **Core** | `presets/_shared/core/**` | Stack-agnostic prose + checklists; без frontmatter; без путей `app/**`, `Features/**`, Playwright, xcodebuild |
-| **Stack** | `presets/{cursor\|claude}/<stack>/` | Domain/tooling, always-on trio стека, stack examples в **Stack notes** |
+| Layer | Where | What to put |
+|-------|-------|-------------|
+| **Core** | `presets/_shared/core/**` | Stack-agnostic prose + checklists; no frontmatter; no paths `app/**`, `Features/**`, Playwright, xcodebuild |
+| **Stack** | `presets/{cursor\|claude}/<stack>/` | Domain/tooling, stack always-on trio, stack examples in **Stack notes** |
 | **Platform** | Cursor `.mdc` / Claude `.md` | Frontmatter (`alwaysApply`/`globs` vs `paths:`), platform-only (`BUGBOT.md`, `CLAUDE.md`) |
 
-## Куда класть новое правило
+## Where to put a new rule
 
-1. Общие принципы для всех стеков → **core** + адаптеры с `<!-- shared-core: … -->`.
-2. Только один из installable стеков (`next` / `nuxt` / `svelte` / `ios-swift` / `go` / `java` / `mcp-ts` / `php-hexagonal` / `php-laravel`) → **stack-specific** (не в `_shared`).
-3. Только Cursor или только Claude packaging → platform artifact / frontmatter, не дублировать семантику.
+1. Shared principles for all stacks → **core** + adapters with `<!-- shared-core: … -->`.
+2. Only one of the installable stacks (`next` / `nuxt` / `svelte` / `ios-swift` / `android-kotlin` / `go` / `java` / `mcp-ts` / `php-hexagonal` / `php-laravel`) → **stack-specific** (not in `_shared`).
+3. Only Cursor or only Claude packaging → platform artifact / frontmatter; do not duplicate semantics.
 
 ## SoT
 
 - Packages path — SoT; root `.cursor/` — dogfood sync.
 - Per stack: **Cursor** `presets/cursor/<stack>/` → Claude twin same PR.
-- `_shared` **не** `--preset` и не копируется CLI `init`.
+- `_shared` is **not** a `--preset` and is not copied by CLI `init`.
 
-См. также: `preset-twin-sync`, `preset-token-budget`, `preset-pr-checklist`, `preset-no-cross-stack-leakage`.
+See also: `preset-twin-sync`, `preset-token-budget`, `preset-pr-checklist`, `preset-no-cross-stack-leakage`.

package/presets/cursor/ios-swift/rules/preset-no-cross-stack-leakage.mdc

@@ -9,18 +9,18 @@ alwaysApply: false
 
 <!-- shared-core: meta/preset-no-cross-stack-leakage.md -->
 
-
 # Preset no cross-stack leakage
 
-Запрет протекания stack-specific имён, путей и handoff stems между пресетами.
+Ban leakage of stack-specific names, paths, and handoff stems across presets.
 
 ## Principles
 
-- `next` must not require iOS-only agents/tooling (`xcuitest-*`, `xcodebuild` as required handoff, Keychain-only rules).
-- `nuxt` must not require iOS-only agents/tooling (`xcuitest-*`, `xcodebuild` as required handoff, Keychain-only rules).
-- `svelte` must not require iOS-only agents/tooling (`xcuitest-*`, `xcodebuild` as required handoff, Keychain-only rules).
-- `ios-swift` must not ship Playwright handoffs or Next lint recipes as required commands.
-- `go` / `java` / `php-hexagonal` / `php-laravel` / `mcp-ts` must not ship Playwright, XCUITest, Next lint recipes, or `xcodebuild`/`SwiftLint` as required handoffs.
+- `next` must not require iOS-only or Android-only agents/tooling (`xcuitest-*`, `instrumentation-test-*`, `xcodebuild` as required handoff, Keychain-only rules).
+- `nuxt` must not require iOS-only or Android-only agents/tooling (`xcuitest-*`, `instrumentation-test-*`, `xcodebuild` as required handoff, Keychain-only rules).
+- `svelte` must not require iOS-only or Android-only agents/tooling (`xcuitest-*`, `instrumentation-test-*`, `xcodebuild` as required handoff, Keychain-only rules).
+- `ios-swift` must not ship Playwright handoffs, Android `instrumentation-test-*` handoffs, or Next lint recipes as required commands.
+- `android-kotlin` must not ship Playwright, XCUITest, `xcodebuild`, or Next lint recipes as required handoffs.
+- `go` / `java` / `php-hexagonal` / `php-laravel` / `mcp-ts` must not ship Playwright, XCUITest, Android instrumentation agents, Next lint recipes, or `xcodebuild`/`SwiftLint` as required handoffs.
 - `mcp-ts` must not ship Go tool commands (`go test`, `go vet`, `golangci-lint`) or `integration-test-*` agents as required delivery gates.
 - Shared core must not embed stack paths (`app/src/**`, `Features/**`, `playwright`, `xcodebuild`).
 
@@ -29,25 +29,37 @@ alwaysApply: false
 In ios-swift `chain-team-phases.sh` / agent handoffs (Cursor + Claude):
 
 - `playwright-test-`, `playwright-agents`, `playwright-e2e`, `user-playwright`
+- `instrumentation-test-` as required Android handoffs
 - `app/__tests__/e2e` as a required path
 - Positive yarn recipes `lint:js` / `lint:css` as commands to run (negation prose alone is weak — prefer zero occurrences)
 
 Required instead: `xcuitest-test-*` stems; build-verifier mentions `xcodebuild` or `post-change-build` / `xcode-tooling`.
 
+## Forbidden in android-kotlin hooks/agents (FAIL)
+
+In android-kotlin `chain-team-phases.sh` / agent handoffs (Cursor + Claude):
+
+- `playwright-test-`, `playwright-agents`, `playwright-e2e`, `user-playwright`
+- `app/__tests__/e2e` as a required path
+- `xcuitest-test-`, positive `xcodebuild` / `SwiftLint` as required handoffs
+- Positive yarn recipes `lint:js` / `lint:css` as commands to run
+
+Required instead: `instrumentation-test-*` stems; build-verifier mentions `gradle-tooling` and/or `post-change-build` (Gradle wrapper discovery — not `xcodebuild` as the default gate).
+
 ## Forbidden in next hooks/agents (FAIL when present as required)
 
-- `xcuitest-test-` as handoff stems
+- `xcuitest-test-` / `instrumentation-test-` as handoff stems
 - Requiring `xcodebuild` / SwiftLint as the default post-change gate for Next app work
 
 ## Forbidden in nuxt hooks/agents (FAIL when present as required)
 
-- `xcuitest-test-` as handoff stems
+- `xcuitest-test-` / `instrumentation-test-` as handoff stems
 - Requiring `xcodebuild` / SwiftLint as the default post-change gate for Nuxt app work
 - Frontend profile mirrors `next`: Playwright / `lint:js` / `lint:css` allowed
 
 ## Forbidden in svelte hooks/agents (FAIL when present as required)
 
-- `xcuitest-test-` as handoff stems
+- `xcuitest-test-` / `instrumentation-test-` as handoff stems
 - Requiring `xcodebuild` / SwiftLint as the default post-change gate for SvelteKit app work
 - Frontend profile mirrors `next` / `nuxt`: Playwright / `lint:js` / `lint:css` allowed
 
@@ -57,7 +69,7 @@ Shared backend-stack bans (`go`, `java`, `php-hexagonal`, and `php-laravel`):
 
 - `playwright-test-`, `playwright-e2e`, `user-playwright`, `app/__tests__/e2e`
 - Positive yarn recipes `lint:js` / `lint:css`
-- `xcuitest-test-`, `xcodebuild`, `SwiftLint` as required handoffs
+- `xcuitest-test-`, `instrumentation-test-`, `xcodebuild`, `SwiftLint` as required handoffs
 - Agent file `accessibility-reviewer` (no UI surface)
 
 Required instead: `integration-test-*`; build-verifier / `post-change-test` plus stack tooling — `go-tooling` (`go test`, `go vet`), `java-tooling` (`mvn test` / `./gradlew test`), or `php-tooling` (`php artisan test` / `composer test` / `vendor/bin/phpunit`).
@@ -68,9 +80,9 @@ Same UI/mobile bans as backend stacks, plus:
 
 - `playwright-test-`, `playwright-agents`, `playwright-e2e`, `user-playwright`, `app/__tests__/e2e`
 - Positive yarn recipes `lint:js` / `lint:css` as required gates
-- `xcuitest-test-`, `xcodebuild`, `SwiftLint` as required handoffs
+- `xcuitest-test-`, `instrumentation-test-`, `xcodebuild`, `SwiftLint` as required handoffs
 - Go tool commands as required MCP delivery gates: `go test`, `go vet`, `golangci-lint`
-- Agent files: `playwright-test-*`, `xcuitest-test-*`, `integration-test-*`, `accessibility-reviewer`
+- Agent files: `playwright-test-*`, `xcuitest-test-*`, `instrumentation-test-*`, `integration-test-*`, `accessibility-reviewer`
 
 Required instead: package-manager–discovered typecheck/test (`mcp-ts-tooling`, `post-change-test`); Phase 1 gates `build-verifier` + `security-reviewer`.
 
@@ -81,4 +93,4 @@ Required instead: package-manager–discovered typecheck/test (`mcp-ts-tooling`,
 
 ## Chain fork
 
-`hooks/chain-team-phases.sh` must differ **byte-wise** pairwise among `next`, `nuxt`, `svelte`, `ios-swift`, `go`, `java`, `mcp-ts`, `php-hexagonal`, and `php-laravel` (per platform).
+`hooks/chain-team-phases.sh` must differ **byte-wise** pairwise among `next`, `nuxt`, `svelte`, `ios-swift`, `android-kotlin`, `go`, `java`, `mcp-ts`, `php-hexagonal`, and `php-laravel` (per platform).

package/presets/cursor/ios-swift/rules/preset-pr-checklist.mdc

@@ -9,19 +9,18 @@ alwaysApply: false
 
 <!-- shared-core: meta/preset-pr-checklist.md -->
 
-
 # Preset PR checklist
 
-Чеклист для PR, затрагивающих `packages/ai-rules/presets/**` (и dogfood `.cursor/` sync).
+Checklist for PRs that touch `packages/ai-rules/presets/**` (and dogfood `.cursor/` sync).
 
 ## Before merge
 
-- [ ] **SoT:** правки в `packages/…` (не только root `.cursor/`)
-- [ ] **Core:** если менялся `_shared/core/**` — обновлены все `<!-- shared-core: … -->` consumers (или documented intentional fork)
-- [ ] **Twin:** Cursor change → Claude twin **same PR** (**FAIL** if missing on next, nuxt, svelte, ios-swift, go, java, mcp-ts, php-hexagonal, and php-laravel — см. `preset-twin-sync`)
-- [ ] **Mapping:** `claude/<stack>/rules/README.md` mapping table актуален
+- [ ] **SoT:** edits in `packages/…` (not only root `.cursor/`)
+- [ ] **Core:** if `_shared/core/**` changed — all `<!-- shared-core: … -->` consumers updated (or documented intentional fork)
+- [ ] **Twin:** Cursor change → Claude twin **same PR** (**FAIL** if missing on next, nuxt, svelte, ios-swift, android-kotlin, go, java, mcp-ts, php-hexagonal, and php-laravel — see `preset-twin-sync`)
+- [ ] **Mapping:** `claude/<stack>/rules/README.md` mapping table is current
 - [ ] **Token budget:** alwaysApply / session-start ≤ 3; meta rules not always-on
-- [ ] **Leakage:** нет чужих stack agent stems / handoff strings (`preset-no-cross-stack-leakage`)
+- [ ] **Leakage:** no foreign stack agent stems / handoff strings (`preset-no-cross-stack-leakage`)
 - [ ] **Twin depth:** domain ≥15 lines; thin aliases documented
 - [ ] **README:** stack `rules/README.md` core→stack mapping / catalog updated if stems added
 - [ ] **CHANGELOG / package README:** note when public preset paths or install surface change

package/presets/cursor/ios-swift/rules/preset-token-budget.mdc

@@ -9,21 +9,20 @@ alwaysApply: false
 
 <!-- shared-core: meta/preset-token-budget.md -->
 
-
 # Preset token budget
 
-Инварианты загрузки правил в **установленном** пресете (consumer app).
+Invariants for rule loading in an **installed** preset (consumer app).
 
 ## Hard caps
 
 | Platform | Always-on | Cap |
 |----------|-----------|-----|
 | Cursor | `alwaysApply: true` | **≤ 3** |
-| Claude | rules **without** `paths:` | **ровно 3** |
+| Claude | rules **without** `paths:` | **exactly 3** |
 
 **Claude Option A (README exclusion):** when counting Claude rules without `paths:` / session-start, **exclude `**/README.md`** (topic indexes are not session-start rules). The intended session-start trio remains **exactly 3**; body budget sums **only those 3** rules.
 
-Session-start body budget (где задокументировано): ≤140 строк суммарно (stretch ≤120).
+Session-start body budget (where documented): ≤140 lines total (stretch ≤120).
 
 ## Meta / author rules