@bonesofspring/ai-rules 0.2.14 → 0.2.15

package/presets/claude/next/rules/tooling-and-review/preset-layering.md

@@ -9,29 +9,28 @@ paths:
 
 <!-- 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` / `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/claude/next/rules/tooling-and-review/preset-no-cross-stack-leakage.md

@@ -9,10 +9,9 @@ paths:
 
 <!-- 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
 

package/presets/claude/next/rules/tooling-and-review/preset-pr-checklist.md

@@ -9,19 +9,18 @@ paths:
 
 <!-- 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, 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/claude/next/rules/tooling-and-review/preset-token-budget.md

@@ -9,21 +9,20 @@ paths:
 
 <!-- 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/claude/next/rules/tooling-and-review/preset-twin-sync.md

@@ -9,7 +9,6 @@ paths:
 
 <!-- shared-core: meta/preset-twin-sync.md -->
 
-
 # Preset twin sync
 
 Cursor `.mdc` — **SoT per stack**. Claude topic `.md` — derived twin.

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

@@ -1,5 +1,5 @@
 ---
-description: Роль агента для проведения технического ретроспективы (retro). On-demand — предпочтительнее slash-команда /technical-retro.
+description: Agent role for running a technical retrospective (retro). On-demand — prefer the /technical-retro slash command.
 paths:
   - .claude/commands/**/*
   - .claude/team/**/*
@@ -7,12 +7,12 @@ paths:
 
 <!-- shared-core: review/technical-retro.md -->
 
-# Техническое ретро — rule alias
+# Technical retro — rule alias
 
-Полный сценарий (включая блок **«Работа агентов»** для slug из team tasks) — в slash-команде:
+Full scenario (including the **“Agent work”** block for a slug from team tasks) lives in the slash command:
 
 **`commands/technical-retro.md`** → `/technical-retro`
 
 When a task has `metrics.json`, use the local aggregation script and state the cohort, sample size, incomplete artifacts, attribution confidence, active attempt duration, and human-gate wait separately. Do not score malformed artifacts or gate wait as agent work.
 
-Используй rule только если command недоступен. Не дублируй содержимое command в ответе — следуй command-файлу и skill `technical-retro`.
+Use this rule only if the command is unavailable. Do not duplicate the command contents in the response — follow the command file and skill `technical-retro`.

package/presets/claude/next/rules/ui-and-accessibility/README.md

@@ -1,12 +1,12 @@
 # UI and accessibility
 
-Компоненты, стили, пропсы.
+Components, styles, props.
 
-| Файл | Содержание | Загрузка |
-|------|------------|----------|
-| `no-props-spread.md` | Явные пропсы, без `{...props}` | `paths: app/src/**/*.tsx` |
-| `css-property-order.md` | Порядок CSS (Stylelint idiomatic-order) | `paths:` styles/css |
-| `react-ui.md` | Структура, стили (`Root`), `.data.ts`, хуки | `paths: app/src/ui/**` |
-| `react-a11y-coding.md` | A11y при написании UI | `paths: app/src/ui/**` |
+| File | Contents | Loading |
+|------|----------|---------|
+| `no-props-spread.md` | Explicit props, no `{...props}` | `paths: app/src/**/*.tsx` |
+| `css-property-order.md` | CSS order (Stylelint idiomatic-order) | `paths:` styles/css |
+| `react-ui.md` | Structure, styles (`Root`), `.data.ts`, hooks | `paths: app/src/ui/**` |
+| `react-a11y-coding.md` | A11y while writing UI | `paths: app/src/ui/**` |
 
 Deprecated stub `component-styles.md` **removed** — styles colocation lives in `react-ui.md`.

package/presets/claude/next/rules/ui-and-accessibility/css-property-order.md

@@ -7,8 +7,8 @@ paths:
   - app/**/*.css
 ---
 
-# Порядок CSS-свойств (как в Stylelint)
+# CSS property order (as in Stylelint)
 
-Порядок свойств — как в **`app/.stylelintrc`** (`stylelint-config-idiomatic-order`). Не дублировать список вручную.
+Property order matches **`app/.stylelintrc`** (`stylelint-config-idiomatic-order`). Do not duplicate the list by hand.
 
