@bonesofspring/ai-rules 0.1.42 → 0.2.0

package/presets/claude/next/rules/architecture/feature-delivery-workflow.md

@@ -1,59 +1,28 @@
 ---
 paths:
-  - app/src/**/*
+  - app/src/ui/**/*
+  - app/src/store/**/*
+  - app/src/api/**/*
+  - app/src/types/**/*
 ---
 
 # Доставка фичи (сквозной порядок)
 
-Типичная фича с данными с backend и общим состоянием. Детали слоёв — в `architecture/architecture-boundaries.md`, `stack/next-app-core.md`.
-
-Плейсхолдеры: `<FeatureName>`, `<ServiceRoot>`, `<Area>` — нейтральные имена; реальные имена брать из соседних фич того же типа.
-
-## Инварианты перед кодом
-
-- Найти в том же слое фичу сопоставимой сложности и **повторить структуру каталогов и паттерн именования**.
-- Не добавлять `any`; при необходимости — `unknown` и сужение типа.
-- После правок — **`tooling-and-review/post-change-lint.md`**: `lint:js` + `lint:css` + `type-check`; менеджер пакетов — `tooling-and-review/package-manager.md`.
+Типичная фича с данными с backend и общим состоянием. Детали слоёв — `architecture/architecture-boundaries.md`, `stack/next-app-core.md`.
 
 ## Чеклист (порядок работ)
 
-1. **Доменные типы** — `app/src/types/**`, экспорт через barrel `app/src/types/index.ts` (`architecture/types-public-imports.md`, **`architecture/layer-barrel-exports.md`**); JSDoc полей — `stack/types-jsdoc.md`.
-2. **Контракт API** — DTO ответов/запросов там, где принято в репо; целевые доменные типы в `@/types`.
-3. **Мапперы** — DTO → домен в `*responseMappers.ts` или аналоге; чистые функции (`api-and-data/api-services.md`).
-4. **Сервисы** — `app/src/api/services/<ServiceRoot>/<Segment>/`: вызовы только через прикладные клиенты `app/src/api/clients/**`, public API модуля (`api-and-data/api-services.md`, `api-and-data/http-client.md`, **`architecture/layer-barrel-exports.md`**). Без `fetch` из UI/store. Новые публичные экспорты (фасады, типы, **константы путей** для моков) — в **`app/src/api/index.ts`** (`@/api`).
-5. **Моки (MSW)** — `app/src/mocks/data/<feature>/`: `data.ts`, `handlers.ts`; собрать хендлеры в **`app/src/mocks/handlers.ts`**. В хендлерах — **те же константы путей**, что и в API (импорт из `@/api`), **не дублировать сырые строки URL**. В репозитории могут быть **два контура** (браузерный worker и Node `setupServer` для тестов): общий список хендлеров должен оставаться согласованным — при добавлении проверять входные точки в `app/src/mocks/**`. Точка входа регистрации (например `app/src/mocks/index.js`).
-6. **Состояние** — `app/src/store/slices/<FeatureName>/`: `createSlice` / `createAsyncThunk`, доменные модели в state (`api-and-data/store-rtk.md`); thunk вызывает сервисы из `@/api`. Подключить редюсер в **`app/src/store/reducers.ts`**. Новый **middleware**: `app/src/store/middleware/**`, регистрация в **`app/src/store/index.ts`** в цепочке `configureStore` (порядок `prepend`/`concat` — как у соседних middleware).
-7. **UI** — `app/src/ui/pages/<FeatureName>Page/**` и/или `app/src/ui/components/**`; стили — как в проекте; тонкие компоненты, типы из `@/types`, без DTO (`ui-and-accessibility/react-ui.md`, `architecture/architecture-boundaries.md`, `ui-and-accessibility/no-props-spread.md`). Данные и загрузка — через store/hooks, без прямого HTTP.
-8. **Unit‑тесты** — `*.spec.ts` / `*.spec.tsx` (`testing/tests-unit.md`); мапперы и нетривиальная логика — обязательно; e2e Jest не запускает (см. `jest.config.js`). При смене HTTP‑клиента — behavior‑тесты (`api-and-data/http-client.md`).
-9. **E2E** — план: `app/__tests__/e2e/<Area>/<plan>.cases.md`; реализация: `*.spec.ts` рядом (`testing/tests-e2e-structure.md`, `testing/playwright-agents.md`).
-10. **Завершение** — **`tooling-and-review/post-change-lint.md`**: из `app/` обязательно `lint:js` + `lint:css` (полный прогон), затем `type-check`.
+1. **Доменные типы** — `app/src/types/**`, barrel (`architecture/public-imports.md`, **`architecture/layer-barrel-exports.md`**); JSDoc — `stack/types-jsdoc.md`.
+2. **Контракт API** — DTO там, где принято; доменные типы в `@/types`.
+3. **Мапперы** — DTO → домен (`api-and-data/api-services.md`).
+4. **Сервисы** — клиенты `app/src/api/clients/**`, barrel `@/api` (`api-and-data/api-services.md`, `api-and-data/http-client.md`, **`architecture/layer-barrel-exports.md`**).
+5. **Состояние** — slice/thunk (`api-and-data/store-rtk.md`); thunk → `@/api`.
+6. **UI** — `@/types`, без DTO (`ui-and-accessibility/react-ui.md`, `architecture/architecture-boundaries.md`, `ui-and-accessibility/no-props-spread.md`).
+7. **Моки** — `app/src/mocks/**`; регистрация в `handlers.ts` (см. ниже).
+8. **Тесты** — unit (`testing/tests-unit.md`); e2e (`testing/tests-e2e-structure.md`, `testing/playwright-agents.md`).
+9. **Завершение** — **`tooling-and-review/post-change-lint.md`**.
 
