---
name: android-development
description: >
  Comprehensive coding skill for Android projects using Kotlin, Jetpack Compose, Hilt DI,
  multi-module Clean Architecture, and MVVM. Use this when asked to create, edit, debug, test,
  or refactor any Android code — including features, ViewModels, composables, repositories,
  use cases, Gradle files, and tests. Also use this when setting up a new Android project or module.
---

# Android Development Skill

This skill governs all Android development tasks. It is **project-agnostic** and applies to any Android codebase using Kotlin, Jetpack Compose, and modern Android architecture.

## How to Use

All rules are in the `references/` directory alongside this file. **Read every references file before generating or editing code.** Each file is a self-contained rule set for a specific concern.

| References File                         | When to Read                                                                |
|-----------------------------------------|-----------------------------------------------------------------------------|
| `references/01-anti-hallucination.md`   | **Always.** Read before every task. These override all other rules.         |
| `references/02-architecture.md`         | When creating modules, features, or any structural code.                    |
| `references/03-gradle.md`               | When touching `build.gradle.kts`, adding dependencies, or creating modules. |
| `references/04-coding-style.md`         | When writing any Kotlin code (non-UI).                                      |
| `references/05-compose-ui.md`           | When writing or editing any Jetpack Compose code.                           |
| `references/06-reactive-programming.md` | When working with Flow, coroutines, or async logic.                         |
| `references/07-navigation.md`           | When adding screens, routes, or navigation logic.                           |
| `references/08-dependency-injection.md` | When creating DI modules, injecting dependencies, or scoping.               |
| `references/09-testing.md`              | When writing or editing any test code.                                      |
| `references/10-database.md`             | When modifying Room entities, DAOs, or schemas.                             |
| `references/11-naming-conventions.md`   | When naming files, packages, modules, or classes.                           |
| `references/12-conventional-commits.md` | When writing commit messages or generating changelogs.                      |

## Key Principle

> When in doubt, **read existing project code first**. Never assume. Never invent. Search, read, confirm — then generate.