@bonesofspring/ai-rules 0.2.14 → 0.2.15

package/presets/claude/ios-swift/commands/technical-retro.md

@@ -3,59 +3,82 @@ name: technical-retro
 description: Facilitate a technical retrospective for a period, incident, release, or completed agent-team task slug.
 ---
 
-# Техническое ретро — роль агента
+# Technical retro
 
-Агент выступает как **нейтральный фасилитатор технической ретроспективы**, а не как ревьюер кода или оценщик людей. Цель — вынести уроки, согласовать действия и улучшить процесс разработки. Используй skill **`technical-retro`** как основной сценарий.
+Act as a **neutral technical retrospective facilitator**, not a code reviewer or people evaluator. Use skill **`technical-retro`** as the primary playbook.
 
-## Когда включать
+## When to run
 
-- Пользователь просит: «ретро», «техническое ретро», «разбор спринта/итерации», «что пошло хорошо / плохо», «action items после релиза».
-- Есть контекст: период (спринт, квартал), тема (релиз, инцидент, миграция), или приложены заметки/линки.
+- User asks for: “retro”, “technical retro”, “sprint/iteration review”, “action items after release”.
+- After an agent-team pipeline completes (`/feature-start` → `/feature-continue`).
+- Context exists: period, topic (release, incident), task slug, notes.
 
-## Входные данные (запросить при нехватке)
+## Inputs (collect, do not invent)
 
-- **Период и фокус** (например: две недели, релиз X, постмортем).
-- **Участники/роли** (если важно для формулировок): только разработка или весь кросс‑функциональный поток.
-- **Ограничения**: время (15 / 30 / 60 мин), формат (async в чате vs синхронная повестка).
-- По желанию: список deliverables, метрики, ссылки на тикеты/MR — **без выдумывания** фактов, которых нет в сообщении или репозитории.
+Ask when missing:
 
-Если контекста мало — задать **1–3 коротких уточняющих вопроса**, затем продолжить с явными допущениями в шапке вывода.
+- **Period and focus**.
+- **Task slug** (if the retro covers agent-team work).
+- **Participants/roles** (when relevant).
+- **Constraints**: time, format (async vs sync).
 
-## Принципы фасилитации
+### Agent-team artifacts (when there is a slug)
 
-- **Безопасность и нейтральность**: формулировки про процесс и систему, не про «виноватых»; избегать ярлыков к людям.
-- **Конкретика**: от абстрактного «надо лучше общаться» — к наблюдаемым событиям и договорённостям.
-- **Баланс**: зафиксировать и позитив (что усилить), и зоны роста.
-- **Один владелец и срок** у каждого action item; избегать списка «сделает команда» без имени/роли.
-- **Не смешивать с code review**: ретро не заменяет построчный разбор диффа; при запросе «и ретро, и ревью» — развести два блока в ответе.
+Read from the repository:
 
-## Рекомендуемая структура сессии (по умолчанию)
+- `.claude/team/tasks/<slug>/pipeline.json`
+- `.claude/team/tasks/<slug>/brief.md`
+- `.claude/team/tasks/<slug>/decomposition.md`
+- `.claude/team/tasks/<slug>/status.json`
+- Git diff / `git status` for changed files
 
-Подстроить под указанное время. Для короткого async‑формата — сжать до шагов 2–4.
+Do not attribute facts that are not in artifacts, the diff, or the user message.
 
-1. **Цель и рамки** (1–2 предложения): зачем встреча, что в фокусе / что вне скоупа.
-2. **Сбор фактов** (молча в чате — списком от пользователя; агент структурирует):
-   - что шло хорошо,
-   - что мешало / вызывало риски,
-   - сюрпризы (технический долг, узкие места, зависимости).
-3. **Группировка тем**: объединить дубли, выделить 3–7 тем для обсуждения (приоритет — влияние × изменяемость).
-4. **Корневые причины (легко)**: для 1–2 самых болезненных тем — кратко «5 почему» или «что в процессе/артефактах позволило этому случиться», без морализаторства.
-5. **Эксперименты на следующий цикл**: не больше 1–3 изменений процесса/инструментов; каждое — измеримое или с явным критерием «успех/не успех».
-6. **Action items**: таблица или список с **что / владелец / до когда / как поймём, что сработало**.
+## Facilitation principles
 
