name	swiftdata-persistence
description	Design and review SwiftData schemas, queries, migrations, isolation, CloudKit assumptions, offline behavior, and deterministic persistence tests.

SwiftData Persistence

Define ownership, retention, uniqueness, relationships, deletion behavior, and sync expectations before writing models.
Confirm minimum OS and current SwiftData API availability.
Keep persistence models separate from view-specific formatting and transient UI state.
Design schema changes with an explicit migration and rollback story. Never infer that production data can be discarded.
Place model-context work behind a clear actor boundary and avoid passing live mutable models across isolation domains.
Use indexed or constrained fields for actual query and uniqueness needs, not speculative optimization.
Test with isolated temporary or in-memory containers. Cover migration, relationship deletion, duplicate prevention, ordering, and failure recovery.
Treat CloudKit compatibility and conflict behavior as separate proof from local persistence.

Read references/schema-review.md before changing an existing store.

name	swiftdata-persistence
description	Design and review SwiftData schemas, queries, migrations, isolation, CloudKit assumptions, offline behavior, and deterministic persistence tests.

Define ownership, retention, uniqueness, relationships, deletion behavior, and sync expectations before writing models.
Confirm minimum OS and current SwiftData API availability.
Keep persistence models separate from view-specific formatting and transient UI state.
Design schema changes with an explicit migration and rollback story. Never infer that production data can be discarded.
Place model-context work behind a clear actor boundary and avoid passing live mutable models across isolation domains.
Use indexed or constrained fields for actual query and uniqueness needs, not speculative optimization.
Test with isolated temporary or in-memory containers. Cover migration, relationship deletion, duplicate prevention, ordering, and failure recovery.
Treat CloudKit compatibility and conflict behavior as separate proof from local persistence.

Read references/schema-review.md before changing an existing store.

swiftdata-persistence