# Android Kotlin Architecture

> >

- **Type:** Skill
- **Install:** `agentstack add skill-haidrrrry-compose-kotlin-agent-skills-android-kotlin-architecture`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [haidrrrry](https://agentstack.voostack.com/s/haidrrrry)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [haidrrrry](https://github.com/haidrrrry)
- **Source:** https://github.com/haidrrrry/compose-kotlin-agent-skills/tree/main/skills/android-kotlin-architecture
- **Website:** https://github.com/haidrrrry/compose-kotlin-agent-skills#readme

## Install

```sh
agentstack add skill-haidrrrry-compose-kotlin-agent-skills-android-kotlin-architecture
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Android Kotlin — Architecture Module

Parent kit: [`../../SKILL.md`](../../SKILL.md) · Index: [`../../AGENTS.md`](../../AGENTS.md)

## Read First

| File | When |
|------|------|
| [`../../references/01-architecture.md`](../../references/01-architecture.md) | Full MVVM/MVI patterns, container/content composables |
| [`../../references/04-coroutines-flow.md`](../../references/04-coroutines-flow.md) | StateFlow, Channel effects, stateIn |
| [`../../references/05-hilt-di.md`](../../references/05-hilt-di.md) | @HiltViewModel, repository wiring |
| [`../../references/06-room-db.md`](../../references/06-room-db.md) | Repository + Room offline-first |

## MVI Contract (Mandatory)

```kotlin
@Immutable
data class FeatureUiState(
    val items: List = emptyList(),
    val isLoading: Boolean = false,
    val error: UiError? = null
)

sealed interface FeatureUiEvent {
    data class SearchChanged(val query: String) : FeatureUiEvent
    data object Refresh : FeatureUiEvent
    data class ItemClicked(val id: String) : FeatureUiEvent
}

sealed interface FeatureUiEffect {
    data class ShowMessage(@StringRes val messageRes: Int) : FeatureUiEffect
    data class NavigateToDetail(val id: String) : FeatureUiEffect
}

class FeatureViewModel @Inject constructor(
    private val repository: FeatureRepository
) : ViewModel() {

    private val _state = MutableStateFlow(FeatureUiState())
    val state: StateFlow = _state.asStateFlow()

    private val _effects = Channel(Channel.BUFFERED)
    val effects: Flow = _effects.receiveAsFlow()

    fun onEvent(event: FeatureUiEvent) {
        when (event) {
            is FeatureUiEvent.SearchChanged -> onSearchChanged(event.query)
            FeatureUiEvent.Refresh -> refresh()
            is FeatureUiEvent.ItemClicked -> emitNavigate(event.id)
        }
    }

    private fun onSearchChanged(query: String) {
        _state.update { it.copy(searchQuery = query) }  // ONLY mutation style allowed
    }

    private fun refresh() {
        viewModelScope.launch {
            _state.update { it.copy(isLoading = true, error = null) }
            repository.sync()
                .onSuccess { _state.update { it.copy(isLoading = false) } }
                .onFailure { e ->
                    _state.update { it.copy(isLoading = false, error = e.toUiError()) }
                }
        }
    }

    private fun emitNavigate(id: String) {
        viewModelScope.launch { _effects.send(FeatureUiEffect.NavigateToDetail(id)) }
    }
}
```

## Module Layout (Large Apps)

```
app/
feature-/
  presentation/   # Composables + ViewModel
  domain/         # Models, repository interfaces, UseCases
  data/           # Room, Ktor, mappers
core/
  core-ui/        # Design system
  core-domain/
  core-testing/
```

Feature modules must not depend on other feature modules — only `core-*` and `domain` contracts.

## UseCase Rule

| Use UseCase | Skip UseCase |
|-------------|--------------|
| Logic shared by 2+ ViewModels | Single-line repo delegate |
| Multi-repo orchestration | One ViewModel, one repo |
| Needs isolated unit tests | CRUD with no extra rules |

## Anti-Patterns (Architecture)

| Banned | Fix |
|--------|-----|
| `_state.value = newState` | `_state.update { it.copy(...) }` |
| God ViewModel (>200 lines) | Split screen or extract UseCases |
| ViewModel in composable params | Pass `onEvent` lambdas |
| Domain model with `@Entity` | Entity in `data/`, map in repository |
| Collecting Flow in `init` without `stateIn` | `stateIn(WhileSubscribed(5_000))` |

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [haidrrrry](https://github.com/haidrrrry)
- **Source:** [haidrrrry/compose-kotlin-agent-skills](https://github.com/haidrrrry/compose-kotlin-agent-skills)
- **License:** MIT
- **Homepage:** https://github.com/haidrrrry/compose-kotlin-agent-skills#readme

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-haidrrrry-compose-kotlin-agent-skills-android-kotlin-architecture
- Seller: https://agentstack.voostack.com/s/haidrrrry
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.