Covers all five SOLID principles with dedicated references (SRP, OCP, LSP, ISP, DIP), concurrency patterns (actors, @MainActor, Sendable), an anti-pattern catalog, and code templates for views, view models, services, protocols, and models.
Requires grepping the codebase for reusable protocols/services before writing new code, and checking shared locations (Core/Extensions/, Core/Utilities/, Core/Protocols/) before duplicating logic used by 2+ features.
SOLID Swift - Apple Best Practices 2026
Agent Workflow (MANDATORY)
Before ANY implementation, spawn 3 agents in parallel, one Agent call each with a name:
- fuse-ai-pilot:explore-codebase - Analyze existing architecture
- fuse-ai-pilot:research-expert - Verify Swift/Apple docs via Apple Docs MCP + Context7
- XcodeBuildMCP - Build validation after code changes. Then run fuse-ai-pilot:sniper.
DRY - Reuse Before Creating (MANDATORY)
Before writing ANY new code:
- Grep the codebase for similar protocols, services, or logic
- Check shared locations:
Core/Extensions/, Core/Utilities/, Core/Protocols/
- If similar code exists -> extend/reuse instead of duplicate
- If code will be used by 2+ features -> create it in
Core/ directly
Architecture (Features Modular MANDATORY)
| Layer |
Location |
Max Lines |
| Views |
Features/[Feature]/Views/ |
80 |
| ViewModels |
Features/[Feature]/ViewModels/ |
100 |
| Services |
Features/[Feature]/Services/ |
100 |
| Protocols |
Features/[Feature]/Protocols/ |
30 |
| Shared |
Core/{Models,Protocols,Services,Extensions,Utilities}/ |
- |
NEVER use flat Sources/ structure - always Features/[Feature]/
Critical Rules (MANDATORY)
| Rule |
Value |
| File limit |
100 lines (split at 90) |
| ViewModels |
@MainActor @Observable |
| Protocols |
Features/[Feature]/Protocols/ or Core/Protocols/ ONLY |
| Models |
Sendable structs |
| Documentation |
/// on all public APIs |
| Previews |
Every View MUST have #Preview |
Reference Guide
Concepts
| Topic |
Reference |
When to consult |
| SOLID Overview |
solid-principles.md |
Quick reference all principles |
| SRP |
single-responsibility.md |
Fat views/VMs, splitting files |
| OCP |
open-closed.md |
Adding providers, extensibility |
| LSP |
liskov-substitution.md |
Protocol contracts, testing |
| ISP |
interface-segregation.md |
Fat protocols, splitting |
| DIP |
dependency-inversion.md |
Injection, testing, mocking |
| Concurrency |
concurrency-patterns.md |
Actors, @MainActor, Sendable |
| Anti-Patterns |
anti-patterns.md |
Code smells detection |
Templates
| Template |
When to use |
| view.md |
SwiftUI View with subviews and #Preview |
| viewmodel.md |
@Observable ViewModel with @MainActor |
| service.md |
API Service, Mock, Cache actor |
| protocol.md |
Service protocol, CQRS, Auth |
| model.md |
Model, DTO, Error, Enum |
Forbidden
| Anti-Pattern |
Fix |
| Files > 100 lines |
Split at 90 |
| Protocols in impl files |
Move to Protocols/ directory |
ObservableObject |
Use @Observable |
| Completion handlers |
Use async/await |
Missing #Preview |
Add preview for every View |
| Non-Sendable in async |
Use struct with let |
Flat Sources/ structure |
Use Features/[Feature]/ |
1---2name: solid-swift3description: Use when applying SOLID principles to Swift 6/SwiftUI code — file-size limits, protocol separation, @Observable, actors, feature-modular architecture.4versions:5 swift: "6.2"6 ios: "26"7user-invocable: true8references: references/solid-principles.md, references/single-responsibility.md, references/open-closed.md, references/liskov-substitution.md, references/interface-segregation.md, references/dependency-inversion.md, references/concurrency-patterns.md, references/anti-patterns.md, references/templates/view.md, references/templates/viewmodel.md, references/templates/service.md, references/templates/protocol.md, references/templates/model.md9related-skills: swift-core, swiftui-core, ios, macos, ipados, watchos, visionos, tvos10metadata:11 source: https://skillmd.com/skills/fusengine/solid-swift12---1314<objective>15Enforces SOLID and DRY principles for Swift 6 and SwiftUI (iOS 26+) projects: a mandatory Features/[Feature]/ modular directory structure (never a flat Sources/ layout), strict file-size limits (100 lines, split at 90, with per-layer budgets for Views/ViewModels/Services/Protocols), protocols separated into their own Protocols/ directories, @Observable + @MainActor for ViewModels, Sendable structs for models, and mandatory #Preview on every View.1617Covers all five SOLID principles with dedicated references (SRP, OCP, LSP, ISP, DIP), concurrency patterns (actors, @MainActor, Sendable), an anti-pattern catalog, and code templates for views, view models, services, protocols, and models.1819Requires grepping the codebase for reusable protocols/services before writing new code, and checking shared locations (Core/Extensions/, Core/Utilities/, Core/Protocols/) before duplicating logic used by 2+ features.20</objective>2122# SOLID Swift - Apple Best Practices 20262324## Agent Workflow (MANDATORY)2526Before ANY implementation, spawn 3 agents in parallel, one `Agent` call each with a `name`:27281. **fuse-ai-pilot:explore-codebase** - Analyze existing architecture292. **fuse-ai-pilot:research-expert** - Verify Swift/Apple docs via Apple Docs MCP + Context7303. **XcodeBuildMCP** - Build validation after code changes. Then run **fuse-ai-pilot:sniper**.3132---3334## DRY - Reuse Before Creating (MANDATORY)3536**Before writing ANY new code:**371. **Grep the codebase** for similar protocols, services, or logic382. Check shared locations: `Core/Extensions/`, `Core/Utilities/`, `Core/Protocols/`393. If similar code exists -> extend/reuse instead of duplicate404. If code will be used by 2+ features -> create it in `Core/` directly4142---4344## Architecture (Features Modular MANDATORY)4546| Layer | Location | Max Lines |47|-------|----------|-----------|48| Views | `Features/[Feature]/Views/` | 80 |49| ViewModels | `Features/[Feature]/ViewModels/` | 100 |50| Services | `Features/[Feature]/Services/` | 100 |51| Protocols | `Features/[Feature]/Protocols/` | 30 |52| Shared | `Core/{Models,Protocols,Services,Extensions,Utilities}/` | - |5354**NEVER use flat `Sources/` structure - always `Features/[Feature]/`**5556---5758## Critical Rules (MANDATORY)5960| Rule | Value |61|------|-------|62| File limit | 100 lines (split at 90) |63| ViewModels | `@MainActor @Observable` |64| Protocols | `Features/[Feature]/Protocols/` or `Core/Protocols/` ONLY |65| Models | `Sendable` structs |66| Documentation | `///` on all public APIs |67| Previews | Every View MUST have `#Preview` |6869---7071## Reference Guide7273### Concepts7475| Topic | Reference | When to consult |76|-------|-----------|-----------------|77| **SOLID Overview** | [solid-principles.md](references/solid-principles.md) | Quick reference all principles |78| **SRP** | [single-responsibility.md](references/single-responsibility.md) | Fat views/VMs, splitting files |79| **OCP** | [open-closed.md](references/open-closed.md) | Adding providers, extensibility |80| **LSP** | [liskov-substitution.md](references/liskov-substitution.md) | Protocol contracts, testing |81| **ISP** | [interface-segregation.md](references/interface-segregation.md) | Fat protocols, splitting |82| **DIP** | [dependency-inversion.md](references/dependency-inversion.md) | Injection, testing, mocking |83| **Concurrency** | [concurrency-patterns.md](references/concurrency-patterns.md) | Actors, @MainActor, Sendable |84| **Anti-Patterns** | [anti-patterns.md](references/anti-patterns.md) | Code smells detection |8586### Templates8788| Template | When to use |89|----------|-------------|90| [view.md](references/templates/view.md) | SwiftUI View with subviews and #Preview |91| [viewmodel.md](references/templates/viewmodel.md) | @Observable ViewModel with @MainActor |92| [service.md](references/templates/service.md) | API Service, Mock, Cache actor |93| [protocol.md](references/templates/protocol.md) | Service protocol, CQRS, Auth |94| [model.md](references/templates/model.md) | Model, DTO, Error, Enum |9596---9798## Forbidden99100| Anti-Pattern | Fix |101|--------------|-----|102| Files > 100 lines | Split at 90 |103| Protocols in impl files | Move to `Protocols/` directory |104| `ObservableObject` | Use `@Observable` |105| Completion handlers | Use `async/await` |106| Missing `#Preview` | Add preview for every View |107| Non-Sendable in async | Use `struct` with `let` |108| Flat `Sources/` structure | Use `Features/[Feature]/` |