diff --git a/README.md b/README.md
new file mode 100644
index 0000000..bc61206
--- /dev/null
+++ b/README.md
@@ -0,0 +1,101 @@
+# RN Empty Client — AI-Ready React Native Project Skeleton
+
+一个**零业务、纯工程骨架**的 React Native 初始化规范文档。把这份文档喂给 AI（Claude、Cursor、Copilot、Codex 等），它能直接生成一个结构清晰、分层合理、开箱即用的 RN 新项目。
+
+## 解决了什么问题？
+
+每次起一个 React Native 新项目，你大概率会从旧项目复制代码，然后删业务逻辑。删不干净 → 带着旧项目的品牌色、API 地址、SDK 配置上线 → 后续越滚越脏。
+
+这个仓库提供了一份**结构化规范文档**，AI 读完就能帮你生成：
+
+- 模块化 MVVM 架构（View → ViewModel → Service → Model）
+- React Navigation 导航骨架（只有 Root + NotFound 两个壳页面）
+- 空 API Client、StorageService、主题 token 等基础设施
+- TypeScript 严格模式 + ESLint + Prettier + Jest
+- 基础通用组件（Button、TextField、EmptyState）
+- 完整的目录结构和模块边界规则
+
+**没有任何业务代码、业务命名、真实 API 地址、第三方业务 SDK。**
+
+## 快速开始
+
+把 [`RN_EMPTY_CLIENT_INIT_GUIDE.md`](./RN_EMPTY_CLIENT_INIT_GUIDE.md) 的内容作为提示词，发给 AI 编程助手即可。文档末尾有一段精简版初始化指令，可以直接复制使用。
+
+示例（Claude Code / Cursor / Copilot Chat）：
+
+```text
+请初始化一个 React Native + TypeScript 项目骨架，只保留工程架构，不包含任何业务。
+
+要求：
+1. 使用模块化 MVVM 架构。
+2. 创建 App.tsx、src/app、src/navigation、src/modules/app-shell、
+   src/components、src/services、src/models、src/theme、src/utils、
+   src/hooks、src/contexts。
+3. 导航只注册 Root 和 NotFound 两个无业务页面。
+4. services 只提供空 ApiClient、StorageService、config 类型。
+5. components 只提供无业务基础组件。
+6. theme 只提供中性设计 token。
+7. 不要创建任何业务模块。
+8. TypeScript 开启 strict，并配置 src 路径别名。
+```
+
+## 生成的目录结构
+
+```text
+.
+├── App.tsx
+├── index.js
+├── app.json
+├── babel.config.js
+├── metro.config.js
+├── tsconfig.json
+├── package.json
+├── __tests__/
+├── docs/
+│   ├── ARCHITECTURE.md
+│   ├── CODE_RULES.md
+│   └── MODULE_RULES.md
+└── src/
+    ├── app/           # AppProviders + AppBootstrap
+    ├── assets/        # 占位资源规范
+    ├── components/    # 无业务通用 UI 组件
+    ├── contexts/      # 全局 Context
+    ├── hooks/         # 公共 Hooks
+    ├── models/        # 跨模块共享类型
+    ├── modules/       # 功能模块（初始仅 app-shell）
+    ├── navigation/    # React Navigation 路由
+    ├── services/      # ApiClient / Storage / Config
+    ├── theme/         # 颜色、间距、字体 token
+    └── utils/         # 工具函数
+```
+
+## 架构原则
+
+| 原则 | 说明 |
+|------|------|
+| 依赖方向 | View → ViewModel → Service → Model（单向） |
+| 模块隔离 | 模块内部实现不暴露，通过 `index.ts` 对外 |
+| 全局≠业务 | 全局目录只放跨模块能力，业务内容留在模块内 |
+| 空项目零业务 | 没有登录、首页、订单、支付、视频等任何业务概念 |
+| 依赖最小化 | 初始依赖只有 RN 核心 + Navigation，不预装 Firebase/支付/分析 |
+
+## 适用场景
+
+- 用 AI 工具起新 RN 项目，想要一个干净、规范的起点
+- 团队统一项目骨架，避免每次从旧项目复制
+- 教学 / 团队新人了解模块化 RN 架构
+- 作为项目模板规范，配合脚本自动生成
+
+## 配合 AI 工具使用
+
+此文档针对 AI 编程助手优化：
+
+- **Claude Code** (`/init` 或直接粘贴)
+- **Cursor** (Composer / Chat)
+- **GitHub Copilot** (Chat / Workspace)
+- **OpenAI Codex CLI**
+- **Windsurf / Cody / 其他 AI IDE**
+
+## License
+
+MIT