This skill should be used when the user asks to "implement a macOS feature", "integrate SwiftUI with AppKit", "fix macOS lifecycle issues", or "apply platform-specific patterns".
Use this skill as the canonical implementation reference for macOS Swift/SwiftUI/AppKit work in this repository.
native-app-designer for primary UI/UX direction and experience analysisquality-assurance for verification lanes and merge gatesswift-concurrency-expert for Swift 6.2 diagnostics/remediationswiftui-performance-audit for SwiftUI runtime bottlenecksswiftui-animation for advanced animation systemsstruct vs class).@MainActor.reuse -> extend -> create.make build-test, targeted tests).quality-assurance.make build-test
make preflight-agent
For final merge in Medium/High risk work:
make build-test
../build-macos-apps/SKILL.md (intake/router)../native-app-designer/SKILL.md (primary UI/UX direction)../quality-assurance/SKILL.md (verification policy)../swiftui-patterns/SKILL.md../menubar/SKILL.md../audio-realtime/SKILL.md../localization/SKILL.md../swift-package-manager/SKILL.mdUse detailed references under references/ for architecture, system APIs, testing, design system, and packaging topics.
When changes touch app lifecycle, enforce this contract:
3d04791 changed shortcut behavior (Enter/Return blocked), touching lifecycle/controller/settings paths.AssistantShortcutController and shortcut settings view models indicate lifecycle fragility.1134cd6 reduced static initializer pressure across onboarding/settings lifecycle code.3cc603f and 05b114a iterated rapidly on floating recording indicator behavior.0c32f13 removed sendable overlay callback patterns to satisfy actor-isolation constraints.swift-concurrency-expert when compiler errors appear.094d280 and 918243b both modified App/AppDelegate/Lifecycle.swift for launch recovery and prewarm sequencing.f7243e0 and 166643c repeatedly touched AppDelegate menu bar/recording UI surfaces to stabilize status and floating-indicator behavior.App/AppDelegate/Lifecycle.swift as the top hotspot (4 commits).