docs: consolidate docs into linear readmes

2026-08-19 05:48:04 +00:00 · 2026-05-03 20:25:27 +08:00
parent c748e2a337
commit 53f050f341
32 changed files with 9187 additions and 8096 deletions
@@ -14,23 +14,16 @@

 ```text
 concepts/
-├── README.md          # 核心概念索引
-├── AGENTS.md          # 本目录操作规则
-├── 拼好码.md          # 复用优先与胶水原则
-├── 问题求解.md        # 问题定义与求解框架
-├── 系统构建方法.md    # 自顶向下、自底向上、分而治之
-├── 开发范式演进.md    # 软件开发范式演进
-├── 语言层要素.md      # 代码理解所需语言层要素
-└── 递归自优化系统.md  # 递归自优化生成系统形式化
+├── README.md  # 线性总文档：问题求解、拼好码、系统构建、开发范式、语言层要素、递归自优化系统
+└── AGENTS.md  # 本目录操作规则
 ```

 ## 修改规则

- 新增概念文档时，必须同步更新 `README.md`。
- 重命名文件时，必须同步更新全仓链接和 `metadata/redirects.yml`。
+- 新增概念内容时，必须追加到 `README.md` 的对应章节。
+- 不再新增同级主题 `.md` 文件；如确需拆分，必须同步更新全仓链接和 `metadata/redirects.yml`。
 - 概念文档应优先使用稳定术语，避免同一概念多种叫法并存。
- 不把一次性操作步骤放入本目录；操作型内容应放入 `docs/getting-started/`
-  或 `docs/references/`。
+- 不把一次性操作步骤放入本目录；操作型内容应放入 `docs/getting-started/` 或 `docs/references/`。

 ## 质量要求