huhan3000/documentation/planning/ROOT_CLEANUP_PLAN.md

5.0 KiB
Raw Blame History

根目录清理计划

当前根目录文件清单

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创建必要的文档目录

cd /home/ben/code/huhan3000
mkdir -p documentation/project-overview
mkdir -p documentation/rfcs
mkdir -p documentation/planning
mkdir -p archive/temp-files

步骤2移动项目核心文档

# 移动到 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处理临时文件

# 移动到归档
mv temp_*.md archive/temp-files/

# 或者直接删除(如果内容已整合)
# rm temp_*.md

步骤4创建目录导航文档

documentation/project-overview/README.md

# 项目概览文档

## 核心发现文档
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. 专业性:符合开源项目的目录规范