Fragment

Fragment 是一组纯文本文件协议，不运行任何东西，核心文件包括 docs/AGENT-PROTOCOL.md、CLAUDE.md、AGENTS.md、docs/STATE.md 和 scripts/docs-check.sh。

Fragment 的 STATE.md 中包含一个专门段落记录已经做出的决策（例如注册用手机号而非邮箱及其原因），供下一个会话在提问之前先读取。

Fragment 项目由两个人使用两个操作系统和两个不同的代理，在 18 小时内完成了 25 次提交。

第二位团队成员在没有经过教学的情况下，其七次提交全部呈现相同的三文件形态（索引、看板、实际工作），只是读了同一个协议文件就收敛到同样的动作。

Fragment 的局限包括：样本量 n=2，两个生产仓库都由作者本人运行；超过两人的并发未测试；Fragment 不证明能防止 bug，它防止的是上下文丢失和重复争论已决策的事项。

在 Claude Code 中可通过运行 npx skills add hematenergi/fragment --skill fragment 来尝试 Fragment，或把网站上的安装提示粘贴到所用代理中。

作者尝试仅维护一个笔记文件的做法大约五天后失效：一个会话忘了更新，下一个会话信任过期的看板，于是回到开头的简报循环。

Fragment 把检查层和业务规则分离：仓库特定的规则放在本地文件里，由共享的检查脚本 source 进来，更新检查逻辑不会碰这些本地规则。