@bonesofspring/ai-rules 0.2.1 → 0.2.3

package/presets/cursor/ios-swift/hooks/guard-shell-command.sh

@@ -0,0 +1,79 @@
+#!/usr/bin/env bash
+# Lightweight shell guard for Cursor projects using this preset.
+# iOS: do NOT blanket-block xcodebuild / simctl / xcrun / swiftlint / swiftformat.
+# Package-manager mismatch checks apply only when a JS lockfile/package.json exists.
+
+set -euo pipefail
+
+input=$(cat)
+
+INPUT="$input" node <<'NODE'
+const fs = require('fs');
+
+const raw = process.env.INPUT || '';
+let event;
+try {
+  event = JSON.parse(raw);
+} catch {
+  process.stdout.write('{ "permission": "allow" }');
+  process.exit(0);
+}
+
+const command = String(event.command || event.input?.command || '');
+if (!command.trim()) {
+  process.stdout.write('{ "permission": "allow" }');
+  process.exit(0);
+}
+
+function out(permission, userMessage, agentMessage) {
+  process.stdout.write(JSON.stringify({
+    permission,
+    user_message: userMessage,
+    agent_message: agentMessage || userMessage,
+  }));
+}
+
+const dangerousGit = /\bgit\s+(reset\s+--hard|clean\s+-[^\n]*f|push\s+--force|push\s+-f|checkout\s+--\s+)/;
+if (dangerousGit.test(command)) {
+  out(
+    'ask',
+    'This command looks destructive for git state. Review it before continuing.',
+    'A project hook flagged a destructive git command. Ask the user before running it.',
+  );
+  process.exit(0);
+}
+
+const managerByFile = [
+  ['yarn.lock', 'yarn'],
+  ['pnpm-lock.yaml', 'pnpm'],
+  ['package-lock.json', 'npm'],
+].find(([file]) => fs.existsSync(file));
+
+let expected = managerByFile?.[1];
+if (!expected && fs.existsSync('package.json')) {
+  try {
+    const pkg = JSON.parse(fs.readFileSync('package.json', 'utf8'));
+    const pm = typeof pkg.packageManager === 'string' ? pkg.packageManager : '';
+    expected = pm.split('@')[0] || undefined;
+  } catch {
+    // Ignore invalid package.json in the hook; the agent can diagnose it later.
+  }
+}
+
+if (!expected) {
+  process.stdout.write('{ "permission": "allow" }');
+  process.exit(0);
+}
+
+const used = command.match(/(^|[;&|]\s*)(npm|yarn|pnpm)\s+/)?.[2];
+if (used && used !== expected) {
+  out(
+    'ask',
+    `This repository appears to use ${expected}, but the command uses ${used}. Confirm before continuing.`,
+    `Use ${expected} for package scripts and installs unless the user explicitly approves ${used}.`,
+  );
+  process.exit(0);
+}
+
+process.stdout.write('{ "permission": "allow" }');
+NODE

package/presets/{claude/next → cursor/ios-swift}/hooks.json

