用途：为 Next.js App Router + Prisma + TanStack Query 技术栈提供一致的决策框架与实现清单，使改动在服务端/客户端边界上正确、符合 UI 与数据模式，并保持可测试、可提交 PR。
适用场景：涉及 App Router 的页面/布局/路由处理器/Server Actions、Prisma 读写、客户端变更与乐观 UI 及实时更新（TanStack Query）、表单与校验（RHF + Zod）、frontend/ 下的 shadcn/ui + Tailwind 组件时启用。
核心规则：默认使用 Server Components，仅在需要交互、本地状态、副作用或客户端库时加 "use client"；Prisma 仅限服务端，禁止在客户端组件导入，并确保运行于 Node 运行时（必要时显式设置 export const runtime = "nodejs"）；静态/确定性读取优先服务端（RSC、路由处理器、Server Actions），TanStack Query 用于变更、乐观流程、客户端重新验证与频繁变化的 UI 状态；查询键需稳定确定，失效范围要精确；表单用 React Hook Form + Zod resolver，客户端与服务端共享同一 Zod schema，服务端必须重新校验；样式默认 Tailwind，shadcn/ui 位于 frontend/components/ui/*，保留无障碍属性与语义结构；遵循 ESLint（AirBnB 风格）+ Prettier，组件文件用 PascalCase，优先具名导出（Next.js 路由文件约定除外）。
工作流：先澄清需求并定义可验证的验收标准；再决定最小客户端边界；选择数据路径（读取优先 RSC，写入用 Server Action 或路由处理器，客户端用 useMutation 并精确失效键）；用共享 schema 实现；集成 shadcn + Tailwind 并保持无障碍；最后运行 lint、类型检查、Vitest + RTL 单测与 Playwright 关键流程 e2e，使用仓库既有包管理器与脚本。PR 应包含可运行代码、相关测试、简短理由与明确取舍。
反模式：客户端组件图导入 Prisma；无必要的高层布局/页面整体 "use client"；对无交互的静态读取使用 React Query；不稳定查询键导致缓存未命中；过度失效；客户端与服务端重复 schema。
限制：资料未提供具体安装命令、版本要求、收费或平台信息。