@bonesofspring/ai-rules 0.2.14 → 0.2.15

package/presets/cursor/ios-swift/rules/swift-conventions.mdc

@@ -7,28 +7,28 @@ alwaysApply: false
 # Naming and API design
 
 - Types: `UpperCamelCase`; methods, properties, enum cases: `lowerCamelCase`.
-- Protocols, описывающие capability: `-able`, `-ing`, или `Protocol` суффикс — как в репо.
-- Избегать аббревиатур в именах, кроме общепринятых (URL, ID, HTTP).
+- Protocols that describe a capability: `-able`, `-ing`, or `Protocol` suffix — as in the repo.
+- Avoid abbreviations in names except common ones (URL, ID, HTTP).
 
 # Optionals and errors
 
 ```swift
-// ❌ Плохо
+// ❌ Bad
 let name = user!.name
 
-// ✅ Хорошо
+// ✅ Good
 guard let name = user?.name else { return }
 ```
 
-- `throws` + typed errors вместо `Result` там, где так принято в слое; быть консistent внутри модуля.
-- `guard` для early exit; не вкладывать глубокие `if let` pyramids.
+- `throws` + typed errors instead of `Result` where that is the layer convention; stay consistent within a module.
+- `guard` for early exit; do not nest deep `if let` pyramids.
 
 # Concurrency
 
 - UI types — `@MainActor`.
-- Shared mutable state — `actor` или isolation через queue; document thread expectations.
-- `Task { }` в ViewModel: учитывать cancellation; `[weak self]` в escaping closures при retain cycles (default when capturing `self` in escaping work).
-- Prefer `async/await` over completion handlers для нового кода.
+- Shared mutable state — `actor` or isolation via a queue; document thread expectations.
+- `Task { }` in ViewModel: account for cancellation; `[weak self]` in escaping closures when retain cycles are possible (default when capturing `self` in escaping work).
+- Prefer `async/await` over completion handlers for new code.
 
 ## Anti-hallucination (Swift / concurrency)
 
@@ -42,20 +42,20 @@ guard let name = user?.name else { return }
 
 # Access control
 
-- Минимально необходимый уровень: `private` / `fileprivate` по умолчанию для implementation details.
-- Public API фичи — явные types и protocols; не экспортировать DTO наружу модуля.
+- Minimum necessary level: `private` / `fileprivate` by default for implementation details.
+- Feature public API — explicit types and protocols; do not export DTOs outside the module.
 
 # Value semantics
 
-- Предпочитать `struct` для models и state где нет identity semantics.
-- `class` — когда нужен identity, inheritance, или Objective-C interop.
+- Prefer `struct` for models and state where there is no identity semantics.
+- `class` — when identity, inheritance, or Objective-C interop is required.
 
 # Extensions
 
-- Группировать extensions по типу; не складывать unrelated helpers в один `Extensions.swift` без структуры.
-- Protocol extensions для shared default behavior.
+- Group extensions by type; do not dump unrelated helpers into one unstructured `Extensions.swift`.
+- Protocol extensions for shared default behavior.
 
-# Требование к агенту
+# Agent requirement
 
 - Style gate: **SwiftLint** (and SwiftFormat when configured) — prefer fixing lint over prose style essays; `// swiftlint:disable` only with an explicit reason.
-- Новый код — Swift Concurrency-ready (`Sendable` где требует компилятор/линтер проекта).
+- New code — Swift Concurrency-ready (`Sendable` where the project compiler/linter requires it).

package/presets/cursor/ios-swift/rules/swiftui-ui.mdc

@@ -1,24 +1,24 @@
 ---
-description: Паттерны SwiftUI, View и Design System (preset)
+description: SwiftUI, View, and Design System patterns (preset)
 globs: "**/{Presentation,DesignSystem}/**/*.swift"
 alwaysApply: false
 ---
 
-# Общие правила View
+# General View rules
 
-- **SwiftUI** — приоритет; UIKit — только по конвенции репо (wrapper, legacy).
-- View должна быть **тонкой**:
-  - отображает state из ViewModel;
-  - делегирует действия через методы/closures ViewModel;
-  - не содержит бизнес-логики, маппинга DTO, сетевых вызовов.
-- Перед новым кастомным контролом — искать компонент в `DesignSystem/` или существующих фичах.
-- Повторяемую UI-логику выносить в `ViewModifier`, `@ViewBuilder` helpers или subviews.
+- **SwiftUI** preferred; UIKit only by repo convention (wrapper, legacy).
+- Views must be **thin**:
+  - render state from the ViewModel;
+  - delegate actions through ViewModel methods/closures;
+  - contain no business logic, DTO mapping, or network calls.
+- Before a new custom control — look for a component in `DesignSystem/` or existing features.
+- Extract repeated UI logic into `ViewModifier`, `@ViewBuilder` helpers, or subviews.
 
