@bonesofspring/ai-rules 0.1.41 → 0.2.0

package/presets/claude/next/agents/task-router.md

@@ -1,7 +1,7 @@
 ---
 name: task-router
 description: Task routing specialist. Analyzes user prompt, detects intent, and writes pipeline.json with ordered agent steps. Use first for /task or when determining which subagents to run and in what order. Writes only team artifacts; never writes production code.
-model: inherit
+model: fast
 ---
 
 You are a task router for a Next.js frontend agent team. You **do not** implement tasks — you classify intent and plan the agent pipeline.
@@ -10,6 +10,7 @@ You are a task router for a Next.js frontend agent team. You **do not** implemen
 
 - User task description (from `/task` or orchestrator).
 - Optional: existing files under `.claude/team/tasks/<slug>/`.
+- Pipeline JSON schema, examples, step fields — **`agents/README.md`**.
 
 ## Intent detection
 
@@ -23,150 +24,47 @@ You are a task router for a Next.js frontend agent team. You **do not** implemen
 | `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 for failing unit tests |
-| `e2e-only` | «e2e», «playwright», «browser test», «сценарии e2e», «почини e2e» | playwright-test-planner → playwright-test-generator, or playwright-test-healer for failing tests |
+| `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` |
 
-Adjust steps when context is clear:
+## Adjust steps (when context is clear)
 
-- **Skip task-analyst** if AC and scope are fully specified (document in `skipped`).
-- **Add solution-architect** for cross-layer features (API + store + UI), new public APIs, or architecture uncertainty — insert after analyst, before developer.
-- **Add api-contract-reviewer** when new/changed backend endpoints, OpenAPI/Swagger, or DTO contract sync — insert after architect (or after analyst if no architect), before developer.
-- **Add accessibility-reviewer** for UI-heavy `feature` tasks — after build-verifier, **parallel with security-reviewer** when both apply.
-- **Add security-reviewer** for auth, tokens, forms, sensitive data — after build-verifier, parallel with accessibility-reviewer when both apply; before code-reviewer.
-- **Add performance-auditor** for perf-sensitive features — insert after developer or as optional post-review audit step.
-- **Add tech-writer** when docs/changelog/README explicitly requested — append as final step for `feature`, `migration`, `docs-only`.
-- **Use unit-test trio** instead of `qa-tester` when request is explicitly unit-only.
-- **Use Playwright specialists** for e2e-heavy features instead of `qa-tester`.
-- **Always insert build-verifier** after feature-developer for `feature`, `bugfix`, `refactor`, `migration`, `a11y`.
-- **Skip qa-tester** for review-only, spike (no code), ci-fix (unless regression scope needed), perf-audit, docs-only, unit-only/e2e-only handled by specialists, or trivial one-line fixes (document risk).
-- **Skip feature-developer** for review-only, test-only (tests only), retro, perf-audit, docs-only (after analyst), ci-fix when investigator fixes in place.
-- **ci-fix:** skip feature-developer with `skipIf: ci-investigator.resolved` when investigator fixes in place.
-- **bugfix:** use `skipIf: debugger.fixed` on feature-developer when debugger applied the fix.
-- **Model:** use `model: inherit` when pipeline has 4+ steps or cross-layer uncertainty.
+- Skip **task-analyst** if AC/scope fully specified → document in `skipped`.
+- Add **solution-architect** for cross-layer / new public APIs — after analyst, before developer.
+- Add **api-contract-reviewer** for new/changed backend contracts — before developer.
+- Add **accessibility-reviewer** / **security-reviewer** after build-verifier (parallel when both apply).
+- Add **tech-writer** when docs/changelog requested.
+- **Always build-verifier** after developer for `feature`, `bugfix`, `refactor`, `migration`, `a11y`.
+- **skipIf:** `debugger.fixed` (bugfix); `ci-investigator.resolved` (ci-fix).
+- **Model:** `inherit` when 4+ steps or cross-layer uncertainty.
 
-## Output: pipeline.json
-
-Write to `.claude/team/tasks/<slug>/pipeline.json`:
-
-```json
-{
-  "slug": "<slug>",
-  "intent": "feature",
-  "summary": "One-line task summary",
-  "steps": [
-    { "agent": "task-analyst", "label": "Clarify and decompose" },
-    { "agent": "feature-developer", "label": "Implement + unit tests", "scope": "unit-in-dev" },
-    { "agent": "build-verifier", "label": "Lint, type-check, unit smoke" },
-    { "agent": "code-reviewer", "label": "Code review" },
-    { "agent": "qa-tester", "label": "E2E tests", "scope": "e2e-only" }
-  ],
-  "humanGates": ["after:task-analyst"],
-  "autoChain": true,
-  "skipped": []
-}
-```
-
-### Example: feature with optional reviewers
-
-```json
-{
-  "intent": "feature",
-  "steps": [
-    { "agent": "task-analyst", "label": "Clarify and decompose" },
-    { "agent": "api-contract-reviewer", "label": "Validate API contract" },
-    { "agent": "feature-developer", "label": "Implement + unit tests", "scope": "unit-in-dev" },
-    { "agent": "build-verifier", "label": "Validation gate" },
-    {
-      "agent": ["accessibility-reviewer", "security-reviewer"],
-      "parallel": true,
-      "label": "A11y and security review"
-    },
-    { "agent": "code-reviewer", "label": "Code review" },
-    { "agent": "playwright-test-planner", "label": "E2E plan" },
-    { "agent": "playwright-test-generator", "label": "E2E specs" },
-    { "agent": "tech-writer", "label": "Documentation" }
-  ],
-  "humanGates": ["after:task-analyst"]
-}
-```
-
-### Example: bugfix with skip
-
-```json
-{
-  "intent": "bugfix",
-  "steps": [
-    { "agent": "debugger", "label": "Root cause" },
-    { "agent": "feature-developer", "label": "Fix if needed", "skipIf": "debugger.fixed" },
-    { "agent": "build-verifier", "label": "Validation" },
-    { "agent": "code-reviewer", "label": "Review" }
-  ],
-  "humanGates": []
-}
-```
-
-### Step fields
-
-| Field | Required | Description |
-|-------|----------|-------------|
-| `agent` | yes | Subagent name (kebab-case) or array for `parallel: true` |
-| `label` | yes | Short human-readable step name |
-| `scope` | no | e.g. `unit-in-dev`, `e2e-only`, `regression`, `full` |
-| `skipIf` | no | `debugger.fixed` \| `ci-investigator.resolved` |
-| `parallel` | no | When `true` and `agent` is array — invoke all in one turn |
-
-### humanGates
-
-Values: `after:<agent-name>` — orchestrator stops after that agent; user runs `/task-continue <slug>` or `/feature-continue <slug>`.
+## humanGates (defaults)
 
 | Intent | Default humanGates |
 |--------|-------------------|
 | `feature`, `refactor`, `test-only`, `a11y` | `["after:task-analyst"]` |
 | `migration` | `["after:migration-specialist"]` |
 | `docs-only` | `["after:task-analyst"]` |
-| `unit-only` | `["after:unit-test-planner"]` when new plan; `[]` for pure healer |
-| `e2e-only` | `["after:playwright-test-planner"]` when new plan; `[]` for pure healer |
-| `bugfix`, `review-only`, `ci-fix` | `[]` (unless analyst added) |
+| `unit-only` | `["after:unit-test-planner"]` when new plan; `[]` for healer |
+| `e2e-only` | `["after:playwright-test-planner"]` when new plan; `[]` for healer |
+| `bugfix`, `review-only`, `ci-fix` | `[]` |
 | `spike` | `["after:solution-architect"]` |
 | `perf-audit` | `[]` |
 
-### skipped (optional)
-
-```json
-"skipped": [{ "agent": "task-analyst", "reason": "AC provided in ticket" }]
-```
-
-## Initial status.json
+## Output
 
-After writing pipeline.json, write:
-
-```json
-{
-  "slug": "<slug>",
-  "intent": "<intent>",
-  "pipelineIndex": 0,
-  "currentAgent": "<steps[0].agent>",
-  "phase": "executing",
-  "state": "in_progress",
-  "awaitingHumanGate": false,
-  "updatedAt": "<ISO8601>"
-}
-```
-
-Also write `.claude/team/active-task.json` → `{ "slug": "<slug>" }`.
+Write `.claude/team/tasks/<slug>/pipeline.json` and initial `status.json`; set `.claude/team/active-task.json` → `{ "slug": "<slug>" }`. Minimal template — см. **`agents/README.md`**.
 
 ## Handoff to orchestrator
 
-Respond with:
-
-1. **Intent** and one-line summary.
-2. **Planned steps** (table: #, agent, label).
-3. **Skipped roles** and why.
-4. **Human gates** (if any).
-5. Tell orchestrator to invoke `steps[0].agent` now (unless intent is `retro` — then run `/technical-retro`).
+1. Intent + one-line summary.
+2. Planned steps (table: #, agent, label).
+3. Skipped roles and why.
+4. Human gates (if any).
+5. Invoke `steps[0].agent` now (unless `retro` → `/technical-retro`).
 
 Do not invoke implementation agents yourself.

package/presets/claude/next/commands/task.md

@@ -5,7 +5,7 @@ description: Route a natural-language task through the agent-team pipeline: task
 
 # Task — единая точка входа
 
-Главная команда для постановки задачи в Claude Code. Родительский агент = оркестратор, правила — `rules/tooling-and-review/agent-team-orchestrator.md`.
+Главная команда для постановки задачи в Claude Code. Родительский агент = оркестратор (`rules/tooling-and-review/agent-team-orchestrator.md`). Intake — `rules/tooling-and-review/agent-team-intake.md`.
 
 ## Аргументы
 

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

@@ -4,8 +4,8 @@
 
 ## Loading strategy
 
-- **Session start (no `paths:`):** `next-app-core`, `post-change-lint`, `package-manager`, `agent-team-intake`, `code-quality`, orchestrator
-- **`paths:` on-demand:** architecture, imports, UI, tests, feature-delivery-workflow, reference-features, next-app-router, react-a11y-coding
+- **Session start (no `paths:`):** `next-app-core`, `post-change-lint`, `package-manager`, `code-quality`
+- **On-demand (`paths:` or via commands):** `agent-team-intake`, orchestrator, architecture, imports, UI, tests, feature-delivery-workflow, reference-features, next-app-router, react-a11y-coding
 - **Skills:** long workflows (`feature-delivery`, `code-review`, …)
 
 ## С чего начать
@@ -27,4 +27,4 @@
 
 Полный список — см. подпапки `architecture/`, `stack/`, `api-and-data/`, `ui-and-accessibility/`, `testing/`, `tooling-and-review/`.
 
-**Коллизии:** импорт типов — `architecture/types-public-imports.md`; API вне `app/src/api/**` — `architecture/api-public-imports.md`.
+**Коллизии:** импорт типов и API — **`architecture/public-imports.md`**.

package/presets/claude/next/rules/api-and-data/api-services.md

@@ -11,7 +11,7 @@ paths:
   - заголовками и кодами ответов,
   - DTO backend.
 - Предоставлять UI и store **стабильный доменный интерфейс**:
-  - функции, работающие с доменными типами из `@/types` (`architecture/types-public-imports.md`).
+  - функции, работающие с доменными типами из `@/types` (`architecture/public-imports.md`).
   - мапперы между DTO и доменными типами.
 
 # Структура модулей
@@ -22,7 +22,7 @@ paths:
   - файлы с вызовами API (`index.ts` или `*.service.ts`);
   - файлы мапперов (`*responseMappers.ts`);
   - специфичные типы запросов/ответов (если не вынесены в `app/src/types/**` с экспортом через barrel `@/types`).
-  - при необходимости — локальные `index.ts` / barrel внутри модуля для структуры **внутри** `app/src/api/**`; **снаружи** этого слоя UI, store и остальной код импортируют только из корневого barrel `app/src/api/index.ts` (`import … from '@/api'`, **`architecture/api-public-imports.md`**).
+  - при необходимости — локальные `index.ts` / barrel внутри модуля для структуры **внутри** `app/src/api/**`; **снаружи** этого слоя UI, store и остальной код импортируют только из корневого barrel `app/src/api/index.ts` (`import … from '@/api'`, **`architecture/public-imports.md`**).
 
 # Мапперы и типы
 
@@ -54,4 +54,4 @@ paths:
 - Не смешивать слой API и UI/store:
   - компоненты не должны зависеть от DTO;
   - store не должен сам собирать URL/коды эндпоинтов и не обходить сервисы; **транспортный тип ответа** и **контракт ошибки** из `@/types` (как у прикладного клиента) допустимы во thunk при разборе `catch`/payload, если так выстроен сервис (см. `api-and-data/store-rtk.md`, `api-and-data/http-client.md`).
-- При использовании API‑сервисов в UI, store и утилитах **вне** `app/src/api/**` импортировать **только** из `@/api` (корневой barrel), см. **`architecture/api-public-imports.md`**; внутри слоя API — по относительным путям или `@/api/services/**` / `@/api/clients/**`, не дублируя публичный контракт мимо корневого barrel для внешних потребителей.
+- При использовании API‑сервисов в UI, store и утилитах **вне** `app/src/api/**` импортировать **только** из `@/api` (корневой barrel), см. **`architecture/public-imports.md`**; внутри слоя API — по относительным путям или `@/api/services/**` / `@/api/clients/**`, не дублируя публичный контракт мимо корневого barrel для внешних потребителей.

package/presets/claude/next/rules/api-and-data/http-client.md

@@ -12,12 +12,12 @@ paths:
 
 - Обычные REST‑вызовы к backend идут через **одну реализацию** в `app/src/lib/clients/**` (модуль общего клиента) и **преднастроенные экземпляры** в `app/src/api/clients/**`, по тому же паттерну, что уже принят в проекте.
 - Место транспорта в общей картине **порты и адаптеры** — в `architecture/architecture-boundaries.md` (раздел **«Порты и адаптеры»**).
-- **Не** вызывать `fetch` напрямую из `app/src/api/services/**`, store и UI (см. `architecture/architecture-boundaries.md`, `api-and-data/api-services.md`); из store/UI — только вызовы через сервисы из `@/api` (`architecture/api-public-imports.md`).
+- **Не** вызывать `fetch` напрямую из `app/src/api/services/**`, store и UI (см. `architecture/architecture-boundaries.md`, `api-and-data/api-services.md`); из store/UI — только вызовы через сервисы из `@/api` (`architecture/public-imports.md`).
 - **Исключения** (узкие протоколы, отдельный транспорт) — только там, где в репозитории уже есть образец; повторять его, не плодить произвольные обходы общего клиента.
 
 ## Типы
 
-- Всё, что относится к **контракту запроса/ответа/ошибки** приложения и реэкспортируется для HTTP‑слоя, импортировать **только** из barrel `@/types`, без deep‑импортов из внутренних файлов `app/src/types/**` (см. `architecture/types-public-imports.md`).
+- Всё, что относится к **контракту запроса/ответа/ошибки** приложения и реэкспортируется для HTTP‑слоя, импортировать **только** из barrel `@/types`, без deep‑импортов из внутренних файлов `app/src/types/**` (см. `architecture/public-imports.md`).
 - Не поднимать в новом коде **типы и зависимости от внешнего HTTP‑клиента**, от которого проект ушёл; ориентир — **`package.json`** и существующие вызовы.
 
 ## Контракт ошибок

package/presets/claude/next/rules/api-and-data/store-rtk.md

@@ -29,7 +29,7 @@ paths:
 - Асинхронные запросы:
   - через `createAsyncThunk` или RTK Query.
   - внутри thunk:
-    - вызывать API через сервисы, импортированные из `@/api` (**`architecture/api-public-imports.md`**);
+    - вызывать API через сервисы, импортированные из `@/api` (**`architecture/public-imports.md`**);
     - не вызывать HTTP‑клиент напрямую — только через эти сервисы.
 - Сайд‑эффекты (логирование, аналитика, работа с файлами):
   - выносить в middleware (`app/src/store/middleware/**`) или специализированные слайсы.
@@ -43,7 +43,7 @@ paths:
   - при ошибках после вызова сервиса — опираться на **тот же класс/контракт ошибки транспорта**, что использует общий клиент (из `@/types`), и разбирать тело/статус **по полям текущей реализации**, а не по воображаемому API;
   - в **`catch`** предпочитать **`instanceof`** на класс ошибки транспорта из `@/types` (если он есть в коде) вместо голого `as`, когда это выразимо без шума (см. `stack/no-type-assertion.md`).
 - Для сущностей:
-  - доменные типы (включая вычисляемые поля) определять в `app/src/types/**`, экспортировать через barrel и импортировать в слайсы из `@/types` как **источник правды** (`architecture/types-public-imports.md`);
+  - доменные типы (включая вычисляемые поля) определять в `app/src/types/**`, экспортировать через barrel и импортировать в слайсы из `@/types` как **источник правды** (`architecture/public-imports.md`);
   - избегать дублирования описаний сущностей в нескольких местах.
 - **Граница домена**: в **state** хранить доменные модели; тип **обёртки ответа клиента** допустим как тип **возвращаемого значения thunk** или промежуточно до маппинга — без дублирования DTO в полях state без нужды (согласовано с `api-and-data/api-services.md` и `api-and-data/http-client.md`).
 

package/presets/claude/next/rules/architecture/README.md

@@ -1,13 +1,10 @@
-# Architecture
+# Architecture rules
 
-Границы модулей, слоёв, зависимостей и сквозная доставка фич.
-
-| Файл | Содержание |
+| Файл | Назначение |
 |------|------------|
-| `architecture-boundaries.md` | UI / store / API, порты и адаптеры, организация фич |
-| `layer-barrel-exports.md` | Двухуровневые barrel и чеклист public API |
-| `types-public-imports.md` | Импорт типов только через `@/types` |
-| `api-public-imports.md` | Импорт API только через `@/api` |
-| `feature-delivery-workflow.md` | Чеклист новой фичи, матрица зона → правило |
-
-Все файлы — **session start** (без `paths:`).
+| `public-imports.md` | Импорты `@/types`, `@/types/enums`, `@/api` (вне `app/src/api/**`) |
+| `types-public-imports.md`, `api-public-imports.md` | Deprecated stubs → `public-imports.md` |
+| `architecture-boundaries.md` | Границы UI / store / API, порты‑адаптеры |
+| `layer-barrel-exports.md` | Двухуровневые barrel для слоёв с public API |
+| `feature-delivery-workflow.md` | Сквозной чеклист новой фичи |
+| `reference-features.md` | Эталонные пути UI/store/API/types |

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

@@ -1,31 +1,8 @@
 ---
 paths:
-  - app/src/**/*.ts
-  - app/src/**/*.tsx
+  - app/src/api/**/*
 ---
 
