学习记录格式

学习记录位于 ./learning-records/，使用顺序编号：0001-slug.md、0002-slug.md 等。目录按需创建 — 仅在写入第一条记录时创建。

它们是 ADR 的教学等价物：捕捉非显而易见的教训、关键洞见，以及已声明的先验知识，用于引导后续会话。用于计算最近发展区。

模板

# {Short title of what was learned or established}

{1-3 sentences: what was learned (or what prior knowledge was established), and why it matters for future sessions.}

这就是全部格式。一条学习记录可以只有一个段落。价值在于记录此刻已知，以及为何它改变下一步该教什么 — 不在于填很多章节。

可选章节

仅在有真正价值时加入。大多数记录不需要。

• Status frontmatter（active | superseded by LR-NNNN）— 当较早的理解被证明错误并被替换时有用。
• Evidence — 用户如何展现该理解（回答的问题、完成的练习、引用的先前经验）。当该断言可能被重新审视时有用。
• Implications — 这对后续会话解锁或排除什么。仅在非显而易见时值得记录。

编号

扫描 ./learning-records/ 中现有最大编号，加一。

何时写学习记录

以下任一成立时写一条：

1. 用户展现了对有分量内容的真正理解 — 不仅是接触，而是有证据表明能正确使用该概念。这为下一步教学设定新基线。
2. 用户披露了先验知识 — "I already know X." 记录下来，避免后续重复教。也记录所声称的深度。
3. 纠正了误解 — 用户先前认识有误，现已明白为何。这些价值很高：可预测相关主题的未来绊脚石。
4. 因学习而 mission 发生变化 — 用户发现真正关心的与原先想的不同。交叉链接到 [[MISSION.md]] 并更新它。

什么不算

• 仅被讲过的材料。讲过不等于学会。等证据。
• 已在 [[GLOSSARY.md]] 中作为术语定义简要记录的内容。不要重复。
• 逐会话的活动日志。学习记录不是日记 — 它们是决策级洞见。

取代关系

当后续记录与较早记录矛盾（用户理解加深或纠正）时，将旧记录标为 Status: superseded by LR-NNNN，而不是删除。理解如何演化的历史本身是有用信号。