@bonesofspring/ai-rules 0.2.14 → 0.2.16

package/presets/cursor/next/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/next/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/next/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
 

package/presets/cursor/next/rules/preset-twin-sync.mdc

@@ -9,7 +9,6 @@ alwaysApply: false
 
 <!-- shared-core: meta/preset-twin-sync.md -->
 
-
 # Preset twin sync
 
 Cursor `.mdc` — **SoT per stack**. Claude topic `.md` — derived twin.
@@ -27,6 +26,7 @@ Cursor `.mdc` — **SoT per stack**. Claude topic `.md` — derived twin.
 | `mcp-ts` | `presets/cursor/mcp-ts/rules/*.mdc` | `presets/claude/mcp-ts/rules/<topic>/` | Keep in `claude/mcp-ts/rules/README.md` |
 | `php-hexagonal` | `presets/cursor/php-hexagonal/rules/*.mdc` | `presets/claude/php-hexagonal/rules/<topic>/` | Keep in `claude/php-hexagonal/rules/README.md` |
 | `php-laravel` | `presets/cursor/php-laravel/rules/*.mdc` | `presets/claude/php-laravel/rules/<topic>/` | Keep in `claude/php-laravel/rules/README.md` |
+| `android-kotlin` | `presets/cursor/android-kotlin/rules/*.mdc` | `presets/claude/android-kotlin/rules/<topic>/` | Keep in `claude/android-kotlin/rules/README.md` |
 
 ## Same-PR checklist
 
@@ -51,5 +51,6 @@ Cursor `.mdc` — **SoT per stack**. Claude topic `.md` — derived twin.
 - **mcp-ts:** missing Claude twin for a changed Cursor rule → **FAIL** (same as next / ios-swift / go / java; mapping table required).
 - **php-hexagonal:** missing Claude twin for a changed Cursor rule → **FAIL** (same as next / ios-swift / go / java / mcp-ts; mapping table required).
 - **php-laravel:** missing Claude twin for a changed Cursor rule → **FAIL** (same as next / ios-swift / go / java / mcp-ts / php-hexagonal; mapping table required).
+- **android-kotlin:** missing Claude twin for a changed Cursor rule → **FAIL** (same as next / ios-swift / go / java / mcp-ts / php-*; mapping table required).
 
 Dogfood: sync packages → root `.cursor/` after Cursor SoT changes (not the reverse). Use `packages/ai-rules/scripts/sync-dogfood-cursor.sh`.

package/presets/cursor/next/rules/public-imports.mdc

@@ -1,5 +1,5 @@
 ---
-description: Импорт доменных типов и API только через публичные barrel @/types и @/api
+description: Import domain types and API only through public barrels @/types and @/api
 globs:
   - app/src/ui/**/*
   - app/src/store/**/*
@@ -10,16 +10,16 @@ alwaysApply: false
 impact: HIGH
 ---
 
-# Публичные импорты (`@/types`, `@/api`)
+# Public imports (`@/types`, `@/api`)
 
-**Коллизии:** импорт типов — раздел `@/types` ниже; API вне `app/src/api/**` — раздел `@/api` ниже (дублирует ESLint `no-restricted-imports` в `app/eslint.config.mjs`).
+**Collisions:** type imports — `@/types` section below; API outside `app/src/api/**` — `@/api` section below (mirrors ESLint `no-restricted-imports` in `app/eslint.config.mjs`).
 
 ## `@/types`
 
-- **Публичный API типов** — barrel `app/src/types/index.ts`; импортировать типы только как `@/types` (или `@/types/index`).
-- **Запрещено** обходить barrel: `@/types/<что‑угодно>`, кроме enum.
-- **Enum** — только `@/types/enums` / `@/types/enums.ts`.
-- Внутри `app/src/types/**` — относительные импорты между файлами слоя.
+- **Public types API** — barrel `app/src/types/index.ts`; import types only as `@/types` (or `@/types/index`).
+- **Forbidden** to bypass the barrel: `@/types/<anything>`, except enums.
+- **Enums** — only `@/types/enums` / `@/types/enums.ts`.
+- Inside `app/src/types/**` — relative imports between layer files.
 
 ```typescript
 // ✅
@@ -30,23 +30,23 @@ import { SomeEnum } from '@/types/enums'
 import type { TUserProfile } from '@/types/User.types'
 ```
 
