Swift Refactor

A comprehensive refactoring guide for migrating Swift/SwiftUI projects to a modular MVVM-C architecture with local SPM packages. You'd reach for this when modernizing from ObservableObject to @Observable, replacing NavigationView with NavigationStack, or restructuring an app into Feature/Domain/Data boundaries where the app target owns dependency injection and coordination. It enforces practical rules like @Equatable on every view for diffing, stable identifiers in ForEach, and the dependency rule that feature modules never import Data or sibling features. The 50+ rules are prioritized by impact and organized into categories like view diffing, API modernization, and state architecture. Opinionated but well structured for teams committed to this specific architecture pattern.

skills.sh installs: 281
GitHub stars: 222
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add pproenca/dot-skills --skill swift-refactor --agent claude-code

Installs into .claude/skills of the current project.

Files

Swift/SwiftUI Refactor (Modular MVVM-C)

Comprehensive refactoring guide for migrating Swift/SwiftUI code to modular MVVM-C with local SPM package boundaries and App-target composition root wiring.

Mandated Architecture Stack

┌───────────────────────────────────────────────────────────────┐
│ App target: DependencyContainer, Coordinators, Route Shells   │
├───────────────────────────────────────────────────────────────┤
│ Feature modules: View + ViewModel (Domain + DesignSystem deps)│
├───────────────────────────────────────────────────────────────┤
│ Data package: repositories, remote/local stores, sync, retry  │
├───────────────────────────────────────────────────────────────┤
│ Domain package: models, repository/coordinator/error protocols │
└───────────────────────────────────────────────────────────────┘

Dependency Rule: Feature modules never import Data and never import sibling features.