-## Формат ответа агента
+- **Safety**: process and system, not “blame”.
+- **Specifics**: from abstractions to observable events.
+- **Balance**: positives and growth areas.
+- **Action items**: owner and due date for each.
+- **Do not mix with code review** — keep blocks separate if both are requested.
 
-- Краткая **шапка**: период, фокус, допущения (если были).
-- **Повестка** или итог по этапам выше.
-- **Темы** — буллеты; по спорным местам — **вопросы команде**, а не окончательные выводы без данных.
-- **Решения и эксперименты** отдельным блоком.
-- **Action items** — в конце, каждый пункт с владельцем и дедлайном (или пометка «нужно назначить на встрече»).
+## Default session structure
 
-## Ограничения
+1. **Goal and frame**.
+2. **Gather facts**: went well / got in the way / surprises.
+3. **Theme clustering** (3–7).
+4. **Root causes** for 1–2 painful themes.
+5. **Experiments** (1–3 process changes).
+6. **Action items**: what / owner / by when / success criterion.
 
-- Не приписывать команде цитаты или факты, которых не было во входе.
-- Не выдавать юридические/HR‑рекомендации; при явных конфликтах или токсичности — мягко предложить эскалацию человеку, ответственному за команду, без детализации «наказаний».
-- Если пользователь просит только шаблон — выдать **шаблон повестки и доски** (колонки, таймбоксы) без выдуманного контента.
+## “Agent work” block (required when there is a slug)
+
+If the retro relates to a `/feature-start` pipeline:
+
+| Question | What to capture |
+|----------|-----------------|
+| Router | Wrong intent, extra/missing steps in pipeline |
+| Analyst | Bad assumptions, missed AC, extra/missing tasks |
+| Decomposition | Incomplete layer coverage, wrong order, blocked dependencies |
+| Developer | Scope creep, missed rules, lint/type gaps |
+| Reviewer | Missed defects, false positives, checklist quality |
+| QA | AC coverage by tests, flakiness, gaps in e2e plans |
+
+**Action items** in this block — improve **prompts, subagents, and rules** (not only code).
+
+## Response format
+
+- Header: period, focus, slug (if any), assumptions.
+- Agenda by stages.
+- **“Agent work”** block (when applicable).
+- Themes — bullets; disputed items — **questions for the team**.
+- **Action items** at the end.
+
+## Constraints
+
+- Do not invent quotes and facts without input.
+- Do not give HR recommendations.
+- If only a template is requested — **agenda template** without invented content.
 
 ### Metrics evidence
 

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

@@ -1,6 +1,6 @@
 # `.claude/rules` (preset ios-swift)
 
-В Claude Code все `.md` под `rules/` **обнаруживаются рекурсивно**. Тела **derived** из Cursor SoT; индексы — не второй SoT.
+In Claude Code all `.md` files under `rules/` are **discovered recursively**. Bodies are **derived** from Cursor SoT; indexes are not a second SoT.
 
 ## SoT sync
 
@@ -13,9 +13,9 @@
 
 ## Loading budget
 
-- **Session-start (no `paths:`):** ровно **3** — `ios-app-core`, `boundaries`, `code-quality` (≤140 body lines total)
-- **Все остальные** — с `paths:` (commands/team/agents и/или Feature/Swift globs)
-- **Soft twin depth:** domain rules ≥15 body lines; thin aliases (`agent-team-intake`, `technical-retro`) могут быть короче (как next)
+- **Session-start (no `paths:`):** exactly **3** — `ios-app-core`, `boundaries`, `code-quality` (≤140 body lines total)
+- **Everything else** — with `paths:` (commands/team/agents and/or Feature/Swift globs)
+- **Soft twin depth:** domain rules ≥15 body lines; thin aliases (`agent-team-intake`, `technical-retro`) may be shorter (as in next)
 
 ## Cursor → Claude mapping
 
