@bonesofspring/ai-rules 0.2.14 → 0.2.15

package/presets/cursor/next/rules/tests-unit.mdc

@@ -1,5 +1,5 @@
 ---
-description: Unit и интеграционные тесты (Testing Library и runner проекта)
+description: Unit and integration tests (Testing Library and project runner)
 globs:
   - app/src/**/*.spec.{ts,tsx}
   - app/src/**/*.test.{ts,tsx}
@@ -7,72 +7,71 @@ alwaysApply: false
 impact: MEDIUM
 ---
 
-# Общие правила тестирования
-
-- **Имена файлов:** для **новых** тестов использовать суффикс **`*.spec.ts` / `*.spec.tsx`**. Существующие **`*.test.ts` / `*.test.tsx`** не переименовывать без отдельной задачи (легаси).
-- **Runner и матчеры** — как в проекте (часто Jest или Vitest); для компонентов — **@testing-library/react**.
-- Основная цель тестов:
-  - проверять **поведение и бизнес‑правила**, а не реализацию или внутренние детали.
-- **Именование unit‑тестов** (строки в `describe` / `it` / `test`):
-  - формулировки **только на русском языке** — понятные бизнес‑фразы (что проверяется и какой ожидается результат);
-  - **каждое предложение** в названии **начинается с заглавной буквы** (в том числе после `.`, `!`, `?` и при нескольких предложениях в одной строке); первая буква всей строки — тоже заглавная.
-  - **Проверка в CI:** ESLint (`jest/valid-title` в `app/eslint.config.mjs`) требует, чтобы строка начиналась с русской заглавной (А–Я, Ё), и запрещает пробел после точки, за которым сразу идёт строчная буква (типичный случай нарушения «с заглавной после точки»).
-
-```typescript
-// ✅ Хорошо
-it('Возвращает пустой список. Пользователь не авторизован', () => {})
-it('При ошибке сети показывается сообщение об ошибке', () => {})
-
-// ❌ Плохо (не с заглавной после точки; или не русский)
-it('Возвращает пустой список. пользователь не авторизован', () => {})
-it('Returns empty list when user is guest', () => {})
-```
+# General testing rules
+
+- **File names:** for **new** tests use the **`*.spec.ts` / `*.spec.tsx`** suffix. Do not rename existing **`*.test.ts` / `*.test.tsx`** without a separate task (legacy).
+- **Runner and matchers** — as in the project (often Jest or Vitest); for components — **@testing-library/react**.
+- Primary goal of tests:
+  - verify **behavior and business rules**, not implementation or internal details.
+- **Unit test naming** (strings in `describe` / `it` / `test`):
+  - consumer apps **may use Russian locale** for titles — clear business phrases (what is checked and expected outcome);
+  - when ESLint enforces Russian (see below), each sentence in the title **must start with a capital letter** (including after `.`, `!`, `?` and with multiple sentences on one line); the first letter of the whole string is capitalized too.
+  - **CI check (when configured):** ESLint (`jest/valid-title` in `app/eslint.config.mjs`) may require titles to start with a Russian capital letter and forbid a space after `.` followed immediately by a lowercase letter (typical "capital after period" violation).
+
+Good (Russian locale in consumer app):
+
+- `it('Возвращает пустой список. Пользователь не авторизован', () => {})` <!-- i18n-keep: E5 --> (Returns empty list. User is not authorized)
+- `it('При ошибке сети показывается сообщение об ошибке', () => {})` <!-- i18n-keep: E5 --> (On network error, an error message is shown)
+
+Bad (no capital after period; or wrong locale for configured ESLint):
 
-# Тесты компонентов
+- `it('Возвращает пустой список. пользователь не авторизован', () => {})` <!-- i18n-keep: E5 -->
+- `it('Returns empty list when user is guest', () => {})`
 
-- Использовать `render` из `@testing-library/react`.
-- Ассерты:
-  - матчеры DOM для Testing Library, как подключены в проекте (`toBeInTheDocument`, `toHaveTextContent` и т.п.).
-- Взаимодействия:
-  - `userEvent` из `@testing-library/user-event`.
+# Component tests
 
-# Изоляция и моки
+- Use `render` from `@testing-library/react`.
+- Assertions:
+  - DOM matchers for Testing Library as wired in the project (`toBeInTheDocument`, `toHaveTextContent`, etc.).
+- Interactions:
+  - `userEvent` from `@testing-library/user-event`.
 
-- Для работы с API/store:
-  - мокать store (через test‑store) или использовать принятый в проекте способ моков HTTP/API.
-- Не мокать то, что является частью публичного контракта фичи, если это ломает смысл теста.
+# Isolation and mocks
 
-# HTTP‑клиент
+- For API/store work:
+  - mock the store (via test-store) or use the project's accepted HTTP/API mock approach.
+- Do not mock what is part of the feature's public contract if that breaks the test's meaning.
 
