规范

项目记忆应该跟着项目走,而不是锁在某个 AI 工具里。

Mainline 把关键工程记忆存在 Git refs 和 notes 里。换 agent、换机器、换工具,都还能读到这份历史。

Actor logs

refs/heads/_mainline/actor/<id>

每个开发者或 agent 都写自己的追加日志,互不抢写。

Pin notes

refs/notes/mainline/intents

代码合进 main 后,用 Git notes 把 commit 和当时的 intent 关联起来。

Lifecycle

一次想法,最后变成可继承的项目记忆

draftingsealed localproposedmergedreverted

被放弃、被取代、被回滚的记录也很重要。它们告诉未来的 agent:这条路以前走过,别再重来。

指纹

seal 时记录涉及哪些文件、模块、行为变化和标签,用来快速发现重叠工作。

冲突检查

先用轻量规则筛一遍;真有语义冲突时,再让 agent 做更细判断。

Hub

给人看的界面:最近的 intent、文件约束、风险、决策和缺口。

配置

每个 repo 可以配置主分支、日志前缀、跳过规则、同步频率和检查阈值。