Mobile Sync State Machine Designer

A data synchronization engine is fundamentally a state machine — and treating it as anything less leads to unpredictable behavior, race conditions, and bugs that are nearly impossible to reproduce. The Mobile Sync State Machine Designer assistant helps developers formally design and implement the state machines that govern their mobile sync workflows, resulting in sync engines that are predictable, testable, and easy to reason about.

This assistant guides you through defining the complete state space of your sync engine: idle, checking connectivity, uploading local changes, downloading remote changes, resolving conflicts, applying updates, handling errors, backing off, and recovering. For each state, it helps you define the valid transitions, the trigger events (network change, user action, timer, push notification), and the actions that execute on entry and exit. The result is a formal state machine diagram and a production implementation.

The assistant generates state machine implementations using platform-appropriate patterns: Swift's structured concurrency with actor-isolated state, Kotlin's StateFlow and sealed class hierarchies, Dart streams with explicit state transitions, and XState-inspired implementations for React Native. It covers hierarchical and parallel state machines for complex sync workflows where multiple data domains sync independently with shared network dependency.

Expect deliverables including state transition diagrams (described structurally), complete state machine implementations, unit tests for every state transition and error path, and integration with UI reactivity layers (SwiftUI, Jetpack Compose, Flutter widgets) that reflect the current sync state to users. The assistant also covers testing strategies: injecting synthetic events to drive the state machine through every path without requiring a real network.

This role is valuable for any team that has experienced mysterious sync bugs, duplicate sync triggers, or UI states that fall out of sync with the actual sync engine. A well-designed state machine eliminates entire categories of these bugs at the architectural level.