我开源了递归漂移背后的上下文引擎
问题在复利
Claude Code 每次会话从零记忆开始。对于单个终端，这很烦人。对于每天并行运行的4-6个终端，这会搞坏事情。
我按顺序遇到了五种故障模式。
重启时零上下文。 周一早上打开终端。花10分钟重新解释你周五构建的东西。乘以每次会话，每天。
跨终端竞争条件。 两个终端同时完成。两个都写入 context-handoff.md。最后一个覆盖。整个会话的上下文消失。
记忆截断。 MEMORY.md 几周内增长到400行。Claude 只加载前200行。你一半的项目知识默默消失。你不会注意到，直到 Claude 做出你三周前已经纠正过的决定。
有损智能体交接。 生成一个子智能体做调研。它做出架构决策。报告回来一个摘要。父智能体不知道决定了什么。下一个智能体重新争论同样的选择。
团队中的决策漂移。 三个智能体并行工作。一个选 snake_case。一个选 camelCase。一个随心情。没人记录决定。合并一团糟。
每种故障模式都在我解决了上一个之后出现。每一个都需要自己的解决方案。
6个层次
context-handoff-engine 是6层上下文基础设施。每层解决一种故障模式。按需使用。
第6层：路由 ─────────── 哪种执行模式适合这个任务？
第5层：团队 ─────────── 并行智能体如何协调？
第4层：智能体交接 ───── 上下文如何在智能体之间传递？
第3层：自我改进 ──────── 错误如何变成规则？
第2层：记忆 ──────────── 知识如何跨会话持久化？
第1层：交接 ──────────── 会话状态如何传递？
第1层：并行安全的交接
竞争条件的修复很简单。停止使用单个文件。每次会话写入 ~/.claude/handoffs/YYYY-MM-DD_HHMMSS_<slug>.md。带时间戳。不会覆盖。
会话开始时，Claude 读取所有未消费的交接文件，打印摘要，然后用 _done 后缀重命名。超过7天的已消费交接自动清理。
四个操作。写入、读取、消费、清理。这就是整个系统。
第2层：结构化记忆
200行截断问题需要重构 Claude 存储持久知识的方式。
MEMORY.md 变成索引文件 - 保持在200行以内，链接到主题文件。主题文件（identity.md、infrastructure.md、completed-work.md）保存细节，在相关时按需加载。
索引始终加载。细节在需要时加载。没有东西被截断。
第3层：自我改进循环
用户每次纠正后，Claude 将教训写入 tasks/lessons.md。日期、上下文和一条规则。会话开始时，Claude 读取所有教训并遵循它们。
循环：纠正、教训、规则、预防。
随着时间推移，规则积累。第1周发生的错误在第8周不会发生，因为规则存在。简单的机制，复利的效果。
第4层：智能体间上下文
会话交接假设对项目的熟悉。智能体交接什么都不假设。
向不同的智能体传递上下文时，生成一个独立文档，包含6个部分：上下文、成果、关键文件、待解决问题、下一步、工作流钩子。接收方智能体无需之前的对话就能立即理解。
最大的价值不是摘要 - 而是保留决策。"我们选择基于游标的分页因为X"防止下一个智能体花20分钟得出同样的结论。
第5层：团队协调
9条规则防止多个智能体同时工作时的混乱。文件所有权（每波每文件一个写入者）。共享决策日志。写前先读。带验证门的波次纪律。部署前构建门。范围隔离。每个执行者刷新上下文。
这些规则听起来很明显。它们确实明显。但如果不在每个智能体都读的约束文件中明确它们，并行智能体会默默地制造正是这些规则要防止的混乱。
第6层：路由
不是每个任务都需要团队。不是每个任务都应该单干。路由框架在5个维度上评分每个任务 - 文件数、关注点分离、交接需求、审查需求、质量门 - 并路由到正确的模式。
模式A：单一聚焦会话。模式B：并行子智能体。模式C：智能体团队。数哪个模式获得3+匹配。路由到那里。
这预防的反模式：为一个3分钟单独完成的2文件编辑启动一个带任务列表和消息传递的完整团队。
仓库里有什么
仓库设计为复制粘贴采用。三个级别。
级别1（5分钟）： curl 一个文件到你的项目根目录。你就有了并行安全的交接。
curl -o CLAUDE.md https://raw.githubusercontent.com/shawnla90/context-handoff-engine/main/templates/claude-md-minimal.md
mkdir -p ~/.claude/handoffs
级别2（15分钟）： 添加记忆持久化和自我改进循环。
级别3（30分钟）： 完整引擎，带团队约束和路由。
每个模板文件都有可运行的 bash 命令。每个示例目录显示文件结构在实践中的样子。单人开发者、并行终端和多智能体团队设置。
递归漂移的配套
recursive-drift 定义方法论 - 六个非线性状态、自读反馈循环、进化系统。这个引擎处理底层管道 - 确保上下文在会话之间持久化，智能体无冲突协调，纠正变成永久规则。
你可以不用另一个而单独使用其中之一。一起用更好。
仓库是 MIT 许可的。