stims

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

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.

Run the Stims quality gate. Knows the fast→full iteration loop and visual verification.

Review changes to CI, wrangler config, build scripts, Cloudflare deploy, or tooling. Use when a PR touches .github/workflows/ci.yml, wrangler.toml, scripts/build.mjs, scripts/deploy-cloudflare.mjs, or package.json scripts.

Review changes to tests, fixtures, or integration harnesses. Use when a PR adds, modifies, or removes tests, or when test expectations, stubs, or environment setup change.

Audit commit history to find recurring fix patterns and update prevention skills. Use when analyzing what keeps breaking, updating review skills, or refreshing the fix-pattern audit doc.

Modify the visualizer's preset workflows. Use when changing bundled presets, preset catalog behavior, live editing, import/export, compatibility/parity, or preset metadata and fixtures.

Launch and inspect the flagship visualizer in a real browser. Use when reproducing runtime behavior manually, checking audio-reactive playback, or capturing visual evidence from the canonical workspace route.

Run the end-to-end flow for a visualizer change. Use when a product-facing runtime or preset update spans implementation, docs sync, validation, and PR-ready completion.

Validate visualizer behavior and product-facing runtime changes. Use when running targeted tests, integration or compatibility coverage, or the full repo quality gate.