垒石 Cairn

要解决什么问题

在 agent 协作型仓库里，常见做法是 JSONL 注入、.current-task 指针或全自动流水线——作者从约 148 个任务的实践里总结：需要纪律喂养的状态机往往先烂；能长期用的是「目录约定 + 纯 Markdown + 按需 grep」，而不是把 22KB 索引塞进每个会话。

cairn（垒石）把项目知识拆成六类：任务留痕、跨会话进度、SOP、架构/选型决策、坑账与详细规约、对外文档。核心隐喻是山路石标：索引行不指挥你怎么做，只告诉后来者「有人走过、结论是什么」。

怎么工作

日常三条命令覆盖主路径：用 mktmp.sh 起任务（自动在 tasks/INDEX.md 顶部幂等垒一行 🚧 占位，避免静默丢任务）；用 grep 查 INDEX.md 看历史是否做过；用行首 🚧/⏸ 看全局在途。临时脚本、SQL、截图一律进 tasks/MM-DD-*/scratch/，根目录写入由 hook 拦截，实现脏净分离。

收尾有写入门禁：「以后的任务会因为这一行做得更好吗？」——否则删掉占位行即可；否则把占位改写成带 [关键词] 的可检索结论，并做三问自检（是否抽 SOP、是否记决策、索引行 [用N]/[失效] 反馈）。长任务用 progress.md 记「下一步/卡点」，跨会话续做不必翻聊天记录。族内用 seek.sh 做 OR 检索与在途影响检查；doctor.sh/panel.sh 负责陈旧标记、容量顶（INDEX ≤200 行）与回顾候选。

边界与注意

个人层（tasks/、INDEX、pitfalls）默认不进 git；共享前须 doctor.sh --strict 与人工确认。禁止全量重写 INDEX（只允许 append 或改自己那行）；合并精简只在回顾仪式里做人审。多项目时向上找最近的 .cairn/，同一会话跨仓写入前先声明目标项目——石标垒错仓比没垒更糟。