@bonesofspring/ai-rules 0.2.2 → 0.2.4

package/presets/claude/ios-swift/rules/architecture/reference-features.md

@@ -0,0 +1,50 @@
+---
+description: Эталонные Feature-модули репозитория — копировать структуру при реализации. Заполните пути после init в целевом iOS-репо.
+paths:
+  - Features/**/*
+  - "**/Presentation/**/*"
+  - "**/Domain/**/*"
+  - "**/Data/**/*"
+  - "**/DesignSystem/**/*"
+---
+
+# Эталонные фичи (reference features)
+
+Перед реализацией найди Feature того же типа и **повтори её структуру**, не изобретая новую организацию файлов.
+
+## Таблица эталонов
+
+После `ai-rules init` замени примеры на **реальные** пути consumer-репо. Ниже — conventional placeholders для greenfield / dogfood.
+
+| Слой | Эталон (пример → заменить) | Conventional glob / path |
+|------|----------------------------|--------------------------|
+| Feature module | `Features/Orders/` | `Features/**` |
+| Presentation / UI | `Features/Orders/Presentation/` | `**/Presentation/**`, `**/DesignSystem/**` |
+| Domain | `Features/Orders/Domain/` | `**/Domain/**` |
+| Data / Network | `Features/Orders/Data/` | `**/Data/**`, `**/Network*/**` |
+| Persistence | `Features/Orders/Data/Persistence/` | `**/Persistence/**`, `**/Keychain/**` |
+| Unit tests | `Features/OrdersTests/` или `*Tests` рядом | `**/*Tests/**/*.swift` |
+| UI tests | `OrdersUITests/` | `**/*UITests/**/*.swift` |
+
+Если в репо другая раскладка (`Modules/`, `Sources/`) — перепиши таблицу один раз и держи её SoT для агентов.
+
+## Как использовать
+
+1. Определи затронутые слои из `decomposition.md` или задачи.
+2. Открой эталон из таблицы (после заполнения путей).
+3. Зеркаль именование, порядок файлов, DI, паттерны тестов.
+4. Если эталона нет — выбери **самую близкую** существующую фичу того же слоя и зафиксируй выбор в handoff.
+
+## Dogfood checklist (5 сценариев)
+
+1. `/task` новая фича в `Features/<Name>` — analyst → developer → build-verifier (xcodebuild).
+2. Баг в ViewModel — debugger → fix → unit test.
+3. Mapper DTO↔domain — unit-test-planner/generator.
+4. UI flow — `xcuitest-test-planner` → generator (accessibilityIdentifier).
+5. Auth/Keychain touch — security-reviewer + `security-ios`.
+
+## Связанные правила
+
+- `tooling-and-review/code-quality.md` — повторять паттерны.
+- `architecture/feature-delivery.md` — порядок слоёв.
+- skill `feature-delivery` — end-to-end сценарий.

package/presets/claude/ios-swift/rules/stack/ios-app-core.md

@@ -39,4 +39,5 @@ description: Базовые принципы, стек и структура iOS
 
 - Определить слой (Presentation / Domain / Data / DesignSystem / Tests); повторить паттерн соседних файлов.
 - Не тянуть `URLSession` во View и DTO во ViewModel — детали в `architecture/boundaries.md`.
-- Доставка фичи — `architecture/feature-delivery.md`; после правок Swift — `tooling-and-review/post-change-build.md`.
+- Доставка фичи — `architecture/feature-delivery.md`; после правок Swift — **вызвать** `tooling-and-review/post-change-build.md` (requestable).
+- Toolchain перед сборкой — `tooling-and-review/xcode-tooling.md` (requestable).

package/presets/claude/ios-swift/rules/testing/ui.md

@@ -39,3 +39,5 @@ paths:
 - Переиспользовать page objects, не дублировать query в каждом тесте.
 - Добавлять `accessibilityIdentifier` в SwiftUI через `.accessibilityIdentifier(...)` для новых интерактивных элементов.
 - Следовать существующим UITest files как эталону.
+
+- Планирование / генерация / heal — agents `xcuitest-test-{planner,generator,healer}` и skill `xcuitest-e2e` (не Playwright).

package/presets/claude/ios-swift/rules/tooling-and-review/README.md

