@bonesofspring/ai-rules 0.2.4 → 0.2.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bonesofspring/ai-rules",
-  "version": "0.2.4",
+  "version": "0.2.5",
   "description": "Presets of Cursor and Claude rules/commands for Revy Ross personal use",
   "license": "MIT",
   "author": "Revy Ross",

package/presets/claude/ios-swift/agents/README.md

@@ -29,6 +29,18 @@ When copying next pipeline templates: put Playwright stems in `skipped` with rea
 
 Все agents — **`readonly: false`** (нужна запись в `.claude/team/**`). Ограничения production — в теле промпта.
 
+## Model matrix (frontmatter `model`)
+
+Same tiers as **claude/next**. Defaults in this preset:
+
+| Tier | Frontmatter | Agents |
+|------|-------------|--------|
+| **cheap** | `fast` | router, analyst, build-verifier, code-reviewer, tech-writer |
+| **standard** | `inherit` | developer, debugger, ci-investigator, api-contract, a11y, qa, unit-*, xcuitest-* |
+| **strong** | `opus` | solution-architect, migration-specialist, security-reviewer, performance-auditor |
+
+Optional `steps[].model`: `cheap` \| `standard` \| `strong`.
+
 ## Pipeline routing
 
 **SoT:** intent table / profiles — **`task-router.md`**. Schema — ниже (same as next).
@@ -43,8 +55,8 @@ When copying next pipeline templates: put Playwright stems in `skipped` with rea
   "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": "build-verifier", "label": "xcodebuild + lint + unit smoke", "model": "cheap" },
+    { "agent": "code-reviewer", "label": "Code review", "model": "cheap" }
   ],
   "humanGates": ["after:task-analyst"],
   "autoChain": true,