-# ViewModel и binding
+# ViewModel and binding
 
-- ViewModel — `@MainActor`, `@Observable` (iOS 17+) или `ObservableObject` — как принято в проекте.
-- View читает state и вызывает **явные методы** ViewModel (`submit()`, `load()`), а не мутирует внутреннее состояние напрямую.
-- Для навигации — coordinator/router или enum route в ViewModel, не размазанные `NavigationLink` с бизнес-условиями в View.
+- ViewModel — `@MainActor`, `@Observable` (iOS 17+) or `ObservableObject` — as adopted in the project.
+- The View reads state and calls **explicit ViewModel methods** (`submit()`, `load()`); it does not mutate internal state directly.
+- For navigation — coordinator/router or a route enum in the ViewModel, not scattered `NavigationLink`s with business conditions in the View.
 
 # Lifecycle, ownership, hit testing
 
@@ -28,42 +28,42 @@ alwaysApply: false
 - Transparent stacks that should receive taps: `.contentShape(Rectangle())`.
 - High-frequency visual updates — prefer `TimelineView` (or repo pattern) over ad-hoc `Timer` in Views.
 
-# Структура файлов
+# File structure
 
-Для экрана фичи:
-- `FeatureView.swift` — композиция subviews.
+For a feature screen:
+- `FeatureView.swift` — subview composition.
 - `FeatureViewModel.swift` — state + intents.
-- `FeatureView+Subviews.swift` — при большом дереве (опционально).
-- `FeatureRoute.swift` — навигация (если используется).
+- `FeatureView+Subviews.swift` — for a large tree (optional).
+- `FeatureRoute.swift` — navigation (when used).
 
-Для компонента Design System:
-- Папка `ComponentName/`:
+For a Design System component:
+- Folder `ComponentName/`:
   - `ComponentName.swift`
-  - `ComponentName+Preview.swift` (опционально)
-  - `ComponentNameStyle.swift` — стили/варианты (опционально)
+  - `ComponentName+Preview.swift` (optional)
+  - `ComponentNameStyle.swift` — styles/variants (optional)
 
-# Стили и Design System
+# Styles and Design System
 
-- Цвета, шрифты, отступы — из **токенов/Theme** проекта (`DesignSystem`, `Assets`, generated tokens).
-- Избегать:
-  - «магических» литералов (`.padding(17)`, `Color(red: 0.2, ...)`), если есть токены;
-  - дублирования стилей, уже закрытых примитивами.
-- `Preview` — для компонентов и экранов с mock ViewModel.
+- Colors, fonts, spacing — from project **tokens/Theme** (`DesignSystem`, `Assets`, generated tokens).
+- Avoid:
+  - “magic” literals (`.padding(17)`, `Color(red: 0.2, ...)`) when tokens exist;
+  - duplicating styles already covered by primitives.
+- `Preview` — for components and screens with a mock ViewModel.
 
 # Accessibility
 
-- Интерактивные элементы: осмысленные `accessibilityLabel`, `accessibilityHint` где нужно.
-- Для UI-тестов — стабильные `accessibilityIdentifier` на ключевых элементах (согласовать с `tests-ui.mdc`).
-- Поддерживать Dynamic Type и контраст, не ломать layout при крупном шрифте.
+- Interactive elements: meaningful `accessibilityLabel`, `accessibilityHint` where needed.
+- For UI tests — stable `accessibilityIdentifier` on key elements (align with `tests-ui.mdc`).
+- Support Dynamic Type and contrast; do not break layout at large text sizes.
 
-# Previews и локализация
+# Previews and localization
 
-- Строки UI — через `String(localized:)` / `LocalizedStringKey`, не hardcoded в production без причины.
-- `#Preview` с реалистичными mock-данными; для ViewModel — stub use cases.
+- UI strings via `String(localized:)` / `LocalizedStringKey`, not hardcoded in production without reason.
+- `#Preview` with realistic mock data; for ViewModels — stub use cases.
 
