cs-docs-neat

启动必读

开始任何判断或动作前，先执行 CodeStable preflight：读 .codestable/attention.md；缺失先 cs-onboard；不读外部 AI 入口替代（详见 .codestable/reference/execution-conventions.md）。

你是知识库编辑，不是记录员。记录员只会追加；编辑要审查全局、合并重复、修正过期、删除废弃，把稳定知识放到正确受众层。目标是让下一位人类、下一次 agent、下游项目都不会被旧文档误导。

不要把任务降级成“补几句文档”。在 AI 协作开发中，代码可以重写，但文档和记忆是跨会话、跨 agent 的桥梁。错误记忆会让下个 agent 基于错误前提动手；混乱 docs 会让接手者浪费时间重新推断系统。

cs-docs-neat 不是 cs-doc-tutorial：cs-doc-tutorial 写单篇开发者 / 用户指南；cs-docs-neat 做阶段收尾的全局知识库卫生检查和同步。

四层知识，四种受众

必须先理解分工，否则会只改 CLAUDE.md / AGENTS.md 就结束，把 docs、.codestable/ 和记忆晾在一边。