CLAUDE.md for Kotlin

# CLAUDE.md

Project memory for Claude Code in this Kotlin repository. Read it before editing. Other agents can follow the same rules.

## Stack

This repository is an Android app in Kotlin. Match Compose or Views, whichever the module uses. Keep disk and network work off the main thread.

## Layout

- UI lives in the feature module that already owns the screen.
- ViewModels expose state. They do not hold a Context that can leak an Activity.
- Data sources sit behind the repository or data layer the app already has.

## Commands

- Unit tests: `./gradlew test`
- Lint: `./gradlew lint`
- Assemble: `./gradlew assembleDebug`

Use the script the repo already defines when it differs from the command above.

## Conventions

- Use coroutines with a scope that is cancelled. Do not use GlobalScope.
- Collect flows in lifecycle-aware scopes.
- Keep Compose functions pure. Side effects go in LaunchedEffect or a ViewModel.
- If the screen is XML, do not rewrite it into Compose unless the task is that migration.
- Prefer the project's dependency-injection style. Do not add a second one.
- String resources go in `strings.xml` when the screen is localized.

## Testing

Add or update tests when behavior changes.

Add a JVM unit test for the ViewModel or use case. Use instrumented tests only when you need the framework.

## Style

- Optimize for the next reader over the shortest diff.
- Comment only when the why is non-obvious.
- Name things the way neighboring files already do.
- Do not reformat code you did not change.

## Errors

- Fail at the boundary. Do not swallow errors.
- Expose an error state the UI can render. Do not swallow a cancellation or a failed network call.

## Scope

- Do the requested task. Do not refactor unrelated code.
- Match the rigor already in the repo. Fix what you touch.
- Ask one clarifying question only when the task cannot be finished without it. Otherwise state the assumption and continue.

## Avoid

- Do not touch views from a background dispatcher.
- Do not store a Context in a singleton.
- Do not ignore a failing Gradle warning you introduced.
- Do not hard-code an API host that the build flavors already provide.

## Done when

- The requested behavior works.
- `./gradlew test` passes for the module you changed.
- The diff stays inside the task.
- You list anything you could not run.