@@ -3,13 +3,13 @@
   "hooks": {
     "beforeShellExecution": [
       {
-        "command": ".claude/hooks/guard-shell-command.sh",
+        "command": ".cursor/hooks/guard-shell-command.sh",
         "failClosed": true
       }
     ],
     "subagentStop": [
       {
-        "command": ".claude/hooks/chain-team-phases.sh",
+        "command": ".cursor/hooks/chain-team-phases.sh",
         "loop_limit": 15
       }
     ]

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

@@ -0,0 +1,65 @@
+### Разница .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 правила и **≤120** строк тела (после YAML) суммарно (stretch ≤100). Новые alwaysApply только вместе с сокращением существующего бюджета.
+
+| Файл | Скоуп | Тема |
+|------|--------|------|
+| `ios-app-core.mdc` | **always** | Стек, структура, tips (+ pointers на tooling/build) |
+| `architecture-boundaries.mdc` | **always** | Границы Presentation / Domain / Data, DI |
+| `code-quality-and-refactoring.mdc` | **always** | Качество и лёгкий refactor |
+| `xcode-tooling.mdc` | requestable | Схемы, xcodebuild, SwiftLint/Format |
+| `post-change-build.mdc` | requestable | Сборка/lint после Swift edits (**обязателен** после code edits) |
+| `agent-team-intake.mdc` | requestable | Подсказка `/task` |
+| `agent-team-orchestrator.mdc` | requestable | Pipeline, gates, build-verifier |
+| `feature-delivery-workflow.mdc` | requestable | Чеклист доставки фичи |
+| `code-review-mr.mdc` | requestable | Ревью MR/diff |
+| `reference-features.mdc` | globs Features/** | Эталоны Feature + dogfood |
+| `technical-retro.mdc` | requestable | Alias → `/technical-retro` |
+| `swiftui-ui.mdc` | Presentation, DesignSystem | SwiftUI, a11y |
+| `navigation-coordinators.mdc` | Navigation / App | NavigationStack, deep links |
+| `networking-services.mdc` | Data, Network | API, DTO, mappers (HTTP only) |
+| `persistence-data.mdc` | Persistence, Keychain | SwiftData/Core Data/Keychain |
+| `security-ios.mdc` | Auth, Keychain, Info.plist | ATS, PII, secrets |
+| `module-public-api.mdc` | Package.swift, Sources | SPM public API |
+| `state-and-viewmodels.mdc` | ViewModels | State, use cases |
+| `swift-conventions.mdc` | `**/*.swift` | Swift style |
+| `tests-unit.mdc` | `*Tests` | Unit |
+| `tests-ui.mdc` | `*UITests` | XCUITest (+ pointer to xcuitest agents/skill) |
+
+**Всего topic `.mdc`:** 21 (без README).
+
+**Twin depth (Cursor↔Claude):** domain rules ≥15 body lines. Thin requestable **aliases** (`agent-team-intake`, `technical-retro`) могут быть короче — как в next (soft AC-19).
+
+### Presentation edit bundle
+
+При правке `**/Presentation/**` или `**/DesignSystem/**`: грузить `swiftui-ui` + `state-and-viewmodels` (+ `navigation-coordinators` при правке навигации). Не подмешивать orchestrator.
+
+### Loading strategy
+
+```text
+alwaysApply (3)
+  └─ ios-app-core + architecture-boundaries + code-quality
+
+requestable
+  └─ orchestrator, intake, feature-delivery, code-review-mr,
+     post-change-build, xcode-tooling, reference-features, technical-retro
+
+globs
+  └─ swiftui, navigation, viewmodels, networking, persistence,
+     security, modules, conventions, tests-*
+```
+
+Установка: `npx @bonesofspring/ai-rules init cursor --preset ios-swift`

package/presets/cursor/ios-swift/rules/agent-team-intake.mdc

@@ -0,0 +1,16 @@
+---
+description: Use when user posts a work request without /task — suggest or use /task to run the agent team router. Lightweight intake hint only.
+alwaysApply: false
+---
+
+# 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/cursor/ios-swift/rules/agent-team-orchestrator.mdc

@@ -0,0 +1,80 @@
+---
+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.
+alwaysApply: false
+---
+
+# Agent team orchestrator
+
+Parent agent = **manager**. Router plans; specialists execute. Artifacts: `.cursor/team/tasks/<slug>/`.
+
+Work request без `/task` — см. **`agent-team-intake.mdc`**.
+
+## 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)
+
+| Agent | Prod writes | Typical intent |
+|-------|-------------|----------------|
+| `task-router` | no (team) | Every `/task` |
+| `task-analyst` | no | feature, refactor, test-only, a11y, docs, migration |
+| `solution-architect` | no | spike, cross-layer Feature |
+| `migration-specialist` | no | Xcode/SPM/iOS upgrades |
+| `api-contract-reviewer` | no | OpenAPI / Swift codegen contracts |
+| `debugger` | minimal | bugfix |
+| `ci-investigator` | minimal CI | ci-fix |
+| `feature-developer` | yes | feature, bugfix, refactor, migration, a11y |
+| `build-verifier` | no | xcodebuild + SwiftLint/Format + unit smoke |
+| `accessibility-reviewer` | no | VoiceOver / Dynamic Type |
+| `performance-auditor` | no | launch / Instruments |
+| `code-reviewer` | no | most pipelines, review-only |
+| `security-reviewer` | no | Keychain, ATS, PII |
+| `qa-tester` | tests | feature, bugfix, test-only |
+| `unit-test-planner` / `generator` / `healer` | tests | unit-only |
+| `xcuitest-test-planner` / `generator` / `healer` | UI tests | e2e-only (XCUITest) |
+| `tech-writer` | docs | docs-only |
+
+**Never use Playwright stems** in this preset — substitute XCUITest trio. Document Playwright skips when copying next templates.
+
+**Cursor frontmatter:** all team agents use `readonly: false` (team writes). Production restrictions live in prompt bodies.
+
+Full prompts: `.cursor/agents/*.md`. Artifacts: `.cursor/team/README.md`.
+
+## Dynamic pipeline
+
+**Source of truth for order:** `pipeline.json` → `steps[]`. Never hardcode analyst → dev → review → QA when `pipeline.json` exists.
+
+## status.json (pipeline mode)
+
+| state | Meaning |
+|-------|---------|
+| `in_progress` | Current step running |
+| `completed` | Current step done; hook advances |
+| `awaiting_approval` | Human gate; wait for `/task-continue` |
+| `changes_requested` | Reviewer blocked; re-run developer |
+| `validation_failed` | build-verifier failed; re-run developer then verifier |
+
+## Rules (strict)
+
+1. **`/task` always starts with task-router** (unless user skips with documented pipeline).
+2. Read `pipeline.json` before every subagent invocation.
+3. One role per Task call — except parallel steps.
+4. **Never** skip `humanGates` without `/task-continue` or explicit approval.
+5. Persist handoffs to disk under `.cursor/team/tasks/<slug>/`.
+6. On `changes_requested`: developer → same reviewer.
+7. On `validation_failed`: developer → build-verifier.
+8. When all steps complete, suggest `/technical-retro <slug>`.
+9. If `autoChain: false`, do not rely on hook.
+
+## Skip pipeline when
+
+- Pure questions; typo / one-file trivial fix; user «без pipeline»; single-line docs-only.
+
+Borderline — **`agent-team-intake.mdc`**.

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,43 @@
+---
+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.
+  - BUGBOT automated review — см. корневой `BUGBOT.md` (Cursor).

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

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

@@ -0,0 +1,26 @@
+---
+description: SPM / модули — public API, access control, запрет deep-import internals
+globs:
+  - "**/Package.swift"
+  - "**/*Public*.swift"
+  - "**/Sources/**/*.swift"
+alwaysApply: false
+---
+
+# 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/cursor/ios-swift/rules/navigation-coordinators.mdc

@@ -0,0 +1,29 @@
+---
+description: NavigationStack, координаторы, deep links — границы Presentation
+globs:
+  - "**/Presentation/**/*Navigator*.swift"
+  - "**/Presentation/**/*Coordinator*.swift"
+  - "**/Presentation/**/*Router*.swift"
+  - "**/App/**/*App*.swift"
+  - "**/*Navigation*.swift"
+alwaysApply: false
+---
+
+# Навигация (iOS)
+
+## Рамка
+
+- **SwiftUI-first:** `NavigationStack` / `navigationDestination` / sheet / fullScreenCover — как в репо.
+- UIKit / coordinator — только если уже принят в модуле; не смешивать два стиля в одном Feature без причины.
+- Маршруты и deep links — **Presentation** (или App shell); Domain не знает о `NavigationPath`.
+
+## Правила
+
+- Один Feature — один явный «вход» навигации (root view / coordinator), не размазывать `NavigationLink` по Data.
+- Параметры экрана — typed (enum route / struct), не «магические» строки без реестра.
+- Deep link → route mapping централизован (App или Navigation hub); ViewModel не парсит URL напрямую.
+- Модалки: владелец presentation state — родительский VM/coordinator, не глобальный singleton без нужды.
+
+## Требование к агенту
+
+Копировать паттерн ближайшего Feature из `reference-features.mdc`. Не тащить networking в навигационный слой.

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 (транспорт).
+- Локальное хранение / Keychain — **`persistence-data.mdc`**, не смешивать с HTTP-клиентом без фасада-репозитория.
+- Наружу (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/persistence-data.mdc

@@ -0,0 +1,31 @@
+---
+description: Persistence — SwiftData / Core Data / файлы / Keychain (не HTTP)
+globs:
+  - "**/Persistence/**/*.swift"
+  - "**/Keychain/**/*.swift"
+  - "**/*Storage*.swift"
+  - "**/*Cache*.swift"
+  - "**/*SwiftData*.swift"
+alwaysApply: false
+---
+
+# Persistence (Data)
+
+Отделить от HTTP (`networking-services.mdc`): здесь локальное хранение и секреты на диске/Keychain.
+
+## Рамка
+
+- Выбор стека (**SwiftData / Core Data / UserDefaults / files**) — **как в репо**; не внедрять второй persistence-стек без задачи.
+- Public API — протоколы в Domain (`…Repository` / `…Store`); реализации в Data.
+- **Keychain** — только для credentials/токенов; не класть PII «для удобства» в UserDefaults.
+
+## Правила
+
+- DTO/Entity persistence ≠ network DTO; маппинг явный.
+- Миграции схемы — по принятому в репо процессу; не ломать silently.
+- `@MainActor` на store — только если UI-facing; тяжёлый I/O — off-main + hop обратно.
+- Ошибки — typed; не глотать `try?` на критичном persist.
+
+## Требование к агенту
+
+Не смешивать URLSession и persistence в одном типе без фасада-репозитория. Тесты — in-memory / fake store.