diff --git a/frontend/README.md b/frontend/README.md
index ff5e77dd..ed121780 100644
--- a/frontend/README.md
+++ b/frontend/README.md
@@ -1 +1,122 @@
-TODO: something here
+# Coze Studio Frontend
+
+This is the frontend project of Coze Studio, an AI Agent development platform built with monorepo architecture, based on React 18 and modern frontend technology stack.
+
+## 🏗️ Project Architecture
+
+### Core Technology Stack
+- **Framework**: React 18 + TypeScript
+- **Build Tool**: Rsbuild
+- **Package Manager**: Rush + PNPM
+- **Routing**: React Router v6
+- **State Management**: Zustand
+- **UI Components**: @coze-arch/coze-design
+- **Internationalization**: @coze-arch/i18n
+
+### Directory Structure
+
+```
+frontend/
+├── apps/                    # Application layer
+│   └── coze-studio/        # Main application
+├── packages/               # Core packages
+│   ├── agent-ide/         # AI Agent development environment
+│   ├── arch/              # Architecture infrastructure
+│   ├── common/            # Common components and utilities
+│   ├── components/        # UI component library
+│   ├── data/              # Data layer
+│   ├── devops/            # DevOps tools
+│   ├── foundation/        # Foundation infrastructure
+│   ├── project-ide/       # Project development environment
+│   ├── studio/            # Studio core features
+│   └── workflow/          # Workflow engine
+├── config/                # Configuration files
+│   ├── eslint-config/     # ESLint configuration
+│   ├── rsbuild-config/    # Rsbuild build configuration
+│   ├── ts-config/         # TypeScript configuration
+│   ├── postcss-config/    # PostCSS configuration
+│   ├── stylelint-config/  # Stylelint configuration
+│   ├── tailwind-config/   # Tailwind CSS configuration
+│   └── vitest-config/     # Vitest testing configuration
+└── infra/                 # Infrastructure tools
+    ├── idl/              # Interface Definition Language tools
+    ├── plugins/          # Build plugins
+    └── utils/            # Utility libraries
+```
+
+## 🚀 Quick Start
+
+### Prerequisites
+- Node.js >= 21
+- PNPM 8.15.8
+- Rush 5.147.1
+
+### Install Dependencies
+```bash
+# Run in project root directory
+rush install
+# update
+rush update
+```
+
+### Development Mode
+```bash
+# Start development server
+cd apps/coze-studio
+npm run dev
+# or use rushx
+rushx dev
+```
+
+### Production Build
+```bash
+# Build application
+cd apps/coze-studio
+npm run build
+# or use rushx
+rushx build
+```
+
+## 📦 Core Modules
+
+### Agent IDE
+- **agent-ide**: AI Agent integrated development environment
+- **prompt**: Prompt editor
+- **tool**: Tool configuration management
+- **workflow**: Workflow integration
+
+### Architecture Layer (arch)
+- **bot-api**: API interface layer
+- **bot-hooks**: React Hooks library
+- **foundation-sdk**: Foundation SDK
+- **i18n**: Internationalization support
+- **bot-flags**: Feature flags management
+- **web-context**: Web context utilities
+
+### Workflow Engine (workflow)
+- **fabric-canvas**: Canvas rendering engine
+- **nodes**: Node component library
+- **sdk**: Workflow SDK
+- **playground**: Debug runtime environment
+
+### Data Layer (data)
+- **knowledge**: Knowledge base management
+- **memory**: Memory system
+- **common**: Common data processing
+
+## 🔧 Development Standards
+
+### Code Quality
+- Code formatting with ESLint + Prettier
+- TypeScript strict mode
+- Unit test coverage requirements
+- Team-based tier management (level-1 to level-4)
+
+### Team Collaboration
+- Rush-based monorepo management
+- Workspace dependency management
+- Unified build and release process
+
+## 📄 License
+
+Apache License 2.0
\ No newline at end of file
diff --git a/frontend/rushx-config.json b/frontend/rushx-config.json
index c0f11e8d..ccc73afb 100644
--- a/frontend/rushx-config.json
+++ b/frontend/rushx-config.json
@@ -1,26 +1,15 @@
-// 所有声明在 rush.json 中的包，需要在 tags 配置中，添加团队和分级描述。描述的枚举如下
 {
   "$schema": "./rushx-config.schema.json",
-  // 团队情况，可以自行添加
   "team": [
-    // 负责人：@xukai.luics
     "team-automation",
-    // 负责人：@changyang.liu
     "team-builder",
-    // 负责人：@linyibin
     "team-community",
-    // 负责人：@sunshengda
     "team-data",
-    // 负责人：@xuyuantong, @dingquan
     "team-devops",
-    // 负责人：@fanwenjie.fe
     "team-arch",
-    // 负责人：@sunkuo
     "team-studio",
     "team-qa"
   ],
-  // 全部分级包
-  // delete 将被删除包，暂不做分级
   "level": ["level-1", "level-2", "level-3", "level-4"],
   "codecov": {
     "coverage": 20,
@@ -33,7 +22,6 @@
       "coverage": 30,
       "incrementCoverage": 60
     },
-    // 后续逐步提升这个 level 的增量覆盖率
     "level-3": {
       "coverage": 0,
       "incrementCoverage": 0