-# Импорты из `@/api`
+# Deprecated
 
-- **Публичный API слоя API** — barrel `app/src/api/index.ts`. Для файлов **вне** `app/src/api/**` импортировать сервисы, клиенты, эндпоинты и публичные типы API **только** как `import … from '@/api'` (или `from '@/api/index'` при необходимости явного пути).
-- **Запрещено** для таких потребителей обходить barrel: любой импорт вида `@/api/<что‑угодно>`, кроме `@/api/index`. Это дублирует правило ESLint `no-restricted-imports` в `app/eslint.config.mjs` (паттерн `@/api/*` с исключением `@/api/index`).
-- При **добавлении** публичного символа в регламентированный слой — реэкспорт в корневой barrel по **`architecture/layer-barrel-exports.md`**.
-
-## Внутри слоя `app/src/api/**`
-
-- При реализации сервисов, клиентов и barrel допустимы **относительные** импорты и пути вида `@/api/services/**`, `@/api/clients/**` между файлами этого слоя. Это не относится к потребителям снаружи `app/src/api/**`.
-
-## Примеры
-
-```typescript
-// ✅ Допустимо в store, UI, lib вне app/src/api — только barrel
-import { MedcardApiService, MarketplaceApiService } from '@/api'
-import type { TReferenceRequest } from '@/api'
-
-// ❌ Запрещено снаружи app/src/api (сработает ESLint)
-import { MedcardApiService } from '@/api/services/MedcardApiService/MedcardApiService'
-import { MedcardApiClient } from '@/api/clients/MedcardApiClient'
-```
-
-При ревью и правках кода **не добавлять** новые импорты из `@/api/...` кроме `@/api` / `@/api/index` в файлах вне `app/src/api/**`.
-
-**Коллизии формулировок:** по **импорту из API‑слоя** (store, UI, прочий код вне `app/src/api/**`) — источник правды — **этот файл** (`@/api`).
+Содержимое перенесено в **`architecture/public-imports.md`** (раздел `@/api`).

