droidconKeKotlin AGENTS.md

AGENTS.md

Working notes for AI agents and new contributors on the droidcon Kenya Android app.

CONTRIBUTING.md covers the human process — issues, forks, PR expectations. This file covers what you need to know to change code here without breaking it.

---

Commands

Run these before opening a PR. CI runs the same set.

./gradlew spotlessApply ktlintFormat          # format first — the checks below are strict
./gradlew spotlessCheck ktlintCheck detekt    # static analysis
./gradlew lint                                # Android Lint + Slack's Compose rules
./gradlew stabilityCheck                      # Compose recomposition regressions
./gradlew assembleDebug                       # build
./gradlew testDebugUnitTest                   # JVM + Robolectric tests

Instrumentation tests run on Gradle Managed Devices, so no emulator setup is needed:

./gradlew :data:supportedApiLevelsGroupDebugAndroidTest    # api30 + api34

Single test class:

./gradlew :presentation:testDebugUnitTest --tests "*SessionsFilterStateTest*"

No JDK setup needed — gradle/gradle-daemon-jvm.properties pins the daemon to Java 17 and the foojay resolver provisions it.

---

Module layout

app                  Application, MainActivity host, manifest, DI graph root
presentation         All Compose UI, ViewModels, navigation
chai                 Design system: colours, typography, shared components
domain               Pure Kotlin — models and repository interfaces. No Android dependency.
data                 Repository implementations, sync, mappers
datasource:local     Room database, DAOs, entities
datasource:remote    Ktor client, DTOs, Remote Config
build-logic          Convention plugins

Dependency rule: domain depends on nothing. data depends on domain, never the reverse. presentation does not reach into datasource:local. Keep domain free of Android imports — it is the module that would move first if this ever becomes multiplatform.