biccame-musume

Backend architecture reference for Cloudflare Workers projects using Vinext App Router route handlers, Prisma with D1 adapter, Firebase Auth with HttpOnly cookie sessions, Workers AI via AI Gateway, and Zod validation. Load when writing API route handlers, database queries, auth middleware, or Workers AI integration.

PWA update notification and cache invalidation pattern for Vite + Service Worker apps. Covers the full flow — build-time version stamp, /api/version endpoint, version-check hook, update banner UI, Service Worker unregister + caches.delete() + hard reload. Load when adding PWA install, Service Worker registration, update prompts, or cache-invalidation flows.

Frontend architecture reference for React 19 + Vinext (Vite App Router) + TanStack Query + Zodios + shadcn/ui + react-hook-form projects running on Cloudflare Workers. Load when writing React components, forms, API clients, or data fetching code in this stack.

Audit and refactor non-UI code (API endpoints, Prisma queries, Zod schemas, utilities, workers, tests) for reuse, separation of concerns, type safety, and dead code removal. Does NOT touch React components or JSX — use /ui-refactor for those.

Assemble an Agent Team as leader and run the plan → approve → execute workflow