huhan3000/documentation/planning/ROOT_CLEANUP_PLAN.md

142 lines
5.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 根目录清理计划
## 当前根目录文件清单
### 1. 项目元文档(保留在根目录)
-**README.md** - 主README保留
-**CLAUDE.md** - AI助手指导文档保留
-**GEMINI.md** - AI助手指导文档保留
-**PROJECT_STRUCTURE.md** - 项目结构,保留
-**REORGANIZATION_PLAN.md** - 刚创建的重组计划,保留
### 2. 项目核心文档(需要移动)
#### → 移动到 `documentation/project-overview/`
- **PROJECT_BREAKTHROUGH.md** - 项目突破总结
- **FINAL_DISCOVERY_SUMMARY.md** - 最终发现总结
- **PROJECT_CORE_SYNTHESIS.md** - 项目核心综合
- **wtf.md** - Matrix理论核心发现
- **CRITICAL_REVIEW_OF_THEORY.md** - 理论批判性审查
#### → 移动到 `documentation/rfcs/` (Request for Comments)
- **RFC-001-CN.md** - RFC文档
- **RFC-002-CN.md** - RFC文档
#### → 移动到 `documentation/planning/`
- **胡汉三千年_目录结构规划.md** - 目录规划
### 3. 临时文件(需要清理)
#### → 删除或整合到正式文档
- **temp_di_emperor_connection.md** - 已整合到 `core-theory/di_phonetic_analysis.md`
- **temp_hu_first_usage.md** - 已整合到 `core-theory/hu_character_first_usage_analysis.md`
- **temp_hu_vs_di_analysis.md** - 已整合到相关文档
- **temp_moon_color_jade_connection.md** - 已整合到相关文档
- **temp_moon_worship_ground_level.md** - 已整合到相关文档
- **temp_mythology_accounting_god_perspective.md** - 可以保留或整合
## 执行方案
### 步骤1创建必要的文档目录
```bash
cd /home/ben/code/huhan3000
mkdir -p documentation/project-overview
mkdir -p documentation/rfcs
mkdir -p documentation/planning
mkdir -p archive/temp-files
```
### 步骤2移动项目核心文档
```bash
# 移动到 project-overview
mv PROJECT_BREAKTHROUGH.md documentation/project-overview/
mv FINAL_DISCOVERY_SUMMARY.md documentation/project-overview/
mv PROJECT_CORE_SYNTHESIS.md documentation/project-overview/
mv wtf.md documentation/project-overview/
mv CRITICAL_REVIEW_OF_THEORY.md documentation/project-overview/
# 移动到 rfcs
mv RFC-001-CN.md documentation/rfcs/
mv RFC-002-CN.md documentation/rfcs/
# 移动到 planning
mv 胡汉三千年_目录结构规划.md documentation/planning/
```
### 步骤3处理临时文件
```bash
# 移动到归档
mv temp_*.md archive/temp-files/
# 或者直接删除(如果内容已整合)
# rm temp_*.md
```
### 步骤4创建目录导航文档
#### documentation/project-overview/README.md
```markdown
# 项目概览文档
## 核心发现文档
1. **wtf.md** - Matrix理论K=Y=J=Yade核心发现
2. **PROJECT_CORE_SYNTHESIS.md** - 项目核心理论综合
3. **PROJECT_BREAKTHROUGH.md** - 项目重大突破记录
4. **FINAL_DISCOVERY_SUMMARY.md** - 最终发现总结
5. **CRITICAL_REVIEW_OF_THEORY.md** - 理论批判性审查
## 阅读顺序建议
1. 先读 wtf.md理解Matrix理论
2. 再读 PROJECT_CORE_SYNTHESIS.md理解整体框架
3. 然后读 CRITICAL_REVIEW_OF_THEORY.md理解理论的薄弱环节
```
## 最终根目录结构
```
/home/ben/code/huhan3000/
├── README.md # 主README
├── CLAUDE.md # Claude AI 指导文档
├── GEMINI.md # Gemini AI 指导文档
├── PROJECT_STRUCTURE.md # 项目结构说明
├── REORGANIZATION_PLAN.md # 重组计划(可以后续移走或删除)
├── ROOT_CLEANUP_PLAN.md # 本文档(执行后可删除)
├── core-theory/ # 核心理论(按主题重组)
├── academic-papers/ # 学术论文
├── historical-research/ # 历史研究
├── literary-works/ # 文学作品
├── tools/ # 工具
├── documentation/ # 文档
│ ├── project-overview/ # 项目概览(新增)
│ │ ├── README.md
│ │ ├── wtf.md
│ │ ├── PROJECT_CORE_SYNTHESIS.md
│ │ ├── PROJECT_BREAKTHROUGH.md
│ │ ├── FINAL_DISCOVERY_SUMMARY.md
│ │ └── CRITICAL_REVIEW_OF_THEORY.md
│ ├── rfcs/ # RFC文档新增
│ │ ├── RFC-001-CN.md
│ │ └── RFC-002-CN.md
│ ├── planning/ # 规划文档(新增)
│ │ └── 胡汉三千年_目录结构规划.md
│ └── sphinx-docs/ # Sphinx文档已有
└── archive/ # 归档
└── temp-files/ # 临时文件归档
└── temp_*.md
```
## 清理后的好处
1. **根目录干净**:只保留核心元文档
2. **分类清晰**
- `documentation/project-overview/` - 项目概览和核心发现
- `documentation/rfcs/` - RFC规范文档
- `documentation/planning/` - 规划文档
- `archive/temp-files/` - 临时文件归档
3. **易于导航**每个目录都有README说明
4. **专业性**:符合开源项目的目录规范