ios-xcode
iOS Xcode & Tooling Best Practices
Comprehensive guide for Xcode project configuration, SwiftData persistence, testing, debugging, profiling, and app distribution. Contains 19 rules across 6 categories.
Clinic Architecture Contract (iOS 26 / Swift 6.2)
All guidance in this skill assumes the clinic modular MVVM-C architecture:
- Feature modules import
Domain+DesignSystemonly (neverData, never sibling features) - App target is the convergence point and owns
DependencyContainer, concrete coordinators, and Route Shell wiring Domainstays pure Swift and defines models plus repository,*Coordinating,ErrorRouting, andAppErrorcontractsDataowns SwiftData/network/sync/retry/background I/O and implements Domain protocols- Read/write flow defaults to stale-while-revalidate reads and optimistic queued writes
- ViewModels call repository protocols directly (no default use-case/interactor layer)
When to Apply
Reference these guidelines when:
- Setting up Xcode projects with AppStorage, ScenePhase, or widgets
- Implementing SwiftData models, queries, and CRUD operations
- Writing tests with Swift Testing framework
- Debugging with breakpoints and console output
- Profiling performance with Instruments
- Distributing apps via TestFlight
- Building for visionOS or integrating ML features
Rule Categories by Priority
| Priority | Category | Impact | Prefix |
|---|---|---|---|
| 1 | SwiftData & Persistence | CRITICAL | data- |
| 2 | Project & Platform | HIGH | platform- |
| 3 | Testing | HIGH | test- |
| 4 | Debugging & Profiling | MEDIUM-HIGH | debug-, perf- |
| 5 | Distribution | MEDIUM | dist- |
| 6 | Specialty Platforms | MEDIUM | ml-, spatial- |
Quick Reference
1. Project & Platform (HIGH)
platform-app-storage- Use AppStorage for user preferencesplatform-scene-phase- Respond to app lifecycle with ScenePhaseplatform-widget-integration- Design for widget and Live Activity integrationplatform-system-features- Integrate system features natively
2. SwiftData & Persistence (CRITICAL)
data-model-macro- Define models with @Model macrodata-query-for-fetching- Use @Query for fetching datadata-model-container- Configure model containersdata-relationships- Define model relationshipsdata-crud-operations- Implement CRUD operations
3. Testing (HIGH)
test-swift-testing- Use Swift Testing frameworktest-preview-sample-data- Create preview sample datatest-preview-macro- Use #Preview macro for rapid iteration
4. Debugging & Profiling (MEDIUM-HIGH)
debug-breakpoints- Use breakpoints for debuggingdebug-console-output- Use console output for debuggingperf-instruments-profiling- Profile SwiftUI with Instruments
5. Distribution (MEDIUM)
dist-testflight- Distribute via TestFlightdist-app-icons- Design app icons for distribution
6. Specialty Platforms (MEDIUM)
ml-natural-language- Integrate Natural Language MLspatial-visionos-windows- Build for visionOS spatial computing
How to Use
Read individual reference files for detailed explanations and code examples:
- Section definitions - Category structure and impact levels
- Rule template - Template for adding new rules
Reference Files
| File | Description |
|---|---|
| references/_sections.md | Category definitions and ordering |
| assets/templates/_template.md | Template for new rules |
More from pproenca/dot-skills
zod
Zod schema validation best practices for type safety, parsing, and error handling. This skill should be used when defining z.object schemas, using z.string validations, safeParse, or z.infer. This skill does NOT cover React Hook Form integration patterns (use react-hook-form skill) or OpenAPI client generation (use orval skill).
2.0Kclean-architecture
Clean Architecture principles and best practices from Robert C. Martin's book. This skill should be used when designing software systems, reviewing code structure, or refactoring applications to achieve better separation of concerns. Triggers on tasks involving layers, boundaries, dependency direction, entities, use cases, or system architecture.
1.4Kemilkowal-animations
Emil Kowalski's animation best practices for web interfaces. Use when writing, reviewing, or implementing animations in React, CSS, or Framer Motion. Triggers on tasks involving transitions, easing, gestures, toasts, drawers, or motion.
918vitest
Vitest testing framework patterns for test setup, async testing, mocking with vi.*, snapshots, and test performance (formerly test-vitest). This skill should be used when writing or debugging Vitest tests. This skill does NOT cover TDD methodology (use test-tdd skill), API mocking with MSW (use test-msw skill), or Jest-specific APIs.
907typescript
This skill should be used when the user asks to "optimize TypeScript performance", "speed up tsc compilation", "configure tsconfig.json", "fix type errors", "improve async patterns", or encounters TS errors (TS2322, TS2339, "is not assignable to"). Also triggers on .ts, .tsx, .d.ts file work involving type definitions, module organization, or memory management. Does NOT cover TypeScript basics, framework-specific patterns, or testing.
821nuqs
nuqs (type-safe URL query state) best practices for Next.js applications. This skill should be used when writing, reviewing, or refactoring code that uses nuqs for URL state management. Triggers on tasks involving useQueryState, useQueryStates, search params, URL state, query parameters, nuqs parsers, or Next.js routing with state.
735