swift-architecture

Select and apply Swift 6.3 architecture patterns for Apple platform apps.

Updated Apr 30, 2026
One-click install
npx skills add https://github.com/onymchat/onym-ios --skill swift-architecture-onymchat
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: swift-architecture
Source: https://github.com/onymchat/onym-ios/tree/main/.claude/skills/swift-architecture
Command: npx skills add https://github.com/onymchat/onym-ios --skill swift-architecture-onymchat

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The Swift-architecture Skill helps teams identify and apply the most suitable architecture pattern for Apple platform apps, from MV to Clean Architecture and Coordinators, reducing guesswork during feature development and migrations.

Core Features & Use Cases

  • Architecture selection guidance across MV, MVVM, MVI, TCA, Clean Architecture, and Coordinator patterns.
  • Migration guidance between patterns and evaluation of a current architecture's fit for a feature or module.
  • Default recommendations for new SwiftUI apps, plus a decision framework to match feature complexity with an architecture pattern.

Quick Start

Describe a feature's complexity and requirements to receive a recommended architecture pattern and implementation plan.

Frequently Asked Questions about swift-architecture

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
What is the best architecture pattern for a new SwiftUI app?

The best SwiftUI architecture depends on feature complexity, with MV or MVVM recommended for simple features and Clean Architecture or TCA for enterprise modules. A structured decision framework matches your specific feature requirements to the most suitable pattern.

How do I migrate my iOS app from MVVM to TCA?

To migrate from MVVM to TCA, evaluate your current architecture's fit and follow structured migration guidance that maps existing modules to the new pattern. This process involves assessing dependency injection and testability considerations to ensure a smooth transition between architecture patterns.

When should I use the Coordinator pattern in Swift?

Use the Coordinator pattern in Swift when you need to manage navigation flow and routing separately from your view components. It is particularly effective for enterprise modules or complex feature flows where decoupling navigation logic improves testability and maintainability.

MVI vs TCA: which architecture fits my Swift feature?

MVI vs TCA selection depends on your feature's state management complexity and unidirectional data flow requirements. The decision framework evaluates feature scope, testability needs, and dependency injection constraints to determine whether MVI or TCA better fits your Swift module.

Does this architecture guidance work for both single features and enterprise modules?

Yes, the architecture guidance works for both single features and enterprise modules by scaling the decision framework accordingly. It evaluates pattern fit, dependency injection strategies, and testability considerations across different complexity levels, from individual SwiftUI views to large-scale module architectures.