@@ -69,10 +69,10 @@ Shared taxonomy: `presets/_shared/README.md`. Sync marker: `<!-- shared-core:
 
 ## Folders
 
-| Папка | О чём |
+| Folder | About |
 |-------|--------|
-| `stack/` | Стек, Swift conventions |
-| `architecture/` | Границы, feature-delivery, reference-features, SPM public API |
+| `stack/` | Stack, Swift conventions |
+| `architecture/` | Boundaries, feature-delivery, reference-features, SPM public API |
 | `api-and-data/` | Networking, persistence |
 | `testing/` | XCTest, XCUITest |
 | `ui-and-accessibility/` | SwiftUI, ViewModels, navigation |

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

@@ -1,6 +1,6 @@
 # API and data
 
-Сетевой слой, persistence, DTO, mappers. Index only — тела в topic `.md`.
+Networking layer, persistence, DTOs, mappers. Index only — bodies live in topic `.md` files.
 
 | File | Cursor SoT |
 |------|------------|

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

@@ -1,49 +1,49 @@
 ---
-description: Конвенции сетевого слоя, API-клиентов и mappers
+description: Networking layer, API clients, and mapper conventions
 paths:
   - "**/{Data,Network,Networking}/**/*.swift"
 ---
 
-# Роль 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.md`**, не смешивать с HTTP-клиентом без фасада-репозитория.
-- Наружу (Domain, ViewModel через repository) отдавать **доменные типы**, не DTO.
+  - Codable DTOs (transport).
+- Local storage / Keychain — **`api-and-data/persistence.md`**; 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/claude/ios-swift/rules/api-and-data/persistence.md

@@ -1,5 +1,5 @@
 ---
-description: Persistence — SwiftData / Core Data / файлы / Keychain (не HTTP)
+description: Persistence — SwiftData / Core Data / files / Keychain (not HTTP)
 paths:
   - "**/Persistence/**/*.swift"
   - "**/Keychain/**/*.swift"
@@ -10,21 +10,21 @@ paths:
 
 # Persistence (Data)
 
-Отделить от HTTP (`api-and-data/networking.md`): здесь локальное хранение и секреты на диске/Keychain.
+Separate from HTTP (`api-and-data/networking.md`): 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/claude/ios-swift/rules/architecture/README.md

@@ -1,6 +1,6 @@
 # Architecture
 
-Границы слоёв, DI, доставка фичи, SPM public API. Index only — тела в topic `.md`.
+Layer boundaries, DI, feature delivery, SPM public API. Index only — bodies live in topic `.md` files.
 
 | File | Cursor SoT |
 |------|------------|

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

@@ -1,33 +1,33 @@
 ---
-description: Архитектурные границы и правила зависимостей iOS приложения
+description: Architectural boundaries and dependency rules for an iOS app
 ---
 
-# Границы между слоями
+# Layer boundaries
 
 - **Presentation** (Views, ViewModels, DesignSystem):
-  - Может: Domain (entities, use case protocols), DesignSystem, Core (без UI).
-  - Не должен: импортировать Data (репозитории, DTO, API-клиенты); знать HTTP/Codable/эндпоинты; маппить DTO → domain.
+  - May: Domain (entities, use case protocols), DesignSystem, Core (non-UI).
+  - Must not: import Data (repositories, DTOs, API clients); know HTTP/Codable/endpoints; map DTO → domain.
 - **Domain**:
-  - Может: Core (базовые типы, протоколы).
-  - Не должен: импортировать SwiftUI, UIKit, сеть; знать конкретные реализации репозиториев.
+  - May: Core (base types, protocols).
+  - Must not: import SwiftUI, UIKit, networking; know concrete repository implementations.
 - **Data**:
-  - Может: Domain (протоколы, entities), Core.
-  - Не должен: импортировать SwiftUI/UIKit; зависеть от View/ViewModel.
+  - May: Domain (protocols, entities), Core.
+  - Must not: import SwiftUI/UIKit; depend on View/ViewModel.
 
-# Зависимости и модули
+# Dependencies and modules
 
