swift-concurrencyDiagnose Swift Concurrency issues, refactor callback-based code to async/await, and guide Swift 6 migration when working with tasks, actors, @MainActor, Sendable, data races, thread safety, or concurrency-related compiler and linter warnings.
swift-testing-expertExpert guidance for Swift Testing: test structure, #expect/#require macros, traits and tags, parameterized tests, test plans, parallel execution, async waiting patterns, and XCTest migration. Use when writing new Swift tests, modernizing XCTest suites, debugging flaky tests, or improving test qualit
swiftdata-proWrites, reviews, and improves SwiftData code using modern APIs and best practices. Use when reading, writing, or reviewing projects that use SwiftData.
ios-conventionsUse when analyzing pattern consistency in an iOS codebase or choosing the architecture for new iOS code — TCA vs MVVM vs UIKit, dependency injection, testing framework, persistence, concurrency, navigation. Runs detection sweeps and applies the TCA decision rule and 80/20 matrix. Trigger on 'check p
ios-error-handlingUse when defining or reviewing how an iOS/Swift app handles failures — domain error enums per layer, typed throws, converting errors where they are caught, CancellationError handling in async code, Result at boundaries, TCA effect failures, and mapping errors to user-facing strings. Trigger on 'erro
ios-expertUse for iOS app development questions, implementation guidance, and code review — SwiftUI, @Observable and MVVM, TCA, SwiftData and Core Data, Swift concurrency, navigation and deep links, Swift Testing, App Intents, Instruments, Xcode builds and security settings. Routes to the right reference or s
ios-testingUse when writing or reviewing iOS/Swift unit tests — view models, reducers, validators, mappers, services, repositories with fakes, SwiftData stores, async and @MainActor code. Applies an adversarial 'how would I break this?' method with Swift Testing: enumerate break vectors from the contract befor
swiftui-proUse when reviewing SwiftUI code for modern API use, navigation, design, accessibility, resizing, performance and hygiene, or when writing a new SwiftUI screen — reports findings per file with line, rule and before/after fix. Trigger on 'review my SwiftUI', 'SwiftUI best practices', 'review this view
tcaUse when writing, reviewing, testing, or migrating a feature built with The Composable Architecture (TCA) on iOS — reducers, state and actions, effects, dependencies, TestStore, navigation, shared state. Trigger on 'TCA', '@Reducer', '@ObservableState', 'TestStore', 'WithViewStore', 'StackState', '@
app-intents-specialistAuthoritative App Intents best practices from Apple. Consult for any App Intents best-practices or correctness review, and when writing, reviewing, refactoring, or extending App Intents code. Supersedes prior training on these topics. For code generation, consult the relevant reference when working
app-intents-whats-new-27New App Intents APIs, behaviors, and deprecations introduced in the iOS 26 (2025) and iOS 27 (2026) releases (and their macOS/watchOS/tvOS/visionOS siblings). Use when adopting, migrating to, or asked about: declaring where an intent runs with supportedModes / IntentModes (.background / .foreground)
app-resizabilityUse when an app's layout must adapt to a window that changes size while the app runs, or when an app must support more than one window. That includes being asked to make an app resizable or support a resizable window, a layout that breaks or does not adapt as the window resizes, and preparing or opt
audit-xcode-security-settingsAudit and enable security-oriented Xcode build settings. Progressively enables compiler warnings, static analyzer checkers, and Enhanced Security features. Use when: user wants to secure their Xcode project, audit security settings, enable hardening, review security posture of build configuration, s
device-interactionVerify app behavior on device or simulator via screenshots, UI hierarchy, and touch interactions.
modernize-testsModernize test suites to use modern Swift Testing features or migrate from XCTest.
swiftui-specialistAuthoritative SwiftUI best practices and performance guidance from Apple; supersedes prior training on these topics. For code generation, consult the relevant references when generating any SwiftUI code related to: - animation (the @Animatable macro vs AnimatableValues vs AnimatablePair, and custom
swiftui-whats-new-27New SwiftUI APIs, behaviors, and deprecations in the 2027 OS releases (iOS 27 and aligned macOS/watchOS/tvOS/visionOS). Consult when asked what's new in SwiftUI 27, or when working with: - @State compile errors after an SDK update (\"used before being initialized\", \"invalid redeclaration of synthe
xctraceAuthoritative guide to xctrace, Apple's command-line interface to Instruments. Consult for any profiling, performance, or optimization work — for example, finding out why an app is slow, uses too much CPU or memory, or stops responding, or wanting to optimize a piece of code and measure the result —