-# Требование к агенту
+# Agent requirement
 
-При создании/изменении UI:
-- Следовать существующим экранам и компонентам как эталону.
-- Не импортировать Data-слой во View/ViewModel.
-- Subview выделять, когда body превышает ~40–60 строк или повторяется.
+When creating/changing UI:
+- Follow existing screens and components as the reference.
+- Do not import the Data layer into View/ViewModel.
+- Extract a subview when body exceeds ~40–60 lines or repeats.

package/presets/cursor/ios-swift/rules/technical-retro.mdc

@@ -1,16 +1,16 @@
 ---
-description: Роль агента для проведения технического ретроспективы (retro) команды / спринта. On-demand — предпочтительнее slash-команда /technical-retro.
+description: Agent role for a technical retrospective (retro) of the team / sprint. On-demand — prefer the /technical-retro slash command.
 alwaysApply: false
 ---
 
 <!-- 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/cursor/ios-swift/rules/tests-ui.mdc

@@ -1,42 +1,43 @@
 ---
-description: UI-тесты XCUITest и accessibility identifiers
+description: XCUITest UI tests and accessibility identifiers
 globs: "**/*UITests/**/*.swift"
 alwaysApply: false
 ---
 
-# Структура UI-тестов
+# UI test structure
 
-- UI Test target: `*UITests/` — сценарии пользовательских потоков.
-- Page Object (или Screen Object) — класс на экран: селекторы + действия (`LoginScreen`, `OrderHistoryScreen`).
-- Общие хелперы — `UITestSupport/`, base classes, launch arguments.
+- UI Test target: `*UITests/` — end-user flow scenarios.
+- Page Object (or Screen Object) — one class per screen: selectors + actions (`LoginScreen`, `OrderHistoryScreen`).
+- Shared helpers — `UITestSupport/`, base classes, launch arguments.
 
-# Селекторы и стабильность
+# Selectors and stability
 
-- **Приоритет:** `accessibilityIdentifier` для ключевых элементов; затем label/trait где устойчиво.
-- Идентификаторы согласовать с Presentation-слоем (`swiftui-ui.mdc`): `{screen}__{element}`.
-  - Пример: `order-history__submit-button`, `login__email-field`.
-- Избегать привязки к абсолютным координатам и хрупким XPath-подобным цепочкам.
+- **Priority:** `accessibilityIdentifier` for key elements; then label/trait where stable.
+- Align identifiers with the Presentation layer (`swiftui-ui.mdc`): `{screen}__{element}`.
+  - Example: `order-history__submit-button`, `login__email-field`.
+- Avoid absolute coordinates and brittle XPath-like chains.
 
-# Сценарии и именование
+# Scenarios and naming
 
-- Названия тестов — **на русском**, с префиксом сущности:
-  - `OH-001 Отображается список заказов` (префикс — первые буквы сущности, номер — три цифры).
-- Один тест — один пользовательский сценарий; не объединять несвязанные проверки.
+- Test names — **in the product locale** (Russian when UI copy is Russian), with an entity prefix:
+  <!-- i18n-keep: E5 -->
+  - `OH-001 Отображается список заказов` (prefix — entity initials, number — three digits).
+- One test — one user scenario; do not combine unrelated checks.
 
-# Launch и окружение
+# Launch and environment
 
-- `-UITesting`, mock server URL, сброс state — через `launchArguments` / `launchEnvironment`, как в репо.
-- Не зависеть от прод-backend в CI; использовать staging/mock.
+- `-UITesting`, mock server URL, state reset — via `launchArguments` / `launchEnvironment`, as in the repo.
+- Do not depend on production backend in CI; use staging/mock.
 
-# Синхронизация с UI
+# Sync with UI
 
-- При изменении UI обновлять identifiers в View и селекторы в page objects.
-- Не ослаблять assertions против бизнес-ожиданий ради «зелёного» CI.
+- When UI changes, update identifiers in Views and selectors in page objects.
+- Do not weaken assertions against business expectations just to keep CI green.
 
-# Требование к агенту
+# Agent requirement
 