-## Полный flow (слой за слоем)
-
-```mermaid
-flowchart LR
-  typesNode["types_domain"]
-  apiNode["api_services_mappers"]
-  mocksNode["mocks_msw"]
-  storeNode["store_slice_thunks"]
-  mwNode["middleware_optional"]
-  uiNode["ui_pages_components"]
-  unitNode["unit_tests"]
-  e2eNode["e2e_plans_specs"]
-
-  typesNode --> apiNode
-  apiNode --> mocksNode
-  apiNode --> storeNode
-  storeNode --> mwNode
-  storeNode --> uiNode
-  apiNode --> unitNode
-  storeNode --> unitNode
-  uiNode --> unitNode
-  uiNode --> e2eNode
-  mocksNode --> e2eNode
-```
-
-## Поток данных (ориентир)
+## Поток данных
 
 ```mermaid
 flowchart LR
@@ -69,36 +38,42 @@ flowchart LR
   Store --> UI[UI]
 ```
 
-## Частичные сценарии (вход с середины)
+## Регистрация по слоям
+
+1. **Типы** — `app/src/types/**`.
+2. **API** — `app/src/api/services/<ServiceRoot>/<Segment>/`; публичные экспорты → **`app/src/api/index.ts`**.
+3. **Моки** — `app/src/mocks/data/<feature>/`; **`app/src/mocks/handlers.ts`**; пути из `@/api`.
+4. **Store** — `app/src/store/slices/<FeatureName>/`; **`app/src/store/reducers.ts`**; middleware → **`app/src/store/index.ts`**.
+5. **UI** — pages/components; store/hooks.
+6. **Unit** — `*.spec.ts(x)`; мапперы обязательно.
+7. **E2E** — `app/__tests__/e2e/<Area>/<plan>.cases.md` + spec.
+
+## Частичные сценарии
 
 | Задача | Минимум действий |
 |--------|------------------|
-| Только API + типы | Типы в `app/src/types/**`, сервис и мапперы, реэкспорт в `app/src/api/index.ts`; unit на маппер. |
-| Только моки | Константа пути уже в `@/api`; `handlers.ts` + данные; регистрация в `app/src/mocks/handlers.ts`; при необходимости убедиться, что хендлеры подхватываются и в браузерном, и в Node‑контуре MSW. |
-| Только store | Thunk на существующий метод `@/api`; slice + `app/src/store/reducers.ts`. |
-| Только UI | Читать готовое состояние из store; не добавлять HTTP/DTO; `data-testid` при необходимости для e2e. |
-| Только e2e | Синхронизировать `*.cases.md` и спеки; page object и `_shared`. |
+| Только API + типы | Типы, сервис, мапперы, `@/api` barrel; unit на маппер. |
+| Только моки | Путь в `@/api`; handlers + `mocks/handlers.ts`. |
+| Только store | Thunk на `@/api`; slice + `reducers.ts`. |
+| Только UI | Store state; без HTTP/DTO. |
+| Только e2e | `*.cases.md` + spec. |
 
 ## Антипаттерны
 
-- DTO и структуры ответа бэкенда в UI или в нетипизированных кусках store.
-- Прямой вызов HTTP‑клиента из компонента или thunk’а в обход сервисного слоя.
-- Deep‑импорты в `app/src/api/services/**/…` из UI/store там, где принят импорт из `@/api`.
-- Проброс пропсов в компоненты через `{...props}` — см. `ui-and-accessibility/no-props-spread.md`.
+- DTO в UI или нетипизированном store.
+- HTTP-клиент из компонента/thunk в обход сервиса.
+- Deep-import `@/api/services/**` из UI/store.
+- `{...props}` — `ui-and-accessibility/no-props-spread.md`.
 
-## Матрица: что меняю → какие правила перечитать
+## Матрица: зона → правила
 
