Individual skill

ios-testing

Testing practices for iOS 26 / Swift 6.2 clinic modular MVVM-C applications. Covers unit/UI/snapshot testing, protocol-based mocks, async actor isolation, and dependency-injected test architecture aligned with Domain protocols, App-target composition, and Data-owned I/O boundaries. Use when writing, reviewing, or refactoring tests for ios-* and swift-* clinic modules.

skills/.experimental/ios-testing/SKILL.md

Read pinned source

Source commit cf93c57cac89d6fc3e4194686000411567f5caf3

What was checked

Matches the observed repository HEAD: Yes
Scanner rules are current: No
Repository scan complete: No
Skill scan complete: Yes
Observed behavior: Not checked yet
Last checked: Nov 5, 2026

These are observations at the recorded commit, not a guarantee of safety. Review the source before running it.

Install this skill

Choose an agent in your Stack or copy a command below. Commands fetch the pinned commit and copy only this skill directory. Existing destinations are refused. Copying a command does not install anything.

An install command is unavailable: current rules, complete repository and skill scans, an eligible behavior level and a permitted license are required.

Repository context

Repository stars (not skill ratings): 222
Repository last updated: Aug 15, 2026
License: MIT

Observed agent integration: No specific integration evidence. Standard SKILL.md installation does not imply verified compatibility.

testing Derived category
engineering Derived category
design Derived category
writing Derived category
data Derived category
design-interface Derived category

Files and excerpt

File metadata and permitted, redacted excerpts come from the recorded scan. Source links are pinned to that commit.

Browse files

SKILL.mdcore · 8,232 bytes
assets/templates/_template.mddoc · 726 bytes
metadata.jsonasset · 1,305 bytes
references/_sections.mddoc · 2,400 bytes
references/arch-arrange-act-assert.mddoc · 1,555 bytes
references/arch-constructor-injection.mddoc · 1,824 bytes
references/arch-protocol-dependencies.mddoc · 2,041 bytes
references/arch-single-responsibility-tests.mddoc · 2,095 bytes
references/arch-test-target-separation.mddoc · 2,103 bytes
references/arch-testable-import.mddoc · 2,110 bytes
references/async-actor-testing.mddoc · 1,788 bytes
references/async-await-directly.mddoc · 1,505 bytes
references/async-confirmation.mddoc · 1,655 bytes
references/async-mainactor-isolation.mddoc · 2,448 bytes
references/async-task-cancellation.mddoc · 1,664 bytes
references/ci-coverage-thresholds.mddoc · 2,664 bytes
references/ci-deterministic-test-data.mddoc · 2,757 bytes
references/ci-flaky-test-quarantine.mddoc · 2,137 bytes
references/ci-parallel-execution.mddoc · 3,635 bytes
references/ci-test-plans.mddoc · 2,593 bytes
references/mock-avoid-over-mocking.mddoc · 1,707 bytes
references/mock-dependency-container.mddoc · 2,095 bytes
references/mock-fake-for-integration.mddoc · 2,333 bytes
references/mock-protocol-based-mocks.mddoc · 2,389 bytes
references/mock-spy-for-verification.mddoc · 1,931 bytes
references/mock-stub-return-values.mddoc · 1,658 bytes
references/snap-device-matrix.mddoc · 1,995 bytes
references/snap-inline-snapshots.mddoc · 1,900 bytes
references/snap-named-references.mddoc · 1,861 bytes
references/snap-swift-snapshot-testing.mddoc · 1,702 bytes
references/swiftui-binding-testing.mddoc · 1,567 bytes
references/swiftui-environment-injection.mddoc · 1,874 bytes
references/swiftui-preview-as-test.mddoc · 1,305 bytes
references/swiftui-test-observable-models.mddoc · 1,630 bytes
references/swiftui-view-model-extraction.mddoc · 2,211 bytes
references/ui-accessibility-identifiers.mddoc · 1,318 bytes
references/ui-launch-arguments.mddoc · 1,604 bytes
references/ui-page-object-pattern.mddoc · 2,871 bytes
references/ui-reset-state-between-tests.mddoc · 2,074 bytes
references/ui-test-user-journeys.mddoc · 2,046 bytes
references/ui-wait-for-elements.mddoc · 1,502 bytes
references/unit-descriptive-test-names.mddoc · 2,033 bytes
references/unit-expect-over-assert.mddoc · 1,638 bytes
references/unit-parameterized-tests.mddoc · 1,971 bytes
references/unit-require-preconditions.mddoc · 1,681 bytes
references/unit-swift-testing-framework.mddoc · 1,783 bytes
references/unit-test-suites.mddoc · 2,139 bytes
references/unit-test-tags.mddoc · 1,876 bytes

Read excerpt


# iOS Testing Best Practices

Comprehensive testing guide for iOS and Swift applications, written at principal engineer level. Contains 44 rules across 8 categories, prioritized by impact to guide test architecture decisions, test authoring patterns, and CI infrastructure.


## Clinic Architecture Contract (iOS 26 / Swift 6.2)

All guidance in this skill assumes the clinic modular MVVM-C architecture:

- Feature modules import `Domain` + `DesignSystem` only (never `Data`, never sibling features)
- App target is the convergence point and owns `DependencyContainer`, concrete coordinators, and Route Shell wiring
- `Domain` stays pure Swift and defines models plus repository, `*Coordinating`, `ErrorRouting`, and `AppError` contracts
- `Data` owns SwiftData/network/sync/retry/background I/O and implements Domain protocols
- Read/write flow defaults to stale-while-revalidate reads and optimistic queued writes