zz-plant

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.

Create and refine glossary entries with consistent taxonomy, cross-linking, and editorial quality.

Perform safe cleanup and refactors that reduce duplication, dead code, and maintenance burden.

Ship repeatable SEO and discoverability improvements for metadata, structured data, and crawl surfaces.

Maintain documentation changes with correct placement, check policy, and PR-ready outcomes.

Encode taste as structure and maintain premium design standards.

Resolve TypeScript type errors systematically across the project.

Run full quality assurance checks before committing or merging.

Verify UI changes using browser-based testing and visual checks.

ESL-first copy review workflow for Building Ledger UI text, notice templates, and contributor docs.

Generate policy-aligned PR summary and changelog text for Building Ledger changes with required scope, security, and test sections.

Security and privacy review workflow for Building Ledger changes that touch access, evidence, export, notice, or visibility controls.

Contributor and review guidance for Building Ledger with strict safety, privacy, and ESL-first copy requirements.