@@ -1,11 +1,16 @@
 # Tooling and review
 
-Качество кода, code review MR, сборка/lint после правок. Index only — тела в topic `.md`.
+Качество, review, build, security, agent-team, retro. Index only — тела в topic `.md`.
 
 | File | Cursor SoT |
 |------|------------|
 | [`code-quality.md`](./code-quality.md) | `code-quality-and-refactoring.mdc` |
 | [`code-review.md`](./code-review.md) | `code-review-mr.mdc` |
 | [`post-change-build.md`](./post-change-build.md) | `post-change-build.mdc` |
+| [`xcode-tooling.md`](./xcode-tooling.md) | `xcode-tooling.mdc` |
+| [`security-ios.md`](./security-ios.md) | `security-ios.mdc` |
+| [`agent-team-intake.md`](./agent-team-intake.md) | `agent-team-intake.mdc` |
+| [`agent-team-orchestrator.md`](./agent-team-orchestrator.md) | `agent-team-orchestrator.mdc` |
+| [`technical-retro.md`](./technical-retro.md) | `technical-retro.mdc` |
 
 Sync: change Cursor → update Claude twin same PR. Full map: [`../README.md`](../README.md).

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

@@ -0,0 +1,18 @@
+---
+description: Use when user posts a work request without /task — suggest or use /task to run the agent team router. Lightweight intake hint only.
+paths:
+  - .claude/commands/**/*
+  - .claude/team/**/*
+---
+
+# Agent team intake
+
+When the user message looks like a **work request** (implement, add, fix, refactor, review MR, write tests, spike) — not a question about how code works:
+
+1. Prefer **`/task <their request>`** or invoke **task-router** first.
+2. Do not jump straight to coding without router + pipeline when scope is non-trivial.
+3. Pure questions («как работает X», «объясни») — answer normally, no `/task`.
+
+Exceptions: user explicitly says «без pipeline», «просто сделай», or continues an active slug.
+
+Scope: iOS/Swift Feature modules (`Features/`, Presentation/Domain/Data) — not `app/src` / Playwright.

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

@@ -0,0 +1,47 @@
+---
+description: Orchestrates the agent team via task-router and pipeline.json. Use for /task, /task-continue, /feature-start, task decomposition, or when the user describes a feature, bug, or review request.
+paths:
+  - .claude/commands/**/*
+  - .claude/team/**/*
+  - .claude/agents/**/*
+---
+
+# Agent team orchestrator
+
+Parent agent = **manager**. Router plans; specialists execute. Artifacts: `.claude/team/tasks/<slug>/`.
+
+Work request без `/task` — см. **`tooling-and-review/agent-team-intake.md`**.
+
+## Entry points
+
+| Command | When |
+|---------|------|
+| **`/task <desc>`** | **Preferred** — router → dynamic pipeline → first agent |
+| `/task-continue <slug>` | After human gate or pause |
+| `/feature-start <desc>` | Legacy: analyst-only start (no router) |
+| `/feature-continue <slug>` | Alias of task-continue |
+| `/technical-retro [slug]` | Retro with agent team block |
+
+## Roles (iOS)
+
+Same stems as Cursor ios-swift agents. **Never Playwright** — use `xcuitest-test-{planner,generator,healer}`. `build-verifier` runs xcodebuild + SwiftLint/Format + unit smoke.
+
+Full prompts: `.claude/agents/*.md`. Artifacts: `.claude/team/README.md`.
+
+## Dynamic pipeline
+
+**Source of truth:** `pipeline.json` → `steps[]`.
+
+## Rules (strict)
+
+1. **`/task` always starts with task-router**.
+2. Read `pipeline.json` before every subagent invocation.
+3. One role per invocation — except parallel steps.
+4. **Never** skip `humanGates` without continue/approval.
+5. Persist handoffs under `.claude/team/tasks/<slug>/` by writing files (not Shell-only `mkdir`).
+6. On `validation_failed`: developer → build-verifier.
+7. When complete, suggest `/technical-retro <slug>`.
+
+## Skip pipeline when
+
+Pure questions; trivial one-file; user «без pipeline»; docs-only one-liner.

