@bonesofspring/ai-rules 0.2.4 → 0.2.6

package/presets/claude/ios-swift/team/fixtures/feature-full.json

@@ -4,32 +4,15 @@
   "profile": "full",
   "summary": "Multi-layer Feature with XCUITest coverage",
   "steps": [
-    {
-      "agent": "task-analyst",
-      "label": "Clarify and decompose"
-    },
-    {
-      "agent": "feature-developer",
-      "label": "Implement + unit tests",
-      "scope": "unit-in-dev"
-    },
-    {
-      "agent": "build-verifier",
-      "label": "xcodebuild + lint + unit smoke"
-    },
-    {
-      "agent": "code-reviewer",
-      "label": "Code review"
-    },
-    {
-      "agent": "qa-tester",
-      "label": "XCUITest",
-      "scope": "e2e-only"
-    }
-  ],
-  "humanGates": [
-    "after:task-analyst"
+    { "agent": "task-analyst", "label": "Clarify and decompose" },
+    { "agent": "solution-architect", "label": "Design boundaries", "model": "strong" },
+    { "agent": "feature-developer", "label": "Implement + unit tests", "scope": "unit-in-dev" },
+    { "agent": "build-verifier", "label": "xcodebuild + lint + unit smoke", "model": "cheap" },
+    { "agent": "security-reviewer", "label": "Security review", "model": "strong" },
+    { "agent": "code-reviewer", "label": "Code review", "model": "cheap" },
+    { "agent": "qa-tester", "label": "XCUITest", "scope": "e2e-only" }
   ],
