uplift-deps

Toolchain/dependency uplift playbook for Android apps: one axis per commit, release-note research, dependency diffs, review.

SKILL.md

GitHub

Dependency 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.

  1. Baseline. Clean git status on feat/<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.
  2. Inventory. List the in-scope entries with current versions (version catalog, or build.gradle files in Groovy repos). Note any gradle.properties opt-outs and convention plugins the uplift touches.
  3. Research. Send one android-researcher per 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 load agp-9-upgrade.
  4. 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}
  5. 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.txt against deps-before.txt and list transitive changes.
  6. Runtime check when native or vendored code is involved: {@invoke android-kit/run-app} on the 16 KB AVD, then the android-verifier agent runs the baseline tests and a smoke journey and returns the evidence.
  7. 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.
  8. Commit, only if asked. Follow the shared Git conventions. Do not push unless asked.
  9. Report table: item, old, new, build result, test result, notable transitive changes, follow-ups.