-Автоисправление из `app/`: **`lint:css --fix`**. Полный прогон — **`tooling-and-review/post-change-lint.md`**.
+Auto-fix from `app/`: **`lint:css --fix`**. Full gate — **`tooling-and-review/post-change-lint.md`**.

package/presets/claude/next/rules/ui-and-accessibility/no-props-spread.md

@@ -3,34 +3,34 @@ paths:
   - app/src/**/*.tsx
 ---
 
-# Не использовать спред пропов при передаче в компоненты
+# Do not spread props when passing to components
 
-При вызове **пользовательских** React-компонентов (имя с заглавной буквы) **передавать пропы явно**, а не через spread (`{...props}`, `{...obj}`).
+When calling **custom** React components (PascalCase name), **pass props explicitly**, not via spread (`{...props}`, `{...obj}`).
 
-**Агентам и при ревью:** не «упрощать» JSX через объект с spread. Длинное ветвление — два явных JSX-блока или отдельные компоненты.
+**For agents and review:** do not “simplify” JSX with a spread object. Long branching — two explicit JSX blocks or separate components.
 
-## Почему
+## Why
 
-- Явная передача делает зависимости очевидными.
-- Упрощает рефакторинг и поиск использований.
-- Снижает риск лишних пропов.
+- Explicit props make dependencies obvious.
+- Easier refactoring and usage search.
+- Lower risk of stray props.
 
-## Проверка в репозитории
+## Repo enforcement
 
-- Для `app/src/ui/**/*.tsx` — ESLint `react/jsx-props-no-spreading` (`app/eslint.config.mjs`).
-- Исключение — `eslint-disable-next-line` с комментарием «почему».
+- For `app/src/ui/**/*.tsx` — ESLint `react/jsx-props-no-spreading` (`app/eslint.config.mjs`).
+- Exception — `eslint-disable-next-line` with a “why” comment.
 
-## Примеры
+## Examples
 
 ```tsx
-// ❌ Плохо
+// ❌ Bad
 const commonProps = { a, b, c }
 return <Child {...commonProps} />
 
-// ❌ Плохо
+// ❌ Bad
 return <Child {...props} />
 
-// ✅ Хорошо
+// ✅ Good
 return (
   <Child
     a={a}
@@ -39,7 +39,7 @@ return (
   />
 )
 
-// ✅ Хорошо — явные пропсы по веткам
+// ✅ Good — explicit props per branch
 return cond ? (
   <IconBox name={name} size="m" variant="warning" />
 ) : (
@@ -51,7 +51,7 @@ return cond ? (
 )
 ```
 
-## Исключения
+## Exceptions
 
-- **Нативный** DOM (`<div {...rest} />`) — если `rest` только HTML-атрибуты.
-- Обёртки — если явно документировано; при необходимости ESLint-disable.
+- **Native** DOM (`<div {...rest} />`) — when `rest` is HTML attributes only.
+- Wrappers — when explicitly documented; use ESLint disable if needed.

package/presets/claude/next/rules/ui-and-accessibility/react-a11y-coding.md

@@ -4,34 +4,34 @@ paths:
   - app/src/ui/**/*.ts
 ---
 
-# A11y при разработке UI
+# A11y while building 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 no native equivalent exists; 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 activate 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 decoration).
+- 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/claude/next/rules/ui-and-accessibility/react-ui.md

@@ -5,91 +5,91 @@ paths:
 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
 
-Для страницы/крупного блока:
+For a page/large block:
 
