Playback Pipeline Audit
Testing & Qualityplayback-pipeline-auditPlayback Pipeline Audit is an Agent Skill for testing & quality published in the oxyroid/M3UAndroid repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Audit M3UAndroid playback flows for UI/engine/persistence boundaries, lifecycle cleanup, Media3 integration, casting, overlays, resume/autoplay behavior, and TV control risks.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/oxyroid/M3UAndroid/blob/HEAD/.claude/skills/playback-pipeline-audit/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/playback-pipeline-audit, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Playback Pipeline Audit
Audit playback changes with evidence from UI, state, data adapters, and lifecycle paths.
When To Use
Use when a task changes or reviews:
- Media3/ExoPlayer setup or adapters
- Playback controls, overlays, or TV remote behavior
- Casting, resume, retry, stream selection, or persistence
- Lifecycle handling around playback resources
Required Context
Read first:
AGENTS.md- Relevant
app/AGENTS.md,business/AGENTS.md, anddata/AGENTS.md docs/ai/playbooks/playback-pipeline.md- Nearby playback UI, state holders, adapters, repositories, and tests
Audit Checks
Verify with file evidence:
- UI state, playback engine state, and persistence concerns remain separated.
- Playback resources are created, observed, and released with lifecycle awareness.
- Side effects are not launched directly from composition without effect control.
- Playback overlays remain readable and do not block primary controls.
- TV remote and focus paths are preserved for TV playback surfaces.
- Resume, autoplay, retry, casting, and stream-selection changes are documented.
Process
- Map playback entry points, state holders, adapters, and UI surfaces.
- Trace one start, one stop/release, and one error/retry path.
- Inspect Compose effects and lifecycle observers involved in playback.
- Check phone and TV surfaces separately when both are affected.
- Cite file paths and line numbers for each finding.
Validation
Recommend:
./gradlew :app:smartphone:compileDebugKotlin
For TV playback changes also recommend:
./gradlew :app:tv:compileDebugKotlin
If manual playback checks cannot be run, state the remaining behavior risk.
Output
Return a concise Markdown report with:
- Scope and behavior paths reviewed
- Pass/fail table for each audit check
- Evidence-backed findings with file paths
- Behavior and lifecycle risks for PR notes
- Validation run or not run, with reason