-- При изменении **реализации общего HTTP‑клиента** (разбор тел, заголовки, ветки ошибок, 401/refresh, `FormData`, `blob` и т.п.) — **обновить или добавить behavior‑тесты** рядом с модулем клиента в `app/src/lib/clients/**` (предпочтительно `*.spec.ts`; легаси `*.test.ts` — не трогать без задачи).
-- Проверять смысловые ветки: успешный JSON, HTTP‑ошибка, сеть, релевантные для проекта сценарии авторизации.
+# HTTP client
 
-# Мапперы и преобразование данных
+- When changing the **shared HTTP client implementation** (body parsing, headers, error branches, 401/refresh, `FormData`, `blob`, etc.) — **update or add behavior tests** next to the client module in `app/src/lib/clients/**` (prefer `*.spec.ts`; legacy `*.test.ts` — do not touch without a task).
+- Cover meaningful branches: successful JSON, HTTP error, network, auth scenarios relevant to the project.
 
-- Функции маппинга данных (DTO -> доменная модель и обратно), особенно содержащие вычисляемые поля и ветвления, должны быть покрыты unit‑тестами.
-- В тестах мапперов особое внимание уделять edge‑кейсам и регрессии бизнес‑правил (например, граничные значения, отсутствие полей, неожиданные комбинации значений).
+# Mappers and data transformation
 
-# Требование к агенту
+- Data mapping functions (DTO → domain model and back), especially with computed fields and branches, must have unit tests.
+- In mapper tests, pay special attention to edge cases and business-rule regression (for example, boundary values, missing fields, unexpected value combinations).
 
-При добавлении тестов:
-- Следовать существующей структуре и паттернам тестов в репозитории: файл `*.spec.ts(x)` рядом с модулем или в общем каталоге тестов — как в соседних фичах.
-- Добавлять тесты для критичных веток логики и edge‑кейсов.
- - При работе с данными:
-   - использовать **типы респонса** из API (DTO‑типы), а также **целевые доменные типы** из `@/types`, не дублировать интерфейсы в тестах;
-   - по возможности опираться на данные и обработчики из `app/src/mocks/**` (или аналог в репо), а не плодить случайные тестовые данные "с нуля".
- - Размещение:
-   - для **компонентов UI** — **не создавать** поддиректорию `__tests__` внутри папки компонента; тест — соседний `*.spec.tsx`.
-   - в **других модулях** (например `api/services`) допустима уже существующая схема с `__tests__` — не ломать ради единообразия с UI.
-   - **новые** файлы — `*.spec.ts` / `*.spec.tsx` (см. блок «Имена файлов» выше).
+# Agent requirement
+
+When adding tests:
+- Follow existing test structure and patterns in the repository: `*.spec.ts(x)` next to the module or in a shared test directory — as in neighboring features.
+- Add tests for critical logic branches and edge cases.
+ - When working with data:
+   - use **response types** from the API (DTO types) and **target domain types** from `@/types`; do not duplicate interfaces in tests;
+   - when possible, rely on data and handlers from `app/src/mocks/**` (or repo equivalent), not ad-hoc random test data.
+ - Placement:
+   - for **UI components** — **do not create** a `__tests__` subdirectory inside the component folder; the test is a sibling `*.spec.tsx`.
+   - in **other modules** (for example `api/services`) an existing `__tests__` layout is acceptable — do not break it for UI uniformity.
+   - **new** files — `*.spec.ts` / `*.spec.tsx` (see "File names" above).
 ## Incorrect
 
 ```ts
 it('returns empty list when guest', () => {})
-it('Возвращает пустой список. пользователь не авторизован', () => {})
 ```
 
+- `it('Возвращает пустой список. пользователь не авторизован', () => {})` <!-- i18n-keep: E5 -->
+
 ## Correct
 
-```ts
-it('Возвращает пустой список. Пользователь не авторизован', () => {})
-```
+- `it('Возвращает пустой список. Пользователь не авторизован', () => {})` <!-- i18n-keep: E5 -->

package/presets/cursor/next/rules/types-jsdoc.mdc

@@ -1,42 +1,49 @@
 ---
-description: Стиль JSDoc для доменных и транспортных типов в app/src/types
+description: JSDoc style for domain and transport types in app/src/types
 globs: app/src/types/**/*.ts
 alwaysApply: false
 ---
 
-# Документация типов в `app/src/types`
+# Type documentation in `app/src/types`
 
-При добавлении или существенном изменении типов в этом слое **следовать уже принятому в репозитории стилю JSDoc** (см. примеры: `User.types.ts`, `Common.types.ts`, `ServerValidation.types.ts`, `TreatmentPlan/*.types.ts`).
+When adding or substantially changing types in this layer, **follow the JSDoc style already adopted in the repo** (see examples: `User.types.ts`, `Common.types.ts`, `ServerValidation.types.ts`, `TreatmentPlan/*.types.ts`).
 