+  "humanGates": ["after:task-analyst"],
   "autoChain": true,
   "skipped": [
     {

package/presets/claude/ios-swift/team/fixtures/feature-light.json

@@ -4,30 +4,15 @@
   "profile": "light",
   "summary": "Trivial single-file Swift change with explicit AC",
   "steps": [
-    {
-      "agent": "feature-developer",
-      "label": "Implement"
-    },
-    {
-      "agent": "build-verifier",
-      "label": "Validation gate"
-    }
+    { "agent": "feature-developer", "label": "Implement", "model": "cheap" },
+    { "agent": "build-verifier", "label": "Validation gate", "model": "cheap" }
   ],
   "humanGates": [],
   "autoChain": true,
   "skipped": [
-    {
-      "agent": "task-analyst",
-      "reason": "Explicit AC and single-file scope"
-    },
-    {
-      "agent": "code-reviewer",
-      "reason": "Light profile"
-    },
-    {
-      "agent": "qa-tester",
-      "reason": "No XCUITest AC"
-    },
+    { "agent": "task-analyst", "reason": "Explicit AC and single-file scope" },
+    { "agent": "code-reviewer", "reason": "Light profile" },
+    { "agent": "qa-tester", "reason": "No XCUITest AC" },
     {
       "agent": "playwright-test-planner",
       "reason": "iOS uses XCUITest; not needed for light"

package/presets/claude/next/README.md

@@ -16,11 +16,19 @@
 
 Файлы правил — обычный Markdown с опциональным YAML frontmatter (`paths:` для скоупа по путям), не формат `.mdc` Cursor.
 
+## Preset taxonomy & contributing
+
+- **Layers:** Core → Stack → Platform — [`../../_shared/README.md`](../../_shared/README.md)
+- **Contribution guide:** [`../../docs/PRESET-CONTRIBUTION.md`](../../docs/PRESET-CONTRIBUTION.md)
+- **Cursor SoT:** `presets/cursor/next/` — этот пресет derived twin; правки Cursor first, same PR
+- **Cursor→Claude map + core table:** [`rules/README.md`](./rules/README.md)
+- **Author meta:** `tooling-and-review/preset-*.md` (`paths:` on `packages/ai-rules/presets/**` only)
+
 ## Agent team workflow
 
 Cursor-пресет и Claude-пресет используют один и тот же смысловой workflow:
 
 - `/task <desc>` → `task-router` → `pipeline.json`;
 - `/task-continue <slug>` → продолжение после human gate;
-- `.claude/agents/*.md` → 20 ролей: planning (router, analyst, architect, migration, api-contract), implementation (debugger, ci-investigator, developer), review (code, a11y, security, perf), testing (QA, unit trio, playwright trio), docs (tech-writer);
+- `.claude/agents/*.md` → **21** ролей: planning (router, analyst, architect, migration, api-contract), implementation (debugger, ci-investigator, developer), review (code, a11y, security, perf), testing (QA, unit trio, playwright trio), docs (tech-writer), build (build-verifier);
 - `.claude/team/tasks/<slug>/` → handoff-артефакты (`brief.md`, `decomposition.md`, `review.md`, `migration-plan.md`, `ci-report.md`, `status.json`, …).

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

@@ -50,6 +50,22 @@
 
 Папка копируется в `.claude/agents/` при `ai-rules init claude --preset next`.
 
+## Model matrix (frontmatter `model`)
+
+SoT по умолчанию — YAML `model` в каждом agent-файле. Опциональный `steps[].model` (`cheap` \| `standard` \| `strong`) переопределяет тир на шаге (см. `task-router.md`, `tooling-and-review/agent-team-orchestrator.md`).
+
+| Tier | Default frontmatter | Agents |
+|------|---------------------|--------|
+| **cheap** | `fast` | `task-router`, `task-analyst`, `build-verifier`, `code-reviewer`, `tech-writer` |
+| **standard** | `inherit` or `sonnet` | `feature-developer`, `debugger`, `ci-investigator`, `api-contract-reviewer`, `accessibility-reviewer`, `qa-tester`, `unit-test-*`, `playwright-test-*` (`sonnet` where already pinned) |
+| **strong** | `opus` | `solution-architect`, `migration-specialist`, `security-reviewer`, `performance-auditor` |
+
+**Notes**
+
+- Claude Code aliases: `haiku` / `sonnet` / `opus` / `inherit` (full IDs also OK). Preset keeps `fast` for cheap agents for cross-tooling parity with Cursor; if ignored, prefer `haiku` locally.
+- Resolution order (Claude Code): env `CLAUDE_CODE_SUBAGENT_MODEL` → per-invocation `model` → frontmatter → parent session.
+- Never put `strong` on `build-verifier` / `tech-writer` / `task-router`.
+
 ## Оркестрация
 
 | Command | Назначение |
@@ -88,6 +104,7 @@
 | `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 |
+| `model` | no | `cheap` \| `standard` \| `strong` — pipeline tier override; omit → agent frontmatter |
 
 ### Minimal template
 
@@ -108,26 +125,43 @@
 }
 ```
 
-### Example: parallel reviewers
+### Example: parallel reviewers + model tiers
 
 ```json
 {
   "intent": "feature",
+  "profile": "full",
   "steps": [
     { "agent": "task-analyst", "label": "Clarify" },
+    { "agent": "solution-architect", "label": "Design boundaries", "model": "strong" },
     { "agent": "feature-developer", "label": "Implement", "scope": "unit-in-dev" },
-    { "agent": "build-verifier", "label": "Validation gate" },
+    { "agent": "build-verifier", "label": "Validation gate", "model": "cheap" },
     {
       "agent": ["accessibility-reviewer", "security-reviewer"],
       "parallel": true,
-      "label": "A11y and security"
+      "label": "A11y and security",
+      "model": "strong"
     },
-    { "agent": "code-reviewer", "label": "Review" }
+    { "agent": "code-reviewer", "label": "Review", "model": "cheap" }
   ],
   "humanGates": ["after:task-analyst"]
 }
 ```
 
+### Example: light profile with cheap models
+
+```json
+{
+  "intent": "feature",
+  "profile": "light",
+  "steps": [
+    { "agent": "feature-developer", "label": "Implement", "model": "cheap" },
+    { "agent": "build-verifier", "label": "Validation gate", "model": "cheap" }
+  ],
+  "humanGates": []
+}
+```
+
 ### Example: bugfix skipIf
 
 ```json

package/presets/claude/next/agents/build-verifier.md

@@ -25,6 +25,30 @@ Use **`rules/tooling-and-review/package-manager.md`** for the repo package manag
 
 Prefer **`lint`** (= js + css + type-check) before handoff on large changes.
 
+## Preset-structure validation (when scope is preset / packages/ai-rules)
+
+When validating **preset packaging** changes (paths under `packages/ai-rules/presets/**`, or `scope: preset-structure-validation` / `preset-artifacts-only`), run these checks. Skip app lint if there are **no** app source changes.
+
+### FAIL (all stacks)
+
+1. **Token budget:** Cursor `alwaysApply: true` count ≤ **3**; Claude rules without `paths:` === **3** (**exclude `**/README.md`** — Option A). Meta `preset-*` rules must **not** be session-start (must have `paths:`).
+2. **Leakage (next):** hooks/agents must not require `xcuitest-test-*` handoffs or `xcodebuild` as the default Next post-change gate. See `tooling-and-review/preset-no-cross-stack-leakage.md`.
+3. **Mapping / README:** `rules/README.md` must include a Cursor→Claude mapping table; document core→stack mapping when `_shared` consumers exist.
+4. **shared-core consumers:** if `_shared/core/**` changed, every file with matching `<!-- shared-core: … -->` in this PR must be updated (or intentional fork documented).
+5. **Twin presence:** Cursor rule change without Claude twin same PR → **FAIL** (next, ios-swift, and go). Domain twin body ≥15 lines; thin aliases may be shorter.
+6. **Session-start body budget:** sum body lines of the **3** intended session-start rules ≤ **120** (stretch ≤100); do **not** include `**/README.md` — record in validation-report; FAIL if grossly over.
+7. **Embed drift (soft by default):** run `packages/ai-rules/scripts/check-shared-core-drift.sh`. Document DRIFT; `AI_RULES_DRIFT_FAIL=1` to enforce. Lineage stems excluded from body equality.
+8. **Dogfood (monorepo soft):** prefer `packages/ai-rules/scripts/sync-dogfood-cursor.sh`; mass dogfood deletion without migration doc → risk / FAIL for maintainers.
+
+### Soft notes
+
+- Thin aliases may be &lt;15 body lines.
+- Embed vs lineage: `docs/PRESET-CONTRIBUTION.md`, `_shared/README.md`.
+
+### ios-swift-only checks
+
+When ios-swift paths are also in the PR, apply ios-swift verifier checks (chain fork, Playwright leakage) — **FAIL**.
+
 ## Output
 
 Write `.claude/team/tasks/<slug>/validation-report.md`:

package/presets/claude/next/agents/code-reviewer.md

@@ -61,3 +61,7 @@ Update `status.json`:
 If **REQUEST_CHANGES**, set `"state": "changes_requested"` (hook will re-invoke feature-developer).
 
 Do not mix this output with retrospective facilitation — keep review and retro separate.
+
+## Design guidance
+
+- Load `design-guidance` (rule stem) when assessing structure, smells, or pattern fit.

package/presets/claude/next/agents/debugger.md

@@ -61,3 +61,7 @@ Update `status.json`:
 Handoff summary: root cause, recommended fix, files touched (if any).
 
 Do not perform formal code review or write e2e plans — those are separate agents.
+
+## Design guidance
+
+- Load `design-guidance` (rule stem) when assessing structure, smells, or pattern fit.

package/presets/claude/next/agents/feature-developer.md

@@ -25,3 +25,7 @@ You are a senior frontend developer working in a Next.js monorepo with strict la
 Update `status.json` (`currentAgent`: `feature-developer`, `state`: `completed`). Handoff: tasks done, files by layer, unit specs, validation result, gaps for build-verifier/reviewer.
 
 Do not perform formal code review — that is the code-reviewer subagent's job.
+
+## Design guidance
+
+- Load `design-guidance` (rule stem) when assessing structure, smells, or pattern fit.

package/presets/claude/next/agents/migration-specialist.md

@@ -1,7 +1,7 @@
 ---
 name: migration-specialist
 description: Migration planning specialist for library upgrades, Next.js major versions, HTTP client swaps, and phased refactors with rollback. Produces migration-plan.md only; never writes production code.
-model: inherit
+model: opus
 ---
 
 You are a migration specialist for a Next.js frontend with strict layer boundaries.
@@ -67,3 +67,7 @@ Update `status.json`:
 ```
 
 Hand off: orchestrator runs human gate (if configured), then `feature-developer` executes phases from the plan.
+
+## Design guidance
+
+- Load `design-guidance` (rule stem) when assessing structure, smells, or pattern fit.

package/presets/claude/next/agents/performance-auditor.md

@@ -1,7 +1,7 @@
 ---
 name: performance-auditor
 description: Performance audit specialist. Reviews bundle size, lazy loading, render patterns, data fetching waterfalls, and Core Web Vitals risks. Writes perf-report.md only; never edits production code.
-model: inherit
+model: opus
 ---
 
 You are a frontend performance auditor for a Next.js React application.
@@ -66,3 +66,7 @@ Update `status.json`:
 For standalone `perf-audit` intent, suggest `/technical-retro` or a follow-up `/task` to implement fixes.
 
 Do not modify production code.
+
+## Design guidance
+
+- Load `design-guidance` (rule stem) when assessing structure, smells, or pattern fit.

package/presets/claude/next/agents/qa-tester.md

@@ -54,3 +54,7 @@ Provide summary:
 - Test run results
 - Gaps vs acceptance criteria
 - Suggest `/technical-retro` with the slug when done
+
+## Design guidance
+
+- Load `design-guidance` (rule stem) when assessing structure, smells, or pattern fit.

package/presets/claude/next/agents/security-reviewer.md

@@ -1,7 +1,7 @@
 ---
 name: security-reviewer
 description: Security review specialist. Audits auth flows, token handling, XSS risks, secrets in diff, and unsafe DOM/API usage. Writes security-review.md only; never edits production code.
-model: inherit
+model: opus
 ---
 
 You are a frontend security reviewer for a Next.js TypeScript application.

package/presets/claude/next/agents/solution-architect.md

@@ -1,7 +1,7 @@
 ---
 name: solution-architect
 description: Solution architect for cross-layer features, API boundaries, and technical design before implementation. Use for spike intent or when router adds architect step for complex features. Writes design docs only; never writes production code.
-model: inherit
+model: opus
 ---
 
 You are a solution architect for a Next.js frontend with strict layer boundaries (types, api, store, ui).
@@ -68,3 +68,7 @@ Update `status.json`:
 For `spike` intent with human gate after architect: set `"state": "awaiting_approval"` if design needs user sign-off.
 
 Handoff: summary of design decisions and recommended next steps for developer.
+
+## Design guidance
+
+- Load `design-guidance` (rule stem) when assessing structure, smells, or pattern fit.

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

@@ -109,3 +109,7 @@ When DoR is reached and artifacts are saved:
 3. **Stop** and ask the user to review artifacts. Tell them to run `/task-continue <slug>` after approval or reply with corrections.
 
 Do not invoke the developer or any implementation subagent.
+
+## Design guidance (optional)
+
+- Optional: Load `design-guidance` (rule stem) when assessing structure, smells, or pattern fit — only when decomposing refactor/architecture tasks (not default).

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

@@ -64,7 +64,21 @@ Fixtures: `.claude/team/fixtures/` (feature-full, feature-light, bugfix-standard
 - 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.
+
+## Model tiers (`steps[].model`)
+
+Optional per-step field: `"model": "cheap" | "standard" | "strong"`. Omit → agent frontmatter default (see **Model matrix** in `agents/README.md`).
+
+| When | What to write |
+|------|----------------|
+| `profile: light` | set `cheap` on **all** steps (exception: unclear bug root cause on `debugger` → `strong`) |
+| `profile: standard` | omit (frontmatter defaults) |
+| `profile: full` | set `strong` on `solution-architect`, `migration-specialist`, `security-reviewer`, `performance-auditor` when present; omit others |
+| `intent: spike` | set `strong` on `solution-architect` (and analyst may stay default/`cheap`) |
+| `intent: perf-audit` / security-heavy feature | `strong` on auditor/reviewer step |
+| Always | **never** `strong` on `build-verifier`, `tech-writer`, `task-router` |
+
+Claude Code mapping when orchestrator invokes Agent tool: `cheap` → `haiku` (or rely on frontmatter `fast`); `standard` → omit / `sonnet` / inherit; `strong` → pass `opus` (or rely on frontmatter `opus`). Prefer explicit per-invocation `model` when frontmatter is unreliable.
 
 ## humanGates (defaults)
 

package/presets/claude/next/agents/unit-test-generator.md

@@ -35,3 +35,7 @@ Update `status.json`:
   "updatedAt": "<ISO8601>"
 }
 ```
+
+## Design guidance
+
+- Load `design-guidance` (rule stem) when assessing structure, smells, or pattern fit.

package/presets/claude/next/agents/unit-test-healer.md

@@ -36,3 +36,7 @@ Update `status.json`:
   "updatedAt": "<ISO8601>"
 }
 ```
+
+## Design guidance
+
+- Load `design-guidance` (rule stem) when assessing structure, smells, or pattern fit.

package/presets/claude/next/agents/unit-test-planner.md

@@ -60,3 +60,7 @@ Update `status.json`:
 ```
 
 Do not write `*.spec.ts` files — that is `unit-test-generator`'s job.
+
+## Design guidance
+
+- Load `design-guidance` (rule stem) when assessing structure, smells, or pattern fit.

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

@@ -1,11 +1,21 @@
 # `.claude/rules` (preset next)
 
-В Claude Code все `.md` под `rules/` **обнаруживаются рекурсивно**. Правила без YAML frontmatter загружаются **в начале сессии**; с `paths:` — **только при работе** с matching-файлами.
+В Claude Code все `.md` под `rules/` **обнаруживаются рекурсивно**. Тела **derived** из Cursor SoT; индексы — не второй SoT.
+
+## SoT sync
+
+| Principle | Detail |
+|-----------|--------|
+| **SoT** | `presets/cursor/next/rules/*.mdc` — edit here first |
+| **Derive** | Claude topic `.md` = body + `paths:` (from Cursor `globs:` / requestable triggers) |
+| **Drop** | Cursor-only keys (`alwaysApply`); keep short `description` |
+| **Checklist** | change Cursor → update Claude twin **same PR** (**FAIL** if missing — next, ios-swift, and go; see `preset-twin-sync` / build-verifier) |
+| **Shared core** | `presets/_shared/core/**` — see `<!-- shared-core: … -->` markers; taxonomy in `_shared/README.md` |
 
 ## Loading strategy
 
 - **Session start (no `paths:`):** ровно **3** — `next-app-core`, `package-manager`, `code-quality`
-- **On-demand (`paths:` or via commands):** `post-change-lint` (**обязателен после правок кода**), `agent-team-intake`, `agent-team-orchestrator`, `code-review-mr`, architecture, imports, UI, tests, feature-delivery-workflow, reference-features, next-app-router, react-a11y-coding
+- **On-demand (`paths:` or via commands):** `post-change-lint` (**обязателен после правок кода**), `agent-team-intake`, `agent-team-orchestrator`, `code-review-mr`, architecture, imports, UI, tests, feature-delivery-workflow, `design-guidance`, reference-features, next-app-router, react-a11y-coding, `technical-retro`, **preset-*** meta (paths on `packages/ai-rules/presets/**`)
 - **Skills:** long workflows (`feature-delivery`, `code-review`, …)
 
 ### UI edit bundle (consolidated paths)
@@ -21,27 +31,70 @@
 
 **Не грузятся на типичный UI edit:** `architecture/architecture-boundaries.md` (api/store/types/lib), `architecture/layer-barrel-exports.md` (только `index.ts`), `stack/navigation-router.md` (только `app/src/app/**`). Стили колокации — в `react-ui.md` (не отдельный stub).
 
-## С чего начать
+## Cursor → Claude mapping
 
-- **`commands/task.md`** — router → `pipeline.json` → agents
-- **`architecture/reference-features.md`** — заполнить TBD после init
-- **`architecture/feature-delivery-workflow.md`** — порядок слоёв
+| Cursor `.mdc` (SoT) | Claude topic |
+|---------------------|--------------|
+| `next-app-core.mdc` | `stack/next-app-core.md` |
+| `package-manager.mdc` | `tooling-and-review/package-manager.md` |
+| `code-quality-and-refactoring.mdc` | `tooling-and-review/code-quality.md` |
+| `design-guidance.mdc` | `tooling-and-review/design-guidance.md` |
+| `next-app-router.mdc` | `stack/next-app-router.md` |
+| `arrow-functions.mdc` | `stack/arrow-functions.md` |
+| `types-jsdoc.mdc` | `stack/types-jsdoc.md` |
+| `no-type-assertion-as-import-export.mdc` | `stack/no-type-assertion.md` |
+| `navigation-router-stack.mdc` | `stack/navigation-router.md` |
+| `navigation-router-ui.mdc` | `stack/navigation-router-ui.md` |
+| `architecture-boundaries.mdc` | `architecture/architecture-boundaries.md` |
+| `architecture-boundaries-ui.mdc` | `architecture/architecture-boundaries-ui.md` |
+| `feature-delivery-workflow.mdc` | `architecture/feature-delivery-workflow.md` |
+| `reference-features.mdc` | `architecture/reference-features.md` |
+| `public-imports.mdc` | `architecture/public-imports.md` |
+| `layer-barrel-exports.mdc` | `architecture/layer-barrel-exports.md` |
+| `api-services.mdc` | `api-and-data/api-services.md` |
+| `http-client.mdc` | `api-and-data/http-client.md` |
+| `store-rtk.mdc` | `api-and-data/store-rtk.md` |
+| `react-ui.mdc` | `ui-and-accessibility/react-ui.md` |
+| `react-a11y-coding.mdc` | `ui-and-accessibility/react-a11y-coding.md` |
+| `no-props-spread.mdc` | `ui-and-accessibility/no-props-spread.md` |
+| `css-property-order-stylelint.mdc` | `ui-and-accessibility/css-property-order.md` |
+| `tests-unit.mdc` | `testing/tests-unit.md` |
+| `tests-e2e-structure.mdc` | `testing/tests-e2e-structure.md` |
+| `playwright-agents.mdc` | `testing/playwright-agents.md` |
+| `post-change-lint.mdc` | `tooling-and-review/post-change-lint.md` |
+| `code-review-mr.mdc` | `tooling-and-review/code-review-mr.md` |
+| `agent-team-intake.mdc` | `tooling-and-review/agent-team-intake.md` |
+| `agent-team-orchestrator.mdc` | `tooling-and-review/agent-team-orchestrator.md` |
+| `technical-retro.mdc` | `tooling-and-review/technical-retro.md` |
+| `preset-layering.mdc` | `tooling-and-review/preset-layering.md` |
+| `preset-twin-sync.mdc` | `tooling-and-review/preset-twin-sync.md` |
+| `preset-token-budget.mdc` | `tooling-and-review/preset-token-budget.md` |
+| `preset-pr-checklist.mdc` | `tooling-and-review/preset-pr-checklist.md` |
+| `preset-no-cross-stack-leakage.mdc` | `tooling-and-review/preset-no-cross-stack-leakage.md` |
 
-## Каталог (новые и ключевые)
+## Core → stack mapping
 
-| Файл | Назначение |
-|------|------------|
-| `architecture/reference-features.md` | Эталонные пути UI/store/API |
-| `stack/next-app-router.md` | App Router, RSC |
-| `ui-and-accessibility/react-a11y-coding.md` | A11y при кодинге UI |
-| `architecture/feature-delivery-workflow.md` | Сквозной чеклист (paths) |
-| `architecture/architecture-boundaries-ui.md` | Slim границы UI при правках компонентов |
-| `architecture/architecture-boundaries.md` | Полная карта UI / store / API |
-| `stack/navigation-router-ui.md` | Навигация в UI-компонентах (slim) |
-| `stack/navigation-router.md` | Полный аудит стека навигации |
-| `tooling-and-review/agent-team-orchestrator.md` | Pipeline, build-verifier, parallel |
-| `agents/build-verifier.md` | Validation gate agent |
-
-Полный список — см. подпапки `architecture/`, `stack/`, `api-and-data/`, `ui-and-accessibility/`, `testing/`, `tooling-and-review/`.
+| Shared core | Cursor adapter | Notes |
+|-------------|----------------|-------|
+| `quality/code-quality-and-refactoring.md` | `code-quality-and-refactoring.mdc` / `code-quality.md` | + Stack notes (ESLint/CSS) |
+| `quality/design-guidance.md` | `design-guidance.mdc` / `design-guidance.md` | requestable smells/GoF |
+| `agent-team/agent-team-orchestrator.md` | `agent-team-orchestrator.mdc` | Roles in Stack notes |
+| `agent-team/agent-team-intake.md` | `agent-team-intake.mdc` | thin alias |
+| `architecture/feature-delivery-workflow.md` | `feature-delivery-workflow.mdc` | Next layer checklist in Stack notes |
+| `architecture/reference-features.template.md` | `reference-features.mdc` | path table in Stack notes |
+| `review/code-review-mr.md` | `code-review-mr.mdc` | Next checklist refs |
+| `review/technical-retro.md` | `technical-retro.mdc` | thin alias |
+| `meta/preset-*.md` | `preset-*.mdc` | author globs only |
+
+## Folders
+
+| Папка | О чём |
+|-------|--------|
+| `stack/` | Next core, router, conventions |
+| `architecture/` | Границы, feature-delivery, reference-features, imports |
+| `api-and-data/` | HTTP, services, store |
+| `testing/` | Unit, e2e, Playwright |
+| `ui-and-accessibility/` | React UI, a11y, props |
+| `tooling-and-review/` | Quality, review, lint, agent-team, retro, **preset meta** |
 
 **Коллизии:** импорт типов и API — **`architecture/public-imports.md`**.

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

@@ -6,6 +6,9 @@ paths:
   - app/src/types/**/*
 ---
 
+<!-- shared-core: architecture/feature-delivery-workflow.md -->
+
+
 # Доставка фичи (сквозной порядок)
 
 Типичная фича с данными с backend и общим состоянием. Детали слоёв — `architecture/architecture-boundaries.md`, `stack/next-app-core.md`.
@@ -64,6 +67,8 @@ flowchart LR
 - HTTP-клиент из компонента/thunk в обход сервиса.
 - Deep-import `@/api/services/**` из UI/store.
 - `{...props}` — `ui-and-accessibility/no-props-spread.md`.
+- **Ubiquitous language:** имена Domain/типов отражают предметную область фичи — не смешивать транспорт/фреймворк-термины в домен без нужды.
+- Load `design-guidance` (rule stem) when assessing structure, smells, or pattern fit.
 
 ## Матрица: зона → правила
 

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

@@ -6,10 +6,15 @@ paths:
   - app/src/types/**/*
 ---
 
+<!-- shared-core: architecture/reference-features.template.md -->
+
+
 # Эталонные фичи (reference features)
 
 Перед реализацией найди фичу того же типа и **повтори её структуру**, не изобретая новую организацию файлов.
 
+Taxonomy / shared core: [`presets/_shared/README.md`](../../../../_shared/README.md) · [Preset contribution guide](../../../../docs/PRESET-CONTRIBUTION.md).
+
 ## Таблица эталонов
 
 Замени **TBD** на реальные пути после договорённости в команде (или при `ai-rules init` в целевом репо):

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

@@ -4,6 +4,8 @@ paths:
   - .claude/team/**/*
 ---
 
+<!-- shared-core: agent-team/agent-team-intake.md -->
+
 # 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

@@ -5,6 +5,9 @@ paths:
   - .claude/agents/**/*
 ---
 
+<!-- shared-core: agent-team/agent-team-orchestrator.md -->
+
+
 # Agent team orchestrator
 
 Parent agent = **manager**. Router plans; specialists execute. Artifacts: `.claude/team/tasks/<slug>/`.
@@ -102,6 +105,7 @@ flowchart TD
 | `skipIf` | `debugger.fixed` / `ci-investigator.resolved` |
 | `parallel: true` | `agent` array — invoke all in one parent turn |
 | `scope` | e.g. `unit-in-dev`, `e2e-only` |
+| `model` | `cheap` \| `standard` \| `strong` — optional tier override |
 
 ## Rules (strict)
 
@@ -121,7 +125,16 @@ Create `.claude/team/tasks/<slug>/**` by writing files (Write/Edit). Avoid Shell
 
 ## Invoking agents
 
-Use the available Claude Code subagent mechanism. Pass: slug, artifact paths, step `scope` if set.
+Use the available Claude Code subagent / Agent tool. Pass: slug, artifact paths, step `scope` if set.
+
+### Model when invoking
+
+1. Read `steps[i].model` if present; else use the agent’s frontmatter `model` (see `agents/README.md` matrix).
+2. Map abstract tiers for the Agent tool `model` param:
+   - **`cheap`** → `haiku` (or rely on frontmatter `fast`).
+   - **`standard`** → omit / `sonnet` / inherit.
+   - **`strong`** → `opus` (matches strong-agent frontmatter). Prefer explicit per-invocation `model` when frontmatter pins are flaky.
+3. Parallel steps: apply the step-level `model` to each agent (or omit → each frontmatter).
 
 After each agent completes, ensure `status.json` has `state: completed` (or `awaiting_approval` if gate applies).
 
@@ -143,3 +156,7 @@ Borderline work requests — см. **`tooling-and-review/agent-team-intake.md`**
 ## Auto-detection (optional)
 
 When user describes a **non-trivial task** (not a question), suggest `/task <message>` or run router if they agree.
+
+## Preset authoring
+
+When editing `packages/ai-rules/presets/**`, follow **`tooling-and-review/preset-pr-checklist.md`** (+ twin-sync / layering / token-budget / leakage).