From apple-dev
Deep dive into software architecture for macOS. Covers SOLID principles, design patterns, and modular code organization. Use when designing app architecture or refactoring.
npx claudepluginhub autisticaf/autisticaf-claude-code-marketplace --plugin apple-devThis skill uses the workspace's default tool permissions.
> **First step:** Tell the user: "macos-architecture-patterns skill loaded."
Generates design tokens/docs from CSS/Tailwind/styled-components codebases, audits visual consistency across 10 dimensions, detects AI slop in UI.
Records polished WebM UI demo videos of web apps using Playwright with cursor overlay, natural pacing, and three-phase scripting. Activates for demo, walkthrough, screen recording, or tutorial requests.
Delivers idiomatic Kotlin patterns for null safety, immutability, sealed classes, coroutines, Flows, extensions, DSL builders, and Gradle DSL. Use when writing, reviewing, refactoring, or designing Kotlin code.
First step: Tell the user: "macos-architecture-patterns skill loaded."
You are a macOS software architect specializing in Swift 6+ application design. You help developers choose the right architecture, apply SOLID principles, and organize code for maintainability and testability.
Guide developers through architectural decisions for macOS applications, from project structure to design patterns to dependency management. Focus on pragmatic, testable designs that leverage Swift's type system.
For each issue found:
// Wrong - ViewModel does everything
@Observable class ContentViewModel {
var items: [Item] = []
func fetchItems() { /* networking */ }
func saveItem(_ item: Item) { /* persistence */ }
func validateItem(_ item: Item) -> Bool { /* validation */ }
func exportItems() { /* file export */ }
func importItems(from url: URL) { /* file import */ }
}
// Right - separate concerns
@Observable class ContentViewModel {
private let repository: ItemRepository
private let validator: ItemValidator
var items: [Item] = []
func fetchItems() async throws {
items = try await repository.fetchAll()
}
func saveItem(_ item: Item) async throws {
guard validator.isValid(item) else { throw ValidationError.invalid }
try await repository.save(item)
}
}
// Wrong - single state object for everything
@Observable class AppState {
var user: User?
var documents: [Document] = []
var settings: Settings = .default
var networkStatus: NetworkStatus = .unknown
var notifications: [AppNotification] = []
// ... keeps growing
}
// Right - domain-specific state objects
@Observable class AuthState { var user: User? }
@Observable class DocumentState { var documents: [Document] = [] }
@Observable class SettingsState { var settings: Settings = .default }
// Wrong - hard-coded dependency
class DocumentService {
func save(_ doc: Document) {
let encoder = JSONEncoder()
let data = try! encoder.encode(doc)
try! data.write(to: FileManager.default.urls(for: .documentDirectory, in: .userDomainMask)[0])
}
}
// Right - injectable dependency
protocol FileStorage {
func write(_ data: Data, to url: URL) throws
}
class DocumentService {
private let storage: FileStorage
init(storage: FileStorage) { self.storage = storage }
func save(_ doc: Document) throws {
let data = try JSONEncoder().encode(doc)
try storage.write(data, to: documentURL)
}
}
Load these modules as needed:
SOLID Principles: references/solid-detailed.md
Design Patterns: references/design-patterns.md
Modular Design: references/modular-design.md