-| Зона в репозитории | Правила (`.claude/rules/`) |
-|--------------------|----------------------------|
-| `app/src/api/clients/**`, `app/src/lib/clients/**` | `api-and-data/http-client.md`; при изменении клиента — `testing/tests-unit.md` |
-| `app/src/api/services/**` | `api-and-data/api-services.md`, `architecture/layer-barrel-exports.md`; при необходимости `api-and-data/http-client.md` |
-| `app/src/store/**` | `api-and-data/store-rtk.md`, `architecture/architecture-boundaries.md`, `architecture/api-public-imports.md` |
-| `app/src/ui/**` | `ui-and-accessibility/react-ui.md`, `ui-and-accessibility/no-props-spread.md`, `architecture/types-public-imports.md`, `architecture/api-public-imports.md` |
-| `app/src/types/**` | `architecture/types-public-imports.md`, `stack/types-jsdoc.md`, `architecture/layer-barrel-exports.md` |
+| Зона | Правила |
+|------|---------|
+| `app/src/api/clients/**`, `app/src/lib/clients/**` | `api-and-data/http-client.md`, `testing/tests-unit.md` |
+| `app/src/api/services/**` | `api-and-data/api-services.md`, `architecture/layer-barrel-exports.md` |
+| `app/src/store/**` | `api-and-data/store-rtk.md`, `architecture/architecture-boundaries.md`, `architecture/public-imports.md` |
+| `app/src/ui/**` | `ui-and-accessibility/react-ui.md`, `ui-and-accessibility/no-props-spread.md`, `architecture/public-imports.md` |
+| `app/src/types/**` | `architecture/public-imports.md`, `stack/types-jsdoc.md`, `architecture/layer-barrel-exports.md` |
 | `app/__tests__/e2e/**` | `testing/tests-e2e-structure.md`, `testing/playwright-agents.md` |
 
-Path-scoped правила подгружаются при работе с соответствующими файлами; эта матрица нужна, когда открыт другой файл или идёт общий чат.
-
-## Требование к агенту
-
-При добавлении или существенном расширении фичи **пройти чеклист сверху** и при правках в зоне из таблицы **ориентироваться на указанные правила**, не смешивать слои и не обходить public API модулей.
+При добавлении или расширении фичи **пройти чеклист** и правила из таблицы для затронутых зон.

package/presets/claude/next/rules/architecture/layer-barrel-exports.md

@@ -10,7 +10,7 @@ paths:
 Для **любого слоя** (каталога, пакета, bounded context), у которого:
 
 - есть **корневой barrel** — единая точка импорта для внешних потребителей;
-- deep-импорты внутрь слоя **запрещены** снаружи (ESLint `no-restricted-imports`, правила `architecture/*-public-imports.md`).
+- deep-импорты внутрь слоя **запрещены** снаружи (ESLint `no-restricted-imports`, правила `architecture/public-imports.md`).
 
 Примеры alias/entry point в разных проектах: `@/api`, `@/types`, `@/core`, `@/store`, `packages/foo`.
 
@@ -33,7 +33,7 @@ paths:
 
 При добавлении или существенном расширении **модуля внутри регламентированного слоя**:
 
-1. Определить слой, его **корневой barrel** и доп. entry points (`architecture/*-public-imports.md`).
+1. Определить слой, его **корневой barrel** и доп. entry points (`architecture/public-imports.md`).
 2. Создать/обновить **локальный** `index.ts` — только публичные символы.
 3. Если в слое есть **фасад/агрегатор** (`*ApiService.ts`, `rootReducer`, …) — подключить модуль там.
 4. Добавить **реэкспорт** новых публичных символов в **корневой barrel** слоя.
@@ -43,7 +43,7 @@ paths:
 
 ## Как найти регламентированные слои в репозитории
 
-1. Правила `architecture/*-public-imports.md` в `.claude/rules/architecture/`.
+1. Правила `architecture/public-imports.md` в `.claude/rules/architecture/`.
 2. ESLint `no-restricted-imports` — паттерны `@/<layer>/*` с исключением barrel.
 3. `architecture/architecture-boundaries.md`, README проекта.
 
@@ -51,8 +51,8 @@ paths:
 
 | Слой | Корневой barrel | Правило импортов |
 |------|-----------------|------------------|
-| API | `app/src/api/index.ts` | `architecture/api-public-imports.md` |
-| Types | `app/src/types/index.ts` | `architecture/types-public-imports.md` (+ `@/types/enums`) |
+| API | `app/src/api/index.ts` | `architecture/public-imports.md` |
+| Types | `app/src/types/index.ts` | `architecture/public-imports.md` (+ `@/types/enums`) |
 | Core | `app/src/core/index.ts` | ESLint: `@/core/index` |
 
 Иллюстрация двух уровней (API): локальный `services/.../<Feature>/index.ts` → фасад `*ApiService.ts` → `app/src/api/index.ts`.

package/presets/claude/next/rules/architecture/public-imports.md

