骨架演进日志
这份文档记录 world-map 骨架本身的变化历史——L 层增减、group 调整、命名变更、归档决策。
为什么需要:骨架不是预设死的,它会被阅读过程反向塑造。这份日志是骨架演化的"git log",让任何时候都能回答"为什么 L 层现在是 5 个不是 4 个"、"为什么 strategic 这个 group 叫这个名字"。
日志格式
每条变更一条记录,倒序排列(最新在上):
### YYYY-MM-DD — 变更简述
**类型**: 新增 L 层 | 合并 L 层 | 拆分 L 层 | 新增 group | 改 group 名 | 归档文档 | 提议(未实施)
**背景**: 是什么触发了这次变更(哪本书、哪篇文章、哪个错误)
**决策**: 具体做了什么
**影响**: 影响了哪些 sidebar / 文档 / 链接
**回退方案**: 怎么回退这次变更(如需要)骨架变更记录
2026-06-22 — 初始化 5 层骨架
类型: 新增 L 层(首次)
背景: 项目创建。book/ 目录下两本书——IDDD(Vaughn Vernon)+ 工程控制论(钱学森、宋健)。需要一套能同时承载"软件方法论"和"系统论"的骨架。
决策:
- 采用控制论五层作为顶层骨架(辨识→设计→实现→验证→适应)
- 每层 6–7 个 group:概览 + 4 个主题 group + 应用案例 + 源典精读
- 顶部 nav 只放首页 + 5 个 L 层(不接受路由层污染)
- DDD 战略/战术映射到 L1,集成/架构映射到 L2,应用/部署映射到 L3
- 元文档(meta/)单独分区,不进 L 层
影响:
- 创建 5 个顶层目录
l1-modeling/到l5-evolution/ - 103 个 .md 占位文件,全部 status=stub
- 顶部 nav 6 项
- 首页加 AI 协作约定 + 元规则分区链接
回退方案: git revert
2026-06-22 — 创建 meta/ 元文档分区
类型: 新增顶层分区
背景: AI 协作约定("wiki 本身是 AI 的操作手册")需要单独载体,不能塞进 L 层。
决策: 新增 meta/ 顶层目录,含 4 份元文档:
meta/ai-collaboration/— AI 协作规则meta/conventions/— 文档撰写约定meta/evolution-log/— 本文档meta/git-workflow/— git 流程规范
影响:
- meta/ 不进顶部 nav(它不是知识体系的认知层)
- 在首页和每个 L 层 01-overview/index.md 末尾的"相关链接"指向 meta/
回退方案: 直接删目录,无外部依赖
待办 / 提议(未实施)
这里记录已识别但还没动手的骨架改造需求。每条标明触发原因 + 建议方案。
2026-06-22 — 新增 meta/source/cybernetics/ 源典精读目录
类型: 新增子目录(提议——等用户确认后实施)
背景: 开始精读《工程控制论》。Ch 1(引论)建立了整个控制论的世界观——五层闭环(辨识→设计→实现→验证→适应)的思想根源。它不属于任何单一 L 层,而是 L1–L5 共同的理论根。
冲突: 现有骨架把"源典精读"放在各 L 层的 07-source/ 下(l1-modeling/07-source/cybernetics.md 是占位单文件),意味着每章精读必须挂到某个 L 层下。
建议方案:
- 新增
meta/source/cybernetics/顶层子目录(与meta/ai-collaboration/等并列) - 路径:
meta/source/cybernetics/ch01-introduction.md/ch02-analysis.md/ ... - 理由:Ch 1 是世界观级,跨所有 L 层,不应被任何 L 层"拥有"
- 各 L 层
07-source/cybernetics.md改为索引页,反向链接到meta/source/cybernetics/对应章节
回退方案: 沿用旧路径 l1-modeling/07-source/cybernetics/chXX.md,把 Ch 1 挂在 L1 下;缺点是后续 Ch 4 涉及稳定性分析可能需要挂 L2,造成归属混乱。
状态: 已实施(commit 6754fc4 feat(meta-source): 接受提议)
2026-06-22 — Phase 1 Ch 8 实际定位修正
类型: 路径澄清(不是新提议,是发现原计划不准确)
背景: 原计划"Ch 8 最优控制(变分法)"。开始精读时发现:
- Ch 8 实际是"最速控制系统设计"——bang-bang 控制 + 开关曲线
- Ch 9 才是"满足指定积分指标的控制系统设计"——泛指最优控制
- Ch 10 是"最优控制(离散/最速)"——补充
影响: Ch 8 草稿以"最速控制(bang-bang + 开关曲线)"为题,而非"最优控制(变分法)"。
调整: 草稿中保留对"变分法/极大值原理"的概念性提及(在"它属于什么"一节),主体写最速控制。Ch 9 可作为 Phase 2 选读。