@bonesofspring/ai-rules 0.1.42 → 0.2.1

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

@@ -11,6 +11,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 `.cursor/team/tasks/<slug>/`.
+- Pipeline JSON schema, examples, step fields — **`agents/README.md`**.
 
 ## Intent detection
 
@@ -24,150 +25,71 @@ 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:
-
-- **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 (see parallel step example).
-- **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` (scope e2e-only on qa when both unit and e2e needed).
-- **Always insert build-verifier** after feature-developer (or ci-investigator/debugger when they changed code) 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` (not fast) when pipeline has 4+ steps or cross-layer uncertainty (API + store + UI).
-
-## Output: pipeline.json
-
-Write to `.cursor/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", "scope": "changed-flows-only" },
-    { "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` — passed to agents |
-| `skipIf` | no | `debugger.fixed` \| `ci-investigator.resolved` — skip step when artifact says fix already applied |
-| `parallel` | no | When `true` and `agent` is array — orchestrator invokes all agents in one turn |
-
-### humanGates
-
-Values: `after:<agent-name>` — orchestrator stops after that agent; user runs `/task-continue <slug>` or `/feature-continue <slug>`.
+## Pipeline profiles
+
+Set optional top-level `"profile": "full" | "standard" | "light"` in `pipeline.json`. Default when omitted: **`standard`** for `feature`/`refactor`/`bugfix`; **`light`** for `review-only`, `perf-audit`; **`full`** when cross-layer or e2e AC required.
+
+| Profile | When | Typical `feature` steps |
+|---------|------|------------------------|
+| `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 signals:** один файл, один слой, явный AC в промпте, нет архитектурного риска. **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:**
+
+| intent | light steps |
+|--------|-------------|
+| `feature` | developer → build-verifier |
+| `bugfix` | debugger → build-verifier (`skipIf: debugger.fixed` on developer) |
+| `review-only` | code-reviewer |
+| `docs-only` | tech-writer (skip analyst if brief exists) |
+| `ci-fix` | ci-investigator → build-verifier (`skipIf: ci-investigator.resolved`) |
+
+Fixtures: `.cursor/team/fixtures/` (feature-full, feature-light, bugfix-standard).
+
+## Adjust steps (when context is clear)
+
+- 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 (or after ci-investigator/debugger if they changed code) for `feature`, `bugfix`, `refactor`, `migration`, `a11y`.
+- **skipIf:** `debugger.fixed` on developer (bugfix); `ci-investigator.resolved` (ci-fix).
+- **Model:** `inherit` when 4+ steps or cross-layer uncertainty.
+
+## 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 before generation; `[]` 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 `.cursor/team/active-task.json` → `{ "slug": "<slug>" }`.
+Write `.cursor/team/tasks/<slug>/pipeline.json` and initial `status.json`; set `.cursor/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/cursor/next/agents/tech-writer.md

@@ -2,7 +2,7 @@
 name: tech-writer
 description: Technical documentation specialist. Writes feature READMEs, migration guides, ADR summaries, and changelog entries from completed task artifacts. Docs-only — never edits production application code.
 readonly: true
-model: inherit
+model: fast
 ---
 
 You are a technical writer for a Next.js frontend team.

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

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

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

@@ -20,10 +20,27 @@
 ### Loading strategy
 
 - **`alwaysApply: true`** (Cursor) / **без `paths:`** (Claude) — только базовые инварианты:
-  - `next-app-core`, `post-change-lint`, `package-manager`, `agent-team-intake`, `code-quality-and-refactoring`
-- **Globs / `paths:`** — architecture, imports, UI, tests, feature-delivery-workflow, reference-features, next-app-router, react-a11y-coding
+  - `next-app-core`, `post-change-lint`, `package-manager`, `code-quality-and-refactoring`
+- **On-demand** — `agent-team-intake` (через orchestrator/commands), `agent-team-orchestrator`, architecture, imports, UI, tests, feature-delivery-workflow, reference-features, next-app-router, react-a11y-coding
 - **Skills** — длинные процедуры (`feature-delivery`, `code-review`, …)
 