@@ -0,0 +1,46 @@
+---
+paths:
+  - app/src/ui/**/*
+  - app/src/store/**/*
+  - app/src/lib/**/*
+  - app/src/types/**/*
+  - app/src/api/**/*
+---
+
+# Публичные импорты (`@/types`, `@/api`)
+
+**Коллизии:** импорт типов — раздел `@/types`; API вне `app/src/api/**` — раздел `@/api` (дублирует ESLint `no-restricted-imports`).
+
+## `@/types`
+
+- **Публичный API типов** — barrel `app/src/types/index.ts`; импортировать типы только как `@/types` (или `@/types/index`).
+- **Запрещено** обходить barrel: `@/types/<что‑угодно>`, кроме enum.
+- **Enum** — только `@/types/enums` / `@/types/enums.ts`.
+- Внутри `app/src/types/**` — относительные импорты между файлами слоя.
+
+```typescript
+// ✅
+import type { TUserProfile } from '@/types'
+import { SomeEnum } from '@/types/enums'
+
+// ❌
+import type { TUserProfile } from '@/types/User.types'
+```
+
+Новые публичные типы — реэкспорт в `app/src/types/index.ts` по **`architecture/layer-barrel-exports.md`**.
+
+## `@/api`
+
+- **Публичный API** — barrel `app/src/api/index.ts`. Вне `app/src/api/**` — только `import … from '@/api'` (или `@/api/index`).
+- **Запрещено** снаружи слоя: `@/api/<что‑угодно>`, кроме `@/api/index`.
+- Внутри `app/src/api/**` — относительные импорты и `@/api/services/**`, `@/api/clients/**`.
+
+```typescript
+// ✅ в store, UI, lib вне app/src/api
+import { MedcardApiService } from '@/api'
+
+// ❌ снаружи app/src/api
+import { MedcardApiService } from '@/api/services/MedcardApiService/MedcardApiService'
+```
+
+Новые публичные символы API — реэкспорт в `app/src/api/index.ts` по **`architecture/layer-barrel-exports.md`**.

package/presets/claude/next/rules/architecture/reference-features.md

@@ -1,6 +1,9 @@
 ---
 paths:
-  - app/src/**/*
+  - app/src/ui/**/*
+  - app/src/store/**/*
+  - app/src/api/**/*
+  - app/src/types/**/*
 ---
 
 # Эталонные фичи (reference features)

package/presets/claude/next/rules/architecture/types-public-imports.md

@@ -1,34 +1,8 @@
 ---
 paths:
-  - app/src/**/*.ts
-  - app/src/**/*.tsx
+  - app/src/types/**/*
 ---
 
-# Импорты из `@/types`
+# Deprecated
 
-- **Публичный API типов** — barrel `app/src/types/index.ts`, импортировать типы и интерфейсы только как `@/types` (или `@/types/index` при необходимости явного пути).
-- **Запрещено** для потребителей слоя обходить barrel: любой импорт вида `@/types/<что‑угодно>`, кроме перечисленного ниже исключения для enum.
-- Отдельно **нельзя** импортировать из вложенных файлов `*.types.ts` по путям `@/types/**/…*.types.ts` (типичный deep‑импорт).
-- **Исключение — enum**: перечисления можно импортировать только из `@/types/enums` / `@/types/enums.ts` (не из других файлов под `@/types`).
-
-## Внутри слоя `app/src/types/**`
-
-- При реализации и поддержке barrel‑файла допустимы **относительные** импорты между файлами внутри `app/src/types` (например `from './User.types'`). Это не относится к потребителям слоя.
-
-## Примеры
-
-```typescript
-// ✅ Допустимо — доменные и транспортные сущности с теми именами, что экспортирует barrel
-import type { TUserProfile } from '@/types'
-import { SomeEnum } from '@/types/enums'
-
-// ❌ Запрещено (обход публичного API)
-import type { TUserProfile } from '@/types/User.types'
-import { TransportError } from '@/types/TransportError'
-```
-
-При ревью и правках кода **не добавлять** новые импорты типов из `@/types/...` кроме `@/types` и `@/types/enums`.
-
-- Новые публичные типы — реэкспорт в `app/src/types/index.ts` по **`architecture/layer-barrel-exports.md`**.
-
-**Коллизии формулировок:** если в разных правилах расходятся детали **импорта типов**, источник правды — **этот файл** (`@/types`, `@/types/enums`).
+Содержимое перенесено в **`architecture/public-imports.md`** (раздел `@/types`).

package/presets/claude/next/rules/stack/next-app-core.md

@@ -1,83 +1,33 @@
 # Стек и окружение
 
-Конкретные версии пакетов и инструментов — **из `package.json` и конфигов целевого репозитория**. Ниже — рамка preset (Next.js + React + TypeScript), без привязки к конкретному вендору UI, моков или APM:
+Конкретные версии — **из `package.json` и конфигов целевого репозитория**. Рамка preset: Next.js, React, TypeScript; runner/e2e/mocks/UI/APM — как заведено в репо.
 