-## Язык и форма
+## Language and form
 
-- Текст комментариев — **на русском**, кратко и по делу: что означает тип или поле в предметной области или в контракте с API.
-- **Не опираться** на теги в духе `@param`, `@returns`, `@see`, `@deprecated` для описания типов — в этом слое они **не используются**; достаточно обычного текста в `/** … */`.
+- Comment text — **in Russian** (repo locale convention for domain/API field descriptions), brief and to the point: what the type or field means in the domain or API contract.
+- **Do not rely** on tags like `@param`, `@returns`, `@see`, `@deprecated` for type descriptions — they are **not used** in this layer; plain text in `/** … */` is enough.
 
-## Экспортируемый `type` / `interface`
+## Exported `type` / `interface`
 
-- Сразу **перед объявлением** — блок `/** … */`.
-- Если нужно пояснить источник данных, ограничения или неочевидности — **второй абзац** в том же блоке (в JSDoc для абзаца — пустая строка между строками текста).
-- Для **вложенных** объектов в том же файле каждый такой тип документируется отдельным блоком над своим объявлением.
+- Immediately **before the declaration** — a `/** … */` block.
+- If you need to explain data source, constraints, or non-obvious details — a **second paragraph** in the same block (in JSDoc, separate paragraphs with a blank line between text lines).
+- For **nested** objects in the same file, document each type with its own block above its declaration.
 
-## Поля
+## Fields
 
-- У **каждого** публичного свойства — **однострочный** `/** … */` на строке непосредственно **над** полем.
-- Если поле **не приходит с бэкенда «как есть»**, а вычисляется или дополняется на фронте (маппер, селектор, UI) — начать описание с префикса **`[computed]`** (как в `TUserProfile`, типах плана лечения).
-- Для форматов данных указывать это **в тексте**: например дата `YYYY-MM-DD`, пример отображаемой строки в кавычках.
+- For **every** public property — a **single-line** `/** … */` on the line directly **above** the field.
+- If a field **does not come from the backend as-is** but is computed or enriched on the frontend (mapper, selector, UI) — start the description with the **`[computed]`** prefix (as in `TUserProfile`, treatment plan types).
+- For data formats, state this **in the text**: e.g. date `YYYY-MM-DD`, a display string example in quotes.
 
-## Классы и прочие объявления
+Example field comment (Russian locale — keep Cyrillic in type docs): <!-- i18n-keep: E5 -->
 
-- Для **классов** (например ошибки транспорта) при изменении публичного API — краткий блок над классом и **комментарии к публичным полям** по тем же правилам, что у свойств интерфейса.
+```ts
+/** Дата рождения в формате YYYY-MM-DD */ <!-- i18n-keep: E5 -->
+birthDate: string
+```
+
+## Classes and other declarations
+
+- For **classes** (e.g. transport errors), when changing public API — a brief block above the class and **comments on public fields** using the same rules as interface properties.
 
 ## `enum`
 
-- В `enums.ts` исторически часто **без JSDoc** на каждом члене; для новых enum допустимо короткое описание **над самим enum**, если назначение неочевидно из имени. Подписи для UI — как принято, через объекты `*Names` рядом с enum.
+- In `enums.ts`, members are often **without JSDoc** historically; for new enums a short description **above the enum** is acceptable if purpose is not obvious from the name. UI labels — as established, via `*Names` objects next to the enum.
 
-## Практика для агента
+## Agent practice
 
-- Добавляя новый тип или поле, **не оставлять** новые публичные поля без пояснения, если смысл не равен имени на 100%.
-- Правя файл, где уже есть такие комментарии, **поддерживать тот же стиль**, а не смешивать с англоязычными или «теговыми» блоками.
-- Не раздувать комментарии: одна-две фразы на тип, одна строка на поле — норма; исключение — действительно сложная доменная оговорка.
+- When adding a new type or field, **do not leave** new public fields unexplained if meaning is not 100% clear from the name.
+- When editing a file that already has such comments, **maintain the same style**, not mixed with English-only or tag-heavy blocks.
+- Do not bloat comments: one or two sentences per type, one line per field is normal; exception — a genuinely complex domain caveat.
 
-См. также импорты и barrel: `public-imports.mdc`.
+See also imports and barrel: `public-imports.mdc`.

package/presets/cursor/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 **`feature-delivery-workflow.mdc`** and **`reference-features.mdc`** — follow layer order and mirror closest reference feature.
 3. Add or update focused tests for changed behavior.
-4. Validation from `app/`: **invoke** **`post-change-lint.mdc`** after code edits (requestable, not always-on — but mandatory when code changed). Pipeline: scoped lint OK if next step is `build-verifier`.
+4. Validation from `app/`: **invoke** **`post-change-lint.mdc`** after code edits (requestable, not always-on — but **must** when code changed). Pipeline: scoped lint OK if next step is `build-verifier`.
 
 ## Scope discipline
 

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

