用途:在按计划实施构建时,持续维护一份 implementation-notes.md,记录所有偏离计划的决定和发现的边界情况。计划无法消除所有未知,有些只有打开代码才会出现;当现实与计划不符时,不要停下,也不要默默即兴发挥,而是选择保守方案、写下来、继续推进。
主要能力:开始时创建 implementation-notes.md,包含三个标题:Deviations(偏离)、Discovered edge cases(发现的边界情况)、Questions for review(待审查问题)。当现实迫使做出计划未覆盖的选择时:选择保守方案(最容易回退的那个),在 Deviations 下记录计划原本怎么说、实际怎么做、原因以及重新审视需要什么,然后继续工作,不要为可逆决定阻塞等待用户。发现边界情况时立即记录,即使处理得很干净也要记,因为它们正是下一次计划应纳入的未知。任何不可逆或改变范围的事项放入 Questions for review,并在安全检查点停止工作。保守偏离可以,代价高昂的偏离需要人工介入。结束时追加五行摘要:偏离数量、最可能被重新审视的一项、发现的边界情况、下一次会话应先读什么,并在交接或 PR 中引用该文件。
限制:笔记文件是临时工作记忆,不是文档,每条保持 2-3 行。绝不能让笔记与现实脱节——未记录的偏离比没有笔记更糟,因为文件声称完整。保守意味着可逆,不一定简单。