package/presets/claude/ios-swift/rules/tooling-and-review/code-review.md

@@ -1,5 +1,10 @@
 ---
 description: Требования к code review для iOS merge requests. Use when reviewing MR/diff/PR, evaluating a branch, or when the user asks for code review.
+paths:
+  - .claude/commands/**/*
+  - .claude/team/**/*
+  - .claude/agents/**/*
+  - .claude/skills/code-review/**/*
 ---
 
 # Code review merge requests

package/presets/claude/ios-swift/rules/tooling-and-review/post-change-build.md

@@ -1,5 +1,10 @@
 ---
 description: Сборка и lint после изменений Swift/iOS кода. Use after editing iOS/Swift sources, Xcode targets, or Package.swift.
+paths:
+  - .claude/commands/**/*
+  - .claude/agents/**/*
+  - **/*.{swift,xcodeproj,xcworkspace,pbxproj}
+  - **/Package.swift
 ---
 
 # Сборка и lint после изменений

package/presets/claude/ios-swift/rules/tooling-and-review/security-ios.md

@@ -0,0 +1,36 @@
+---
+description: ATS, Keychain, PII, секреты, безопасное логирование iOS
+paths:
+  - "**/*Keychain*.swift"
+  - "**/*Auth*.swift"
+  - "**/*Token*.swift"
+  - "**/*Credential*.swift"
+  - "**/Info.plist"
+  - .claude/commands/**/*
+  - .claude/agents/**/*
+---
+
+# Security (iOS)
+
+## Секреты и конфиг
+
+- Нет API keys / tokens в исходниках и git; использовать Keychain, xcconfig (не в VCS), CI secrets.
+- Debug-only bypass ATS / SSL — только `#if DEBUG` и никогда в Release.
+
+## ATS и сеть
+
+- ATS exceptions в Info.plist — минимальные, с обоснованием; предпочитать HTTPS.
+- Certificate pinning — только если уже принято в репо.
+
+## PII и логи
+
+- Не логировать токены, пароли, полные номера карт/документов.
+- Crash/APM: scrub PII по политике репо.
+
+## Keychain / биометрия
+
+- Accessible уровни и `kSecAttrAccessible` — осознанно; Face ID/Touch ID — через LocalAuthentication как в репо.
+
+## Требование к агенту
+
+При auth/формах/платежах — сверить с этим правилом и `code-review`. Security-reviewer подключать для чувствительных фич.

package/presets/claude/ios-swift/rules/tooling-and-review/technical-retro.md

@@ -0,0 +1,14 @@
+---
+description: Роль агента для проведения технического ретроспективы (retro). On-demand — предпочтительнее slash-команда /technical-retro.
+paths:
+  - .claude/commands/**/*
+  - .claude/team/**/*
+---
+
+# Техническое ретро — rule alias
+
+Полный сценарий — в slash-команде:
+
+**`.claude/commands/technical-retro.md`** → `/technical-retro`
+
+Используй rule только если command недоступен. Не дублируй содержимое — следуй command-файлу и skill `technical-retro`.

package/presets/claude/ios-swift/rules/tooling-and-review/xcode-tooling.md

@@ -0,0 +1,24 @@
+---
+description: Перед xcodebuild / SwiftLint / SwiftFormat определять toolchain и схемы репозитория и использовать только их
+paths:
+  - .claude/commands/**/*
+  - .claude/agents/**/*
+  - "**/*.{swift,xcodeproj,xcworkspace,pbxproj}"
+  - "**/Package.swift"
+---
+
+# Xcode tooling (терминал)
+
+Перед **`xcodebuild` / `swift build` / `swift test` / SwiftLint / SwiftFormat / `simctl`** определи toolchain репозитория и **используй только его**.
+
+## Как определить
+
+1. **Workspace / project:** `.xcworkspace` (CocoaPods) → workspace; иначе `.xcodeproj`; SPM-only — `Package.swift`.
+2. **Scheme / destination:** как в CI, `Makefile`, `fastlane`, `scripts/` — не угадывать.
+3. **Lint:** `.swiftlint.yml` / `SwiftLint` в PATH или Mint/mise — если конфига нет, не запускать «чужой» lint.
+4. **Format:** `.swiftformat` / SwiftFormat — только если принято в репо.
+5. **Simulator:** `xcrun simctl list` + destination из CI; не хардкодить UDID.
+
+Примеры: `xcodebuild -scheme App -destination 'platform=iOS Simulator,name=iPhone 16' build`, `swiftlint lint --quiet`, `swiftformat . --lint`.
+
+Долгие сборки и DerivedData — нормальны; не блокировать `xcodebuild`/`simctl`/`xcrun`.

