docs: add the Kotlin migration playbook and tracker

[nickolas-dimitrakas]

Summary

Adds the playbook and tracker for the Java to Kotlin migration of android-core and android-kit-base internals, and points AGENTS.md at them.

• docs/kotlin-migration/PLAYBOOK.md: the two governing rules (no breaking change; main is always releasable), what converts and what stays Java and why, the compatibility tiers and the check that proves each, the conversion rules that keep the compiled API identical, the per-PR checklist, risk classes and merge rules, the ProGuard protocol, rollback, and the steps to add when a release is cut while migration work is unreleased.
• docs/kotlin-migration/TRACKER.md: every planned pull request by phase and stack, with line counts, existing-test counts and risk class, plus the QA checkpoints.
• AGENTS.md: a short pointer to both documents.

Dependencies

The documents refer to tooling introduced by the other Phase 0 pull requests (apiCheck and scripts/check_api_dump.py, scripts/api_compat_report.py, settings-compat.gradle). This pull request should merge after them.

🤖 Generated with Claude Code

[github-actions]

📦 SDK Size Impact Report

What the SDK adds to a minified release APK.

Measured against an empty baseline app. Unlike the Rokt kit, android-core ships no Compose and no resources, so there is nothing here that a host app would already provide.

mParticle Core SDK

Metric	Target branch	This PR	Change
APK size	119.79 KB	119.79 KB	-2 bytes
Download size	117.60 KB	117.60 KB	-2 bytes
Dex bytes	213.75 KB	213.75 KB	0 bytes

➡️ SDK size impact change is minimal.

Raw measurements

Target branch:

{"baseline_dex_bytes": 0, "baseline_download_bytes": 2512, "baseline_install_bytes": 7528, "core_dex_bytes": 218884, "core_download_bytes": 122937, "core_install_bytes": 130190}

This PR:

{"baseline_dex_bytes": 0, "baseline_download_bytes": 2513, "baseline_install_bytes": 7529, "core_dex_bytes": 218884, "core_download_bytes": 122936, "core_install_bytes": 130189}

_{Measured b20a64d merged into 19fef8d}

[cursor]

PR Summary

Low Risk
Documentation additions outlining the Java-to-Kotlin migration guidelines and roadmap with no changes to application code.

Overview
Adds documentation and tracking guidelines for the ongoing Java-to-Kotlin migration across android-core and android-kit-base.

Introduces docs/kotlin-migration/PLAYBOOK.md, which defines the rules to prevent breaking API changes, conversion best practices, review checklists, risk classifications, and ProGuard verification protocols.

Introduces docs/kotlin-migration/TRACKER.md to map out the planned migration phases, individual pull request stacks, line count baselines, and milestone checkpoints. Also updates AGENTS.md to direct contributors to these guidelines before modifying core or kit modules.

^{Reviewed by Cursor Bugbot for commit 5fcb2ae. Bugbot is set up for automated code reviews on this repo. Configure here.}

[jamesnrokt]

One flag is we need a deeper test before any releases following this process

[github-actions]

Binary compatibility

• ✅ android-core is compatible with 6.1.5 (115 classes compared, 1 with additions only).
• ✅ android-kit-base is compatible with 6.1.5 (44 classes compared, 0 with additions only).

Compares the release AAR against the same artifact at the last version published to Maven Central; R8-renamed classes and members are excluded (see the script docstring). Full japicmp HTML/XML reports are attached as the api-compat-reports workflow artifact. This check is not in the required-check set yet, so a red result here does not block merging.

[jamesnrokt]

Approving and reran checks - Happy to approve again if checks need a proper fix