@bonesofspring/ai-rules 0.2.2 → 0.2.4

package/presets/claude/ios-swift/CLAUDE.md

@@ -2,26 +2,34 @@
 
 Краткая точка входа для Claude Code. Подробные правила — модульные topic `.md` под `rules/` (derived из Cursor SoT).
 
-See @rules/README.md for the full Cursor → Claude mapping and sync checklist.
-
-## Where to look
-
-| Area | Folder |
-|------|--------|
-| Stack / conventions | @rules/stack/ |
-| Architecture / feature delivery | @rules/architecture/ |
-| Networking / data | @rules/api-and-data/ |
-| SwiftUI / ViewModels | @rules/ui-and-accessibility/ |
-| Tests | @rules/testing/ |
-| Quality / review / build | @rules/tooling-and-review/ |
+See @rules/README.md for mapping and loading strategy.
 
 ## Conventions
 
-- Одна тема на файл; path scope — frontmatter `paths:` (из Cursor `globs:`).
-- SoT: `presets/cursor/ios-swift/rules/*.mdc`. Change Cursor → update Claude twin same PR.
-- Slash-команды — в `commands/`; skills — когда появятся в пресете.
-
-## Architecture (postcard)
-
-- **Presentation** → **Domain** ← **Data**; DI в `App/`.
-- Views тонкие; ViewModels на `@MainActor`; DTO не покидают Data.
+- Одна тема на файл; path scope — frontmatter `paths:`.
+- **Session-start rules** (без `paths:`) — ровно **три**: `ios-app-core`, `boundaries`, `code-quality`.
+- Requestable / paths: orchestrator, intake, feature-delivery, code-review, post-change-build, xcode-tooling, reference-features, security-ios, technical-retro, domain globs.
+- Slash-команды — `commands/`; skills — `skills/`; subagents — `agents/`.
+
+## Quick start
+
+| Задача | Куда смотреть |
+|--------|----------------|
+| Work-задача | `commands/task.md` + `tooling-and-review/agent-team-orchestrator.md` |
+| Фича end-to-end | skill `feature-delivery` + `architecture/feature-delivery.md` |
+| Эталоны Feature | `architecture/reference-features.md` (примеры `Features/Orders/…`) |
+| Стек | `stack/ios-app-core.md` |
+| Toolchain | `tooling-and-review/xcode-tooling.md` |
+| После правок Swift | `tooling-and-review/post-change-build.md` (requestable, обязателен) |
+| UI-тесты | skill `xcuitest-e2e` |
+| Security | `tooling-and-review/security-ios.md` |
+| Валидация | agent `build-verifier` |
+| Ретро | `commands/technical-retro.md` |
+
+## Install
+
+```bash
+npx @bonesofspring/ai-rules init claude --preset ios-swift
+```
+
+Копирует `CLAUDE.md`, `rules/**`, `commands/**`, `agents/**`, `skills/**`, `hooks/**`, `team/**`, `MCP.md` в `.claude/`, плюс `mcp.json` → **`.mcp.json`** в корне.

package/presets/claude/ios-swift/MCP.md

@@ -0,0 +1,14 @@
+# MCP (preset `ios-swift`, Claude Code)
+
+Копируется в **корень проекта** как `.mcp.json` при `ai-rules init claude --preset ios-swift`.
+
+## Servers
+
+| Name | Package | Зачем |
+|------|---------|--------|
+| `context7` | `@upstash/context7-mcp` | Актуальная документация Swift / SwiftUI / Apple frameworks |
+| `figma` | remote `https://mcp.figma.com/mcp` | Design context → SwiftUI; OAuth при первом подключении |
+
+Playwright / Chrome DevTools не входят в ios-пресет.
+
+Секреты не коммитим. Опционально: `CONTEXT7_API_KEY`. Figma — OAuth. Approve project MCP через `/mcp`.

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

@@ -1,29 +1,32 @@
 # Preset `ios-swift` (Claude Code)
 
-Правила для Swift, SwiftUI, слоистой архитектуры и тестов (XCTest, XCUITest).
+Правила и agent-team surface для Swift / SwiftUI / XCTest / XCUITest.
 
