AGENTS.md 作单一真源（CLAUDE.md 薄壳共存）

把一个工程的项目上下文归约成“AGENTS.md 作单一真源（SSOT）、对多个 agent 兼容”——CLAUDE.md 或已有的 AGENTS.md 经两条路径收敛到同一份工具无关的 AGENTS.md，各 agent 各用各的入口加载它 （原生读 AGENTS.md 的 / 经薄壳 CLAUDE.md → @AGENTS.md 的），不必维护两份

设计与原理

核心是让 AGENTS.md 成为单一真源：所有项目上下文只在这里维护一份，CLAUDE.md 退化成引入它的 薄壳（加少量 Claude 专属逃生舱）。AGENTS.md 是跨 agent 的事实标准——原生读它的 agent 都原生识别， 无需额外配置；不原生读 AGENTS.md 的 agent 则经薄壳 CLAUDE.md → @AGENTS.md 引入同一份内容， 且支持递归 @import，故 AGENTS.md 内的 @MEMORY/MEMORY.md 也会被自动展开

L2 记忆层用 @MEMORY/MEMORY.md 收口（R2）：AGENTS.md 单行引入索引 + 顶部强制 Read 指令通吃 展开与否两类 agent——一条通则，不绑定具体 agent、段内不再单挂指引；为什么不把索引内联进正文、 展开行为怎么分类，完整理由见 ref/layering.md"L2 索引收口"一节

记忆跟 repo 走（R6）：跨会话记忆真源是 repo 根 MEMORY/，禁写 agent 私有 memory；迁前无 MEMORY/ 时在 repo 下新建最小 MEMORY/MEMORY.md 索引，不跳过、不省略记忆段（私有路径三个硬伤见 R6）