+### UI edit bundle (consolidated globs)
+
+При правке `app/src/ui/**/*.tsx` подгружается **уменьшенный** набор (не весь `app/src/**`):
+
+| Rule | Globs | Назначение |
+|------|-------|------------|
+| `react-ui.mdc` | `app/src/ui/**` | Структура, стили, пропсы |
+| `architecture-boundaries-ui.mdc` | `app/src/ui/**` | Slim границы UI-слоя |
+| `react-a11y-coding.mdc` | `app/src/ui/**` | A11y |
+| `navigation-router-ui.mdc` | `app/src/ui/**/*.tsx` | Краткий ориентир навигации |
+| `no-props-spread.mdc` | `app/src/**/*.tsx` | Явные пропсы |
+| `arrow-functions.mdc` | `app/src/**` | Синтаксис |
+
+**Не грузятся на типичный UI edit:** `architecture-boundaries` (api/store/types/lib), `layer-barrel-exports` (только `index.ts`), `navigation-router-stack` (только `app/src/app/**`), `no-cross-component-styles-import` (consolidated в `react-ui`).
+
+`css-property-order-stylelint.mdc` — только на `styles.ts` / `.css`.
+
 ### Эталонные фичи
 
 Заполните **`reference-features.mdc`** (TBD → реальные пути) после `init` в целевом репо.
@@ -36,17 +53,19 @@
 | `next-app-router.mdc` | App Router, RSC, loading/error |
 | `react-a11y-coding.mdc` | A11y при написании UI |
 | `feature-delivery-workflow.mdc` | Сквозной чеклист (on-demand, не always-on) |
-| `agent-team-intake.mdc` | Автоподсказка `/task` при постановке задачи (alwaysApply) |
+| `agent-team-intake.mdc` | Подсказка `/task` при work-запросе (on-demand, через orchestrator) |
 | `package-manager.mdc` | Перед `install` / `run` в терминале определить менеджер пакетов репо (lockfile, `packageManager`) и использовать только его |
 | `agent-team-orchestrator.mdc` | `/task`, router, `pipeline.json`, build-verifier, parallel steps |
-| `next-app-core.mdc` | Стек, слои, порты‑адаптеры (alwaysApply) |
+| `next-app-core.mdc` | Стек, слои, карта каталогов (alwaysApply) |
 | `post-change-lint.mdc` | **Обязательный** прогон ESLint + Stylelint после любых изменений кода |
-| `architecture-boundaries.mdc` | Границы UI / store / API, импорты (`@/types`, `@/api`), порты‑адаптеры, фича как срез |
+| `architecture-boundaries-ui.mdc` | Slim границы UI при правках компонентов |
+| `architecture-boundaries.mdc` | Полная карта UI / store / API (api, store, types, lib) |
+| `navigation-router-ui.mdc` | Навигация в UI-компонентах (slim) |
+| `navigation-router-stack.mdc` | Полный аудит стека навигации (App Router / SPA) |
 | `http-client.mdc` | Один HTTP‑стек, контракты из `@/types`, без разбросанного низкоуровневого API |
 | `api-services.mdc` | Сервисы, мапперы, вызовы через прикладные API‑клиенты |
 | `store-rtk.mdc` | Redux Toolkit, thunk’и, типизация ошибок/ответов как в коде репо |
-| `types-public-imports.mdc` | Импорты только через barrel `@/types` |
-| `api-public-imports.mdc` | Импорты только через barrel `@/api` (вне `app/src/api/**`) |
+| `public-imports.mdc` | Импорты `@/types`, `@/types/enums`, `@/api` (вне `app/src/api/**`); stubs: `types-public-imports.mdc`, `api-public-imports.mdc` |
 | `layer-barrel-exports.mdc` | Двухуровневые barrel для слоёв с public API (`@/api`, `@/types`, `@/core`, …) |
 | `types-jsdoc.mdc` | JSDoc для типов в `app/src/types` (русский текст, `[computed]`, без `@param`/`@returns`) |
 | `no-type-assertion-as-import-export.mdc` | Ограничение `as`, в т.ч. `instanceof` для ошибок транспорта в `catch` |