package/presets/claude/ios-swift/rules/ui-and-accessibility/README.md

@@ -1,10 +1,11 @@
 # UI and accessibility
 
-SwiftUI Views, Design System, ViewModels. Index only — тела в topic `.md`.
+SwiftUI Views, Design System, ViewModels, navigation. Index only — тела в topic `.md`.
 
 | File | Cursor SoT |
 |------|------------|
 | [`swiftui.md`](./swiftui.md) | `swiftui-ui.mdc` |
 | [`viewmodels.md`](./viewmodels.md) | `state-and-viewmodels.mdc` |
+| [`navigation.md`](./navigation.md) | `navigation-coordinators.mdc` |
 
 Sync: change Cursor → update Claude twin same PR. Full map: [`../README.md`](../README.md).

package/presets/claude/ios-swift/rules/ui-and-accessibility/navigation.md

@@ -0,0 +1,28 @@
+---
+description: NavigationStack, координаторы, deep links — границы Presentation
+paths:
+  - "**/Presentation/**/*Navigator*.swift"
+  - "**/Presentation/**/*Coordinator*.swift"
+  - "**/Presentation/**/*Router*.swift"
+  - "**/App/**/*App*.swift"
+  - "**/*Navigation*.swift"
+---
+
+# Навигация (iOS)
+
+## Рамка
+
+- **SwiftUI-first:** `NavigationStack` / `navigationDestination` / sheet / fullScreenCover — как в репо.
+- UIKit / coordinator — только если уже принят в модуле; не смешивать два стиля в одном Feature без причины.
+- Маршруты и deep links — **Presentation** (или App shell); Domain не знает о `NavigationPath`.
+
+## Правила
+
+- Один Feature — один явный «вход» навигации (root view / coordinator), не размазывать `NavigationLink` по Data.
+- Параметры экрана — typed (enum route / struct), не «магические» строки без реестра.
+- Deep link → route mapping централизован (App или Navigation hub); ViewModel не парсит URL напрямую.
+- Модалки: владелец presentation state — родительский VM/coordinator, не глобальный singleton без нужды.
+
+## Требование к агенту
+
+Копировать паттерн ближайшего Feature из `reference-features`. Не тащить networking в навигационный слой.

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

@@ -0,0 +1,13 @@
+# `.claude/skills` (preset ios-swift)
+
+| Skill | Назначение |
+|-------|------------|
+| `feature-delivery` | Domain → Data → VM → View → tests → post-change-build |
+| `code-review` | iOS MR checklist |
+| `unit-testing` | XCTest / Swift Testing |
+| `xcuitest-e2e` | XCUITest plan/generate/heal (← next `playwright-e2e`) |
+| `debug-investigation` | Runtime evidence before fix |
+| `ci-investigation` | iOS CI red |
+| `technical-retro` | Retro facilitation |
+
+Копируется в `.claude/skills/` при init.

package/presets/claude/ios-swift/skills/ci-investigation/SKILL.md