-Новые публичные типы — реэкспорт в `app/src/types/index.ts` по **`layer-barrel-exports.mdc`**.
+New public types — re-export in `app/src/types/index.ts` per **`layer-barrel-exports.mdc`**.
 
 ## `@/api`
 
-- **Публичный API** — barrel `app/src/api/index.ts`. Вне `app/src/api/**` — только `import … from '@/api'` (или `@/api/index`).
-- **Запрещено** снаружи слоя: `@/api/<что‑угодно>`, кроме `@/api/index`.
-- Внутри `app/src/api/**` — относительные импорты и `@/api/services/**`, `@/api/clients/**`.
+- **Public API** — barrel `app/src/api/index.ts`. Outside `app/src/api/**` — only `import … from '@/api'` (or `@/api/index`).
+- **Forbidden** from outside the layer: `@/api/<anything>`, except `@/api/index`.
+- Inside `app/src/api/**` — relative imports and `@/api/services/**`, `@/api/clients/**`.
 
 ```typescript
-// ✅ в store, UI, lib вне app/src/api
+// ✅ in store, UI, lib outside app/src/api
 import { MedcardApiService } from '@/api'
 
-// ❌ снаружи app/src/api
+// ❌ outside app/src/api
 import { MedcardApiService } from '@/api/services/MedcardApiService/MedcardApiService'
 ```
 
