| name | apk-size-audit |
| description | Audit M3UAndroid APK/AAB size and packaging changes for dependency growth, native libraries, resources, R8/minification, generated assets, baseline profiles, and artifact comparison evidence. |
| allowed-tools | Read, Glob, Grep, Bash, Agent |
| argument-hint | [repo path or app module path] |
APK Size Audit
Audit packaging and size-sensitive changes with measurable artifact and configuration evidence.
When To Use
Use when a task changes or reviews:
- Dependencies, native libraries, packaging options, or R8/minification
- Resources, generated assets, baseline profiles, or release artifacts
- Native-load packaging and runtime loading behavior
Required Context
Read first:
AGENTS.md- Relevant module
AGENTS.md files for touched build logic
docs/ai/playbooks/apk-size.mddocs/native-load-yaml.md when native packs are affected- Relevant Gradle, version catalog, packaging, and benchmark files
Audit Checks
Verify with file evidence:
- Dependencies are added through the version catalog with justification.
- Native library packaging and runtime loading remain aligned.
- R8/minification/resource shrinking changes are intentional and variant-scoped.
- Generated assets are not committed or modified manually unless required.
- Artifact size comparisons use the same variant/build type.
- Baseline profile or benchmark changes do not hide runtime regressions.
Process
- Map changed Gradle, version catalog, packaging, native-load, and generated-asset files.
- Identify artifact variants affected by the change.
- Compare dependency/resource/native-library deltas when data is available.
- Cite file paths and line numbers for each finding.
- Avoid claiming size wins without measured artifact evidence.
Validation
Recommend:
./gradlew :app:smartphone:assembleRelease
Use the affected TV or extension variant when applicable. If artifact comparison cannot be run, state the remaining size risk.
Output
Return a concise Markdown report with:
- Scope and artifacts reviewed
- Pass/fail table for each audit check
- Evidence-backed findings with file paths
- Measured size deltas or reason measurements are unavailable
- Validation run or not run, with reason