-При добавлении UI-тестов:
-- Переиспользовать page objects, не дублировать query в каждом тесте.
-- Добавлять `accessibilityIdentifier` в SwiftUI через `.accessibilityIdentifier(...)` для новых интерактивных элементов.
-- Следовать существующим UITest files как эталону.
-- Планирование / генерация / heal — agents `xcuitest-test-{planner,generator,healer}` и skill `xcuitest-e2e` (не Playwright).
+When adding UI tests:
+- Reuse page objects; do not duplicate queries in every test.
+- Add `accessibilityIdentifier` in SwiftUI via `.accessibilityIdentifier(...)` for new interactive elements.
+- Follow existing UITest files as the reference.
+- Planning / generation / heal — agents `xcuitest-test-{planner,generator,healer}` and skill `xcuitest-e2e` (not Playwright).

package/presets/cursor/ios-swift/rules/tests-unit.mdc

@@ -1,41 +1,41 @@
 ---
-description: Unit и integration тесты (XCTest / Swift Testing)
+description: Unit and integration tests (XCTest / Swift Testing)
 globs: "**/*Tests/**/*.swift"
 alwaysApply: false
 ---
 
-# Общие правила тестирования
+# General testing rules
 
-- **Framework** — XCTest или Swift Testing, как в проекте.
-- Цель: проверять **поведение и бизнес-правила**, не детали реализации и private API.
-- Именование:
-  - `test` / `@Test` descriptions и `XCTContext` — **на русском**, как понятные бизнес-фразы.
-  - Описания **с заглавной буквы**.
+- **Framework** — XCTest or Swift Testing, as in the project.
+- Goal: verify **behavior and business rules**, not implementation details and private API.
+- Naming:
+  - `test` / `@Test` descriptions and `XCTContext` — **in the product locale** (Russian when UI copy is Russian), as clear business phrases.
+  - Descriptions **start with a capital letter**.
 
-# ViewModel и use case
+# ViewModel and use case
 
-- Mock протоколов repositories / use cases; не поднимать реальную сеть.
-- Проверять переходы state: loading → success/failure, validation errors, edge cases.
-- `@MainActor` ViewModel тестировать с `@MainActor` test methods или `await MainActor.run`.
+- Mock repository / use case protocols; do not hit the real network.
+- Assert state transitions: loading → success/failure, validation errors, edge cases.
+- Test `@MainActor` ViewModels with `@MainActor` test methods or `await MainActor.run`.
 
-# Mappers и domain
+# Mappers and domain
 
-- Mapper functions — unit-тесты с таблицами кейсов: nil fields, empty arrays, граничные значения.
-- Regression на бизнес-правила (скидки, статусы, форматирование дат).
+- Mapper functions — unit tests with case tables: nil fields, empty arrays, boundary values.
+- Regressions on business rules (discounts, statuses, date formatting).
 
-# Изоляция
+# Isolation
 
-- Не мокать то, что является предметом теста (например, сам mapper при тесте mapper).
-- Fixtures — в `TestSupport/`, `Mocks/` или рядом по конвенции репо; не дублировать большие JSON inline без нужды.
+- Do not mock the subject under test (e.g. the mapper itself when testing the mapper).
+- Fixtures — in `TestSupport/`, `Mocks/`, or colocated per repo convention; do not inline large JSON without need.
 
-# Структура файлов
+# File structure
 
-- `FeatureViewModelTests.swift`, `OrderMapperTests.swift` — суффикс `Tests` в имени типа/файла по стилю Xcode.
-- Не создавать глубокую вложенность `Tests/Tests/`; следовать target structure проекта.
+- `FeatureViewModelTests.swift`, `OrderMapperTests.swift` — `Tests` suffix on type/file name per Xcode style.
+- Do not create deep `Tests/Tests/` nesting; follow the project target structure.
 
-# Требование к агенту
+# Agent requirement
 
-При добавлении тестов:
-- Копировать паттерны из существующих test files в репо.
-- Добавлять тесты для новых веток логики и регрессий.
-- Использовать DTO fixtures из Data layer и domain types из Domain, не дублировать типы в тестах.
+When adding tests:
+- Copy patterns from existing test files in the repo.
+- Add tests for new logic branches and regressions.
+- Use DTO fixtures from the Data layer and domain types from Domain; do not duplicate types in tests.

package/presets/cursor/ios-swift/rules/xcode-tooling.mdc

@@ -1,20 +1,20 @@
 ---
-description: Перед xcodebuild / SwiftLint / SwiftFormat определять toolchain и схемы репозитория и использовать только их
+description: Before xcodebuild / SwiftLint / SwiftFormat, detect the repo toolchain and schemes and use only those
 alwaysApply: false
 ---
 
