用途：为 Next.js App Router 项目提供统一的前端开发约定，指导组件类型选择、数据获取、表单、鉴权路由与 UI 组件使用。
主要能力：默认使用 Server Components，仅在需要 hooks、事件、浏览器 API 或第三方客户端库时使用 Client Components；数据获取统一走 tRPC，查询支持 staleTime、refetchOnWindowFocus 等 React Query 选项；变更操作支持乐观更新与缓存失效（utils.activities.list.invalidate()）；复杂表单使用 React Hook Form + Zod，并可将服务端 zodError 映射到字段错误；受保护页面用 AuthGuard 包裹，未登录重定向 /login；错误处理使用 error.tsx 错误边界；UI 采用 shadcn/ui 组件与 globals.css 语义色令牌。
使用方式：按决策树判断组件类型；客户端查询用 trpc.activities.list.useQuery，变更用 useMutation 并在 onSuccess 中失效缓存；表单用 zodResolver(activitySchema) 与 form.handleSubmit；路由按 app/(marketing)、app/(dashboard)、app/api 组织，组件 PascalCase、工具 camelCase、hooks 以 use 开头、路由段 kebab-case。
依赖：next v15+、react v19+、@tanstack/react-query v5、@trpc/client、@trpc/server、@trpc/react-query、tailwindcss v4、zod；可选 react-hook-form、@hookform/resolvers、sonner。
限制：资料未提供安装命令、价格、平台支持范围与性能数据；测试要求包括用 React Testing Library 测客户端组件、msw-trpc 模拟 tRPC、测试错误边界，具体配置暂未提供。