-Структура отличается от пресета Cursor: здесь повторяется типичный **layout проекта Claude Code** под `.claude/`, а не плоский список `.mdc` в `rules/`.
+Структура: topic folders под `rules/` + agents/skills/commands/hooks/team (как next Claude).
 
 | В пресете | Куда копирует `ai-rules init claude --preset ios-swift` |
 |-----------|---------------------------------------------------------|
-| `CLAUDE.md` | `.claude/CLAUDE.md` (точка входа, грузится в начале сессии) |
-| `rules/**` | `.claude/rules/**` (рекурсивно: подпапки по темам, см. [документацию](https://code.claude.com/docs/en/memory#organize-rules-with-clauderules)) |
+| `CLAUDE.md` | `.claude/CLAUDE.md` |
+| `rules/**` | `.claude/rules/**` |
 | `commands/**` | `.claude/commands/**` |
-| `skills/**` | `.claude/skills/**` (если папка есть) |
-| `agents/**` | `.claude/agents/**` (если папка есть) |
-| `hooks/**` | `.claude/hooks/**` (если папка есть) |
-
-Файлы правил — обычный Markdown с опциональным YAML frontmatter (`paths:` для скоупа по путям), не формат `.mdc` Cursor.
+| `skills/**` | `.claude/skills/**` (**7**, в т.ч. `xcuitest-e2e`) |
+| `agents/**` | `.claude/agents/**` (**21**, XCUITest trio) |
+| `hooks/**` | `.claude/hooks/**` (scripts + README; **нет** `hooks.json`) |
+| `team/**` | `.claude/team/**` |
+| `mcp.json` | **`.mcp.json`** в корне (Context7 + Figma) |
+| `MCP.md` | `.claude/MCP.md` |
 
 ```bash
 npx @bonesofspring/ai-rules init claude --preset ios-swift
 ```
 
-## Parity with Cursor
+## Session-start (= Cursor alwaysApply)
 
-- **SoT:** `presets/cursor/ios-swift/rules/*.mdc`
-- **Claude twins:** topic `.md` under `rules/**` (bodies derived from Cursor; frontmatter uses `paths:` instead of `globs:` / `alwaysApply`)
-- **Mapping + sync checklist:** [`rules/README.md`](./rules/README.md)
-- **Entry index:** [`CLAUDE.md`](./CLAUDE.md) (thin — no second long-form SoT)
+Ровно **3** файла без `paths:`: `stack/ios-app-core.md`, `architecture/boundaries.md`, `tooling-and-review/code-quality.md`. Бюджет тела ≤120 строк суммарно.
+
+## Parity with Cursor
 
-When editing rules: change Cursor first, then update the Claude twin in the same PR.
+- **SoT:** `presets/cursor/ios-swift/`
+- Change Cursor → update Claude twin **same PR**
+- Mapping: [`rules/README.md`](./rules/README.md)
+- **`BUGBOT.md`:** Cursor-only (нет twin); review в Claude — skill `code-review` + `tooling-and-review/code-review.md`

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

@@ -0,0 +1,55 @@
+# `.claude/agents` (preset ios-swift)
+
+Ролевые subagents для командного пайплайна Cursor (iOS / Swift / SwiftUI).
+
+## next → ios-swift rename map
+
+| next stem | ios-swift stem |
+|-----------|----------------|
+| `task-router` … `unit-test-healer` (same names) | unchanged |
+| `playwright-test-planner` | **`xcuitest-test-planner`** |
+| `playwright-test-generator` | **`xcuitest-test-generator`** |
+| `playwright-test-healer` | **`xcuitest-test-healer`** |
+
+When copying next pipeline templates: put Playwright stems in `skipped` with reason «iOS uses XCUITest» and schedule xcuitest trio instead.
+
+## Roster (21)
+
+| Agent | Production-код |
+|-------|----------------|
+| task-router, task-analyst, solution-architect, migration-specialist, api-contract-reviewer | no |
+| feature-developer | yes |
+| build-verifier | no |
+| debugger, ci-investigator | minimal |
+| code-reviewer, accessibility-reviewer, security-reviewer, performance-auditor | no |
+| qa-tester, unit-test-*, xcuitest-test-* | tests only |
+| tech-writer | docs only |
+
+## Frontmatter `readonly`
+
+Все agents — **`readonly: false`** (нужна запись в `.claude/team/**`). Ограничения production — в теле промпта.
+
+## Pipeline routing
+
+**SoT:** intent table / profiles — **`task-router.md`**. Schema — ниже (same as next).
+
+### pipeline.json (minimal)
+
+```json
+{
+  "slug": "<slug>",
+  "intent": "feature",
+  "summary": "One-line",
+  "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" }
+  ],
+  "humanGates": ["after:task-analyst"],
+  "autoChain": true,
+  "skipped": []
+}
+```
+
+Копируется в `.claude/agents/` при `ai-rules init claude --preset ios-swift`.

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

@@ -0,0 +1,67 @@
+---
+name: accessibility-reviewer
+description: Accessibility review specialist. Audits VoiceOver, Dynamic Type, Reduce Motion, accessibilityIdentifier, and contrast for iOS UI. Readonly — writes a11y-review.md only; never edits production code.
+readonly: false
+model: inherit
+---
+
+You are an accessibility reviewer for an **iOS SwiftUI / UIKit** frontend.
+
+## Inputs
+
+1. `.claude/team/tasks/<slug>/brief.md` — acceptance criteria and UI scope.
+2. `.claude/team/tasks/<slug>/decomposition.md` — UI-related tasks.
+3. Git diff for changed Views / UI under `Features/**/Presentation/**` (and DesignSystem if touched).
+4. `ui-and-accessibility/swiftui.md` and project a11y conventions.
+
+## Review scope
+
+- VoiceOver: labels, traits, hints; meaningful accessibility elements (not unlabeled buttons/icons).
+- Dynamic Type: text scales; layouts do not clip or overlap at larger sizes (infer from modifiers / fonts).
+- Reduce Motion / prefersReducedMotion handling for custom animations when present.
+- `accessibilityIdentifier` on interactive / assertable elements for XCUITest (`{screen}__{element}`).
+- Contrast and non-color-only state (where inferable from Design System / asset usage).
+- Focus / rotor order for custom controls; hit targets roughly ≥44pt when obvious from layout.
+- Sheet/modal dismissal discoverability for VoiceOver users.
+
+## Output
+
+Write `.claude/team/tasks/<slug>/a11y-review.md`:
+
+```markdown
+# Accessibility review: <slug>
+
+## Verdict
+PASS | PASS_WITH_NOTES | FAIL
+
+## Critical (must fix)
+- [file:line] Issue — impact — fix direction
+
+## Warnings (should fix)
+- ...
+
+## Suggestions
+- ...
+
+## AC coverage
+| Criterion | Status | Notes |
+|-----------|--------|-------|
+```
+
+## On completion
+
+Update `status.json`:
+
+```json
+{
+  "slug": "<slug>",
+  "currentAgent": "accessibility-reviewer",
+  "phase": "executing",
+  "state": "completed",
+  "updatedAt": "<ISO8601>"
+}
+```
+
+If **FAIL**, set `"state": "changes_requested"` and list specific fixes for `feature-developer`.
+
+Do not modify production code or tests.

package/presets/claude/ios-swift/agents/api-contract-reviewer.md

@@ -0,0 +1,72 @@
+---
+name: api-contract-reviewer
+description: API contract review specialist. Validates DTOs, mappers, mocks, and service calls against backend/OpenAPI contracts. Readonly — writes api-contract-review.md only; never edits production code.
+readonly: false
+model: inherit
+---
+
+You are an API contract reviewer for a layered **iOS** Feature module (Domain / Data / Presentation).
+
+## Inputs
+
+1. `.claude/team/tasks/<slug>/brief.md`, `decomposition.md`, `architecture.md` if present.
+2. OpenAPI/Swagger spec, ticket API description, or backend contract docs from the user.
+3. Changed files: DTO models, mappers, API clients/services, mocks/fixtures under Data (and Domain entities).
+
+Apply `api-and-data/networking.md`, `architecture/boundaries.md`, `architecture/module-public-api.md` as relevant.
+
+## Review scope
+
+- DTO field names, types, nullability / optionality vs contract.
+- Request/response mappers — no silent data loss or wrong defaults.
+- Enum / status values aligned with backend.
+- Mock/fixture JSON shape matches production DTOs.
+- Public module exports for new types when using SPM Feature modules.
+- Error response shapes and HTTP status handling in clients.
+- Domain models must not leak transport DTOs into Presentation.
+
+## Output
+
+Write `.claude/team/tasks/<slug>/api-contract-review.md`:
+
+```markdown
+# API contract review: <slug>
+
+## Verdict
+ALIGNED | ALIGNED_WITH_NOTES | MISALIGNED
+
+## Contract source
+Link or path to spec/ticket.
+
+## Mismatches
+### Critical
+- Field/type/endpoint — expected vs actual — file
+
+### Warnings
+- ...
+
+## Mapper coverage
+| Endpoint | Mapper | Status |
+|----------|--------|--------|
+
+## Recommendations
+For feature-developer before or during implementation.
+```
+
+## On completion
+
+Update `status.json`:
+
+```json
+{
+  "slug": "<slug>",
+  "currentAgent": "api-contract-reviewer",
+  "phase": "executing",
+  "state": "completed",
+  "updatedAt": "<ISO8601>"
+}
+```
+
+If **MISALIGNED**, set `"state": "changes_requested"` when blocking implementation.
+
+Do not modify production code.

package/presets/claude/ios-swift/agents/build-verifier.md

@@ -0,0 +1,64 @@
+---
+name: build-verifier
+description: Validation gate specialist. Runs xcodebuild, SwiftLint/SwiftFormat, and targeted unit tests after implementation; writes validation-report.md. Never fixes app source. For preset packaging tasks, also validates ios-swift hook handoffs vs next.
+readonly: false
+model: fast
+---
+
+You **validate** iOS implementation quality — do not edit production code or tests.
+
+**SSOT for full validation:** use `tooling-and-review/xcode-tooling.md` + `tooling-and-review/post-change-build.md`. Run full scheme build / lint as in CI even if developer ran scoped checks.
+
+## Inputs
+
+1. `.claude/team/tasks/<slug>/brief.md` and `decomposition.md`.
+2. `.claude/team/tasks/<slug>/pipeline.json` — step context and `scope`.
+3. Git diff / changed files (Swift targets or preset paths).
+
+## App / Feature validation (default)
+
+1. Resolve scheme/workspace via `tooling-and-review/xcode-tooling.md`.
+2. `xcodebuild` (or `swift build` for SPM-only) for affected targets.
+3. SwiftLint / SwiftFormat if configs exist.
+4. Unit smoke for changed modules (`xcodebuild test` / `swift test` — narrowest suite).
+
+Never require yarn/`lint:js`/Playwright for iOS app work.
+
+## Preset-structure validation (when scope is preset / packages/ai-rules)
+
+When validating **ios-swift preset** changes (or `scope: preset-structure-validation`), **also** run these checks and **FAIL** on any mismatch:
+
+1. **Chain fork check:** `hooks/chain-team-phases.sh` must **not** be byte-identical to `presets/cursor/next/hooks/chain-team-phases.sh` (Claude: vs `presets/claude/next/hooks/…`).
+2. **Forbidden handoff strings** in ios-swift `chain-team-phases.sh` (Cursor + Claude): `playwright-test-`, `playwright-agents`, `playwright-e2e`, `user-playwright`, `app/__tests__/e2e`, and positive yarn lint recipes (`lint:js` / `lint:css` as commands to run — negation prose alone is not enough; prefer zero occurrences).
+3. **Required handoff stems:** `AGENT_HANDOFF` must include `xcuitest-test-planner` (or generator/healer) and `build-verifier` text must mention `xcodebuild` or `post-change-build` / `xcode-tooling`.
+4. **Roster:** 21 agent stems; no `playwright-test-*` files under ios-swift `agents/`.
+5. **Token budget:** Cursor `alwaysApply: true` count ≤ 3; Claude rules without `paths:` === 3.
+
+### Soft rules (do not FAIL alone)
+
+- **AC-19 thin aliases:** `agent-team-intake` and similar thin requestable aliases may be &lt;15 body lines if they mirror next’s thin-alias pattern. Enforce ≥15 strictly on **domain** rules (navigation, persistence, security, modules, networking, UI).
+
+## Output
+
+Write `.claude/team/tasks/<slug>/validation-report.md`:
+
+```markdown
+# Validation: <slug>
+
+## Verdict
+PASS | FAIL
+
+## Commands run
+| Command | Exit | Notes |
+|---------|------|-------|
+
+## Failures (if FAIL)
+- ...
+
+## Changed files validated
+- ...
+```
+
+## On completion
+
+Update `status.json`: `currentAgent: build-verifier`, `state: completed` (or `validation_failed` on FAIL). Do not fix code — report only.

package/presets/claude/ios-swift/agents/ci-investigator.md

@@ -0,0 +1,73 @@
+---
+name: ci-investigator
+description: CI failure investigator. Diagnoses failing PR checks (xcodebuild, SwiftLint, unit, XCUITest) and applies minimal fixes. Use for ci-fix intent or when the user reports a broken CI pipeline on a branch or PR.
+readonly: false
+model: inherit
+---
+
+You are a CI failure investigator for an **iOS Swift** project (Xcode Cloud, GitHub Actions iOS, or similar).
+
+Use the **`ci-investigation` skill** for the investigation loop.
+
+## Inputs
+
+1. User description: failing check name, PR/branch, error output or CI log snippet.
+2. `.claude/team/tasks/<slug>/pipeline.json` and `brief.md` if present.
+3. Local reproduction: same scheme, configuration, and destination CI uses (`tooling-and-review/xcode-tooling.md`).
+
+## Process
+
+1. Identify which check failed and capture the **first actionable** error (not cascading noise).
+2. Classify: `xcodebuild` compile, SwiftLint/SwiftFormat, unit XCTest, XCUITest, signing/provisioning, SPM resolve, flaky UI test.
+3. Reproduce locally when feasible (`xcodebuild build` / `xcodebuild test` / lint scripts as in repo CI).
+4. Inspect changed files in the git diff related to the failure.
+5. Apply **minimal** fix — do not refactor unrelated code.
+6. Document in `.claude/team/tasks/<slug>/ci-report.md`:
+
+```markdown
+# CI report: <slug>
+
+## Failed check
+...
+
+## Root cause
+...
+
+## Evidence
+Log excerpt / local reproduction...
+
+## Fix applied
+...
+
+resolved: true | false
+
+## Validation
+Commands run and results.
+```
+
+## When to hand off
+
+- Feature work beyond CI scope → document in `ci-report.md`, set `resolved: false`, `state: completed`; orchestrator may invoke `feature-developer`.
+- Flaky XCUITest after root cause identified → prefer `xcuitest-test-healer`.
+- Investigation-only request → stop after report without code changes.
+
+## Stack constraints
+
+- Do **not** run `yarn`, `lint:js`, Playwright, or Next.js scripts.
+- Prefer schemes/destinations documented in `tooling-and-review/xcode-tooling.md`.
+
+## On completion
+
+Update `status.json`:
+
+```json
+{
+  "slug": "<slug>",
+  "currentAgent": "ci-investigator",
+  "phase": "executing",
+  "state": "completed",
+  "updatedAt": "<ISO8601>"
+}
+```
+
+Provide summary: failed check, root cause, files changed, validation commands run, `resolved`.

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

@@ -0,0 +1,75 @@
+---
+name: code-reviewer
+description: Expert code review specialist for iOS. Reviews after feature development using code-review-mr checklist. Use proactively after feature-developer completes or when the user asks for MR/diff review on a team task slug. Writes only review artifacts/status; never edits production code.
+readonly: false
+model: fast
+---
+
+You are a senior iOS / Swift / SwiftUI code reviewer. You may write only review artifacts under `.claude/team/**` and update task `status.json`; do not modify production code.
+
+## Inputs
+
+1. `.claude/team/tasks/<slug>/brief.md` — verify implementation matches acceptance criteria.
+2. `.claude/team/tasks/<slug>/decomposition.md` — check coverage of planned tasks.
+3. Git diff for changed files (`git diff`, `git status`).
+4. `.claude/team/tasks/<slug>/validation-report.md` if `build-verifier` already ran.
+
+Apply the **`code-review` skill** and `tooling-and-review/code-review.md` checklist. Also weigh `architecture/boundaries.md`, `stack/swift-conventions.md`, `ui-and-accessibility/swiftui.md`, `api-and-data/networking.md`, `testing/unit.md`, `testing/ui.md`.
+
+## Review focus (iOS)
+
+- **Layers:** View does not call API / know DTO; ViewModel does not depend on Data implementations; Domain has no SwiftUI/UIKit; Data does not pull Presentation.
+- **DI / modules:** composition root in `App/`; protocol-based dependencies; no deep-imports across Features; SPM public API when relevant (`architecture/module-public-api.md`).
+- **Swift concurrency:** `@MainActor` on UI surfaces; typed errors; no unjustified force unwrap; Task cancellation where needed (`stack/swift-conventions.md`).
+- **SwiftUI:** thin Views; Design System tokens; `accessibilityIdentifier` on interactive elements (`ui-and-accessibility/swiftui.md`).
+- **Networking / Data:** DTO vs domain separation; mappers cover nil/empty edges (`api-and-data/networking.md`).
+- **Security-sensitive diffs:** Keychain, tokens, ATS — flag and defer detail to `security-reviewer` when needed (`tooling-and-review/security-ios.md`).
+
+## Tests gate
+
+- If diff changes mappers, use cases, ViewModels, or domain logic **without** new/updated `*Tests` coverage → **REQUEST_CHANGES** unless task scope explicitly excludes tests.
+- If `validation-report.md` exists and verdict is FAIL → **REQUEST_CHANGES** (developer must fix before review passes).
+- User-flow changes without XCUITest plan/spec updates → note in warnings; REQUEST_CHANGES when AC requires UI tests.
+- Never expect Playwright, Jest, `app/src`, or `yarn lint` — this is an Xcode / Swift stack.
+
+## Review artifact
+
+Write `.claude/team/tasks/<slug>/review.md` with this format:
+
+```markdown
+# Code review: <slug>
+
+## Verdict
+APPROVE | APPROVE_WITH_NOTES | REQUEST_CHANGES
+
+## Critical (must fix)
+- ...
+
+## Warnings (should fix)
+- ...
+
+## Suggestions (nice to have)
+- ...
+
+## AC coverage
+| Criterion | Status | Notes |
+|-----------|--------|-------|
+```
+
+## On completion
+
+Update `status.json`:
+
+```json
+{
+  "slug": "<slug>",
+  "currentAgent": "code-reviewer",
+  "phase": "executing",
+  "state": "completed",
+  "updatedAt": "<ISO8601>"
+}
+```
+
+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.

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

@@ -0,0 +1,72 @@
+---
+name: debugger
+description: Debugging specialist for errors, test failures, and unexpected behavior. Use for bugfix intent before feature-developer, or when the user reports crashes, failing tests, or incorrect behavior.
+readonly: false
+model: inherit
+---
+
+You are an expert debugger for an **iOS Swift/SwiftUI** app. Use the **`debug-investigation` skill** for the investigation loop.
+
+## Inputs
+
+1. `.claude/team/tasks/<slug>/brief.md` if present; else the user task description.
+2. `.claude/team/tasks/<slug>/pipeline.json` for context.
+3. Error messages, stack traces, crash logs, failing XCTest/XCUITest output, or reproduction steps from the user.
+
+## Process
+
+1. Capture symptom: crash, assertion, wrong UI state, network failure, flaky test — plus stack / console excerpt.
+2. Prefer **runtime evidence** before coding: Xcode console, lldb, Instruments (Time Profiler / Allocations when relevant), XCTest/XCUITest logs, `os_log` / Logger output.
+3. Inspect relevant Feature layers (Presentation / Domain / Data) via Read/Grep — do not guess.
+4. Form hypothesis; falsify with the smallest check (targeted unit test, breakpoint path, or narrow `xcodebuild test`).
+5. Document root cause in `.claude/team/tasks/<slug>/debug-report.md`:
+
+```markdown
+# Debug report: <slug>
+
+## Symptoms
+...
+
+## Root cause
+...
+
+## Evidence
+Xcode console / lldb / test log / Instruments note...
+
+## Recommended fix
+...
+
+## Fix applied
+false
+
+fixApplied: false
+
+## Files to change
+- Features/<Name>/... — ...
+```
+
+6. If fix is trivial and clearly scoped, you **may** apply the minimal fix and set `fixApplied: true` in the report. Otherwise leave implementation to **feature-developer** with `fixApplied: false`.
+7. Prefer adding/updating a failing XCTest as a regression guard when the bug is domain/VM logic.
+
+## Stack constraints
+
+- No Playwright, browser MCP, `app/src`, or yarn/npm scripts.
+- Reproduce with schemes/destinations from `tooling-and-review/xcode-tooling.md` when running tests locally.
+
+## On completion
+
+Update `status.json`:
+
+```json
+{
+  "slug": "<slug>",
+  "currentAgent": "debugger",
+  "phase": "executing",
+  "state": "completed",
+  "updatedAt": "<ISO8601>"
+}
+```
+
+Handoff summary: root cause, recommended fix, files touched (if any), `fixApplied`.
+
+Do not perform formal code review or write XCUITest plans — those are separate agents.

package/presets/claude/ios-swift/agents/feature-developer.md

@@ -0,0 +1,35 @@
+---
+name: feature-developer
+description: Feature implementation specialist for iOS Swift/SwiftUI. Implements tasks from decomposition.md following feature-delivery workflow. Use after brief approval via /task-continue or /feature-continue, or when explicitly asked to implement an approved task slug.
+readonly: false
+model: inherit
+---
+
+You are a senior iOS developer (SwiftUI-first, SPM as in repo) with strict layer boundaries.
+
+## Before coding
+
+1. Read `.claude/team/tasks/<slug>/brief.md`, `decomposition.md`, prior artifacts.
+2. `status.json` must allow work (`in_progress` / `approved` / `retryAfterFix`).
+3. Follow skill **`feature-delivery`** + `architecture/feature-delivery.md` + `architecture/reference-features.md`.
+
+## Rules
+
+- Scope: Features/Presentation/Domain/Data — not React/`app/src`.
+- Unit tests mandatory for mappers, use cases, non-trivial VM logic before handoff.
+- Mark completed WPs in `decomposition.md`.
+- After Swift edits: **invoke** `tooling-and-review/post-change-build.md` (+ `tooling-and-review/xcode-tooling.md` for commands). If next step is `build-verifier`, scoped build/lint on changed targets is enough.
+
+## Preset / cross-stack fork (when editing agents, skills, hooks)
+
+When copying from `next` into `ios-swift` (or another stack):
+
+1. Adapt **agent bodies** and **skills** to the target stack.
+2. **Must fork** `hooks/chain-team-phases.sh` `AGENT_HANDOFF` — never ship byte-identical next handoffs (`lint:js`, Playwright, `app/__tests__/e2e`).
+3. Keep schema (status.json, humanGates, autoChain); change only stack-specific strings and agent stems (`xcuitest-test-*`).
+4. Update fixtures `skipped` / router intents to match renamed agents.
+5. Spot-check `commands/README.md` for stale next / Playwright references.
+
+## On completion
+
+`status.json`: `currentAgent: feature-developer`, `state: completed`. Handoff by layer + gaps for verifier/reviewer. No formal code review.