-- **Фреймворк:** Next.js, React, TypeScript (strict — если включён в проекте).
-- **Сборка и Node:** как задано в репозитории.
-- **Тесты:** unit/integration — runner и библиотеки проекта; e2e — инструмент проекта (правила для агентов Playwright — в `testing/playwright-agents.md`).
-- **Моки HTTP/API:** если приняты в репо — повторять существующую схему (каталоги, регистрация, точка входа).
-- **Стили и UI:** способ стилизации и **дизайн‑система / токены** — как уже заведено в коде; приоритет общим примитивам и токенам вместо разрозненных «магических» значений.
-- **Наблюдаемость:** только если уже подключена в проекте — централизованно (клиент, обёртки), без дублирования в каждом методе.
+# Структура проекта
 
-# Структура проекта (верхний уровень)
-
-- `app/` — корень Next.js приложения.
-  - `app/src/**` — исходный код приложения.
-  - `app/__tests__/e2e/**` — e2e‑тесты и планы.
-- `app/tsconfig.json`:
-  - `baseUrl: "."`
-  - `paths: { "@/*": ["./src/*"] }`
-
-**Требование:** во всех новых изменениях использовать алиас `@/*` вместо относительных импортов выше по дереву.
+- `app/` — корень Next.js; `app/src/**` — код; `app/__tests__/e2e/**` — e2e.
+- `app/tsconfig.json`: `baseUrl: "."`, `paths: { "@/*": ["./src/*"] }`.
+- **Требование:** `@/*` вместо относительных импортов выше по дереву.
 
 # Архитектурные слои
 
-- **UI слой** (`app/src/ui/**`):
-  - `app/src/ui/pages/**` — страницы и контейнеры.
-  - `app/src/ui/components/**` — переиспользуемые компоненты.
-- **Store слой** (`app/src/store/**`):
-  - `app/src/store/slices/**` — модули состояния (Redux Toolkit; подробности в `api-and-data/store-rtk.md`).
-  - `app/src/store/middleware/**` — middleware для сайд‑эффектов (например, файлы, аналитика).
-- **API слой** (`app/src/api/**` — прежде всего `services/**`, плюс `clients/**`, корневой barrel `index.ts`):
-  - Сервисы и мапперы; **потребители вне каталога** импортируют только через `@/api` (`architecture/api-public-imports.md`).
-- **HTTP‑транспорт** (`app/src/lib/clients/**`, `app/src/api/clients/**`):
-  - Один механизм запросов, без разбросанного «сырого» `fetch`/`XMLHttpRequest` по фичам. Детали — **`api-and-data/http-client.md`**.
-- **Типы** (`app/src/types/**`):
-  - Доменные модели и транспортные контракты; **потребители** импортируют только через **`architecture/types-public-imports.md`** (`@/types`, `@/types/enums`).
-- **Моки и тестовые данные** (`app/src/mocks/**`):
-  - По структуре и назначению — как принято в репозитории.
-
-## Порты и адаптеры (сопоставление с каталогами)
-
-Та же идея, что в `architecture/architecture-boundaries.md` (раздел **«Порты и адаптеры»**): UI и store зависят от **контракта** к backend (`@/api` + доменные типы), реализация HTTP — в **`app/src/lib/clients/**`** и **`app/src/api/clients/**`**. Детали транспорта — `api-and-data/http-client.md`; импорты `@/api` — `architecture/api-public-imports.md`.
+| Слой | Каталог | Детали |
+|------|---------|--------|
+| UI | `app/src/ui/**` (pages, components) | `ui-and-accessibility/react-ui.md`, `architecture/architecture-boundaries.md` |
+| Store | `app/src/store/**` (slices, middleware) | `api-and-data/store-rtk.md` |
+| API | `app/src/api/**` (services, clients, barrel) | `api-and-data/api-services.md`, `api-and-data/http-client.md` |
+| HTTP | `app/src/lib/clients/**`, `app/src/api/clients/**` | `api-and-data/http-client.md` |
+| Types | `app/src/types/**` | `architecture/public-imports.md`, `stack/types-jsdoc.md` |
+| Mocks | `app/src/mocks/**` | по схеме репозитория |
 