-# Xcode tooling (терминал)
+# Xcode tooling (terminal)
 
-Перед **`xcodebuild` / `swift build` / `swift test` / SwiftLint / SwiftFormat / `simctl`** определи toolchain репозитория и **используй только его**.
+Before **`xcodebuild` / `swift build` / `swift test` / SwiftLint / SwiftFormat / `simctl`**, detect the repository toolchain and **use only it**.
 
-## Как определить
+## How to detect
 
-1. **Workspace / project:** `.xcworkspace` (CocoaPods) → workspace; иначе `.xcodeproj`; SPM-only — `Package.swift`.
-2. **Scheme / destination:** как в CI, `Makefile`, `fastlane`, `scripts/` — не угадывать.
-3. **Lint:** `.swiftlint.yml` / `SwiftLint` в PATH или Mint/mise — если конфига нет, не запускать «чужой» lint.
-4. **Format:** `.swiftformat` / SwiftFormat — только если принято в репо.
-5. **Simulator:** `xcrun simctl list` + destination из CI; не хардкодить UDID.
+1. **Workspace / project:** `.xcworkspace` (CocoaPods) → workspace; else `.xcodeproj`; SPM-only — `Package.swift`.
+2. **Scheme / destination:** as in CI, `Makefile`, `fastlane`, `scripts/` — do not guess.
+3. **Lint:** `.swiftlint.yml` / `SwiftLint` on PATH or Mint/mise — if there is no config, do not run a foreign lint.
+4. **Format:** `.swiftformat` / SwiftFormat — only if adopted in the repo.
+5. **Simulator:** `xcrun simctl list` + destination from CI; do not hardcode UDID.
 
-Примеры: `xcodebuild -scheme App -destination 'platform=iOS Simulator,name=iPhone 16' build`, `swiftlint lint --quiet`, `swiftformat . --lint`.
+Examples: `xcodebuild -scheme App -destination 'platform=iOS Simulator,name=iPhone 16' build`, `swiftlint lint --quiet`, `swiftformat . --lint`.
 
-Долгие сборки и DerivedData — нормальны; не блокировать `xcodebuild`/`simctl`/`xcrun` shell-guard’ом.
+Long builds and DerivedData are normal; do not block `xcodebuild`/`simctl`/`xcrun` with the shell guard.

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

@@ -1,7 +1,7 @@
 # `.cursor/skills` (preset ios-swift)
 
-| Skill | Назначение |
-|-------|------------|
+| Skill | Purpose |
+|-------|---------|
 | `feature-delivery` | Domain → Data → VM → View → tests → post-change-build |
 | `code-review` | iOS MR checklist |
 | `unit-testing` | XCTest / Swift Testing |
@@ -11,4 +11,4 @@
 | `technical-retro` | Retro facilitation |
 | `write-adr` | Architecture Decision Record (context / decision / consequences) |
 
-Копируется в `.cursor/skills/` при init.
+Copied to `.cursor/skills/` on init.

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

@@ -1,6 +1,6 @@
 # Agent team artifacts (ios-swift)
 
-Каталог артефактов пайплайна «команда агентов» для iOS.
+Artifact directory for the iOS agent-team pipeline.
 
 ## Layout
 

package/presets/cursor/java/AGENTS.md

@@ -2,17 +2,17 @@
 
 **Repo-root agents:** see [`AGENTS.md`](../../AGENTS.md) at the project root (cross-tool setup, commands, security, living conventions pointers).
 
-| Задача | Куда смотреть |
+| Task | Where to look |
 |--------|----------------|
-| Новая work-задача | `/task` → `commands/task.md` + `agent-team-orchestrator.mdc` |
-| Фича end-to-end | skill `feature-delivery` + `feature-delivery-workflow.mdc` |
-| Стек и слои | `java-app-core.mdc`, `architecture-boundaries.mdc` |
-| После правок Java | `post-change-test.mdc` (+ `java-tooling.mdc`) |
+| New work task | `/task` → `commands/task.md` + `agent-team-orchestrator.mdc` |
+| Feature end-to-end | skill `feature-delivery` + `feature-delivery-workflow.mdc` |
+| Stack and layers | `java-app-core.mdc`, `architecture-boundaries.mdc` |
+| After Java edits | `post-change-test.mdc` (+ `java-tooling.mdc`) |
 | Integration tests | `integration-test-*` + skill `integration-testing` |
 | Unit tests | `unit-test-*` + skill `unit-testing` |
 | Code review | skill `code-review` + `code-review-mr.mdc` |
 | ADR | skill `write-adr` (on-demand) |
