persistence-setup

Persistence Setup Generator

Generates a production-ready persistence layer using SwiftData (iOS 17+) or CoreData with optional iCloud (CloudKit) sync.

When This Skill Activates

• User asks to "add persistence" or "set up data storage"
• User mentions "SwiftData", "CoreData", or "local storage"
• User wants to "sync data to iCloud" or "enable cloud sync"
• User asks about "offline storage" or "data models"

Pre-Generation Checks (CRITICAL)

1. Project Context Detection

Before generating, ALWAYS check:

# Check deployment target
cat Package.swift | grep -i "platform"
# Or check project.pbxproj

# Find existing persistence implementations
rg -l "ModelContainer|NSPersistentContainer|@Model|@Entity" --type swift

# Check for existing SwiftData models
rg "@Model" --type swift | head -5

# Check for CoreData stack
rg "NSManagedObjectContext|NSPersistentStore" --type swift | head -5

# Check existing entitlements for iCloud
cat *.entitlements 2>/dev/null | grep -i "icloud"

2. Framework Selection

Use SwiftData if:

• Deployment target is iOS 17+ / macOS 14+
• User explicitly requests SwiftData
• No existing CoreData implementation

Use CoreData if:

• Deployment target < iOS 17
• Existing CoreData stack present
• User explicitly requests CoreData

3. Conflict Detection

If existing persistence found:

• Ask: Extend existing, migrate to SwiftData, or create separate?

Configuration Questions

Ask user via AskUserQuestion:

1. Framework choice?

   • SwiftData (iOS 17+, recommended)
   • CoreData (older targets)

2. Enable iCloud sync?

   • Yes (requires CloudKit entitlement)
   • No (local only)

3. Generate example model?

   • Yes (with sample Item model)
   • No (just infrastructure)

Generation Process

Step 1: Create Core Files

Always generate:

Sources/Persistence/
├── PersistenceController.swift    # Container setup
├── Repository.swift               # Repository protocol
└── SwiftDataRepository.swift      # Concrete implementation