-# Общие архитектурные принципы
-
-- **Чёткое разделение слоёв**:
-  - UI знает о доменных типах (из `@/types` / `@/types/enums`) и публичных API store; при необходимости импортирует из **`@/api`** — см. `architecture/api-public-imports.md` и `architecture/architecture-boundaries.md` (**«UI и обращение к API»**).
-  - Store знает о доменных типах и вызывает API‑сервисы через **`@/api`**.
-  - API‑сервисы знают о DTO, мапперах и вызовах через клиенты из `app/src/api/clients/**` (`api-and-data/http-client.md`).
-- **Никаких «проникновений» слоёв**:
-  - UI не вызывает HTTP‑клиент и не работает с DTO; сценарии с записью в общий state — через store; узкие исключения для сервисов из UI — только по `architecture/architecture-boundaries.md`.
-  - Store не собирает запросы сам и не обходит API‑сервисы; данные для state — доменные модели после маппинга. Транспортные типы ответа/ошибки во thunk — как в `@/types`, согласованно с `api-and-data/http-client.md`, `api-and-data/store-rtk.md`.
-- **Доменная логика и state**:
-  - DTO → домен — в **мапперах** и чистых функциях (`api-and-data/api-services.md`); **редюсеры и селекторы** — узкие. Подробности — `api-and-data/store-rtk.md`.
-- **Типы — источник правды**:
-  - При коллизии по **импорту типов** — **`architecture/types-public-imports.md`**.
-  - Новые сущности — в `app/src/types/**` с экспортом через barrel.
-  - Не использовать `any`; при необходимости — `unknown` + безопасное сужение типа.
-
-# Кодстайл и качества кода
-
-- Следовать конфигам линтеров и форматтера **проекта** (`eslint`, `prettier`, `stylelint` — какие есть в репо).
-- KISS, DRY, SOLID; модульность; визуальная консистентность через UI‑примитивы и токены.
-- При добавлении нового кода **искать и копировать существующие паттерны**:
-  - Для страниц — `app/src/ui/pages/**`.
-  - Для блоков — `app/src/ui/components/**`.
-  - Для API — `app/src/api/services/**`.
-  - Для состояния — `app/src/store/slices/**`.
+Границы слоёв, порты/адаптеры, UI→API — **`architecture/architecture-boundaries.md`**. Импорты `@/types`, `@/api` — **`architecture/public-imports.md`**.
 
 # Работа агента
 
-При генерации кода:
-
-- При добавлении или существенном расширении фичи — **`architecture/feature-delivery-workflow.md`**.
-- Определить целевой слой (UI/store/API/типизация/тесты).
-- Найти похожие примеры и **копировать архитектурный паттерн** (структура файлов, типы, именование).
-- Не упрощать архитектуру (не тянуть DTO и HTTP в UI; вызовы сервисов из UI — только в рамках `architecture/architecture-boundaries.md`).
-- Избегать `any`; при необходимости — `unknown` с безопасным сужением.
-- После **любых** изменений — **`tooling-and-review/post-change-lint.md`** и **`tooling-and-review/package-manager.md`**.
+- Архитектура и импорты: `architecture/architecture-boundaries.md`, `architecture/public-imports.md`
+- Фичи: `architecture/feature-delivery-workflow.md` + skill `feature-delivery`
+- После правок: `tooling-and-review/post-change-lint.md`; менеджер пакетов: `tooling-and-review/package-manager.md`
+- Копировать паттерны соседних файлов в целевом слое; не использовать `any` (предпочитать `unknown` + сужение)
 
-Задачи на **сеть, замену HTTP‑библиотеки, новые эндпоинты**: **`api-and-data/http-client.md`** + **`api-and-data/api-services.md`** + **`api-and-data/store-rtk.md`**.
+Задачи на **сеть, HTTP, новые эндпоинты**: `api-and-data/http-client.md` + `api-and-data/api-services.md` + `api-and-data/store-rtk.md`.
 
-См. также **`rules/README.md`** — полный каталог правил пресета.
+См. **`rules/README.md`** — полный каталог.

package/presets/claude/next/rules/stack/no-type-assertion.md

@@ -1,7 +1,8 @@
 ---
 paths:
-  - app/src/**/*.ts
-  - app/src/**/*.tsx
+  - app/src/api/**/*
+  - app/src/store/**/*
+  - app/src/types/**/*
 ---
 
 # Не использовать `as` для приведения типов при экспорте и импорте

package/presets/claude/next/rules/stack/types-jsdoc.md

@@ -34,4 +34,4 @@ paths:
 - Поддерживать **тот же стиль**, что в файле.
 - Одна-две фразы на тип, одна строка на поле — норма.
 
-См. также импорты и barrel: `architecture/types-public-imports.md`.
+См. также импорты и barrel: `architecture/public-imports.md`.

package/presets/claude/next/rules/tooling-and-review/agent-team-intake.md

@@ -1,3 +1,9 @@
+---
+paths:
+  - .claude/commands/**/*
+  - .claude/team/**/*
+---
+
 # Agent team intake
 
 When the user message looks like a **work request** (implement, add, fix, refactor, review MR, write tests, spike) — not a question about how code works:

package/presets/claude/next/rules/tooling-and-review/agent-team-orchestrator.md

@@ -2,6 +2,8 @@
 
 Parent agent = **manager**. Router plans; specialists execute. Artifacts: `.claude/team/tasks/<slug>/`.
 
+Work request без `/task` — см. **`tooling-and-review/agent-team-intake.md`**.
+
 ## Entry points
 
 | Command | When |
