// 01 > CONTEXT
Coherence 以 Claude Code 钩子和斜杠命令的形式运行。它监视代码在文档未同步的情况下发生变化，并提出补丁，所有可在团队中分发的部分都以提交的文件形式存在，永远没有后端。
// 02 > THE_PROBLEM
文档会悄无声息地漂移：代码变了，描述它的文档却没变，而这道鸿沟只有在有人被它误导时才被发现。
天真地让 LLM 去修文档并不安全：它会产生幻觉、改写过多，还会被注入的文本带偏。此前没有可信赖的方式让智能体在无人监督下触碰文档。
之前
文档无声漂移 · 盲目的 LLM 编辑有风险 · 无法安全自动应用
// 03 > APPROACH
我把工作拆成一条两段式流水线，在模型与文件系统之间加入确定性校验，并把自动应用门控在按开发者维护的信任账本之后。
两段式流水线
第一阶段选定权威来源；第二阶段写出补丁，必须通过格式、应用、变更类别、行比例、注入、幻觉与断言等检查。
渐进式信任门
仅在信任分超过 0.85 时自动应用，该分数以 30 天半衰期衰减，且绝不应用于破坏性或 frontmatter 变更。
TypeScriptClaude CodeLLMSigstore cosignGitHub Actions
// 04 > THE_RESULT
智能体可以安全地让文档保持同步，在模型与你的仓库之间有八个校验引擎和经 cosign 签名的发布版本把守。
之前
- 漂移由人发现，且为时已晚
- 盲目的 LLM 编辑，没有护栏
- 没有可验证的发布版本
之后
- 自动检测漂移
- 8 引擎确定性校验
- 无密钥 cosign 签名、Rekor 可验证
“我不会仅凭信任就让模型写入仓库。每个补丁在落地之前都必须挺过确定性检查。”