日志

为什么保留项目日志

决策、失败样本和变更依据会在持续记录中形成可检索的项目记忆。

保存决策背景

只保留最终代码会丢失约束、候选方案和当时证据。短日志可以说明为何选择某个实现,也能帮助未来版本判断旧限制是否仍然存在。

保存失败样本

失败样本应包含输入、环境、现象和复现步骤。相同问题再次出现时,可以直接比较差异,减少重复排查。

形成项目索引

日志中的项目名、文件路径、版本号和日期可以形成检索入口。它们让零散决定逐渐组成一份可用的项目记忆。