@@ -116,6 +118,17 @@ After each agent completes, ensure `status.json` has `state: completed` (or `awa
 
 If `pipeline.json` is missing (old `/feature-start` tasks), fall back to fixed phases: analysis → development → review → testing.
 
+## Skip pipeline when
+
+Do **not** run `/task` + router for:
+
+- Pure questions («как работает X», «объясни»).
+- Typo / one-file fix / trivial config with no architecture risk.
+- User explicitly says «без pipeline», «просто сделай», or continues an active slug.
+- Single-line `docs-only` with no code impact.
+
+Borderline work requests — см. **`tooling-and-review/agent-team-intake.md`**.
+
 ## Auto-detection (optional)
 
-When user describes a **task** (not a question "how does X work"), suggest `/task <their message>` or run router proactively if they agree.
+When user describes a **non-trivial task** (not a question), suggest `/task <message>` or run router if they agree.

package/presets/claude/next/rules/tooling-and-review/code-quality.md

@@ -32,19 +32,11 @@
   - сначала локально улучшить архитектуру минимальными шагами;
   - оставить код в консистентном состоянии.
 
-## ESLint, Stylelint и плагины
+## Линтеры
 
-- Учитывать **все активные правила ESLint** и **подключённые плагины** проекта (конфиг: `app/eslint.config.mjs`, базовые пресеты в т.ч. `@sh/eslint-config-react`, `@sh/eslint-config-boundaries` и локальные overrides).
-- Учитывать **Stylelint** для CSS и CSS-in-JS (конфиг: `app/.stylelintrc`; порядок свойств — `ui-and-accessibility/css-property-order.md`).
-- Новый или изменённый код не должен нарушать эти правила.
-- После **каждого** изменения кода агент **обязан** выполнить **`tooling-and-review/post-change-lint.md`**: полный прогон **`lint:js`** и **`lint:css`**, анализ вывода, исправление срабатываний в зоне задачи.
-- Отключение правила (`eslint-disable`) — только **точечно** (строка/небольшой блок) и с **кратким комментарием**, зачем это нужно; отключать «на весь файл» без веской причины не следует.
+Lint/stylelint — только **`tooling-and-review/post-change-lint.md`**; ESLint config: `app/eslint.config.mjs`. Отключение правила (`eslint-disable`) — только **точечно** с кратким комментарием «зачем».
 
 ## Требование к агенту
 
-При каждом изменении:
-
-- Поддерживать принцип **«boy scout rule»**:
-  - оставлять модуль в немного лучшем состоянии, чем до изменения (простые, безопасные улучшения).
+- **Boy scout rule:** оставлять модуль немного лучше, чем до изменения (простые, безопасные улучшения).
 - Не жертвовать архитектурой и слоями ради краткости реализации.
-- **Не завершать задачу**, пока не пройдены обязательные линтеры (`tooling-and-review/post-change-lint.md`).

package/presets/claude/next/rules/tooling-and-review/code-review-mr.md

@@ -18,13 +18,13 @@
 ### Импорты и организация кода
 
 - Использование алиаса `@/...` вместо относительных импортов выше по дереву.
-- Отсутствие deep‑импортов во внешние фичи; только public API; в файлах вне `app/src/api/**` импорты из API — только `from '@/api'` (`architecture/api-public-imports.md`, дублирует ESLint).
+- Отсутствие deep‑импортов во внешние фичи; только public API; в файлах вне `app/src/api/**` импорты из API — только `from '@/api'` (`architecture/public-imports.md`, дублирует ESLint).
 - При новых/изменённых модулях в регламентированных слоях — реэкспорт публичных символов в корневой barrel по **`architecture/layer-barrel-exports.md`**.
 - Размещение новых файлов в корректных слоях и директориях фич.
 
 ### Типы и TS‑строгость
 
-- Не допускать новых `any`; предпочитать доменные типы из `@/types` (barrel, см. `architecture/types-public-imports.md`).
+- Не допускать новых `any`; предпочитать доменные типы из `@/types` (barrel, см. `architecture/public-imports.md`).
 - Проверять корректность пропсов/возвращаемых типов, особенно в UI и API‑слое.
 
 ### UI и стили

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

@@ -1,20 +1,11 @@
 # Менеджер пакетов (терминал)
 
-Перед **`npm install` / `yarn` / `pnpm` / `bun`** и любыми **`… run …`** (lint, test, dev, build) **сначала определи**, какой менеджер закреплён в этом репозитории, и **используй только его**.
+Перед **`npm install` / `yarn` / `pnpm` / `bun`** и **`… run …`** определи менеджер репозитория и **используй только его**.
 
-## Как определить (по убыванию надёжности)
+## Как определить
 
-1. Поле **`packageManager`** в `package.json` (корень монорепо или `app/package.json`) — `yarn@…`, `pnpm@…`, `npm@…`, `bun@…`.
-2. **Lockfile** рядом с тем `package.json`:
-   - `yarn.lock` → **yarn**
-   - `pnpm-lock.yaml` → **pnpm**
-   - `package-lock.json` → **npm**
-   - `bun.lock` / `bun.lockb` → **bun**
-3. Если неоднозначно — где лежат **`node_modules`** и какой lockfile обновляют в CI.
+1. **`packageManager`** в `package.json` (корень или `app/package.json`).
+2. **Lockfile** рядом: `yarn.lock` → yarn; `pnpm-lock.yaml` → pnpm; `package-lock.json` → npm; `bun.lock(b)` → bun.
+3. Если неоднозначно — где `node_modules` и какой lockfile в CI.
 
-## Как запускать
-
-- Рабочий каталог — там, где **`package.json`** с нужными **scripts** (в этом репозитории — **`app/`**).
-- Примеры: `yarn lint`, `pnpm run test` — **в соответствии с обнаруженным менеджером**.
-
-Если менеджер неочевиден — **посмотри файлы** инструментами чтения, **не угадывай**.
+Рабочий каталог для scripts — **`app/`**. Примеры: `yarn lint`, `pnpm run test`. Не угадывай — проверь файлы.

package/presets/claude/next/rules/tooling-and-review/post-change-lint.md

@@ -2,42 +2,32 @@
 
 ## Когда применять
 
-После **любого** изменения исходников в репозитории: правка, создание или удаление файлов в `app/**` (TS/TSX/JS/MJS, CSS, styled/Linaria в `.ts`/`.tsx`, markdown с ESLint и т.д.).
+После **любого** изменения исходников в `app/**` (TS/TSX/JS/MJS, CSS, styled/Linaria в `.ts`/`.tsx`).
 
-Исключения без прогона линтеров: только правки **документации вне `app/`**, конфигов CI, `.claude/rules/**`, если **не** менялся исполняемый код приложения.
+Исключения: правки документации вне `app/`, конфигов CI, `.claude/rules/**`, если исполняемый код приложения не менялся.
+
+**Pipeline exception:** если задача идёт через agent team и следующий шаг — `build-verifier`, developer может ограничиться lint/type-check **изменённых файлов**; полный прогон — обязанность `build-verifier`. В single-agent режиме (без pipeline) — всегда полный прогон.
 
 ## Обязательные команды
 
-Рабочий каталог — **`app/`** (там `package.json` со скриптами). Менеджер пакетов — **`tooling-and-review/package-manager.md`**.
+Рабочий каталог — **`app/`**. Менеджер пакетов — **`tooling-and-review/package-manager.md`**.
 
-1. **`lint:js`** — полный ESLint по проекту (`eslint .` с расширениями из скрипта).
+1. **`lint:js`** — полный ESLint по проекту.
 2. **`lint:css`** — полный Stylelint (`**/*.{css,ts}`).
 
-**Всегда запускать обе команды**, даже если задача не касалась стилей: Stylelint проверяет и CSS-in-JS в `.ts`.
-
-Точечный ESLint/Stylelint только на один файл **не заменяет** полный прогон перед завершением задачи.
+Точечный lint на один файл **не заменяет** полный прогон перед завершением задачи (кроме pipeline exception выше).
 
-## Алгоритм для агента
+## Алгоритм
 
 1. Завершить правки кода.
-2. Запустить **`lint:js`** и **`lint:css`** из `app/` (через терминал, не «на глаз»).
-3. **Проанализировать весь вывод**: errors и warnings.
-4. **Исправить** все срабатывания в **изменённых файлах** и связанных с задачей; для Stylelint сначала пробовать **`lint:css --fix`**, если правило автоисправимо.
-5. При ненулевом exit code — повторить шаги 2–4 до успешного прогона или явного блокера.
-6. **Не считать задачу выполненной**, пока оба линтера не завершились с кодом 0 **или** в ответе пользователю не зафиксирован блокер (например, легаси вне скоупа) с перечислением оставшихся замечаний.
+2. Запустить **`lint:js`** и **`lint:css`** из `app/`.
+3. Проанализировать весь вывод; исправить errors/warnings в изменённых файлах; для Stylelint — **`lint:css --fix`** если автоисправимо.
+4. Повторить до exit code 0 или зафиксировать блокер в ответе пользователю.
+5. **`type-check`** при изменениях TypeScript. CI-уровень: **`lint`** (= `lint:js` + `lint:css` + `type-check`).
 
 ## Что исправлять
 
 - **Errors** — обязательно.
-- **Warnings** — обязательно в файлах из текущей задачи; вне скоупа — не чинить «заодно», но **упомянуть** в ответе, если мешают нулевому exit code.
-- **`eslint-disable`** — только точечно, с кратким комментарием «зачем» (`tooling-and-review/code-quality.md`).
-
-## Связанные проверки
-
-- **`type-check`** — обязателен при изменениях TypeScript (`stack/next-app-core.md`); не подменяет ESLint/Stylelint.
-- Полная валидация как в CI: **`lint`** (= `lint:js` + `lint:css` + `type-check`) — уместна перед крупным MR.
-
-## Конфиги
+- **Warnings** — обязательно в файлах задачи; вне скоупа — упомянуть, если мешают нулевому exit code.
 
-- ESLint: `app/eslint.config.mjs`
-- Stylelint: `app/.stylelintrc` (порядок свойств — `ui-and-accessibility/css-property-order.md`)
+Конфиги: `app/eslint.config.mjs`, `app/.stylelintrc` (порядок CSS — `ui-and-accessibility/css-property-order.md`).