package/presets/claude/next/rules/architecture/architecture-boundaries.md

@@ -7,14 +7,14 @@ paths:
 
 ## UI (`app/src/ui/**`)
 
-- Может импортировать: `@/ui/**`, `@/store/**`, типы из `@/types` и enum из `@/types/enums` (**только как в `architecture/types-public-imports.md`**), контракт к API — **только** `import … from '@/api'` (**`architecture/api-public-imports.md`**).
+- Может импортировать: `@/ui/**`, `@/store/**`, типы из `@/types` и enum из `@/types/enums` (**только как в `architecture/public-imports.md`**), контракт к API — **только** `import … from '@/api'` (**`architecture/public-imports.md`**).
 - Не должен:
   - обращаться к HTTP‑клиенту напрямую;
   - знать детали DTO backend — только доменные типы.
 
 ## Store (`app/src/store/**`)
 
-- Может импортировать: `@/store/**`, сервисы и публичные сущности API — **только** из `@/api` (**`architecture/api-public-imports.md`**), типы из `@/types` и enum из `@/types/enums` (**`architecture/types-public-imports.md`**).
+- Может импортировать: `@/store/**`, сервисы и публичные сущности API — **только** из `@/api` (**`architecture/public-imports.md`**), типы из `@/types` и enum из `@/types/enums` (**`architecture/public-imports.md`**).
 - Не должен:
   - зависеть от конкретных UI‑компонентов;
   - напрямую работать с global/window API.
