Axiom Cloud Sync

What it does

The Axiom Cloud Sync skill enables AI agents to manage and synchronize data between local storage and cloud services, specifically iCloud's CloudKit and iCloud Drive. It focuses on implementing robust offline-first patterns to handle network interruptions gracefully. The skill provides tools for choosing the appropriate synchronization method based on data structure (structured records vs. files) and offers guidance on conflict resolution strategies.

When to use it

• When needing to synchronize structured data with relationships between devices using SwiftData or other persistence frameworks.
• For applications requiring file-based data storage accessible through the Files app on iOS.
• When dealing with large binary files like images and videos that need to be synchronized.
• To manage application settings and preferences, considering the limitations of NSUbiquitousKeyValueStore.
• In scenarios where continuous, reliable data synchronization is critical, even in offline environments.

Key capabilities

• CloudKit Integration: Supports structured data synchronization with query support, relationships, and record-level conflict resolution.
• iCloud Drive Integration: Enables file-based data synchronization visible within the Files app.
• Decision Tree Guidance: Provides a quick decision tree to help select between CloudKit and iCloud Drive based on data type.
• Offline-First Architecture: Mandates an offline-first approach for all sync operations, prioritizing local storage writes before cloud synchronization.
• Conflict Resolution Strategies: Offers guidance on resolving conflicts that arise when multiple devices modify the same data concurrently.

Example prompts

• "Which method should I use to synchronize user records with relationships?"
• "How do I handle network failures during file uploads to iCloud Drive?"
• "What's the best way to sync app preferences between my iPhone and iPad?"

Tips & gotchas

• Choose the right tool: CloudKit is designed for structured data, while iCloud Drive is ideal for files. Avoid using them interchangeably.
• Offline-first is mandatory: All synchronization code must prioritize local storage writes to ensure resilience against network interruptions.
• Expect and handle conflicts: Implement conflict resolution strategies to manage situations where multiple devices modify the same data simultaneously.