@@ -0,0 +1,39 @@
+---
+name: ci-investigation
+description: Investigates failing CI checks on PRs and branches — xcodebuild, SwiftLint, unit, XCUITest — with local reproduction and minimal fixes. Use when CI is red or for ci-fix pipeline tasks.
+---
+
+# CI Investigation (iOS)
+
+## Workflow
+
+1. Identify the **first failing check** (compile, lint, unit, XCUITest, signing, SPM).
+2. Capture error output — ignore cascading failures until root cause is found.
+3. Reproduce locally with the same scheme/destination CI uses (`tooling-and-review/xcode-tooling.md`):
+   - `xcodebuild build` / `xcodebuild test`
+   - SwiftLint / SwiftFormat scripts as in repo CI
+   - affected XCUITest if UI job failed
+4. Inspect git diff for changed files related to the failure.
+5. Apply **minimal fix** — no unrelated refactors.
+
+## Artifact
+
+Write `ci-report.md` under the task slug folder (`.claude/team/tasks/<slug>/`):
+
+- Failed check name and log excerpt
+- Root cause classification
+- Fix applied (or handoff to feature-developer)
+- `resolved: true|false`
+- Validation commands and results
+
+## Handoff Rules
+
+- Config-only or one-line fixes → fix in place, re-run check.
+- Missing tests or architecture work → document and route to `feature-developer` or `qa-tester`.
+- Flaky XCUITest → prefer `xcuitest-test-healer` after ci-investigator identifies the case.
+
+## Validation
+
+Always re-run the failing command locally before marking complete. If environment blocks execution (no simulator), state the exact command and blocker.
+
+Never run yarn/`lint:js`/Playwright — wrong stack.

package/presets/claude/ios-swift/skills/code-review/SKILL.md

@@ -0,0 +1,27 @@
+---
+name: code-review
+description: Reviews pull requests, merge requests, git diffs, and branch changes using iOS architecture, SwiftUI, networking, and testing standards. Use when the user asks for review or when code-reviewer runs in an agent pipeline.
+---
+
+# Code Review (iOS)
+
+## Inputs
+
+Use the local repository as the source of truth: `git status`, `git diff`, task artifacts under `.claude/team/tasks/<slug>/` when present, and opened files. Do not invent hosting metadata such as labels, CI status, or reviewers.
+
+## Review Order
+
+1. Understand the intent and affected Feature layers (Presentation / Domain / Data).
+2. Check correctness and regressions first.
+3. Verify architecture boundaries (`architecture/boundaries.md`): View ≠ API/DTO; ViewModel ≠ Data impl; Domain ≠ SwiftUI; Data ≠ Presentation.
+4. Check DI composition in `App/`, SPM public API (`architecture/module-public-api.md`), and no deep-imports across Features.
+5. Review Swift concurrency and conventions (`stack/swift-conventions.md`): `@MainActor`, typed errors, force unwrap.
+6. Review SwiftUI thinness, Design System usage, accessibility identifiers (`ui-and-accessibility/swiftui.md`).
+7. Check tests: unit for mapper/domain/VM (`testing/unit.md`); XCUITest for user flows (`testing/ui.md`).
+8. Report validation gaps: `xcodebuild`, SwiftLint, or relevant tests not run (`tooling-and-review/xcode-tooling.md`, `tooling-and-review/post-change-build.md`).
+
+## Output
+
+Lead with findings ordered by severity. Each finding should include the file, the problem, impact, and a concrete fix direction. If there are no findings, say so and call out remaining test or validation risk.
+
+For agent team tasks, write `.claude/team/tasks/<slug>/review.md` and set `status.json` to `completed` or `changes_requested`.

package/presets/claude/ios-swift/skills/debug-investigation/SKILL.md

@@ -0,0 +1,30 @@
+---
+name: debug-investigation
+description: Investigates bugs, failing tests, crashes, and incorrect behavior with runtime evidence before applying minimal fixes. Use for bugfix tasks, debugger agent runs, regressions, and flaky test diagnosis.
+---
+
+# Debug Investigation (iOS)
+
+## Process
+
+1. Reproduce the issue or collect the closest available evidence: Xcode console, lldb backtrace, crash log, failing XCTest/XCUITest output, Instruments note, or user steps.
+2. Define expected vs actual behavior in one sentence.
+3. Trace the failing path through the smallest relevant Feature slice (Presentation → Domain → Data).
+4. Identify the root cause before editing. Avoid broad refactors during bugfixes.
+5. Apply the smallest fix that preserves existing architecture and public contracts.
+6. Add or update a regression XCTest when the behavior is domain/VM logic or likely to recur.
+7. Run the narrow failing check first (`xcodebuild test` for the affected target), then broader build validation if needed (`tooling-and-review/xcode-tooling.md`).
+
+## Artifacts
+
+For agent team tasks, write `.claude/team/tasks/<slug>/debug-report.md` with:
+
+- Reproduction steps or evidence source.
+- Root cause.
+- Fix scope (`fixApplied`).
+- Regression coverage.
+- Remaining risk.
+
+Update `status.json` when complete.
+
+Do not use browser/Playwright tooling — this is an Xcode stack.

