android-uplift-deps
Toolchain/dependency uplift playbook for Android apps: one axis per commit, release-note research, dependency diffs, review.
SKILL.mdcodex/skills/android-uplift-deps/SKILL.md
GitHubRead the project AGENTS.md and applicable global guidance first. Fall back to CLAUDE.md if AGENTS.md is absent. Follow the global rules for optional tools, specialist agents and Git actions.
Dependency uplift: the user request
Repo facts (modules, compile/assemble commands, catalog vs Groovy scripts, deliberate opt-outs) come from the project's
AGENTS.md and its gradle-deps rule if present. Write the step 4 plan before editing dependency versions. Existing authorization to perform the uplift is sufficient.
Skills named below are optional companions. When one is missing, follow references/companions.md in the android-standards skill 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. Proceed within the user-authorized scope. Ask only about unresolved scope or consequential choices.
- 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:
$android-run-appon 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.