.knowledge/ 目录
文件 内容 写入时机 读取时机
patterns.md 成功的解决模式 V 阶段 R₀b 阶段
pitfalls.md 踩过的坑和规避方法 V 阶段 / 出错时 R₀b/R 阶段
decisions.md 架构决策记录 (ADR) D 阶段 R 阶段
tools.md 工具使用经验和配置 任何时候 R 阶段
写入格式
[日期] [标题]
场景: 什么情况下遇到的 方案: 怎么解决的 效果: 结果如何
规则
-
V 阶段结束前, 至少更新一个 .knowledge/ 文件
-
出错重试超过 2 次, 立即写入 pitfalls.md
-
ADR 记录不可删除, 只追加