@@ -1,6 +1,6 @@
 # Agent team artifacts
 
-Каталог артефактов пайплайна «команда агентов» Cursor.
+Artifact directory for the Cursor “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/cursor/nuxt/AGENTS.md

@@ -1,6 +1,6 @@
 # Nuxt 3 stack — Cursor agent team
 
-Краткая точка входа для Cursor. Подробные правила — `.cursor/rules/*.mdc`; сценарии — `.cursor/skills/**`.
+Short Cursor entry point. Detailed rules — `.cursor/rules/*.mdc`; scenarios — `.cursor/skills/**`.
 
 **Repo-root agents:** see [`AGENTS.md`](../../AGENTS.md) at the project root (cross-tool setup, commands, security, living conventions pointers).
 
@@ -8,23 +8,23 @@ See `.cursor/rules/README.md` for the full catalog and loading strategy.
 
 ## Quick start
 
-| Задача | Куда смотреть |
-|--------|----------------|
-| Любая новая work-задача | `/task` → `commands/task.md` + `agent-team-orchestrator.mdc` (+ `agent-team-intake.mdc` on-demand) |
-| Новая фича end-to-end | skill `feature-delivery` + `feature-delivery-workflow.mdc` |
-| Стек и слои | `nuxt-app-core.mdc` |
-| Эталонные фичи | `reference-features.mdc` (заполнить пути в репо) |
-| После правок кода | `post-change-lint.mdc` (**requestable**, но обязателен после edits; полный gate — `build-verifier`) |
+| Task | Where to look |
+|------|----------------|
+| Any new work task | `/task` → `commands/task.md` + `agent-team-orchestrator.mdc` (+ `agent-team-intake.mdc` on-demand) |
+| New end-to-end feature | skill `feature-delivery` + `feature-delivery-workflow.mdc` |
+| Stack and layers | `nuxt-app-core.mdc` |
+| Reference features | `reference-features.mdc` (fill in repo paths) |
+| After code edits | `post-change-lint.mdc` (**requestable**, but required after edits; full gate — `build-verifier`) |
 | Code review MR | skill `code-review` + `code-review-mr.mdc` |
 | Security (auth/forms/env) | `security-nuxt.mdc` + agent `security-reviewer` |
-| Валидация перед review | agent `build-verifier` |
-| Техническое ретро | `/technical-retro` + skill `technical-retro` |
+| Validation before review | agent `build-verifier` |
+| Technical retro | `/technical-retro` + skill `technical-retro` |
 
-## Когда использовать `/task`
+## When to use `/task`
 
-- Реализация, багфикс, миграция, тесты, ревью MR, CI-fix — **предпочтительно через `/task`**.
-- Простой one-liner без архитектурного риска — можно без pipeline, если пользователь явно просит.
-- Вопросы «как работает X» — agent `codebase-analyzer` (explain-as-is) или ответ без `/task`.
+- Implementation, bugfix, migration, tests, MR review, CI-fix — **prefer `/task`**.
+- Simple one-liner with no architecture risk — may skip the pipeline if the user explicitly asks.
+- “How does X work?” questions — agent `codebase-analyzer` (explain-as-is) or answer without `/task`.
 
 ## Pipeline routing
 
@@ -36,4 +36,4 @@ Intent detection, profiles (`full` / `standard` / `light`), and default steps
 npx @bonesofspring/ai-rules init cursor --preset nuxt
 ```
 
-Копирует rules, commands, agents, hooks, skills, team, `hooks.json`, `BUGBOT.md`, `AGENTS.md` → `.cursor/AGENTS.md`, `MCP.md`, `mcp.json` → `.cursor/mcp.json`, плюс `REPO_AGENTS.md` → корневой `AGENTS.md`. Skills: `write-adr`, `vue-performance` (on-demand).
+Copies rules, commands, agents, hooks, skills, team, `hooks.json`, `BUGBOT.md`, `AGENTS.md` → `.cursor/AGENTS.md`, `MCP.md`, `mcp.json` → `.cursor/mcp.json`, plus `REPO_AGENTS.md` → root `AGENTS.md`. Skills: `write-adr`, `vue-performance` (on-demand).

package/presets/cursor/nuxt/MCP.md

@@ -1,16 +1,16 @@
 # MCP (preset `nuxt`, Cursor)
 
-Копируется в `.cursor/mcp.json` при `ai-rules init cursor --preset nuxt`.
+Copied to `.cursor/mcp.json` on `ai-rules init cursor --preset nuxt`.
 
 ## Servers
 
-| Name | Package | Зачем |
-|------|---------|--------|
-| `context7` | `@upstash/context7-mcp` | Актуальная документация Vue/Nuxt/TS и библиотек (меньше устаревших API в ответах агента) |
-| `playwright` | `@playwright/mcp` | Browser automation для e2e агентов (`playwright-test-*`) и проверки селекторов |
-| `chrome-devtools` | `chrome-devtools-mcp` | Live DOM/network/performance при отладке UI |
-| `figma` | remote `https://mcp.figma.com/mcp` | Design context → код (макеты, токены, Code Connect); OAuth в Cursor |
+| Name | Package | Why |
+|------|---------|-----|
+| `context7` | `@upstash/context7-mcp` | Up-to-date Vue/Nuxt/TS and library docs (fewer stale APIs in agent replies) |
+| `playwright` | `@playwright/mcp` | Browser automation for e2e agents (`playwright-test-*`) and selector checks |
+| `chrome-devtools` | `chrome-devtools-mcp` | Live DOM/network/performance when debugging UI |
+| `figma` | remote `https://mcp.figma.com/mcp` | Design context → code (layouts, tokens, Code Connect); OAuth in Cursor |
 
