@bonesofspring/ai-rules 0.2.14 → 0.2.15

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

@@ -6,37 +6,37 @@ alwaysApply: false
 impact: MEDIUM
 ---
 
-# Общие правила тестирования
+# Shared testing rules
 
-- **Имена файлов:** новые тесты — **`*.spec.ts`**. Существующие `*.test.ts` не переименовывать без задачи.
-- **Runner:** Vitest (или как в проекте). Компоненты — **`@testing-library/svelte`** (не `@vue/test-utils`, не React Testing Library as default).
-- Проверять **поведение**, не внутренности.
-- **Именование** `describe` / `it`: формулировки **на русском**, каждое предложение с заглавной (как в ESLint `jest/valid-title` если включён).
+- **File names:** new tests — **`*.spec.ts`**. Do not rename existing `*.test.ts` without a task.
+- **Runner:** Vitest (or as in the project). Components — **`@testing-library/svelte`** (not `@vue/test-utils`, not React Testing Library as default).
+- Assert **behavior**, not internals.
+- **`describe` / `it` naming:** formulate titles **in Russian**, each sentence capitalized (as with ESLint `jest/valid-title` if enabled). <!-- i18n-keep: E5 -->
 
 ```typescript
 // ✅
-it('Возвращает пустой список. Пользователь не авторизован', () => {})
+it('Возвращает пустой список. Пользователь не авторизован', () => {}) // <!-- i18n-keep: E5 -->
 
 // ❌
 it('Returns empty list when user is guest', () => {})
 ```
 
-# Компоненты
+# Components
 
-- `render` из `@testing-library/svelte`.
-- Взаимодействия: `userEvent` из `@testing-library/user-event` когда принято в репо.
+- `render` from `@testing-library/svelte`.
+- Interactions: `userEvent` from `@testing-library/user-event` when that is the repo convention.
 
-# Изоляция
+# Isolation
 
-- Мокать `$lib/api` / stores по паттерну соседей.
-- Не мокать публичный контракт фичи без нужды.
+- Mock `$lib/api` / stores per neighbor patterns.
+- Do not mock the feature’s public contract without need.
 
 # HTTP / mappers
 
-- Изменения общего HTTP‑клиента — behavior‑тесты рядом с `src/lib/clients/**`.
-- Мапперы DTO→domain — unit‑тесты на edge‑кейсы.
+- Changes to the shared HTTP client — behavior tests next to `src/lib/clients/**`.
+- DTO→domain mappers — unit tests for edge cases.
 
-# Размещение
+# Placement
 
-- UI: соседний `*.spec.ts` (не обязательный `__tests__/` внутри компонента).
-- Другие модули — как у соседей.
+- UI: neighboring `*.spec.ts` (no required `__tests__/` inside the component).
+- Other modules — as neighbors do.

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

@@ -1,42 +1,42 @@
 ---
-description: Стиль JSDoc для доменных и транспортных типов в types
+description: JSDoc style for domain and transport types under types
 globs: src/lib/types/**/*.ts
 alwaysApply: false
 ---
 
-# Документация типов в `types`
+# Type documentation in `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 used in the repository** (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**, short 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 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 bits — a **second paragraph** in the same block (blank line between paragraphs in JSDoc).
+- For **nested** objects in the same file, each such type gets its own block above its declaration.
 
-## Поля
+## Fields
 
-- У **каждого** публичного свойства — **однострочный** `/** … */` на строке непосредственно **над** полем.
-- Если поле **не приходит с бэкенда «как есть»**, а вычисляется или дополняется на фронте (маппер, селектор, UI) — начать описание с префикса **`[computed]`** (как в `TUserProfile`, типах плана лечения).
-- Для форматов данных указывать это **в тексте**: например дата `YYYY-MM-DD`, пример отображаемой строки в кавычках.
+- Every **public** property — a **one-line** `/** … */` on the line immediately **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 that **in the text**: e.g. date `YYYY-MM-DD`, example display string in quotes.
 
-## Классы и прочие объявления
+## Classes and other declarations
 
-- Для **классов** (например ошибки транспорта) при изменении публичного API — краткий блок над классом и **комментарии к публичным полям** по тем же правилам, что у свойств интерфейса.
+- For **classes** (e.g. transport errors), when changing the public API — a short block above the class and **comments on public fields** by the same rules as interface properties.
 
 ## `enum`
 
-- В `enums.ts` исторически часто **без JSDoc** на каждом члене; для новых enum допустимо короткое описание **над самим enum**, если назначение неочевидно из имени. Подписи для UI — как принято, через объекты `*Names` рядом с enum.
+- In `enums.ts` historically often **without JSDoc** on each member; for new enums a short description **above the enum itself** is OK if purpose is not obvious from the name. UI labels — as usual, 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 the meaning is not 100% equal to the name.
+- When editing a file that already has such comments, **keep the same style**, do not mix with English or “tag-style” blocks.
+- Do not inflate comments: one–two phrases per type, one line per field — normal; exception — a truly complex domain caveat.
 
-См. также импорты и barrel: `public-imports.mdc`.
+See also imports and barrel: `public-imports.mdc`.

package/presets/cursor/svelte/skills/feature-delivery/SKILL.md

@@ -8,7 +8,7 @@ description: Delivers SvelteKit frontend features end-to-end across domain types
 1. Read task brief, acceptance criteria, and decomposition if present.
 2. Read **`feature-delivery-workflow`** and **`reference-features`** — follow layer order and mirror closest reference feature.
 3. Add or update focused tests for changed behavior.
-4. Validation from SvelteKit root: **invoke** **`post-change-lint`** 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 SvelteKit root: **invoke** **`post-change-lint`** 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/svelte/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>
 ```