android-kmp-playbook
Comprehensive Claude Code toolkit for Android and Kotlin Multiplatform (KMP) many skills, sub-agents, and command enforcing Clean Architectu
Open source Open in the app JSON README (API)
About
Comprehensive Claude Code toolkit for Android and Kotlin Multiplatform (KMP) many skills, sub-agents, and command enforcing Clean Architecture, Jetpack Compose best practices, KMP patterns, coroutines, TDD, Wear OS, TV, XR, and more.
Details
- Kind
- Plugins
- Topic
- No topic detected
- Publisher
- rezaiyan
- Origin
- marketplace
- Category
- ferramentas
- Stars
- 1
- Last push
- 2026-03-22T11:01:46Z
- Repository state
- ativo
- License
- MIT
- Added
- 2026-08-30 01:48:58
- Updated
- 2026-08-30 01:48:58
- Origin id
rezaiyan/android-kmp-claude-playbook/android-kmp-playbook
README
# Android & KMP Claude Code Playbook
A Claude Code plugin for Android and Kotlin Multiplatform (KMP) projects — 16 skills, 8 sub-agents, and 1 command that enforce Clean Architecture, Compose best practices, KMP patterns, TDD, and more.
## Install as a plugin
```
/plugin marketplace add rezaiyan/android-kmp-claude-playbook
```
That's it. Skills and agents load automatically based on what you're working on.
## Manual install (copy-paste)
If you prefer not to use the plugin system:
1. Copy `.claude/` and `CLAUDE.md` into the root of your Android/KMP project.
2. Open the project in Claude Code — rules and skills load automatically.
## What's included
```
.claude/
├── agents/ # Sub-agents for specialized autonomous tasks
├── skills/ # Topic-specific reference skills (loaded on demand)
└── commands/ # Custom slash commands
.claude-plugin/
├── plugin.json # Plugin manifest
└── marketplace.json # Marketplace metadata
CLAUDE.md # Project instructions Claude reads automatically
```
## Skills
Skills are Markdown files Claude reads when relevant context is detected, or when you invoke them with `/skill <name>`.
| Skill | Topic |
|---|---|
| `clean-code` | Kotlin naming, null safety, scope functions, sealed interfaces |
| `clean-architecture` | Layer diagram, domain models, use cases, mappers |
| `jetpack-compose` | Stateless composables, state hoisting, slot API, side effects |
| `compose-stability` | @Stable/@Immutable, ImmutableList, strong skipping, compiler metrics |
| `kmp-patterns` | Source sets, expect/actual, SQLDelight, Ktor, kotlinx.datetime, SKIE |
| `coroutines-flow` | Structured concurrency, Flow operators, StateFlow, SharedFlow |
| `dependency-injection` | Koin 4.x modules, viewModel {}, scopes, Hilt patterns |
| `solid-android` | SOLID + YAGNI/DRY/KISS applied to Kotlin/Android |
| `tdd-android` | Red-Green-Refactor, Turbine, FakeRepository, MockEngine |
| `database-migration` | Room AutoMigration, manual Migration, SQLDelight .sqm |
| `ci-cd-android` | GitHub Actions, Gradle caching, signing, Play Store, Kover |
| `modularization` | Feature module graph, convention plugins, boundary rules |
| `wear-os` | Tiles, complications, Horologist, Health Services, ambient mode |
| `tv-os` | Compose for TV, D-pad focus, TvLazyRow/Column, 10-foot UX |
| `xr-development` | Jetpack XR, Subspace, SpatialPanel, Orbiter, GltfModel, gaze |
| `widget-development` | Glance API, GlanceAppWidget, state, lazy lists, click actions |
## Agents
Sub-agents handle specialized tasks autonomously. Claude triggers them automatically based on what you're working on.
| Agent | Purpose | Triggered when |
|---|---|---|
| `compose-reviewer` | Reviews Compose code for recomposition, stability, Modifier order, accessibility | Writing/modifying Compose UI |
| `tdd-enforcer` | Writes failing tests first, then implementation; enforces coverage | Before/during feature implementation |
| `migration-expert` | Designs and implements Room/SQLDelight migrations with tests | Any database schema change |
| `wear-os-specialist` | Implements Wear OS screens, tiles, complications, Health Services | Wear OS feature work |
| `tv-developer` | Implements Android TV screens with D-pad focus and 10-foot UX | Android TV feature work |
| `ci-cd-optimizer` | Builds/improves GitHub Actions pipelines — cache, signing, Play Store | CI/CD setup or optimization |
| `xr-specialist` | Implements Android XR features — Subspace, SpatialPanel, Orbiter, 3D | Android XR feature work |
| `module-graph-auditor` | Detects illegal cross-module deps, missing convention plugins, layer violations | Adding modules or reviewing dependency graph |
## Commands
| Command | What it does |
|---|---|
| `/migrate` | Plans and implements a Room or SQLDelight database migration |
## Universal rules
These rules are always active via `CLAUDE.md`:
- Kotlin idioms over Java patterns. No `!!` without justification.
- Coroutines over callbacks. `Flow` over `LiveData`.
- State flows down, events flow up (event sink pattern).
- No business logic in `@Composable` functions.
- No `try-catch` for control flow — use `Flow.catch {}` or `Try<T>`.
- Clean Architecture layer boundaries strictly enforced.
- `ImmutableList<T>` over `List<T>` in Compose parameters.
- `fakes` over `mocks` in tests.
## License
MIT