-- Направление: **Presentation → Domain ← Data**.
-- Переиспользуемое — в Core / DesignSystem; к другой фиче — только **public API** (протокол, facade, coordinator), не deep-import.
-- SPM: Domain не линкуется с Data; реализации Data подключаются через DI в `App/`.
-- Раскладка фичи — как в `stack/ios-app-core.md` / соседних `Features/*` репо (Presentation / Domain / Data + тесты).
+- Direction: **Presentation → Domain ← Data**.
+- Shared code — in Core / DesignSystem; to another feature — only **public API** (protocol, facade, coordinator), not deep-import.
+- SPM: Domain does not link Data; Data implementations are wired via DI in `App/`.
+- Feature layout — as in `stack/ios-app-core.md` / neighboring `Features/*` in the repo (Presentation / Domain / Data + tests).
 
-# DI и composition root
+# DI and composition root
 
-- Сборка графа — в `App/` (или `DI/` / CompositionRoot), не во View.
-- ViewModel получает **протоколы** (use case / repository), не конкретные Data-типы.
-- Preview и тесты — mock/stub реализаций.
+- Graph assembly — in `App/` (or `DI/` / CompositionRoot), not in the View.
+- ViewModel receives **protocols** (use case / repository), not concrete Data types.
+- Previews and tests — mock/stub implementations.
 
-# Требование к агенту
+# Agent requirement
 
-- Файлы — в соответствующих слоях; протоколы репозиториев в Domain, реализации в Data.
-- Не «коротить» слои (API из View «ради скорости»).
+- Place files in the matching layers; repository protocols in Domain, implementations in Data.
+- Do not “short-circuit” layers (API from a View “for speed”).

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

@@ -1,5 +1,5 @@
 ---
-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.
 paths:
   - .claude/commands/**/*
   - .claude/team/**/*
@@ -12,21 +12,22 @@ paths:
 
 <!-- shared-core: architecture/feature-delivery-workflow.md -->
 
+# Feature delivery (iOS)
 
-# Доставка фичи (iOS)
+## Stack notes
 
-Типичная фича с данными и UI. Детали слоёв — `architecture/boundaries.md`, `stack/ios-app-core.md`.
+Typical feature with data and UI. Layer details — `architecture/boundaries.md`, `stack/ios-app-core.md`.
 
-## Чеклист (порядок работ)
+## Checklist (work order)
 
-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 по конфигу репо.
+1. **Domain** — entities, value types, repository / use case protocols (`Features/**/Domain/**`).
+2. **Data** — DTOs (`Codable`), Domain ↔ DTO mappers, repository implementations, API client (`api-and-data/networking.md`).
+3. **ViewModel** — state, use case / protocol calls; DI from App; no DTOs or URLs (`ui-and-accessibility/viewmodels.md`).
+4. **View / navigation** — thin SwiftUI Views, Design System; navigation as in the repo (`ui-and-accessibility/swiftui.md`).
+5. **Tests** — unit for mappers / use cases / VM (`testing/unit.md`); UI flows — XCUITest (`testing/ui.md`).
+6. **Completion** — **invoke** `tooling-and-review/post-change-build.md` (+ `tooling-and-review/xcode-tooling.md` for schemes/commands): build touched targets + lint/format per repo config.
 
-## Поток данных (ориентир)
+## Data flow (orientation)
 
 ```mermaid
 flowchart LR
@@ -38,36 +39,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.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` |
+| `**/*.swift` (style) | `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`) |
+| After Swift edits | `tooling-and-review/post-change-build.md` |
 
-При добавлении или расширении фичи **пройти чеклист** и правила из таблицы для затронутых зон.
+When adding or extending a feature, **walk the checklist** and the table rules for touched zones.

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

@@ -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
 paths:
   - "**/Package.swift"
   - "**/*Public*.swift"
@@ -8,18 +8,18 @@ paths:
 
 # 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/claude/ios-swift/rules/architecture/reference-features.md

@@ -1,5 +1,5 @@
 ---
-description: Эталонные Feature-модули репозитория — копировать структуру при реализации. Заполните пути после init в целевом iOS-репо.
+description: Reference Feature modules of the repository — copy structure when implementing. Fill in paths after init in the target iOS repo.
 paths:
   - Features/**/*
   - "**/Presentation/**/*"
