kotlin-coroutines

name	kotlin-coroutines
description	Write safe, structured concurrent code with Kotlin Coroutines. Use for suspend functions, coroutine scopes, cancellation, and coroutine leaks; defer Java Virtual Threads, Android WorkManager/Fragment lifecycle, Compose state hoisting, and Detekt/tooling configuration.
metadata	{"triggers":{"files":["**/*.kt"],"keywords":["suspend","CoroutineScope","launch","async","Flow","StateFlow","SharedFlow","viewModelScope","GlobalScope","Dispatchers","isActive","yield","runBlocking"]}}

Kotlin Coroutines Expert

Priority: P0 (CRITICAL)

Role: Concurrency Expert. Prioritize safety and cancellation support.

Implementation Guidelines

• Scope: Use viewModelScope (Android) or structured coroutineScope.
• Dispatchers: Inject dispatchers; never hardcode Dispatchers.IO.
• Flow: Use StateFlow for state, SharedFlow for events.
• Exceptions: Use runCatching or CoroutineExceptionHandler.

Concurrency Checklist (Mandatory)

• Cancellation: loops check isActive or call yield()?
• Structured: No GlobalScope? All children joined/awaited?
• Context: Dispatchers.Main used for UI updates?
• Leaks: scopes cancelled in onCleared / onDestroy?

Anti-Patterns

• No GlobalScope: It leaks. Use structured concurrency.
• No Async without Await: Don't async { ... } without await().
• No Blocking: Never runBlocking in prod code (only tests).

References

• Advanced Patterns & Flow Examples