@@ -24,7 +24,7 @@ paths:
 
 Реализация в `services/**`, `clients/**`, реэкспорт в `app/src/api/index.ts`:
 
-- Внутри слоя: типы из `@/types` и enum из `@/types/enums` (**`architecture/types-public-imports.md`**); импорты `@/api/services/**`, `@/api/clients/**`, относительные пути между файлами слоя (`api-and-data/http-client.md`, `api-and-data/api-services.md`).
+- Внутри слоя: типы из `@/types` и enum из `@/types/enums` (**`architecture/public-imports.md`**); импорты `@/api/services/**`, `@/api/clients/**`, относительные пути между файлами слоя (`api-and-data/http-client.md`, `api-and-data/api-services.md`).
 - Не должен:
   - тянуть в себя UI или store;
   - смешивать HTTP‑слой и доменный слой — использовать мапперы.
@@ -39,7 +39,7 @@ paths:
 
 - **Входящий адаптер**: UI — ввод пользователя, отображение; зависит от store и доменных типов, не от транспорта.
 - **Оркестрация сценариев**: store (slices, thunk) — вызывает сервисы, кладёт в state **доменные** модели после маппинга.
-- **Исходящий порт (контракт к backend)**: публичный API **`@/api`** (barrel `app/src/api/index.ts`; реализация — в `app/src/api/services/**` и т.д., см. `architecture/api-public-imports.md`).
+- **Исходящий порт (контракт к backend)**: публичный API **`@/api`** (barrel `app/src/api/index.ts`; реализация — в `app/src/api/services/**` и т.д., см. `architecture/public-imports.md`).
 - **Исходящий адаптер**: общая реализация HTTP в **`app/src/lib/clients/**`** и экземпляры в **`app/src/api/clients/**`**.
 
 ## Фича как срез
