mirror of
https://github.com/meshtastic/Meshtastic-Android.git
synced 2026-04-20 22:23:37 +00:00
57 lines
3.3 KiB
Markdown
57 lines
3.3 KiB
Markdown
# Agent Playbooks
|
|
|
|
These playbooks are execution-focused guidance for common changes in this repository.
|
|
|
|
Use `AGENTS.md` as the source of truth for architecture boundaries and required conventions. If guidance conflicts, follow `AGENTS.md` and current code patterns.
|
|
|
|
## Version baseline for external docs
|
|
|
|
When checking upstream docs/examples, match these repository-pinned versions from `gradle/libs.versions.toml`:
|
|
|
|
- Kotlin: `2.3.20`
|
|
- Koin: `4.2.0` (`koin-annotations` `2.1.0`, compiler plugin `0.4.1`)
|
|
- JetBrains Navigation 3: `1.1.0-alpha04` (`org.jetbrains.androidx.navigation3`)
|
|
- JetBrains Lifecycle (multiplatform): `2.10.0-beta01` (`org.jetbrains.androidx.lifecycle`)
|
|
- AndroidX Lifecycle (Android-only): `2.10.0` (`androidx.lifecycle`)
|
|
- Kotlin Coroutines: `1.10.2`
|
|
- Compose Multiplatform: `1.11.0-alpha04`
|
|
- JetBrains Material 3 Adaptive: `1.3.0-alpha06` (`org.jetbrains.compose.material3.adaptive`)
|
|
|
|
Prefer versioned docs pages that match those versions (for example, Koin `4.2` docs rather than older `4.0/4.1` pages).
|
|
|
|
## Dependency alias quick-reference
|
|
|
|
Version catalog aliases split cleanly by fork provenance. **Use the right prefix for the right source set.**
|
|
|
|
| Alias prefix | Coordinates | Use in |
|
|
|---|---|---|
|
|
| `jetbrains-lifecycle-*` | `org.jetbrains.androidx.lifecycle:*` | `commonMain`, `androidMain` |
|
|
| `jetbrains-navigation3-*` | `org.jetbrains.androidx.navigation3:*` | `commonMain`, `androidMain` |
|
|
| `jetbrains-navigationevent-*` | `org.jetbrains.androidx.navigationevent:*` | `commonMain`, `androidMain` |
|
|
| `jetbrains-compose-material3-adaptive-*` | `org.jetbrains.compose.material3.adaptive:*` | `commonMain`, `androidMain` |
|
|
| `androidx-lifecycle-process` | `androidx.lifecycle:lifecycle-process` | `androidMain` only — `ProcessLifecycleOwner` |
|
|
| `androidx-lifecycle-runtime-ktx` | `androidx.lifecycle:lifecycle-runtime-ktx` | `androidMain` only |
|
|
| `androidx-lifecycle-viewmodel-ktx` | `androidx.lifecycle:lifecycle-viewmodel-ktx` | `androidMain` only |
|
|
| `androidx-lifecycle-testing` | `androidx.lifecycle:lifecycle-runtime-testing` | `androidUnitTest` only |
|
|
| `androidx-navigation-common` | `androidx.navigation:navigation-common` | `androidMain` only |
|
|
|
|
> `jetbrains-navigation3-runtime` and `jetbrains-navigation3-ui` resolve to the same `navigation3-ui` artifact — JetBrains does not publish a separate runtime artifact yet.
|
|
|
|
Quick references:
|
|
|
|
- Koin annotations (4.2 docs): `https://insert-koin.io/docs/reference/koin-annotations/start`
|
|
- Koin KMP docs: `https://insert-koin.io/docs/reference/koin-annotations/kmp`
|
|
- AndroidX Navigation 3 release notes: `https://developer.android.com/jetpack/androidx/releases/navigation3`
|
|
- Kotlin release notes: `https://kotlinlang.org/docs/releases.html`
|
|
|
|
## Playbooks
|
|
|
|
- `docs/agent-playbooks/common-practices.md` - architecture and coding patterns to mirror.
|
|
- `docs/agent-playbooks/di-navigation3-anti-patterns-playbook.md` - DI and Navigation 3 mistakes to avoid.
|
|
- `docs/agent-playbooks/kmp-source-set-bridging-playbook.md` - when to use `expect`/`actual` vs interfaces + app wiring.
|
|
- `docs/agent-playbooks/task-playbooks.md` - step-by-step recipes for common implementation tasks.
|
|
- `docs/agent-playbooks/testing-and-ci-playbook.md` - which Gradle tasks to run based on change type, plus CI parity.
|
|
- `docs/agent-playbooks/testing-quick-ref.md` - Quick reference for using the new testing infrastructure.
|
|
|
|
|
|
|