# CLAUDE.md

## MVP 实现阶段指南

在 MVP 实现阶段，解决问题时请遵循以下阅读优先级：

### 1. 优先阅读文档

1. **MVP 方案文档** (`docs/mvp-skeleton-plan.md`)
   - 项目骨架结构、模块划分、接口定义
   - 技术实现要点和代码规范

2. **原型文档** (`docs/ref/xinfra-prototype.v3.html`)
   - 完整的页面交互流程和 UI 规范
   - 组件行为、状态管理、API 调用时机
   - 异常处理和用户体验细节

### 2. 理解优先级

- **先读文档，再看代码**：理解设计意图后再动手实现
- **原型优先**：当实现细节与原型冲突时，以原型为准
- **MVP 文档优先**：当架构决策有疑问时，以 MVP 文档为准

### 3. 实现原则

- 严格遵循 MVP 文档中定义的目录结构和模块划分
- 参考原型文档中的交互流程和状态管理
- 保持代码简洁，聚焦 MVP 核心功能
- 遵循项目既定的技术栈和编码规范