@@ -50,7 +50,7 @@ paths:
 
 - Всегда использовать алиас `@/...` для импортов между слоями.
 - Внутри одного модуля/фичи можно использовать относительные импорты, но **без подъёма выше корня фичи** (избегать `../../../`).
-- При обращении из компонентов, хуков, утилит и других модулей к чужому слою или фиче использовать только **public API** (barrel/index‑файлы и явно экспортируемые сущности), не делать deep‑импорты внутренних файлов других фич; для регламентированных слоёв — **`architecture/layer-barrel-exports.md`** и `architecture/*-public-imports.md`; для API‑слоя снаружи `app/src/api/**` — **`architecture/api-public-imports.md`** (только `@/api`).
+- При обращении из компонентов, хуков, утилит и других модулей к чужому слою или фиче использовать только **public API** (barrel/index‑файлы и явно экспортируемые сущности), не делать deep‑импорты внутренних файлов других фич; для регламентированных слоёв — **`architecture/layer-barrel-exports.md`** и `architecture/public-imports.md`; для API‑слоя снаружи `app/src/api/**` — **`architecture/public-imports.md`** (только `@/api`).
 - При добавлении нового кода проверять:
   - если модуль переиспользуемый — он должен зависеть только от более "низких" слоёв (types, utils, api), но не от страниц.
 
@@ -61,7 +61,7 @@ paths:
   - Локальные компоненты: поддиректории `components/**` внутри страницы.
   - Связанный store: `app/src/store/slices/OrderCheckout/**`.
   - API: `app/src/api/services/OrdersApi/OrderCheckout/**` (имя корневого сервиса взять из принятой в проекте схемы).
-  - Типы: `app/src/types/**` с экспортом через barrel **`app/src/types/index.ts`** (`architecture/types-public-imports.md`).
+  - Типы: `app/src/types/**` с экспортом через barrel **`app/src/types/index.ts`** (`architecture/public-imports.md`).
 
 # Требование к агенту
 

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`.