package/presets/claude/ios-swift/skills/feature-delivery/SKILL.md

@@ -0,0 +1,27 @@
+---
+name: feature-delivery
+description: Delivers iOS Swift/SwiftUI features end-to-end across Domain, Data, ViewModels, Views, tests, and post-change-build validation. Use when implementing or extending a feature, especially through /task or feature-developer.
+---
+
+# Feature Delivery (iOS)
+
+1. Read task brief, acceptance criteria, and decomposition if present.
+2. Read `architecture/feature-delivery.md` and `architecture/reference-features.md` — Domain → Data → ViewModel → View → tests; mirror the closest Feature.
+3. Wire DI in `App/` composition root; keep Views thin; keep DTOs out of ViewModels.
+4. Add or update focused XCTest for mappers / use cases / ViewModels (`testing/unit.md`).
+5. After Swift edits: **invoke** `tooling-and-review/post-change-build.md` (+ `tooling-and-review/xcode-tooling.md`). Pipeline: scoped build OK if next step is `build-verifier`.
+
+## Do / Don't
+
+- **Do** follow existing Feature folder layout and public module APIs.
+- **Do** add `accessibilityIdentifier`s for new interactive UI when UI tests are in scope.
+- **Don't** introduce TCA/SwiftData/etc. unless the repo already uses them.
+- **Don't** use yarn, Playwright, or `app/src` paths — wrong stack.
+
+## Preset packaging note
+
+When editing **ai-rules ios-swift preset** sources (agents, hooks, rules) rather than an app Feature: keep Cursor and Claude trees in sync where applicable, and **fork / verify hook handoffs** (`hooks/chain-team-phases.sh`, guard scripts, team path conventions) so Cursor (`.cursor/team`) and Claude (`.claude/team`) do not regress against each other or against the next preset templates.
+
+## Handoff
+
+Summarize by layer, validation results, and known gaps. Agent team: update `.claude/team/tasks/<slug>/status.json`.

package/presets/claude/ios-swift/skills/technical-retro/SKILL.md

@@ -0,0 +1,10 @@
+---
+name: technical-retro
+description: Facilitates technical retrospectives for tasks, sprints, incidents, releases, and agent-team pipelines. Use when the user asks for retro, postmortem, process review, or action items after delivery.
+---
+
+# Technical Retro
+
+Same structure as next technical-retro skill. For `/task` pipelines include router, analyst, developer, **build-verifier** (xcodebuild), reviewer, QA/XCUITest, hooks, rules.
+
+Preset feedback: propose updates to `.claude/rules|agents|skills` — do not apply without approval.

package/presets/claude/ios-swift/skills/unit-testing/SKILL.md

@@ -0,0 +1,32 @@
+---
+name: unit-testing
+description: Plans, generates, and heals XCTest / Swift Testing for mappers, use cases, and ViewModels using *Tests targets and tests-unit rules. Use for unit test planning, generation, or fixing failing unit tests.
+---
+
+# Unit Testing (iOS)
+
+## Project Layout
+
+- Unit targets: `*Tests/` colocated or parallel to Feature — **as in the Xcode project**.
+- Framework: XCTest or Swift Testing per project convention.
+- Do **not** create Jest/Vitest `*.spec.ts` files.
+
+Follow `testing/unit.md` (Cursor `.mdc` / Claude `testing/unit.md` depending on preset).
+
+## Planner
+
+Write or update `.claude/team/tasks/<slug>/unit-test-plan.md`.
+
+Each scenario needs a Russian `test` / `@Test` title (capital letter after each sentence). Cover mappers, use cases, ViewModel state branches, and mocked client/repository behavior per AC.
+
+## Generator
+
+Implement tests from `unit-test-plan.md` into the correct `*Tests` target. Reuse TestSupport / protocol mocks. Do not change production code.
+
+## Healer
+
+Fix mocks, async/MainActor timing, and fixtures — preserve business assertions. Use `unit-test-plan.md` and `brief.md` as the behavior contract.
+
+## Validation
+
+Run affected unit tests via `xcodebuild test` (`tooling-and-review/xcode-tooling.md`) when feasible. Report command, pass/fail, and remaining gaps vs plan.