@@ -55,6 +74,6 @@
 | `playwright-agents.mdc`, `tests-e2e-structure.mdc` | E2E |
 | `react-ui.mdc` | React/Next UI: структура компонентов, соседние `ComponentName.data.ts` / `.utils.ts`, стили, пропсы |
 
-**Коллизии формулировок:** если в разных `.mdc` расходятся детали **импорта типов**, источник правды — **`types-public-imports.mdc`** (`@/types`, `@/types/enums`); по **импорту из API‑слоя** (store, UI, прочий код вне `app/src/api/**`) — **`api-public-imports.mdc`** (`@/api`), в том же смысле что правило ESLint `no-restricted-imports` в `app/eslint.config.mjs`.
+**Коллизии формулировок:** импорт типов и API — источник правды **`public-imports.mdc`**; дублирует ESLint `no-restricted-imports` в `app/eslint.config.mjs`.
 
 Задачи на **сеть, замену HTTP‑библиотеки, новые эндпоинты**: опираться на **`http-client.mdc`** + **`api-services.mdc`** + **`store-rtk.mdc`**.

package/presets/cursor/next/rules/agent-team-intake.mdc

@@ -1,6 +1,6 @@
 ---
-description: When the user describes a new task, feature, bug, or implementation request (not a pure question), suggest or use /task to run the agent team router. Lightweight intake hint only.
-alwaysApply: true
+description: Use when user posts a work request without /task — suggest or use /task to run the agent team router. Lightweight intake hint only.
+alwaysApply: false
 ---
 
 # Agent team intake

package/presets/cursor/next/rules/agent-team-orchestrator.mdc

@@ -7,6 +7,8 @@ alwaysApply: false
 
 Parent agent = **manager**. Router plans; specialists execute. Artifacts: `.cursor/team/tasks/<slug>/`.
 
+Work request без `/task` — см. **`agent-team-intake.mdc`** (когда предлагать router вместо прямого кодинга).
+
 ## Entry points
 
 | Command | When |
@@ -121,6 +123,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. Hook supports both.
 
+## 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 — см. **`agent-team-intake.mdc`**.
+
 ## 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/cursor/next/rules/api-public-imports.mdc

@@ -1,29 +1,8 @@
 ---
-description: Импорт из API-слоя только через публичный barrel @/api
-globs: app/src/**/*.ts,app/src/**/*.tsx
+description: Moved to public-imports.mdc — read that file instead
 alwaysApply: false
 ---
 
-# Импорты из `@/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 по **`layer-barrel-exports.mdc`**.
-
-## Внутри слоя `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/**`.
+Содержимое перенесено в **`public-imports.mdc`** (раздел `@/api`).

package/presets/cursor/next/rules/api-services.mdc

@@ -12,7 +12,7 @@ alwaysApply: false
   - заголовками и кодами ответов,
   - DTO backend.
 - Предоставлять UI и store **стабильный доменный интерфейс**:
-  - функции, работающие с доменными типами из `@/types` (`types-public-imports.mdc`).
+  - функции, работающие с доменными типами из `@/types` (`public-imports.mdc`).
   - мапперы между DTO и доменными типами.
 
 # Структура модулей
@@ -23,7 +23,7 @@ alwaysApply: false
   - файлы с вызовами 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'`, **`api-public-imports.mdc`**).
+  - при необходимости — локальные `index.ts` / barrel внутри модуля для структуры **внутри** `app/src/api/**`; **снаружи** этого слоя UI, store и остальной код импортируют только из корневого barrel `app/src/api/index.ts` (`import … from '@/api'`, **`public-imports.mdc`**).
 
 # Мапперы и типы
 
