五人平台组的三层项目记忆：Claude Code 复现对账实录
01 · 单文件记忆对分层记忆：五人平台组的两套起点
五人平台组每天在多个仓库里启动 Claude Code，任务批量且持续，预算按真实 token 结算。团队内部只争一个问题：项目记忆写在哪里。一条路线把全部约束压进根目录的 CLAUDE.md，要求越短越好，改一处全局生效；另一条路线把记忆拆成三层——仓库根部的全局约定、模块级记忆文件、任务级运行记录，按需加载。前者上手快、改动集中，后者在跨仓库一致性、复现率和缓存成本上更有优势。下面几轮对照使用同一批存量代码库和同一批任务单，只改变记忆文件的组织方式，其余条件保持一致。
可复现在这支团队里有明确含义：同一份任务单、同一个仓库状态、同一组约束，换一位成员、换一天执行，得到的修改范围与结论摘要应当可以互相印证；一旦出现偏差，必须能指认到具体哪一条记忆出了问题。四轮对照依次看复现、账单、回滚和模型分工。
02 · 同一条提示词跑三轮：偏差从哪一条记忆开始
对照组用单文件方案，把命令、目录约定、禁止事项和历史结论混排在一起，长度很快超过任务真正需要的范围，模型在长上下文里容易把过期条目当成现行规则。实验组把内容切成四类条目并标注生效范围：必须遵守的硬约束、推荐的实现路径、已知的坑、上一次运行的结论摘要。会话开始时只加载与当前任务相关的条目，运行结束后把实际结论回写并注明日期。
差异集中在三处：
- › 提示词一致性：新成员照着分层记忆执行，得到的修改范围与老成员接近，评审往返减少。
- › 偏差可定位：两次运行结果不一致时，可以直接指认是哪一条记忆缺失、过期或被误解。
- › 上下文占用：短而准的条目把上下文预算留给真正的代码阅读，而不是反复自我描述。
03 · cache write 与 cache read：长会话账单的分野
持续跑长任务的团队都清楚，成本不只来自输出 token。Quanta 是按量计费的 API 中转服务，按真实 token 计量，cache write 与 cache read 分开计价，这让记忆文件的排版本身成为成本变量。单文件方案每次会话开头都要重写一大段稳定内容，cache write 偏高；分层方案把长期不变的全局约定放在最前并保持顺序固定，命中缓存后大部分读取转为 cache read，长会话的单位成本随之下降。
三条纪律可以直接落地：稳定内容前置、变动内容后置、运行中途不改写前置段落。团队按项目设预算上限，在任务级记录里写明当前模型与预估调用规模，接近上限时先收敛记忆文件的长度，而不是先砍任务范围。
模型分工同样影响账单结构。规划与架构级重构交给 Claude Opus 5.5，批量的格式化、迁移与文档整理交给 Claude Haiku 4.5，轻量执行不必占用旗舰模型的推理预算。Quanta 用一个余额覆盖多款模型，切换不必更换供应商，计费口径统一，便于把成本拆到项目一级；推荐他人充值，还能拿到对方充值额 19% 的返点。
04 · 记忆文件进不进版本库：回滚与审计的两条路线
第二处对峙是存放位置。一条路线放在团队共享文档里，编辑自由、随时可改；另一条随代码进版本库，跟分支走，改记忆要过评审。共享文档的软肋在回滚：一次错误的规则更新会同时污染多个仓库的运行，而且难以还原到某个时间点。随代码走的记忆可以按分支隔离，合并时的冲突会强制团队讨论每一次规则变更。
- › 回滚：版本库路线可以精确回到某次提交，共享文档只能凭人工记忆修补。
- › 审计：规则的增删、生效日期和责任人留在提交记录里，复盘时不必重建时间线。
- › 隔离：实验性规则只挂在实验分支上，不污染主线的运行契约。
05 · 落地清单：把记忆文件写成可审计的运行契约
把两套方案的优劣合并，团队最后留下一份可执行清单：
- › 分层：全局约定、模块记忆、任务记录三层分开，总量控制在一次会话能完整读完的范围。
- › 标注：每条记忆写明触发条件、适用仓库和最后更新日期，过期就删，不留废条目。
- › 回写：每次运行结束把结论摘要写回任务级记录，下一轮以它为起点，而不是从零推断。
- › 分工：把模型分配写进记忆本身，复杂推理走 Claude Opus 5.5，批量执行走 Claude Haiku 4.5。
这套组织方式的价值在于，记忆文件不再是提示词的堆叠，而是团队与模型之间的运行契约：谁都能读懂规则从哪来、何时生效、上一轮跑出了什么。对按量结算、持续跑批量任务的团队，Quanta 提供一个余额覆盖多款模型的入口，配合按真实 token 计量、cache write 与 cache read 分开计价的口径，预算可以拆到项目一级；欢迎在 Quanta 开一个账户，把你的记忆文件方案直接跑在下一轮批量任务上。