| name | playbridge-android |
| description | Work across PlayBridge's Android phone, Android TV, and shared Kotlin projects. Use for Kotlin, Compose, GeckoView, Android playback, Gradle, shared KMP, root version-catalog, or Android-specific protocol consumer changes under mobile/android/, tv/android/, shared/, gradle/, or prebuilt/media3/. |
PlayBridge Android
Establish ownership
- Treat
mobile/android/ and tv/android/ as separate Gradle roots.
- Treat
shared/ and gradle/libs.versions.toml as cross-consumer code. Give them one writer and inspect both Android consumers.
- Split phone and TV work between subagents only when their edits do not overlap. Keep shared files with the primary integrator or one designated owner.
- Load
playbridge-protocol as well when wire messages, pairing, or generated protocol bindings change.
Work safely
- Follow the root
AGENTS.md, including the graph-first exploration workflow.
- Run every Gradle command from the project that owns the change.
- Preserve TV cleartext stream support and the scoped TLS behavior in
ContentSniffer.kt.
- Keep GeckoView and Media3 versions compatible with both Android roots and
prebuilt/media3/.
- Never log Debrid tokens, pairing credentials, signing material, or authenticated stream URLs.
Verify
On macOS, invoke Gradle through zsh after sourcing ~/.zshrc.
From mobile/android/, select the narrowest relevant checks:
zsh -c "source ~/.zshrc && ./gradlew :app:testFossDebugUnitTest"
zsh -c "source ~/.zshrc && ./gradlew :app:assembleDebug"
zsh -c "source ~/.zshrc && ./gradlew :app:lintFossDebug"
From tv/android/, select the narrowest relevant checks:
zsh -c "source ~/.zshrc && ./gradlew test"
zsh -c "source ~/.zshrc && ./gradlew :player:app:assembleDebug"
zsh -c "source ~/.zshrc && ./gradlew lint"
Validate shared/ changes through both roots when both consume the affected code.