package/presets/claude/ios-swift/skills/xcuitest-e2e/SKILL.md

@@ -0,0 +1,33 @@
+---
+name: xcuitest-e2e
+description: Plans, generates, and heals XCUITest UI tests using *UITests targets, accessibility identifiers, and screen objects. Use for UI test planning, generation, or fixing flaky XCUITest.
+---
+
+# XCUITest E2E
+
+## Project Layout
+
+- UI Test target: `*UITests/` (as in the Xcode project).
+- Optional plans: `*.cases.md` if the repo uses them.
+- Screen/Page objects keyed by `accessibilityIdentifier` (`{screen}__{element}`).
+- Shared helpers: `UITestSupport/` or equivalent — follow existing patterns.
+
+Follow `testing/ui.md`. Agents: `xcuitest-test-{planner,generator,healer}`.
+
+**Never Playwright** and never `app/__tests__/e2e`.
+
+## Planner
+
+Create or update the relevant plan (`*.cases.md` or team notes). Each scenario should include title, preconditions, steps, and expected result. Cover happy path, important edge cases, validation, and error states. Russian titles with entity prefix when that is repo convention.
+
+## Generator
+
+Generate XCUITest from plans into the UITests target. Reuse screen objects. Keep test names aligned with scenario names. Prefer identifiers over coordinates.
+
+## Healer
+
+Fix waits, launch arguments, identifiers, or screen-object details without weakening business assertions. Use the matching plan / AC as the behavior contract.
+
+## Validation
+
+Run affected UI tests via `xcodebuild test` (`tooling-and-review/xcode-tooling.md`) when a simulator is available. If blocked, report the exact command and blocker.

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

@@ -0,0 +1,27 @@
+# Agent team artifacts (ios-swift)
+
+Каталог артефактов пайплайна «команда агентов» для iOS.
+
+## Layout
+
+```
+.claude/team/   # Claude: .claude/team/
+  active-task.json
+  fixtures/
+  tasks/<slug>/
+    pipeline.json
+    status.json
+    brief.md
+    decomposition.md
+    …
+```
+
+## Fixtures
+
+| Fixture | Notes |
+|---------|-------|
+| `feature-full.json` | Full profile; QA scope `e2e-only` = **XCUITest**; Playwright stems in `skipped` |
+| `feature-light.json` | developer → build-verifier |
+| `bugfix-standard.json` | debugger → developer (skipIf) → verifier → reviewer |
+
+**Never** schedule Playwright-only steps without skip rationale. Use `xcuitest-test-*` for UI-test-only intents.

package/presets/claude/ios-swift/team/fixtures/bugfix-standard.json

@@ -0,0 +1,33 @@
+{
+  "slug": "example-bugfix-standard",
+  "intent": "bugfix",
+  "profile": "standard",
+  "summary": "Regression fix with review",
+  "steps": [
+    {
+      "agent": "debugger",
+      "label": "Root cause"
+    },
+    {
+      "agent": "feature-developer",
+      "label": "Fix if needed",
+      "skipIf": "debugger.fixed"
+    },
+    {
+      "agent": "build-verifier",
+      "label": "Validation gate"
+    },
+    {
+      "agent": "code-reviewer",
+      "label": "Code review"
+    }
+  ],
+  "humanGates": [],
+  "autoChain": true,
+  "skipped": [
+    {
+      "agent": "playwright-test-planner",
+      "reason": "iOS uses XCUITest — not in this bugfix path"
+    }
+  ]
+}

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

@@ -0,0 +1,48 @@
+{
+  "slug": "example-feature-full",
+  "intent": "feature",
+  "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"
+  ],
+  "autoChain": true,
+  "skipped": [
+    {
+      "agent": "playwright-test-planner",
+      "reason": "iOS uses XCUITest — see xcuitest-test-* agents"
+    },
+    {
+      "agent": "playwright-test-generator",
+      "reason": "iOS uses XCUITest"
+    },
+    {
+      "agent": "playwright-test-healer",
+      "reason": "iOS uses XCUITest"
+    }
+  ]
+}