-Новые публичные символы API — реэкспорт в `app/src/api/index.ts` по **`layer-barrel-exports.mdc`**.
+New public API symbols — re-export in `app/src/api/index.ts` per **`layer-barrel-exports.mdc`**.
 ## Incorrect
 
 ```ts

package/presets/cursor/next/rules/react-a11y-coding.mdc

@@ -1,37 +1,37 @@
 ---
-description: Accessibility при написании React UI — семантика, формы, focus, keyboard
+description: Accessibility when writing React UI — semantics, forms, focus, keyboard
 globs: app/src/ui/**/*.tsx,app/src/ui/**/*.ts
 alwaysApply: false
 ---
 
-# A11y при разработке UI
+# A11y when developing UI
 
-Reviewer (`accessibility-reviewer`) проверяет diff; эти правила — **при написании** кода.
+The reviewer (`accessibility-reviewer`) checks the diff; these rules apply **while writing** code.
 
-## Семантика и ARIA
+## Semantics and ARIA
 
-- Предпочитать **нативные элементы** (`button`, `a`, `label`, `input`) вместо `div` с `onClick`.
-- **`role` / `aria-*`** — только когда нативного аналога нет; не дублировать то, что даёт семантика.
-- Заголовки — иераархия `h1`–`h6` без пропусков уровней ради стилей.
+- Prefer **native elements** (`button`, `a`, `label`, `input`) over `div` with `onClick`.
+- **`role` / `aria-*`** — only when there is no native equivalent; do not duplicate what semantics already provide.
+- Headings — `h1`–`h6` hierarchy without skipping levels for styling.
 
-## Формы
+## Forms
 
-- Каждый input связан с **`label`** (`htmlFor` / `id` или обёртка).
-- Сообщения об ошибках — **`aria-describedby`**, `aria-invalid` при validation errors.
-- Кнопки submit vs button — явный `type`.
+- Every input is associated with a **`label`** (`htmlFor` / `id` or wrapper).
+- Error messages — **`aria-describedby`**, `aria-invalid` on validation errors.
+- Submit vs button — explicit `type`.
 
-## Клавиатура и focus
+## Keyboard and focus
 
-- Все интерактивные элементы **достижимы с Tab** и активируются Enter/Space где ожидается.
-- **Modals/drawers** — focus trap, возврат focus на trigger при закрытии, Esc закрывает (если по UX).
-- Не удалять видимый **focus outline** без замены на доступный custom focus style.
+- All interactive elements are **reachable via Tab** and activatable with Enter/Space where expected.
+- **Modals/drawers** — focus trap, return focus to trigger on close, Esc closes (if UX allows).
+- Do not remove visible **focus outline** without an accessible custom focus style.
 
-## Контент
+## Content
 
-- Изображения — **`alt`** (пустой `alt` только для декора).
-- Иконки-кнопки — **`aria-label`** или visually hidden text.
-- Динамические обновления — `aria-live` для критичных status/error (умеренно).
+- Images — **`alt`** (empty `alt` only for decorative images).
+- Icon buttons — **`aria-label`** or visually hidden text.
+- Dynamic updates — `aria-live` for critical status/error (use sparingly).
 
-## Проверка
+## Verification
 
-- При сомнении — devtools a11y tree или `accessibility-reviewer` в pipeline для UI-heavy фич.
+- When unsure — devtools a11y tree or `accessibility-reviewer` in the pipeline for UI-heavy features.

package/presets/cursor/next/rules/react-ui.mdc

@@ -1,95 +1,95 @@
 ---
-description: Паттерны React/Next UI и стилей (preset)
+description: React/Next UI and styling patterns (preset)
 globs: app/src/ui/**/*.tsx,app/src/ui/**/*.ts
 alwaysApply: false
 impact: HIGH
 ---
 
-# Общие правила компонентов
+# General component rules
 
-- Использовать **функциональные компоненты** с хуками, без классов.
-- Компонент должен:
-  - быть максимально "тонким" по бизнес‑логике;
-  - делегировать состояние в store/хуки, если оно нужно в нескольких местах;
-  - опираться на **общие UI‑примитивы дизайна проекта** (пакеты или локальная библиотека компонентов), если они есть.
-- Перед новым кастомным контролом — поискать готовый или близкий компонент в репозитории / пакетах UI проекта и переиспользовать или расширить его.
-- Для повторяемой логики создавать `useSomething`‑хуки рядом или в `src/ui/hooks/**`.
- - При обращении к store, API, общим хелперам и утилитам компоненты и хуки должны использовать только их **public API** (например, `@/store`, `@/store/slices/Foo`, `@/lib/utils`), а не импортировать внутренние файлы реализации других модулей.
+- Use **functional components** with hooks, no classes.
+- A component should:
+  - stay as "thin" as possible on business logic;
+  - delegate state to store/hooks when needed in multiple places;
+  - rely on **shared project UI design primitives** (packages or local component library), if present.
+- Before a new custom control — search for an existing or close component in the repository / project UI packages and reuse or extend it.
+- For repeated logic, create `useSomething` hooks nearby or in `src/ui/hooks/**`.
+ - When accessing store, API, shared helpers, and utilities, components and hooks must use only their **public API** (for example, `@/store`, `@/store/slices/Foo`, `@/lib/utils`), not internal implementation files of other modules.
 
-# Структура файлов
+# File structure
 
-Для страницы/крупного блока:
-- `FeatureBlock.tsx` — JSX и композиция.
-- `styles.ts` или соседний модуль стилей — по конвенции репозитория (CSS Modules, CSS-in-JS, и т.д.).
-- `index.ts` — реэкспорт (если нужно наружу).
+For a page/large block:
+- `FeatureBlock.tsx` — JSX and composition.
+- `styles.ts` or adjacent style module — per repository convention (CSS Modules, CSS-in-JS, etc.).
+- `index.ts` — re-export (if needed externally).
 
-## Дочерние компоненты (`./components`)
+## Child components (`./components`)
 
-- Локальные подкомпоненты, используемые только этим блоком, выносятся в **`./components/<ComponentName>/`** относительно папки родительского компонента (не оставлять крупные куски JSX и «внутренние» компоненты в том же файле, что и родитель).
-- У каждого такого подкомпонента — **своя** папка с тем же именем, что и публичное имя компонента:
-  - `ComponentName.tsx` — разметка и композиция;
-  - `styles.ts` — только стили этого подкомпонента (не тянуть `styles` соседних компонентов — см. § Стили ниже);
-  - при необходимости — `ComponentName.data.ts`, `ComponentName.utils.ts`, `ComponentName.hooks.ts` по тем же правилам префикса, что и у родителя;
-  - опционально `index.ts` с реэкспортом.
-- Родитель импортирует подкомпонент из `./components/...`, а не держит его реализацию inline.
+- Local subcomponents used only by this block go in **`./components/<ComponentName>/`** relative to the parent component folder (do not leave large JSX chunks and "internal" components in the same file as the parent).
+- Each subcomponent has **its own** folder with the same name as the public component:
+  - `ComponentName.tsx` — markup and composition;
+  - `styles.ts` — styles for this subcomponent only (do not import `styles` from sibling components — see Styles below);
+  - when needed — `ComponentName.data.ts`, `ComponentName.utils.ts`, `ComponentName.hooks.ts` with the same prefix rules as the parent;
+  - optional `index.ts` re-export.
+- The parent imports subcomponents from `./components/...`, not inline implementations.
 
-Для переиспользуемого компонента:
-- Папка с именем компонента:
+For a reusable component:
+- Folder named after the component:
   - `ComponentName.tsx`
-  - файлы стилей по принятой схеме;
-  - опционально: `types.ts`, `ComponentName.hooks.ts` (см. ниже про префикс).
+  - style files per project scheme;
+  - optional: `types.ts`, `ComponentName.hooks.ts` (see prefix rules below).
 
-## Вспомогательные модули рядом с компонентом (именование)
+## Adjacent helper modules (naming)
 
-**Префикс имени файла = публичное имя компонента** (как у `ComponentName.tsx` в этой папке), в **PascalCase**. Не вводить отдельные «говорящие» имена файлов по смыслу содержимого (`analysisPreparationIconMap.ts`, `buildAnalysisIdToNameMap.ts` и т.п.) — так теряется связь с компонентом и плодятся одноразовые названия.
+**File name prefix = public component name** (as in `ComponentName.tsx` in that folder), in **PascalCase**. Do not introduce separate "descriptive" file names by content meaning (`analysisPreparationIconMap.ts`, `buildAnalysisIdToNameMap.ts`, etc.) — that breaks the link to the component and creates one-off names.
 
-**Суффикс по роли:**
+**Role suffix:**
 
-| Суффикс | Назначение | Примеры содержимого |
-|--------|------------|---------------------|
-| `ComponentName.data.ts` | Статические данные и конфигурация для UI | мапы `id → иконка/лейбл`, константы списков, таблицы соответствий для отображения |
-| `ComponentName.utils.ts` | Чистые функции без React | форматирование, предобработка пропсов/данных для рендера, `build…`/`map…`‑хелперы |
-| `ComponentName.hooks.ts` | Хуки, используемые только этим блоком | локальные `use…` (если не вынесены в `src/ui/hooks/**`) |
+| Suffix | Purpose | Content examples |
+|--------|---------|------------------|
+| `ComponentName.data.ts` | Static data and UI configuration | `id → icon/label` maps, list constants, display lookup tables |
+| `ComponentName.utils.ts` | Pure non-React functions | formatting, prop/data preprocessing for render, `build…`/`map…` helpers |
+| `ComponentName.hooks.ts` | Hooks used only by this block | local `use…` (if not moved to `src/ui/hooks/**`) |
 
-- Несколько констант/мапов или несколько функций — **по-прежнему один** `.data.ts` и один `.utils.ts`, не дробить по «темам» отдельными файлами без веской причины (размер, разные зоны ответственности на уровне подкомпонентов).
-- Если логика принадлежит **подкомпоненту** в подпапке (`components/Child/Child.tsx`), те же правила применяются к **`Child.data.ts`**, **`Child.utils.ts`** относительно этого подкомпонента.
-- Тесты для утилит и данных — рядом в `__tests__/` или с суффиксом `.test.ts`, согласно `tests-unit.mdc`, с тем же префиксом (`RequestForAnalysisRecommendations.utils.test.ts` и т.д.).
+- Multiple constants/maps or multiple functions — still **one** `.data.ts` and one `.utils.ts`; do not split by "topic" into separate files without good reason (size, different responsibility at subcomponent level).
+- If logic belongs to a **subcomponent** in a subfolder (`components/Child/Child.tsx`), the same rules apply to **`Child.data.ts`**, **`Child.utils.ts`** for that subcomponent.
+- Tests for utilities and data — nearby in `__tests__/` or with `.test.ts` suffix per `tests-unit.mdc`, same prefix (`RequestForAnalysisRecommendations.utils.test.ts`, etc.).
 
-# Стили и дизайн‑токены
+# Styles and design tokens
 
-- **Корневой** styled в соседнем `styles` — экспорт **`Root`**; в JSX: `<s.Root>` при `import * as s from './styles'`. Вложенные — `Title`, `List` и т.д. Не `Container`/`Wrapper` для единственной обёртки.
-- **Запрещено** импортировать `styles` другого компонента (`../Other/styles`, `../../styles`). Разрешено: `./styles`, общие примитивы из `@/ui/components/...` или пакетов дизайн-системы.
-- Порядок CSS / `styled` — Stylelint idiomatic-order: `css-property-order-stylelint.mdc` (грузится на `styles.ts` / `.css`).
-- Для визуала использовать **тот стек стилей и токенов, который уже в проекте** (переменные, тема, общие классы, дизайн‑пакет).
-- Избегать:
-  - inline‑стилей, кроме простых случаев;
-  - дублирования оформления, уже закрытого общими примитивами;
-  - «магических» литералов (`#xxxxxx`, произвольные `17px` / `23px`), если в проекте есть токены или масштаб.
-- Если подходящего токена нет — локальный примитив **в одном месте** с последующим выравниванием под систему дизайна при возможности.
+- **Root** styled export in adjacent `styles` — **`Root`**; in JSX: `<s.Root>` with `import * as s from './styles'`. Nested — `Title`, `List`, etc. Not `Container`/`Wrapper` for a single wrapper.
+- **Forbidden** to import another component's `styles` (`../Other/styles`, `../../styles`). Allowed: `./styles`, shared primitives from `@/ui/components/...` or design-system packages.
+- CSS / `styled` order — Stylelint idiomatic-order: `css-property-order-stylelint.mdc` (loads on `styles.ts` / `.css`).
+- For visuals use **the style stack and tokens already in the project** (variables, theme, shared classes, design package).
+- Avoid:
+  - inline styles except simple cases;
+  - duplicating styling already covered by shared primitives;
+  - "magic" literals (`#xxxxxx`, arbitrary `17px` / `23px`) when the project has tokens or scale.
+- If no suitable token exists — a local primitive **in one place**, aligned with the design system when possible.
 
-# Пропсы и типизация
+# Props and typing
 
-- **Не передавать пропы в компоненты через spread** (`<Foo {...x} />`). Только явные атрибуты; подробности и исключения — `no-props-spread.mdc` (в `app/src/ui` это дополнительно ловит ESLint).
-- Описывать пропсы через `type Props = { ... }` или `interface Props { ... }`.
-- Не использовать `any`; при необходимости:
-  - обобщения (`<T>`), `unknown`, тип‑предикаты и user‑defined type guards.
-- Для доменных сущностей использовать типы из `@/types` (и enum из `@/types/enums`), а не описывать их заново (`public-imports.mdc`).
+- **Do not pass props via spread** (`<Foo {...x} />`). Only explicit attributes; details and exceptions — `no-props-spread.mdc` (in `app/src/ui` ESLint catches this too).
+- Describe props with `type Props = { ... }` or `interface Props { ... }`.
+- Do not use `any`; when needed:
+  - generics (`<T>`), `unknown`, type predicates and user-defined type guards.
+- For domain entities use types from `@/types` (and enums from `@/types/enums`), not redefined locally (`public-imports.mdc`).
 
-# Логика и side effects
+# Logic and side effects
 
-- Side effects и асинхронщина:
-  - по возможности выносить в store (thunk‑и, middleware) или в отдельные хуки.
-- Компоненты не должны:
-  - напрямую знать детали API (URL, структура DTO);
-  - заниматься маппингом "сырых" DTO — только доменные типы;
-  - содержать нетривиальные вычисления и преобразования данных (булевы флаги, сложная склейка строк, агрегаты и т.п.). В большинстве случаев данные для отображения должны быть подготовлены на этапах маппинга/подготовки данных (API -> доменная модель -> store), а компоненты использовать уже готовые поля.
+- Side effects and async:
+  - when possible, move to store (thunks, middleware) or dedicated hooks.
+- Components must not:
+  - know API details directly (URL, DTO shape);
+  - map "raw" DTOs — only domain types;
+  - contain non-trivial computations and data transforms (boolean flags, complex string concatenation, aggregates, etc.). In most cases display data should be prepared at mapping/preparation stages (API → domain model → store), and components use ready fields.
 
-# Тестирование UI
+# UI testing
 
-- Для нетривиальных компонентов добавлять тесты:
-  - **Testing Library** для React, как принято в проекте;
-  - проверять поведение и бизнес‑правила, а не конкретные CSS‑классы.
-- В тестах ориентироваться на текст, роли и aria‑атрибуты.
+- For non-trivial components add tests:
+  - **Testing Library** for React as adopted in the project;
+  - verify behavior and business rules, not specific CSS classes.
+- In tests prefer text, roles, and aria attributes.
 ## Incorrect
 
 ```tsx

package/presets/cursor/next/rules/reference-features.mdc

@@ -1,5 +1,5 @@
 ---
-description: Эталонные фичи репозитория — копировать структуру при реализации новых задач. Заполните пути после init в целевом репо.
+description: Repository reference features — copy structure when implementing new tasks. Fill paths after init in the target repo.
 globs:
   - app/src/ui/**/*
   - app/src/store/**/*
