Menu
Review changes to WebGPU/WebGL dual-backend parity. Use when a PR touches feedback managers, renderer adapters, shader lowering, or any code that affects both WebGPU and WebGL rendering paths.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | review-webgpu-parity |
| description | Review changes to WebGPU/WebGL dual-backend parity. Use when a PR touches feedback managers, renderer adapters, shader lowering, or any code that affects both WebGPU and WebGL rendering paths. |
Use this skill when reviewing or authoring changes to src/js/milkdrop/feedback-manager-*, src/js/milkdrop/renderer-adapter*, src/js/milkdrop/backend-behavior.ts, src/js/milkdrop/compiler/gpu-descriptor-plan.ts, or any shader-lowering code.
The most frequent source of fixes in this repo (~22% of fix commits) is parity drift between WebGPU and WebGL — still the #1 category: alpha blending order, feedback color math, wave interpolation, resolution scales, and shader lowering. This skill prevents those regressions at review time.
bun run test:compat passes
If the change touches shader generation or feedback sampling, run the parity reference suite:
bun run test tests/milkdrop-renderer-adapter.test.ts
bun run test tests/milkdrop-feedback-composite-profile.test.ts
bun run test tests/milkdrop-shader-sampler-aliases.test.ts
If the change touches compiler IR or GPU descriptor plans, run:
bun run test tests/milkdrop-compiler.test.ts
bun run test tests/milkdrop-compiler-seams.test.ts
tests/milkdrop-renderer-adapter.test.ts for patterns).If the PR changes the render pipeline, verify against at least one of:
eos-phat-cubetrace-v2krash-rovastar-cerebral-demons-starsrovastar-parallel-universebun run dev
# Load preset, compare visual output to baseline or upstream projectM
compiler/gpu-descriptor-plan.ts, lowered field handling, or shader center normalization includes a comment explaining how the generated GPU code differs between WebGL and WebGPU.if (isWebGPU) branches that duplicate logic without a shared helperinnerHTML or string-built shader code without a corresponding test fixturefeedback-manager-shared.ts that do not also update feedback-manager-webgpu.ts (or explain why not)modify-preset-workflow — when the change is mainly preset content, not renderer paritymodify-visualizer-runtime — when the change is broader runtime/shell worktest-visualizer — for running the full validation suiteAuto-guardrail for agent-authored changes. Use at the start of any coding session to prevent the most common agent mistakes in this repo.
Iterate on visualizer UI, workspace chrome, and CSS with fast feedback loops. Use when changing frontend components, styling, layout, or animation without needing the full MilkDrop runtime.
Modify the flagship visualizer runtime safely. Use when changing the shared runtime, loader, renderer, shell, controls, audio flows, capability checks, or canonical-route behavior.
Review changes to module loading, bootstrap, toy manifest, library resolution, or gamepad polling. Use when a PR touches src/js/bootstrap/, src/js/loader.ts, src/js/router.ts, src/js/toy-view.ts, src/data/toys.json, or gamepad polling code.
Review changes to renderer capability probing, fallback chains, timeout logic, or audio worklet initialization. Use when a PR touches src/js/core/renderer-*, src/js/core/audio-handler.ts, or src/js/milkdrop/runtime/backend-fallback.ts.
Review changes to React workspace UI state, URL routing, toast/panel behavior, or engine adapter interactions. Use when a PR touches src/js/frontend/*, especially App.tsx, workspace hooks, or url-state.ts.