用途：为现代 React 前端开发提供系统化规范，适用于新建组件与页面、开发新功能、使用 TanStack Query 获取数据、配置 TanStack Router 路由、使用 MUI v7 样式、性能优化、组织前端代码及 TypeScript 最佳实践。
主要能力：以 Suspense 为核心的数据获取（useSuspenseQuery）、组件懒加载、文件与目录组织约定、样式与路由规范、加载与错误状态处理、性能优化及 TypeScript 编码标准。
使用方式：遵循新组件清单，如使用 React.FC<Props>、重型组件用 React.lazy(() => import()) 懒加载、用 SuspenseLoader 包裹、数据用 useSuspenseQuery、导入别名 @/、~types、~components、~features；新功能则创建 features/{feature-name}/ 及 api/、components/、hooks/、helpers/、types/ 子目录，并在 routes/ 下建立路由、导出公共 API。
核心原则：重型一律懒加载；加载状态用 Suspense 而非提前 return；新代码数据获取以 useSuspenseQuery 为主；功能模块化组织；样式按行数内联或拆分；避免提前 return 以防布局偏移；通知统一用 useMuiSnackbar。
适用场景：React 18 + TypeScript + MUI v7 + TanStack Router/Query 项目；其他技术栈可参考其原则（仓库根目录 CLAUDE_INTEGRATION_GUIDE.md）。
限制：未提供具体版本兼容范围、性能指标或授权信息；示例代码较丰富，建议按需查阅对应资源文档。