-Секреты в файл не кладём. Опционально: `CONTEXT7_API_KEY` в окружении — выше rate limits у Context7. Figma — OAuth при первом подключении (токен в конфиг не пишем).
+Do not put secrets in the file. Optional: `CONTEXT7_API_KEY` in the environment — higher Context7 rate limits. Figma — OAuth on first connect (do not write the token into the config).
 
-После init: Settings → MCP → включить серверы (или перезапустить Cursor). Локально можно дополнять/переопределять; `init` перезаписывает одноимённый `mcp.json`.
+After init: Settings → MCP → enable servers (or restart Cursor). Locally you may extend/override; `init` overwrites the same-named `mcp.json`.

package/presets/cursor/nuxt/README.md

@@ -1,6 +1,6 @@
 # Nuxt 3 preset (Cursor)
 
-Правила и agent-team surface для Nuxt 3 / Vue / TypeScript.
+Rules and agent-team surface for Nuxt 3 / Vue / TypeScript.
 
 ## Install
 
@@ -8,15 +8,15 @@
 npx @bonesofspring/ai-rules init cursor --preset nuxt
 ```
 
-Копирует:
+Copies:
 
-| Path | Содержание |
-|------|------------|
+| Path | Contents |
+|------|----------|
 | `REPO_AGENTS.md` | → repo-root `AGENTS.md` (cross-tool) |
 | `AGENTS.md` | → `.cursor/AGENTS.md` quick-start |
-| `BUGBOT.md` | Cursor Bugbot review priorities (Next) |
+| `BUGBOT.md` | Cursor Bugbot review priorities |
 | `rules/**` | `.mdc` + README (alwaysApply ≤3); golden rules with Incorrect/Correct + `impact:` |
-| `agents/**` | **22** ролей (+ README; includes on-demand `codebase-analyzer`) |
+| `agents/**` | **22** roles (+ README; includes on-demand `codebase-analyzer`) |
 | `skills/**` | 9 skills (incl. `playwright-e2e`, `write-adr`, `vue-performance`) |
 | `commands/**` | task, task-continue, feature-start/continue, technical-retro |
 | `hooks.json` + `hooks/**` | guard-shell + chain-team-phases; optional `hooks/examples/` cookbook |
@@ -27,7 +27,7 @@ npx @bonesofspring/ai-rules init cursor --preset nuxt
 
 `nuxt-app-core`, `package-manager`, `code-quality-and-refactoring`.
 
-Requestable (не always-on): `post-change-lint`, `agent-team-*`, `code-review-mr`, `feature-delivery-workflow`, `reference-features`, domain globs.
+Requestable (not always-on): `post-change-lint`, `agent-team-*`, `code-review-mr`, `feature-delivery-workflow`, `reference-features`, domain globs.
 
 ## Preset taxonomy & contributing
 
@@ -38,10 +38,10 @@ Requestable (не always-on): `post-change-lint`, `agent-team-*`, `code-review-m
 
 ## Sync with Claude
 
-SoT = этот Cursor-пресет. После правок `.mdc` / agents / skills — обновить twin в `presets/claude/nuxt/` **в том же PR**.
+SoT = this Cursor preset. After edits to `.mdc` / agents / skills — update the twin in `presets/claude/nuxt/` **in the same PR**.
 
-`BUGBOT.md` — **Cursor-only** (нет Claude twin); для Claude Code — skill `code-review` + `tooling-and-review/code-review.md`.
+`BUGBOT.md` — **Cursor-only** (no Claude twin); for Claude Code — skill `code-review` + `tooling-and-review/code-review.md`.
 
 Claude→Cursor map: `presets/claude/nuxt/rules/README.md`.
 
-См. также `AGENTS.md`.
+See also `AGENTS.md`.

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

@@ -1,45 +1,45 @@
 # `.cursor/agents` (preset nuxt)
 
-Ролевые subagents для командного пайплайна Cursor.
+Role subagents for the Cursor team pipeline.
 
 ## Planning and routing
 
-| Agent | Файл | Production-код |
-|-------|------|----------------|
+| Agent | File | Production code |
+|-------|------|-----------------|
 | Router | `task-router.md` | no |
-| Аналитик | `task-analyst.md` | no |
-| Архитектор | `solution-architect.md` | no |
+| Analyst | `task-analyst.md` | no |
+| Architect | `solution-architect.md` | no |
 | Migration planner | `migration-specialist.md` | no |
 | API contract reviewer | `api-contract-reviewer.md` | no |
 
 ## Analysis (on-demand)
 
-| Agent | Файл | Production-код |
-|-------|------|----------------|
+| Agent | File | Production code |
+|-------|------|-----------------|
 | Codebase analyzer | `codebase-analyzer.md` | no (explain-as-is only) |
 
 ## Implementation and CI
 
-| Agent | Файл | Production-код |
-|-------|------|----------------|
+| Agent | File | Production code |
+|-------|------|-----------------|
 | Debugger | `debugger.md` | minimal fix only |
 | CI investigator | `ci-investigator.md` | minimal CI fix only |
 | Build verifier | `build-verifier.md` | no |
-| Разработчик | `feature-developer.md` | yes |
+| Developer | `feature-developer.md` | yes |
 
 ## Review specialists
 
-| Agent | Файл | Production-код |
-|-------|------|----------------|
-| Ревьюер | `code-reviewer.md` | no |
+| Agent | File | Production code |
+|-------|------|-----------------|
+| Reviewer | `code-reviewer.md` | no |
 | A11y reviewer | `accessibility-reviewer.md` | no |
 | Security reviewer | `security-reviewer.md` | no |
 | Performance auditor | `performance-auditor.md` | no |
 
 ## Testing
 
-| Agent | Файл | Production-код |
-|-------|------|----------------|
+| Agent | File | Production code |
+|-------|------|-----------------|
 | QA | `qa-tester.md` | tests only |
 | Unit planner | `unit-test-planner.md` | no |
 | Unit generator | `unit-test-generator.md` | tests only |
@@ -50,21 +50,21 @@
 
 ## Documentation
 
-| Agent | Файл | Production-код |
-|-------|------|----------------|
+| Agent | File | Production code |
+|-------|------|-----------------|
 | Tech writer | `tech-writer.md` | docs only |
 
-Копируется в `.cursor/agents/` при `ai-rules init cursor --preset nuxt`.
+Copied to `.cursor/agents/` on `ai-rules init cursor --preset nuxt`.
 
 ## Frontmatter `readonly`
 
-Все agents пайплайна — **`readonly: false`**. Им нужна запись в `.cursor/team/**` (`pipeline.json`, `brief.md`, `review.md`, `status.json`, …).
+All pipeline agents are **`readonly: false`**. They need write access under `.cursor/team/**` (`pipeline.json`, `brief.md`, `review.md`, `status.json`, …).
 
-Ограничение «не трогать production / `app/**`» задаётся **в теле промпта**, не флагом `readonly`. В Cursor `readonly: true` блокирует *любые* file edits (включая team) — для team-агентов это ломает пайплайн.
+The “do not touch production / `app/**`” limit is set **in the prompt body**, not via the `readonly` flag. In Cursor `readonly: true` blocks *any* file edits (including team) — that breaks the pipeline for team agents.
 
 ## Model matrix (frontmatter `model`)
 
-SoT по умолчанию — YAML `model` в каждом agent-файле. Опциональный `steps[].model` (`cheap` \| `standard` \| `strong`) переопределяет тир на шаге пайплайна (см. `task-router.md`, `agent-team-orchestrator.mdc`).
+Default SoT — YAML `model` in each agent file. Optional `steps[].model` (`cheap` \| `standard` \| `strong`) overrides the tier for a pipeline step (see `task-router.md`, `agent-team-orchestrator.mdc`).
 
 | Tier | Default frontmatter | Agents |
 |------|---------------------|--------|
@@ -74,20 +74,20 @@ SoT по умолчанию — YAML `model` в каждом agent-файле.
 
 **Notes**
 
-- `inherit` = модель parent-чата (обычно сильнее `fast`).
+- `inherit` = parent-chat model (usually stronger than `fast`).
 - Strong pin uses Cursor bracket options (`[effort=high]`). If the ID is blocked by plan/admin, Cursor falls back to a compatible model.
 - Alternate strong pin when Opus unavailable: `composer-2.5[fast=false]` (edit frontmatter locally).
 - Never put `strong` on `build-verifier` / `tech-writer` / `task-router`.
 
-## Оркестрация
+## Orchestration
 
-| Command | Назначение |
-|---------|------------|
-| `/task <desc>` | Router → dynamic pipeline → первый agent |
-| `/task-continue <slug>` | После human gate |
-| `/feature-start`, `/feature-continue` | Legacy (совместимость) |
+| Command | Purpose |
+|---------|---------|
+| `/task <desc>` | Router → dynamic pipeline → first agent |
+| `/task-continue <slug>` | After a human gate |
+| `/feature-start`, `/feature-continue` | Legacy (compatibility) |
 
-Правило: `agent-team-orchestrator.mdc`. План: `pipeline.json` в `.cursor/team/tasks/<slug>/`.
+Rule: `agent-team-orchestrator.mdc`. Plan: `pipeline.json` under `.cursor/team/tasks/<slug>/`.
 
 ## Pipeline routing
 
@@ -129,7 +129,7 @@ SoT по умолчанию — YAML `model` в каждом agent-файле.
   "steps": [
     { "agent": "task-analyst", "label": "Clarify and decompose" },
     { "agent": "feature-developer", "label": "Implement + unit tests", "scope": "unit-in-dev" },
-    { "agent": "build-verifier", "label": "Lint, typecheck, unit smoke" },
+    { "agent": "build-verifier", "label": "Lint, check, unit smoke" },
     { "agent": "code-reviewer", "label": "Code review" }
   ],
   "humanGates": ["after:task-analyst"],

package/presets/cursor/nuxt/agents/feature-developer.md

@@ -17,7 +17,7 @@ You are a senior frontend developer working in a Nuxt 3 monorepo with strict lay
 ## Task execution rules
 
 - Do **not** start blocked tasks or tasks with incomplete dependencies.
-- **Unit tests mandatory before handoff** for mappers, store logic, and non-trivial pure functions.
+- **Unit tests must run before handoff** for mappers, store logic, and non-trivial pure functions.
 - Mark completed tasks in `decomposition.md`.
 - Validation: **`post-change-lint.mdc`**. If pipeline next step is **`build-verifier`**, scoped lint/typecheck on **changed files** is enough; full project lint is build-verifier's job.
 

package/presets/cursor/nuxt/agents/task-analyst.md

@@ -9,7 +9,7 @@ You are a senior business/technical analyst for a Nuxt 3 frontend team.
 
 Your job is to reach **Definition of Ready (DoR)** before any implementation starts. You may write only `.cursor/team/**` artifacts. You do **not** write production code or modify application source files.
 
-## Clarification cycle (mandatory)
+## Clarification cycle (must)
 
 1. Rephrase the task in your own words (goal, user value, boundaries).
 2. Ask **1–3 questions per iteration** — never more than 3 at once.

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

@@ -17,20 +17,20 @@ You are a task router for a Nuxt 3 frontend agent team. You **do not** implement
 
 | intent | Signals in prompt | Default steps |
 |--------|-------------------|---------------|
-| `feature` | «добавь», «новая», «реализуй», «сделай», new UI/API/store | task-analyst → feature-developer (unit-in-dev) → build-verifier → code-reviewer → qa-tester (e2e-only) or playwright trio |
-| `bugfix` | «баг», «fix», «не работает», «падает», «ошибка», regression | debugger → feature-developer (skipIf debugger.fixed) → build-verifier → code-reviewer → qa-tester (regression) |
-| `ci-fix` | «CI», «упал пайплайн», «красный PR», «failing check», «lint в CI» | ci-investigator → feature-developer (skipIf ci-investigator.resolved) → build-verifier → code-reviewer |
-| `migration` | «миграция», «upgrade», «обнови Next», «переход на», major version | task-analyst → migration-specialist → feature-developer → build-verifier → code-reviewer → qa-tester (regression) |
-| `perf-audit` | «производительность», «perf», «bundle», «LCP», «медленно», «waterfall» | performance-auditor |
-| `a11y` | «a11y», «доступность», «accessibility», «WCAG», «screen reader», «клавиатура» | task-analyst → feature-developer → build-verifier → accessibility-reviewer → code-reviewer |
-| `review-only` | «ревью», «review MR», «проверь diff», «code review» | code-reviewer |
-| `test-only` | «покрой тестами», «напиши тесты» (mixed unit+e2e, no impl) | task-analyst → qa-tester |
-| `unit-only` | «unit», «юнит», «mapper tests», «покрой маппер», «почини unit» | unit-test-planner → unit-test-generator, or unit-test-healer |
-| `e2e-only` | «e2e», «playwright», «browser test», «сценарии e2e», «почини e2e» | playwright-test-planner → playwright-test-generator, or playwright-test-healer |
-| `docs-only` | «документация», «README», «changelog», «ADR», «migration guide» | task-analyst → tech-writer |
-| `refactor` | «рефакторинг», «без изменения поведения», «почисти» | task-analyst → feature-developer → build-verifier → code-reviewer |
-| `spike` | «исследуй», «оцени», «можно ли», «spike», proof of concept | task-analyst → solution-architect |
-| `retro` | «ретро», «разбор», «postmortem» | (no pipeline — orchestrator runs `/technical-retro`) |
+| `feature` | «добавь» (add), «новая» (new), «реализуй» (implement), «сделай» (do/build), new UI/API/store | task-analyst → feature-developer (unit-in-dev) → build-verifier → code-reviewer → qa-tester (e2e-only) or playwright trio | <!-- i18n-keep: E4 -->
+| `bugfix` | «баг» (bug), «fix», «не работает» (doesn't work), «падает» (crashes), «ошибка» (error), regression | debugger → feature-developer (skipIf debugger.fixed) → build-verifier → code-reviewer → qa-tester (regression) | <!-- i18n-keep: E4 -->
+| `ci-fix` | «CI», «упал пайплайн» (pipeline failed), «красный PR» (red PR), «failing check», «lint в CI» (lint in CI) | ci-investigator → feature-developer (skipIf ci-investigator.resolved) → build-verifier → code-reviewer | <!-- i18n-keep: E4 -->
+| `migration` | «миграция» (migration), «upgrade», «обнови Nuxt» (upgrade Nuxt), «переход на» (move to), major version | task-analyst → migration-specialist → feature-developer → build-verifier → code-reviewer → qa-tester (regression) | <!-- i18n-keep: E4 -->
+| `perf-audit` | «производительность» (performance), «perf», «bundle», «LCP», «медленно» (slow), «waterfall» | performance-auditor | <!-- i18n-keep: E4 -->
+| `a11y` | «a11y», «доступность» (accessibility), «accessibility», «WCAG», «screen reader», «клавиатура» (keyboard) | task-analyst → feature-developer → build-verifier → accessibility-reviewer → code-reviewer | <!-- i18n-keep: E4 -->
+| `review-only` | «ревью» (review), «review MR», «проверь diff» (check diff), «code review» | code-reviewer | <!-- i18n-keep: E4 -->
+| `test-only` | «покрой тестами» (cover with tests), «напиши тесты» (write tests) (mixed unit+e2e, no impl) | task-analyst → qa-tester | <!-- i18n-keep: E4 -->
+| `unit-only` | «unit», «юнит» (unit), «mapper tests», «покрой маппер» (cover mapper), «почини unit» (fix unit) | unit-test-planner → unit-test-generator, or unit-test-healer | <!-- i18n-keep: E4 -->
+| `e2e-only` | «e2e», «playwright», «browser test», «сценарии e2e» (e2e scenarios), «почини e2e» (fix e2e) | playwright-test-planner → playwright-test-generator, or playwright-test-healer | <!-- i18n-keep: E4 -->
+| `docs-only` | «документация» (documentation), «README», «changelog», «ADR», «migration guide» | task-analyst → tech-writer | <!-- i18n-keep: E4 -->
+| `refactor` | «рефакторинг» (refactoring), «без изменения поведения» (no behavior change), «почисти» (clean up) | task-analyst → feature-developer → build-verifier → code-reviewer | <!-- i18n-keep: E4 -->
+| `spike` | «исследуй» (investigate), «оцени» (estimate), «можно ли» (is it possible), «spike», proof of concept | task-analyst → solution-architect | <!-- i18n-keep: E4 -->
+| `retro` | «ретро» (retro), «разбор» (postmortem), «postmortem» | (no pipeline — orchestrator runs `/technical-retro`) | <!-- i18n-keep: E4 -->
 
 ## Pipeline profiles
 
@@ -40,9 +40,9 @@ Set optional top-level `"profile": "full" | "standard" | "light"` in `pipeline.j
 |---------|------|------------------------|
 | `full` | Multi-layer, new public API, e2e coverage needed, incomplete AC | analyst → [architect] → developer → build-verifier → reviewer → qa-tester |
 | `standard` | Single layer, default work | analyst → developer → build-verifier → reviewer |
-| `light` | Trivial: one file/layer, explicit AC, «просто поправь», «typo», user «без pipeline» | developer → build-verifier |
+| `light` | Trivial: one file/layer, explicit AC, «просто поправь» (just fix it), «typo», user «без pipeline» (without pipeline) | developer → build-verifier | <!-- i18n-keep: E4 -->
 
-**Light signals:** один файл, один слой, явный AC в промпте, нет архитектурного риска. **Never skip `build-verifier`** after developer when `app/**` changed. **Skip `code-reviewer`** in light only for non-prod preset/docs tasks — for `pages/components/stores` changes prefer standard.
+**Light signals:** one file, one layer, explicit AC in prompt, no architectural risk. **Never skip `build-verifier`** after developer when `app/**` changed. **Skip `code-reviewer`** in light only for non-prod preset/docs tasks — for `app/src` changes prefer standard.
 
 **Light by intent:**