@@ -10,40 +10,40 @@ alwaysApply: false
 
 <!-- shared-core: architecture/reference-features.template.md -->
 
-# Эталонные фичи (reference features)
+# Reference features
 
 ## Stack notes
 
-Перед реализацией найди фичу того же типа и **повтори её структуру**, не изобретая новую организацию файлов.
+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
 
-Замени **TBD** на реальные пути после договорённости в команде (или при `ai-rules init` в целевом репо):
+Replace **TBD** with real paths after team agreement (or on `ai-rules init` in the target repo):
 
-| Слой | Эталон | Что копировать |
-|------|--------|----------------|
+| Layer | Reference | What to copy |
+|-------|-----------|--------------|
 | UI page | **TBD** `app/src/ui/pages/<Example>/` | `components/`, `*.data.ts`, `styles.ts`, barrel |
 | Store slice | **TBD** `app/src/store/slices/<example>/` | slice, thunks, selectors, types |
 | API service | **TBD** `app/src/api/services/<example>/` | service, mappers, barrel |
 | Types module | **TBD** `app/src/types/<example>/` | domain types, JSDoc, barrel export |
-| Unit tests | **TBD** рядом с эталонным mapper/service | `*.spec.ts`, describe/it naming |
+| Unit tests | **TBD** next to the reference mapper/service | `*.spec.ts`, describe/it naming |
 | E2E area | **TBD** `app/__tests__/e2e/<Area>/` | `*.cases.md`, page objects, `_shared/` |
 
-## Как использовать
+## How to use
 
-1. Определи затронутые слои из `decomposition.md` или задачи.
-2. Открой эталон из таблицы (после заполнения путей).
-3. Зеркаль именование, порядок файлов, паттерны импортов и тестов.
-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, import patterns, and tests.
+4. If there is no reference — pick the **closest** existing feature of the same layer and record the choice in the handoff.
 
 ## Living conventions
 
 Post-init gotchas / patterns / decisions: **`.cursor/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
 
-- `code-quality-and-refactoring.mdc` — повторять паттерны, не deep-import.
-- `feature-delivery-workflow.mdc` — порядок слоёв.
-- skill `feature-delivery` — end-to-end сценарий.
+- `code-quality-and-refactoring.mdc` — repeat patterns, no deep-import.
+- `feature-delivery-workflow.mdc` — layer order.
+- skill `feature-delivery` — end-to-end scenario.