@@ -52,4 +64,6 @@ When copying next pipeline templates: put Playwright stems in `skipped` with rea
 }
 ```
 
+`steps[].model` optional: `cheap` \| `standard` \| `strong`.
+
 Копируется в `.claude/agents/` при `ai-rules init claude --preset ios-swift`.

package/presets/claude/ios-swift/agents/migration-specialist.md

@@ -2,7 +2,7 @@
 name: migration-specialist
 description: Migration planning specialist for Xcode/iOS/SPM upgrades, dependency swaps, and phased refactors with rollback. Writes migration-plan.md and team status; never writes production code.
 readonly: false
-model: inherit
+model: opus
 ---
 
 You are a migration specialist for an **iOS Swift** codebase with Feature-module layer boundaries.

package/presets/claude/ios-swift/agents/performance-auditor.md

@@ -2,7 +2,7 @@
 name: performance-auditor
 description: Performance audit specialist. Reviews launch path, main-thread work, SwiftUI body churn, list scrolling, image decoding, and Instruments-oriented risks. Readonly — writes perf-report.md only; never edits production code.
 readonly: false
-model: inherit
+model: opus
 ---
 
 You are an iOS performance auditor for a Swift/SwiftUI application.

package/presets/claude/ios-swift/agents/security-reviewer.md

@@ -2,7 +2,7 @@
 name: security-reviewer
 description: Security review specialist. Audits Keychain/token handling, ATS, PII in logs, secrets in diff, and unsafe URL/deep-link handling. Readonly — writes security-review.md only; never edits production code.
 readonly: false
-model: inherit
+model: opus
 ---
 
 You are an iOS security reviewer for a Swift/SwiftUI application.

package/presets/claude/ios-swift/agents/solution-architect.md

@@ -2,7 +2,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. Readonly — produces design docs, not production code.
 readonly: false
-model: inherit
+model: opus
 ---
 
 You are a solution architect for **iOS Feature modules** (Presentation / Domain / Data). Write `architecture.md` under `.claude/team/tasks/<slug>/`. No production code.

package/presets/claude/ios-swift/agents/task-router.md

@@ -40,6 +40,15 @@ You are a task router for an **iOS Swift/SwiftUI** agent team. You **do not** im
 
 **Never skip `build-verifier`** after developer when Swift/Xcode sources changed.
 
+## Model tiers (`steps[].model`)
+
+Optional: `"model": "cheap" | "standard" | "strong"`. Same policy as **claude/next** `task-router.md`:
+
+- `light` → `cheap` on all steps (debugger unclear root cause → `strong`)
+- `full` / `spike` / security|perf specialists → `strong` on architect, migration, security, perf steps
+- never `strong` on build-verifier / tech-writer / task-router
+- omit on `standard` → agent frontmatter (`fast` / `inherit` / `opus`)
+
 Fixtures: `.claude/team/fixtures/` (feature-full, feature-light, bugfix-standard).
 
 ## humanGates (defaults)

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

@@ -42,6 +42,14 @@ Full prompts: `.claude/agents/*.md`. Artifacts: `.claude/team/README.md`.
 6. On `validation_failed`: developer → build-verifier.
 7. When complete, suggest `/technical-retro <slug>`.
 
+## Model when invoking
+
+Honor optional `steps[i].model` (`cheap` \| `standard` \| `strong`); else agent frontmatter (matrix in `agents/README.md`).
+
+- `cheap` → Agent `haiku` (or frontmatter `fast`).
+- `standard` → omit / `sonnet` / inherit.
+- `strong` → `opus`.
+
 ## Skip pipeline when
 
 Pure questions; trivial one-file; user «без pipeline»; docs-only one-liner.

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

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.

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

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/rules/tooling-and-review/agent-team-orchestrator.md

@@ -102,6 +102,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 +122,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).
 

package/presets/claude/next/team/fixtures/feature-full.json

@@ -5,9 +5,11 @@
   "summary": "Multi-layer feature with e2e coverage",
   "steps": [
     { "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": "Validation gate" },
-    { "agent": "code-reviewer", "label": "Code review" },
+    { "agent": "build-verifier", "label": "Validation gate", "model": "cheap" },
+    { "agent": "security-reviewer", "label": "Security review", "model": "strong" },
+    { "agent": "code-reviewer", "label": "Code review", "model": "cheap" },
     { "agent": "qa-tester", "label": "E2E", "scope": "e2e-only" }
   ],
   "humanGates": ["after:task-analyst"],

package/presets/claude/next/team/fixtures/feature-light.json

@@ -4,8 +4,8 @@
   "profile": "light",
   "summary": "Trivial single-file 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,

package/presets/cursor/ios-swift/agents/README.md

@@ -29,6 +29,18 @@ When copying next pipeline templates: put Playwright stems in `skipped` with rea
 
 Все agents — **`readonly: false`** (нужна запись в `.cursor/team/**`). Ограничения production — в теле промпта.
 
+## Model matrix (frontmatter `model`)
+
+Same tiers as **cursor/next** (see that README for full notes). Defaults in this preset:
+
+| Tier | Frontmatter | Agents |
+|------|-------------|--------|
+| **cheap** | `fast` | router, analyst, build-verifier, code-reviewer, tech-writer |
+| **standard** | `inherit` | developer, debugger, ci-investigator, api-contract, a11y, qa, unit-*, xcuitest-* |
+| **strong** | `claude-opus-4-8[effort=high]` | solution-architect, migration-specialist, security-reviewer, performance-auditor |
+
+Optional `steps[].model`: `cheap` \| `standard` \| `strong` (router/orchestrator policy — same as next).
+
 ## Pipeline routing
 
 **SoT:** intent table / profiles — **`task-router.md`**. Schema — ниже (same as next).
@@ -43,8 +55,8 @@ When copying next pipeline templates: put Playwright stems in `skipped` with rea
   "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": "build-verifier", "label": "xcodebuild + lint + unit smoke", "model": "cheap" },
+    { "agent": "code-reviewer", "label": "Code review", "model": "cheap" }
   ],
   "humanGates": ["after:task-analyst"],
   "autoChain": true,
@@ -52,4 +64,6 @@ When copying next pipeline templates: put Playwright stems in `skipped` with rea
 }
 ```
 
+`steps[].model` optional: `cheap` \| `standard` \| `strong`.
+
 Копируется в `.cursor/agents/` при `ai-rules init cursor --preset ios-swift`.

package/presets/cursor/ios-swift/agents/migration-specialist.md

@@ -2,7 +2,7 @@
 name: migration-specialist
 description: Migration planning specialist for Xcode/iOS/SPM upgrades, dependency swaps, and phased refactors with rollback. Writes migration-plan.md and team status; never writes production code.
 readonly: false
-model: inherit
+model: claude-opus-4-8[effort=high]
 ---
 
 You are a migration specialist for an **iOS Swift** codebase with Feature-module layer boundaries.

package/presets/cursor/ios-swift/agents/performance-auditor.md

@@ -2,7 +2,7 @@
 name: performance-auditor
 description: Performance audit specialist. Reviews launch path, main-thread work, SwiftUI body churn, list scrolling, image decoding, and Instruments-oriented risks. Readonly — writes perf-report.md only; never edits production code.
 readonly: false
-model: inherit
+model: claude-opus-4-8[effort=high]
 ---
 
 You are an iOS performance auditor for a Swift/SwiftUI application.

package/presets/cursor/ios-swift/agents/security-reviewer.md

@@ -2,7 +2,7 @@
 name: security-reviewer
 description: Security review specialist. Audits Keychain/token handling, ATS, PII in logs, secrets in diff, and unsafe URL/deep-link handling. Readonly — writes security-review.md only; never edits production code.
 readonly: false
-model: inherit
+model: claude-opus-4-8[effort=high]
 ---
 
 You are an iOS security reviewer for a Swift/SwiftUI application.

package/presets/cursor/ios-swift/agents/solution-architect.md

@@ -2,7 +2,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. Readonly — produces design docs, not production code.
 readonly: false
-model: inherit
+model: claude-opus-4-8[effort=high]
 ---
 
 You are a solution architect for **iOS Feature modules** (Presentation / Domain / Data). Write `architecture.md` under `.cursor/team/tasks/<slug>/`. No production code.

package/presets/cursor/ios-swift/agents/task-router.md

@@ -40,6 +40,15 @@ You are a task router for an **iOS Swift/SwiftUI** agent team. You **do not** im
 
 **Never skip `build-verifier`** after developer when Swift/Xcode sources changed.
 
+## Model tiers (`steps[].model`)
+
+Optional: `"model": "cheap" | "standard" | "strong"`. Same policy as **cursor/next** `task-router.md`:
+
+- `light` → `cheap` on all steps (debugger unclear root cause → `strong`)
+- `full` / `spike` / security|perf specialists → `strong` on architect, migration, security, perf steps
+- never `strong` on build-verifier / tech-writer / task-router
+- omit on `standard` → agent frontmatter (`fast` / `inherit` / `claude-opus-4-8[effort=high]`)
+
 Fixtures: `.cursor/team/fixtures/` (feature-full, feature-light, bugfix-standard).
 
 ## humanGates (defaults)

package/presets/cursor/ios-swift/rules/agent-team-orchestrator.mdc

@@ -73,6 +73,14 @@ Full prompts: `.cursor/agents/*.md`. Artifacts: `.cursor/team/README.md`.
 8. When all steps complete, suggest `/technical-retro <slug>`.
 9. If `autoChain: false`, do not rely on hook.
 
+## Model when invoking (Task)
+
+Honor optional `steps[i].model` (`cheap` \| `standard` \| `strong`); else agent frontmatter (matrix in `agents/README.md`).
+
+- `cheap` → Task `model: "fast"` when accepted.
+- `standard` → omit Task model.
+- `strong` → never pass `fast`; use agent pin `claude-opus-4-8[effort=high]` / parent Max.
+
 ## Team artifact I/O (Cursor Shell sandbox)
 
 - Create/update `.cursor/team/tasks/<slug>/**` with the **Write** tool. Do **not** bootstrap slug dirs with Shell `mkdir -p` — sandbox → `Operation not permitted` (esp. macOS Desktop/Documents + TCC).

package/presets/cursor/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/cursor/ios-swift/team/fixtures/feature-light.json

@@ -2,35 +2,16 @@
   "slug": "example-feature-light",
   "intent": "feature",
   "profile": "light",
-  "summary": "Trivial single-file Swift change with explicit AC",
+  "summary": "Trivial single-file 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": "xcodebuild + lint + unit smoke", "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": "playwright-test-planner",
-      "reason": "iOS uses XCUITest; not needed for light"
-    }
+    { "agent": "task-analyst", "reason": "Explicit AC and single-file scope" },
+    { "agent": "code-reviewer", "reason": "Light profile — non-trivial app changes should use standard" },
+    { "agent": "qa-tester", "reason": "No e2e AC" }
   ]
 }

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

@@ -56,6 +56,23 @@
 
 Ограничение «не трогать production / `app/**`» задаётся **в теле промпта**, не флагом `readonly`. В Cursor `readonly: true` блокирует *любые* file edits (включая team) — для team-агентов это ломает пайплайн.
 
+## Model matrix (frontmatter `model`)
+
+SoT по умолчанию — YAML `model` в каждом agent-файле. Опциональный `steps[].model` (`cheap` \| `standard` \| `strong`) переопределяет тир на шаге пайплайна (см. `task-router.md`, `agent-team-orchestrator.mdc`).
+
+| Tier | Default frontmatter | Agents |
+|------|---------------------|--------|
+| **cheap** | `fast` | `task-router`, `task-analyst`, `build-verifier`, `code-reviewer`, `tech-writer` |
+| **standard** | `inherit` | `feature-developer`, `debugger`, `ci-investigator`, `api-contract-reviewer`, `accessibility-reviewer`, `qa-tester`, `unit-test-*`, `playwright-test-*` |
+| **strong** | `claude-opus-4-8[effort=high]` | `solution-architect`, `migration-specialist`, `security-reviewer`, `performance-auditor` |
+
+**Notes**
+
+- `inherit` = модель parent-чата (обычно сильнее `fast`).
+- Strong pin uses Cursor bracket options (`[effort=high]`). If the ID is blocked by plan/admin, Cursor falls back to a compatible model.
+- Alternate strong pin when Opus unavailable: `composer-2.5[fast=false]` (edit frontmatter locally).
+- Never put `strong` on `build-verifier` / `tech-writer` / `task-router`.
+
 ## Оркестрация
 
 | Command | Назначение |
@@ -94,6 +111,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
 
@@ -114,26 +132,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/cursor/next/agents/migration-specialist.md

@@ -2,7 +2,7 @@
 name: migration-specialist
 description: Migration planning specialist for library upgrades, Next.js major versions, HTTP client swaps, and phased refactors with rollback. Writes migration-plan.md and team status; never writes production code.
 readonly: false
-model: inherit
+model: claude-opus-4-8[effort=high]
 ---
 
 You are a migration specialist for a Next.js frontend with strict layer boundaries.

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

@@ -2,7 +2,7 @@
 name: performance-auditor
 description: Performance audit specialist. Reviews bundle size, lazy loading, render patterns, data fetching waterfalls, and Core Web Vitals risks. Readonly — writes perf-report.md only; never edits production code.
 readonly: false
-model: inherit
+model: claude-opus-4-8[effort=high]
 ---
 
 You are a frontend performance auditor for a Next.js React application.

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

@@ -2,7 +2,7 @@
 name: security-reviewer
 description: Security review specialist. Audits auth flows, token handling, XSS risks, secrets in diff, and unsafe DOM/API usage. Readonly — writes security-review.md only; never edits production code.
 readonly: false
-model: inherit
+model: claude-opus-4-8[effort=high]
 ---
 
 You are a frontend security reviewer for a Next.js TypeScript application.

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

@@ -2,7 +2,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. Readonly — produces design docs, not production code.
 readonly: false
-model: inherit
+model: claude-opus-4-8[effort=high]
 ---
 
 You are a solution architect for a Next.js frontend with strict layer boundaries (types, api, store, ui).

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

@@ -65,7 +65,21 @@ Fixtures: `.cursor/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` |
+
+Cursor mapping when orchestrator invokes Task: `cheap` → pass `model: "fast"` if the tool accepts it; `standard`/`strong` → **do not** pass `fast` (rely on agent frontmatter pin / inherit).
 
 ## humanGates (defaults)
 

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

@@ -102,6 +102,7 @@ flowchart TD
 | `skipIf` | `debugger.fixed` / `ci-investigator.resolved` — hook skips step when artifact says fix applied |
 | `parallel: true` | `agent` is array — invoke **all** agents in one parent turn; each appends to `parallelCompleted` |
 | `scope` | e.g. `unit-in-dev`, `e2e-only` — passed to developer/qa |
+| `model` | `cheap` \| `standard` \| `strong` — optional tier override (see below) |
 
 ## Rules (strict)
 
@@ -125,6 +126,15 @@ flowchart TD
 
 Use Task tool or `/agent-name`. Pass: slug, artifact paths, step `scope` if set.
 
+### Model when invoking (Task)
+
+1. Read `steps[i].model` if present; else use the agent’s frontmatter `model` (see `agents/README.md` matrix).
+2. Map abstract tiers:
+   - **`cheap`** → pass Task `model: "fast"` when the tool accepts it (or rely on agent `fast`).
+   - **`standard`** → omit Task `model` (frontmatter `inherit` / mid default).
+   - **`strong`** → **never** pass `fast`; rely on agent pin (`claude-opus-4-8[effort=high]`) or parent Max model. If Task allows an explicit model ID from the allowed list, prefer the strong agent’s frontmatter ID.
+3. Parallel steps: apply the step-level `model` to **each** agent in the array (or omit → each agent’s own frontmatter).
+
 After each agent completes, ensure `status.json` has `state: completed` (or `awaiting_approval` if gate applies).
 
 ## Legacy mode

package/presets/cursor/next/team/fixtures/feature-full.json

@@ -5,9 +5,11 @@
   "summary": "Multi-layer feature with e2e coverage",
   "steps": [
     { "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": "Validation gate" },
-    { "agent": "code-reviewer", "label": "Code review" },
+    { "agent": "build-verifier", "label": "Validation gate", "model": "cheap" },
+    { "agent": "security-reviewer", "label": "Security review", "model": "strong" },
+    { "agent": "code-reviewer", "label": "Code review", "model": "cheap" },
     { "agent": "qa-tester", "label": "E2E", "scope": "e2e-only" }
   ],
   "humanGates": ["after:task-analyst"],

package/presets/cursor/next/team/fixtures/feature-light.json

@@ -4,8 +4,8 @@
   "profile": "light",
   "summary": "Trivial single-file 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,