codestable cs-keep
把这次学到的东西沉淀成下次能被检索到的项目记忆。落点由你判断，不追问用户分类。
开工与授权
- 有
.codestable/attention.md就先读；写前检索.codestable/lessons/与 v1 只读.codestable/compound/，核实证据、scope、重复项与已有 canonical owner。 - 用户明确要求“记住 / 更新 / 退役”、接受普通 owning task 给出的晶化候选，或在 Epic 最终毕业 gate 批准候选，就是本次精确内容的写入授权，不追问分类。新建、改写规则/scope、晋升、删除或 跨项目分享仍需用户显式授权，不能从历史操作或“这可能有用”推断。
- 没有可追溯证据不写；不编造，不从模型记忆、命中次数或自评置信度泛化。
落点判断
按单一 owner 和以下顺序路由：
- 机械 guard 优先：能由测试、checker、lint、类型或 deterministic helper 阻止的重复错误， 在 owning task 已有实现授权且不扩大 scope 时直接机械化，不另写重复 lesson；否则只建议进入 对应 owning task，不把记忆写入授权扩成代码修改授权。
- 高频必读事实进入
attention.md：全文保持 ≤25 条，保留存量分节；超限先合并再新增。 - 结构性决定进入 ADR：必须同时满足难回退、缺少上下文会令人意外、源于真实取舍；沿用项目 惯例位置，不用 lesson 复制决定。
- 其他稳定方法进入项目既有文档；目标不存在时请 owner 选择，不发明目录。
- 其余尚未被更强 owner 承接的可复用经验，进入
.codestable/lessons/YYYY-MM-DD-{slug}.md，作为可纠偏、可删除的 staging。
.codestable/、attention.md 或 lessons/ 不存在时可按需创建，不要求先跑 cs-onboard。临时状态、
本周计划或 git 已完整表达的事实不沉淀。codestable-eval 只标记未来上游候选；本轮不导出、不上传、
不改 skill，也不恢复 cs-feedback。
lesson 格式
一条一文件，slug 用小写连字符、≤30 字符：
---
status: observed
scope: 模块 / 命令 / 场景关键词
date: YYYY-MM-DD
---
规则：未来可执行的结论。
适用 / 不适用：边界与停止应用信号。
证据：最多三个代表性路径、测试、diff 或任务指针。
候选归宿：test | checker | attention | project-doc | adr | codestable-eval
生命周期
| status | 判据 |
|---|---|
observed |
单次任务已有证据，尚未在独立后续任务验证 |
validated |
非创建该 lesson 的任务和 agent invocation 中有效命中，真实改善行为并验证成功；具体表现为改变计划或验证，或明确排除一个具体且合理的错误路径 |
retired |
被仓库事实反证、scope 完全失效或已有更强 canonical owner；不得应用且不再复活原结论 |
- 新 lesson 一律从
observed开始；不能把创建该 lesson 的同一任务自证为 validated，也不因命中 次数或模型自评晋级。 - 旧 lesson 缺
status按observed读取，不批量迁移；只在真实状态变化或本来就要更新时补字段。 observed -> validated只在独立后续任务确实采用并验证成功时发生，并只补一次代表性证据；必须记录 lesson 实际改变的计划或验证，或明确排除的具体且合理错误路径，以及本次通过的验收证据。observed|validated -> retired只写反证/替代原因与指针。retired 条目上的新结论必须另建 observed lesson，不继承旧条目的 validated 身份。- 稳定 validated 命中不产生文件 churn。不得保存原始对话、逐次命中日志或无限 evidence history。
写入纪律（硬门槛）
- 命中同域 lesson 时查重、合并到原条目，不新增重复；继续维持约 50 条预算，达到预算先整理、 晋升、合并或删除，不简单扩容。
.codestable/compound/是只读历史知识源：命中且结论完整时只引用来源、不新建；有增量时只合并进现有 lesson 或新建 lesson，并引用旧 compound 来源，绝不更新 compound。- 晋升前先验证新 owner 已写入且能承接完整事实，再在同一更新中删除重复 lesson；若 task skill
只发现已有 owner，则先标 retired，删除留待显式
cs-keep整理。 - 一次只写用户拍板过的内容，不顺手多写。
检索约定
日后找回：grep -ri "关键词" .codestable/lessons/ .codestable/compound/。应用前以当前代码、测试或
canonical 文档核实；retired 不应用，compound/ 命中仍按只读规则处理。
完成
报告写入、更新或删除的文件路径与一句话摘要即可，不设写后确认。