@@ -54,5 +54,5 @@ alwaysApply: false
 - Не смешивать слой API и UI/store:
   - компоненты не должны зависеть от DTO;
   - store не должен сам собирать URL/коды эндпоинтов и не обходить сервисы; **транспортный тип ответа** и **контракт ошибки** из `@/types` (как у прикладного клиента) допустимы во thunk при разборе `catch`/payload, если так выстроен сервис (см. `store-rtk.mdc`, `http-client.mdc`).
-- При использовании API‑сервисов в UI, store и утилитах **вне** `app/src/api/**` импортировать **только** из `@/api` (корневой barrel), см. **`api-public-imports.mdc`**; внутри слоя API — по относительным путям или `@/api/services/**` / `@/api/clients/**`, не дублируя публичный контракт мимо корневого barrel для внешних потребителей.
+- При использовании API‑сервисов в UI, store и утилитах **вне** `app/src/api/**` импортировать **только** из `@/api` (корневой barrel), см. **`public-imports.mdc`**; внутри слоя API — по относительным путям или `@/api/services/**` / `@/api/clients/**`, не дублируя публичный контракт мимо корневого barrel для внешних потребителей.
 

package/presets/cursor/next/rules/architecture-boundaries-ui.mdc

@@ -0,0 +1,15 @@
+---
+description: Границы слоя UI — slim rule для правок компонентов (без полной карты store/API)
+globs: app/src/ui/**/*.tsx,app/src/ui/**/*.ts
+alwaysApply: false
+---
+
+# UI layer boundaries (slim)
+
+- **Импорты:** `@/ui/**`, `@/store/**`, типы из `@/types` и enum из `@/types/enums`, API — только `from '@/api'` (`public-imports.mdc`).
+- **Запрещено:** прямой HTTP‑клиент; знание DTO — только доменные типы.
+- **Состояние:** сценарии с записью и координация шагов — через store/thunk; узкие прямые вызовы `@/api` для чтения — только как в соседних фичах.
+- **Организация:** алиас `@/`; без deep‑импортов в чужие фичи; только public API.
+- **Barrel:** при новых публичных символах — реэкспорт по `layer-barrel-exports.mdc` (правило грузится на `index.ts`).
+
+Полная карта слоёв (store, API, порты‑адаптеры): **`architecture-boundaries.mdc`** — при правках `app/src/api`, `store`, `types`, `lib`.

package/presets/cursor/next/rules/architecture-boundaries.mdc

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

package/presets/cursor/next/rules/code-quality-and-refactoring.mdc

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

package/presets/cursor/next/rules/code-review-mr.mdc

@@ -5,50 +5,24 @@ alwaysApply: false
 
 # Code review merge requests
 
