f8-tools-coroutine-mainthread-workflow

# Coroutine/MainThread Tools Workflow ## Use this skill when - The task involves coroutine management or dispatching work to the main thread. - The user needs to run code on the main thread from a background thread. ## Path resolution 1. Source: Assets/F8Framework/Runtime/Utility/Coroutine/ ## Sources of truth - Source directory: Assets/F8Framework/Runtime/Utility/Coroutine ## Key capabilities - Coroutine start/stop utilities - Main thread action dispatch from background threads - Thread-safe Unity API access patterns - Coroutine chaining helpers ## Workflow 1. Use coroutine utilities for managed coroutine lifecycle. 2. Dispatch to main thread when accessing Unity APIs from background threads. 3. Combine with `LogF8.LogToMainThread()` for thread-safe logging. 4. WebGL does not support multi-threading — use coroutines only. ## Common error handling | Error | Cause | Solution | |-------|-------|----------| | Unity API from background thread | Thread-unsafe access | Dispatch to main thread | | Coroutine not running | MonoBehaviour inactive | Ensure host is active | ## Output checklist - Threading model identified (main thread only vs multi-thread). - Main thread dispatch configured if needed. - Coroutine host MonoBehaviour verified.