-| Как работает X | agent `codebase-analyzer` (explain-as-is; без `/task`) |
+| How does X work | agent `codebase-analyzer` (explain-as-is; without `/task`) |
 
 ## Install
 
@@ -20,7 +20,7 @@
 npx @bonesofspring/ai-rules init cursor --preset java
 ```
 
-Копирует rules/agents/hooks/skills/commands/team + `REPO_AGENTS.md` → корневой `AGENTS.md`.
+Copies rules/agents/hooks/skills/commands/team + `REPO_AGENTS.md` → root `AGENTS.md`.
 
 ## Inventory
 
@@ -28,10 +28,10 @@ npx @bonesofspring/ai-rules init cursor --preset java
 - **8 skills** — `feature-delivery`, `unit-testing`, `integration-testing`, `ci-investigation`, `debug-investigation`, `code-review`, `technical-retro`, `write-adr`
 - **5 commands** — `/task`, `/task-continue`, `/feature-start`, `/feature-continue`, `/technical-retro`
 
-## Dogfood (5 сценариев)
+## Dogfood (5 scenarios)
 
-1. `/task` — новый use case (domain → ports → adapters → wire).
-2. Баг маппинга HTTP — debugger + MockMvc/focused controller test.
+1. `/task` — new use case (domain → ports → adapters → wire).
+2. HTTP mapping bug — debugger + MockMvc/focused controller test.
 3. Repository contract — integration-test trio (Testcontainers).
 4. Unit use case — unit-test planner/generator (JUnit 5 + port fake/mock).
 5. Secrets in logs — security-reviewer + `security-java`.

package/presets/cursor/java/MCP.md

@@ -1,15 +1,15 @@
 # MCP (preset `java`, Cursor)
 
-Копируется в `.cursor/mcp.json` при `ai-rules init cursor --preset java`.
+Copied to `.cursor/mcp.json` on `ai-rules init cursor --preset java`.
 
 ## Servers
 
-| Name | Package | Зачем |
+| Name | Package | Why |
 |------|---------|--------|
-| `context7` | `@upstash/context7-mcp` | Актуальная документация Java / Spring / JDK / популярных библиотек |
+| `context7` | `@upstash/context7-mcp` | Up-to-date Java / Spring / JDK / popular library docs |
 
-Figma и browser e2e MCP (Playwright / Chrome DevTools) **не** входят в java-пресет (backend-only).
+Figma and browser e2e MCP (Playwright / Chrome DevTools) are **not** part of the java preset (backend-only).
 
-Секреты в файл не кладём. Опционально: `CONTEXT7_API_KEY` в окружении.
+Do not put secrets in the file. Optional: `CONTEXT7_API_KEY` in the environment.
 
-После init: Settings → MCP → включить серверы. `init` перезаписывает одноимённый `mcp.json`.
+After init: Settings → MCP → enable servers. `init` overwrites the same-named `mcp.json`.

package/presets/cursor/java/agents/README.md

@@ -1,10 +1,10 @@
 # `.cursor/agents` (preset java)
 
-Ролевые subagents для командного пайплайна Cursor (Java hexagonal).
+Role subagents for the Cursor agent-team pipeline (Java hexagonal).
 
 ## Analysis (on-demand)
 
-| Agent | Файл | Production-код |
+| Agent | File | Production code |
 |-------|------|----------------|
 | Codebase analyzer | `codebase-analyzer.md` | no (explain-as-is only) |
 
@@ -25,7 +25,7 @@
 
 ## Frontmatter `readonly`
 
-Все agents — **`readonly: false`** (нужна запись в `.cursor/team/**`). Ограничения production — в теле промпта.
+All agents are **`readonly: false`** (need write access to `.cursor/team/**`). Production constraints are in the prompt body.
 
 ## Model matrix (frontmatter `model`)
 

package/presets/cursor/java/agents/task-router.md

@@ -17,21 +17,21 @@ You are a task router for a **Java hexagonal backend** agent team. You **do not*
 
 | intent | Signals | Default steps |
 |--------|---------|---------------|
-| `feature` | «добавь», «новая», «реализуй», use case/API/adapter | task-analyst → feature-developer → build-verifier → code-reviewer → qa-tester or **integration-test** trio when adapter AC |
-| `bugfix` | «баг», «fix», «не работает», «падает» | debugger → feature-developer (skipIf debugger.fixed) → build-verifier → code-reviewer |
-| `ci-fix` | «CI», «красный PR», «failing check» | ci-investigator → feature-developer (skipIf resolved) → build-verifier → code-reviewer |
-| `migration` | «миграция», «upgrade», «обнови JDK/Maven-Gradle» | task-analyst → migration-specialist → feature-developer → build-verifier → code-reviewer |
-| `perf-audit` | «производительность», «JFR/async-profiler», «медленно» | performance-auditor |
-| `review-only` | «ревью», «review MR», «проверь diff» | code-reviewer |
-| `test-only` | «покрой тестами» (unit+integration, no impl) | task-analyst → qa-tester |
-| `unit-only` | «unit», «юнит», «покрой use case» | unit-test-planner → unit-test-generator, or unit-test-healer |
+| `feature` | «добавь» (add), «новая» (new), «реализуй» (implement), use case/API/adapter | task-analyst → feature-developer → build-verifier → code-reviewer → qa-tester or **integration-test** trio when adapter AC | <!-- i18n-keep: E4 -->
+| `bugfix` | «баг» (bug), «fix», «не работает» (doesn't work), «падает» (crashes) | debugger → feature-developer (skipIf debugger.fixed) → build-verifier → code-reviewer | <!-- i18n-keep: E4 -->
+| `ci-fix` | «CI», «красный PR» (red PR), «failing check» | ci-investigator → feature-developer (skipIf resolved) → build-verifier → code-reviewer | <!-- i18n-keep: E4 -->
+| `migration` | «миграция» (migration), «обнови JDK/Maven-Gradle» (upgrade), "update JDK/Maven-Gradle" | task-analyst → migration-specialist → feature-developer → build-verifier → code-reviewer | <!-- i18n-keep: E4 -->
+| `perf-audit` | «производительность» (performance), «JFR/async-profiler», «медленно» (slow) | performance-auditor | <!-- i18n-keep: E4 -->
+| `review-only` | «ревью» (review), «проверь diff» (review MR), "check diff" | code-reviewer | <!-- i18n-keep: E4 -->
+| `test-only` | «покрой тестами» (cover with tests), (unit+integration, no impl) | task-analyst → qa-tester | <!-- i18n-keep: E4 -->
+| `unit-only` | «юнит» (unit), «покрой use case» (cover use case) | unit-test-planner → unit-test-generator, or unit-test-healer | <!-- i18n-keep: E4 -->
 | `e2e-only` / integration | «integration», «e2e», «MockMvc», «Testcontainers» | **integration-test-planner** → **integration-test-generator**, or **integration-test-healer** |
-| `docs-only` | «документация», «README», «changelog» | task-analyst → tech-writer |
-| `refactor` | «рефакторинг», «без изменения поведения» | task-analyst → feature-developer → build-verifier → code-reviewer |
-| `spike` | «исследуй», «spike», proof of concept | task-analyst → solution-architect |
-| `retro` | «ретро», «postmortem» | (orchestrator → `/technical-retro`) |
+| `docs-only` | «документация» (docs), "README", "changelog" | task-analyst → tech-writer | <!-- i18n-keep: E4 -->
+| `refactor` | «рефакторинг» (refactor), «без изменения поведения» (no behavior change) | task-analyst → feature-developer → build-verifier → code-reviewer | <!-- i18n-keep: E4 -->
+| `spike` | «исследуй» (explore), "spike", proof of concept | task-analyst → solution-architect | <!-- i18n-keep: E4 -->
+| `retro` | «ретро» (retro), "postmortem" | (orchestrator → `/technical-retro`) | <!-- i18n-keep: E4 -->
 
-**Never schedule** Playwright (`playwright-test-*`), XCUITest (`xcuitest-test-*`), or `accessibility-reviewer`. Put them in `skipped` with reason «Java backend uses integration-test trio».
+**Never schedule** Playwright (`playwright-test-*`), XCUITest (`xcuitest-test-*`), or `accessibility-reviewer`. Put them in `skipped` with reason "Java backend uses integration-test trio".
 
 ## Pipeline profiles