-- `FeatureBlock.tsx` — JSX и композиция.
-- `styles.ts` или соседний модуль стилей — по конвенции репозитория (CSS Modules, CSS-in-JS, и т.д.).
-- `index.ts` — реэкспорт (если нужно наружу).
+- `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`, согласно `testing/tests-unit.md`, с тем же префиксом (`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 `testing/tests-unit.md`, 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: `ui-and-accessibility/css-property-order.md` (грузится на `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: `ui-and-accessibility/css-property-order.md` (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} />`). Только явные атрибуты; подробности — `ui-and-accessibility/no-props-spread.md` (в `app/src/ui` это дополнительно ловит ESLint).
-- Описывать пропсы через `type Props = { ... }` или `interface Props { ... }`.
-- Не использовать `any`; при необходимости — обобщения (`<T>`), `unknown`, type guards.
-- Для доменных сущностей использовать типы из `@/types` (и enum из `@/types/enums`), а не описывать их заново (`architecture/public-imports.md`).
+- **Do not pass props via spread** (`<Foo {...x} />`). Only explicit attributes; details — `ui-and-accessibility/no-props-spread.md` (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 guards.
+- For domain entities use types from `@/types` (and enums from `@/types/enums`), not redefined locally (`architecture/public-imports.md`).
 
-# Логика и side effects
+# Logic and side effects
 
-- Side effects и асинхронщина — по возможности в store (thunk’и, middleware) или в отдельные хуки.
-- Компоненты не должны:
-  - напрямую знать детали API (URL, структура DTO);
-  - заниматься маппингом «сырых» DTO — только доменные типы;
-  - содержать нетривиальные вычисления и преобразования данных (булевы флаги, сложная склейка строк, агрегаты и т.п.). Данные для отображения должны быть подготовлены на этапах маппинга/подготовки (API → доменная модель → store).
+- Side effects and async — when possible in 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.). Display data should be prepared at mapping/preparation stages (API → domain model → store).
 
-# Тестирование 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/claude/next/skills/README.md

@@ -1,9 +1,9 @@
 # `.claude/skills` (preset next)
 
-[Skills](https://code.claude.com/docs/en/skills) в Claude Code — сценарии, которые подгружаются по необходимости, а не в каждой сессии целиком. Они синхронизированы по смыслу с `.cursor/skills` из Cursor-пресета.
+[Skills](https://code.claude.com/docs/en/skills) in Claude Code are scenarios loaded on demand, not in every session in full. They match the intent of `.cursor/skills` from the Cursor preset.
 
-| Skill | Когда использовать |
-|-------|--------------------|
+| Skill | When to use |
+|-------|-------------|
 | `feature-delivery` | End-to-end feature work across types, API, store, UI, tests |
 | `code-review` | MR/diff review using project architecture and test standards |
 | `debug-investigation` | Reproducing and fixing bugs with root-cause evidence |
@@ -14,4 +14,4 @@
 | `write-adr` | Author an Architecture Decision Record (context / decision / consequences) |
 | `react-performance` | Implementer checklist: bundle, RSC/client, memo, waterfalls, CWV (not a perf audit agent) |
 
-Папка копируется в `.claude/skills/` при `ai-rules init claude --preset next`, если существует.
+The folder is copied to `.claude/skills/` on `ai-rules init claude --preset next` when it exists.

package/presets/claude/next/skills/feature-delivery/SKILL.md

@@ -8,7 +8,7 @@ description: Delivers Next.js frontend features end-to-end across domain types,
 1. Read task brief, acceptance criteria, and decomposition if present.
 2. Read **`rules/architecture/feature-delivery-workflow.md`** and **`rules/architecture/reference-features.md`** — follow layer order and mirror closest reference feature.
 3. Add or update focused tests for changed behavior.
-4. Validation from `app/`: **invoke** **`rules/tooling-and-review/post-change-lint.md`** after code edits (requestable, not session-start — but mandatory when code changed). Pipeline: scoped lint OK if next step is `build-verifier`.
+4. Validation from `app/`: **invoke** **`rules/tooling-and-review/post-change-lint.md`** after code edits (requestable, not session-start — but **must** when code changed). Pipeline: scoped lint OK if next step is `build-verifier`.
 
 ## Scope discipline
 

package/presets/claude/next/team/README.md

@@ -1,6 +1,6 @@
 # Agent team artifacts
 
-Каталог артефактов пайплайна «команда агентов» Claude.
+Artifact directory for the Claude “agent team” pipeline.
 
 ## Layout
 
@@ -97,7 +97,7 @@ Prefer **`executing`** for pipeline mode. Legacy: `analysis`, `development`, `re
 ## Workflow entry
 
 ```bash
-/task <описание задачи>
+/task <task description>
 /task-continue <slug>
 /technical-retro <slug>
 ```

package/presets/claude/nuxt/CLAUDE.md

@@ -1,6 +1,6 @@
-# Nuxt 3 stack — project instructions
+# Nuxt stack — project instructions
 
-Краткая точка входа для Claude Code. Подробные правила — модульные файлы под `rules/` (подпапки по темам).
+Short entry point for Claude Code. Detailed rules — modular files under `rules/` (topic subfolders).
 
 **Repo-root agents:** see [`AGENTS.md`](../../AGENTS.md) at the project root (cross-tool setup, commands, security, living conventions pointers).
 
@@ -8,27 +8,27 @@ See @rules/README.md for the full catalog and loading strategy.
 
 ## Conventions
 
-- **Одна тема на файл**; для больших областей — подпапки в `rules/<topic>/`.
-- **Session-start rules** (без `paths:`) — ровно **три**: `nuxt-app-core`, `package-manager`, `code-quality`.
-- **Domain-specific rules** — YAML frontmatter `paths:` (подгружаются при работе с matching-файлами); `post-change-lint` — requestable (**обязателен после code edits**); orchestrator и code-review — on-demand.
-- Slash-команды — в `commands/`; сценарии — в `skills/`; subagents — в `agents/`.
+- **One topic per file**; for large areas — subfolders under `rules/<topic>/`.
+- **Session-start rules** (no `paths:`) — exactly **three**: `nuxt-app-core`, `package-manager`, `code-quality`.
+- **Domain-specific rules** — YAML frontmatter `paths:` (loaded when matching files); `post-change-lint` — requestable (**required after code edits**); orchestrator and code-review — on-demand.
+- Slash commands — in `commands/`; scenarios — in `skills/`; subagents — in `agents/`.
 
 ## Quick start
 
-| Задача | Куда смотреть |
-|--------|----------------|
-| Любая новая work-задача | `commands/task.md` + `rules/tooling-and-review/agent-team-orchestrator.md` |
-| Новая фича end-to-end | skill `feature-delivery` + `rules/architecture/feature-delivery-workflow.md` |
-| Эталонные фичи | `rules/architecture/reference-features.md` (заполнить TBD в репо) |
-| Стек и слои | `rules/stack/nuxt-app-core.md` |
-| Nuxt file-based routing | `rules/stack/nuxt-pages-routing.md` |
-| A11y при кодинге UI | `rules/ui-and-accessibility/vue-a11y-coding.md` |
-| После правок кода | `rules/tooling-and-review/post-change-lint.md` (**requestable**, обязателен после edits) |
-| Валидация перед review | agent `build-verifier` |
+| Task | Where to look |
+|------|----------------|
+| Any new work task | `commands/task.md` + `rules/tooling-and-review/agent-team-orchestrator.md` |
+| New end-to-end feature | skill `feature-delivery` + `rules/architecture/feature-delivery-workflow.md` |
+| Reference features | `rules/architecture/reference-features.md` (fill TBD in the repo) |
+| Stack and layers | `rules/stack/nuxt-app-core.md` |
+| Nuxt routing | `rules/stack/nuxt-pages-routing.md` |
+| A11y when coding UI | `rules/ui-and-accessibility/vue-a11y-coding.md` |
+| After code edits | `rules/tooling-and-review/post-change-lint.md` (**requestable**, required after edits) |
+| Validation before review | agent `build-verifier` |
 | Code review MR | skill `code-review` + `rules/tooling-and-review/code-review-mr.md` |
 | Security (auth/forms/env) | `rules/tooling-and-review/security-nuxt.md` + agent `security-reviewer` |
-| Как работает X | agent `codebase-analyzer` (explain-as-is; без `/task`) |
-| Техническое ретро | `commands/technical-retro.md` + skill `technical-retro` |
+| How X works | agent `codebase-analyzer` (explain-as-is; no `/task`) |
+| Technical retro | `commands/technical-retro.md` + skill `technical-retro` |
 
 ## Install
 
@@ -36,4 +36,4 @@ See @rules/README.md for the full catalog and loading strategy.
 npx @bonesofspring/ai-rules init claude --preset nuxt
 ```
 
-Копирует `CLAUDE.md`, `rules/**`, `commands/**`, `agents/**`, `hooks/**`, `team/**`, `MCP.md` в `.claude/`, плюс `mcp.json` → **`.mcp.json`** и `REPO_AGENTS.md` → корневой **`AGENTS.md`**. Skills: `write-adr`, `vue-performance` (on-demand).
+Copies `CLAUDE.md`, `rules/**`, `commands/**`, `agents/**`, `hooks/**`, `team/**`, `MCP.md` into `.claude/`, plus `mcp.json` → **`.mcp.json`** and `REPO_AGENTS.md` → root **`AGENTS.md`**. Skills: `write-adr`, `vue-performance` (on-demand).