uplift-deps
Toolchain/dependency uplift playbook for Android apps: one axis per commit, release-note research, dependency diffs, review.
SKILL.mdsrc/skills/android-kit/uplift-deps/SKILL.md
GitHubDependency uplift: {@args}
Repo facts (modules, compile/assemble commands, catalog vs Groovy scripts, deliberate opt-outs) come from the project's
{@project_file_full} and its gradle-deps rule if present. {@uplift_gate}
Skills named below are optional companions. When one is missing, follow references/companions.md in {@skill_named android-kit/standards} and continue.
- Baseline. Clean
git statusonfeat/<ticket>-<slug>(or the project's documented branch convention). Run the project's compile checks and./gradlew :app:dependencies --configuration <debugVariant>RuntimeClasspath > <scratchpad>/deps-before.txt. Quote results. - Inventory. List the in-scope entries with current versions (version catalog, or
build.gradlefiles in Groovy repos). Note anygradle.propertiesopt-outs and convention plugins the uplift touches. - Research. Send one
android-researcherper axis from step 4, in parallel, each asking for its inventory table. Ask for the latest stable of each item, its release notes, and compatibility (AGP↔Gradle↔JDK, Kotlin↔KSP↔Compose compiler). For AGP majors also loadagp-9-upgrade. - Plan. One commit per axis, ordered Gradle → AGP → Kotlin/KSP → Compose BOM/AndroidX → third-party. Name the variants you will build and the tests you will run. {@plan_gate}
- Apply each axis. Edit versions only where the project declares them. Rebuild all compile checks. For
AGP/Kotlin/Gradle also run one release assemble (R8 path) and one debug assemble. Run the unit tests that passed at baseline.
Diff
deps-after.txtagainstdeps-before.txtand list transitive changes. - Runtime check when native or vendored code is involved:
{@invoke android-kit/run-app}on the 16 KB AVD, then theandroid-verifieragent runs the baseline tests and a smoke journey and returns the evidence. - Review.
android-reviewer. Confirm each Blocker and Major against the code first, and decline a refuted one with the counter-evidence. Fix the rest, then re-run the compile check and the affected tests. Send the same reviewer the finding IDs and their "Verified fixed when" criteria to re-review the fix delta. Stop after two re-review rounds and report anything still open. - Commit, only if asked. Follow the shared Git conventions. Do not push unless asked.
- Report table: item, old, new, build result, test result, notable transitive changes, follow-ups.