@@ -10,50 +10,53 @@ paths:
 
 <!-- shared-core: architecture/reference-features.template.md -->
 
+# Reference features
 
-# Эталонные фичи (reference features)
+## Stack notes
 
-Перед реализацией найди Feature того же типа и **повтори её структуру**, не изобретая новую организацию файлов.
+Before implementing, find a Feature of the same type and **mirror its structure**; do not invent a new file organization.
 
 Taxonomy / shared core: [`presets/_shared/README.md`](../../../../_shared/README.md) · [Preset contribution guide](../../../../docs/PRESET-CONTRIBUTION.md).
 
-## Таблица эталонов
+## Reference table
 
-После `ai-rules init` замени примеры на **реальные** пути consumer-репо. Ниже — conventional placeholders для greenfield / dogfood.
+After `ai-rules init`, replace examples with **real** consumer-repo paths. Below — conventional placeholders for greenfield / dogfood.
 
-| Слой | Эталон (пример → заменить) | Conventional glob / path |
+| Layer | Reference (example → replace) | 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` |
+| Unit tests | `Features/OrdersTests/` or colocated `*Tests` | `**/*Tests/**/*.swift` |
 | UI tests | `OrdersUITests/` | `**/*UITests/**/*.swift` |
 
-Если в репо другая раскладка (`Modules/`, `Sources/`) — перепиши таблицу один раз и держи её SoT для агентов.
+If the repo uses another layout (`Modules/`, `Sources/`) — rewrite the table once and keep it as SoT for agents.
 
-## Как использовать
+## How to use
 
-1. Определи затронутые слои из `decomposition.md` или задачи.
-2. Открой эталон из таблицы (после заполнения путей).
-3. Зеркаль именование, порядок файлов, DI, паттерны тестов.
-4. Если эталона нет — выбери **самую близкую** существующую фичу того же слоя и зафиксируй выбор в handoff.
+1. Identify affected layers from `decomposition.md` or the task.
+2. Open the reference from the table (after paths are filled).
+3. Mirror naming, file order, DI, and test patterns.
+4. If there is no reference — pick the **closest** existing feature of the same layer and record the choice in the handoff.
 
-## Dogfood checklist (5 сценариев)
+## Dogfood checklist (5 scenarios)
 
-1. `/task` новая фича в `Features/<Name>` — analyst → developer → build-verifier (xcodebuild).
-2. Баг в ViewModel — debugger → fix → unit test.
-3. Mapper DTO↔domain — unit-test-planner/generator.
+Run after preset init (manual smoke for agents):
+
+1. `/task` new feature under `Features/<Name>` — analyst → developer → build-verifier (xcodebuild).
+2. ViewModel bug — debugger → fix → unit test.
+3. DTO↔domain mapper — unit-test-planner/generator.
 4. UI flow — `xcuitest-test-planner` → generator (accessibilityIdentifier).
-5. Auth/Keychain touch — security-reviewer + `security-ios`.
+5. Auth/Keychain touch — security-reviewer + `tooling-and-review/security-ios.md`.
 
 ## Living conventions
 
 Post-init gotchas / patterns / decisions: **`.claude/team/conventions.md`** (and the twin tool path if both Cursor and Claude are installed). Consumer-owned; not always-on. See root `AGENTS.md` § Living conventions.
 
-## Связанные правила
+## Related rules
 
-- `tooling-and-review/code-quality.md` — повторять паттерны.
-- `architecture/feature-delivery.md` — порядок слоёв.
-- skill `feature-delivery` — end-to-end сценарий.
+- `tooling-and-review/code-quality.md` — repeat patterns.
+- `architecture/feature-delivery.md` — layer order.
+- skill `feature-delivery` — end-to-end scenario.

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

@@ -1,6 +1,6 @@
 # Stack
 
-Язык, платформа и базовый каркас приложения. Index only — тела в topic `.md`.
+Language, platform, and app scaffold. Index only — bodies live in topic `.md` files.
 
 | File | Cursor SoT |
 |------|------------|