-- **Когда применять**
-  - Если пользователь просит: "проведи ревью", "оценить MR/ветку/дифф", "посмотри изменения".
-  - Опираться на локальный репозиторий: текущую ветку, `git diff` и открытые файлы, а не на данные внешнего API хостинга.
-
-- **Что обязан проверить агент**
-  - **Архитектура и слои**:
-    - Соблюдение правил из `architecture-boundaries.mdc`, `next-app-core.mdc` и при сетевых изменениях — `http-client.mdc`:
-      - UI (`app/src/ui/**`) не ходит напрямую в HTTP‑клиент и не знает DTO.
-      - Store (`app/src/store/**`) не зависит от UI; границы транспортных типов и ошибок — `store-rtk.mdc` / `http-client.mdc`.
-      - API (`app/src/api/**`) не тянет UI/store, использует мапперы; без прямого `fetch` в сервисах (кроме оговорённых исключений).
-  - **Импорты и организация кода**:
-    - Использование алиаса `@/...` вместо относительных импортов выше по дереву.
-    - Отсутствие deep‑импортов во внешние фичи; использование только public API; в файлах вне `app/src/api/**` импорты из API — только `from '@/api'` (`api-public-imports.mdc`, дублирует ESLint).
-    - При новых/изменённых модулях в регламентированных слоях — реэкспорт публичных символов в корневой barrel по **`layer-barrel-exports.mdc`**.
-    - Размещение новых файлов в корректных слоях и директориях фич.
-  - **Типы и TS‑строгость**:
-    - Не допускать новых `any`; предпочитать доменные типы из `@/types` (barrel, см. `types-public-imports.mdc`).
-    - Проверять корректность пропсов/возвращаемых типов, особенно в UI и API‑слое.
-  - **UI и стили**:
-    - Для компонентов и стилей сверяться с `react-ui.mdc` и `next-app-core.mdc`:
-      - Соблюдать принятый в проекте способ стилей и общие UI‑примитивы/токены, а не "магические" значения.
-      - Сохранять консистентность с существующими компонентами и паттернами.
-  - **Тесты**:
-    - Проверять, что для нетривиальных изменений:
-      - либо обновлены/добавлены unit‑тесты (`tests-unit.mdc`),
-      - либо e2e‑сценарии/спеки отражают новую логику (`playwright-agents.mdc`, `tests-e2e-structure.mdc`).
-    - При правках **общего HTTP‑клиента** — наличие/актуальность **behavior‑тестов клиента** (`http-client.mdc`, `tests-unit.mdc`).
-    - Указывать, какие именно тесты стоит добавить или поправить.
-  - **Линтеры (обязательно)** — **`post-change-lint.mdc`**:
-    - Перед финализацией отчёта по ревью и после любых правок по итогам ревью: полный прогон **`lint:js`** и **`lint:css`** из `app/`.
-    - В отчёт включить **все сообщения ESLint и Stylelint (errors и warnings)** по файлам из диффа MR/ветки; запуск — по всему проекту, фильтрация вывода — к путям из `git diff`.
-    - Не считать ревью/правки завершёнными, пока линтеры не проходят или не зафиксирован блокер в ответе.
-    - Полная валидация как в CI: **`lint`** (= `lint:js` + `lint:css` + `type-check`) — уместна перед итогом крупного MR.
-
-- **Глубина и формат ревью**
-  - Фокус на **изменениях MR** (дифф относительно целевой ветки), а не на всём проекте.
-  - Сначала дать **высокоуровневый обзор** (что делает MR, риски, архитектурные замечания), затем список конкретных комментариев.
-  - Каждый комментарий делать:
-    - **конкретным** (указать файл/участок и проблему),
-    - **практичным** (предложить вариант исправления, опираясь на существующие паттерны),
-    - без "больших рефакторингов" в духе `code-quality-and-refactoring.mdc`, если задача локальная.
-
-- **Ограничения для агента**
-  - Не придумывать несуществующие метаданные из хостинга (лейблы MR, авторов, статусы CI), если их нет в локальных данных.
-  - Не менять общую архитектуру фичи без прямого запроса пользователя.
-  - Следовать принципу "boy scout rule": предлагать улучшения, которые реально можно внести в рамках MR.
+On-demand rule for review flows. **Procedure and output format:** skill `code-review`.
 
+## Checklist references
+
+- Architecture layers: `architecture-boundaries.mdc`, `next-app-core.mdc`; network: `http-client.mdc`
+- Imports: `public-imports.mdc`, `layer-barrel-exports.mdc`
+- UI: `react-ui.mdc`
+- Tests: `tests-unit.mdc`, `playwright-agents.mdc`, `tests-e2e-structure.mdc`
+- Lint gate before final report: `post-change-lint.mdc`
+
+## When to load
+
+- User asks for review/MR/diff
+- Pipeline step `code-reviewer`
+- BUGBOT automated review
+
+## Constraints
+
+- Focus on MR diff, not the whole repo.
+- Use local `git diff` — do not invent hosting metadata.
+- Boy scout rule: suggest fixes feasible within the MR scope.