Swift Architecture

Covers pattern selection and implementation for Swift apps across MV, MVVM, MVI, TCA, Clean Architecture, Coordinator, and VIPER. Includes a decision table that maps complexity and testability needs to patterns, with practical examples showing @Observable models, view model separation, and unidirectional flow. The default guidance is sensible: start with MV for new SwiftUI apps and escalate only when feature complexity demands it. Handles migration paths between patterns and explicitly scopes out SwiftUI state mechanics, navigation, and concurrency to other skills. Most useful when you're choosing an architecture for a new feature or justifying why your current pattern isn't working anymore.

skills.sh installs: 3.3K
GitHub stars: 1.3K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add dpearson2699/swift-ios-skills --skill swift-architecture --agent claude-code

Installs into .claude/skills of the current project.

Files

Swift Architecture

Choose the smallest architecture that makes state ownership, dependencies, side effects, and tests explicit. Default new SwiftUI features to MV; escalate only for observed complexity.

Scope Boundary
Decision Workflow
Pattern Selection
MV Default
Escalation Signals
Migration
Common Mistakes
Review Checklist
References

Scope Boundary

This skill owns pattern selection, module boundaries, dependency direction, migration strategy, and architecture-level test seams. Route SwiftUI property-wrapper wiring and view composition to swiftui-patterns, navigation APIs and route models to swiftui-navigation, isolation diagnostics to swift-concurrency, and test syntax/fixtures to swift-testing.