用途：在项目发生重大变化后，更新 CLAUDE.md 或 AGENTS.md，让后续 AI 会话一开始就掌握准确的项目上下文。仅当项目根目录已存在 CLAUDE.md 或 AGENTS.md，且变更达到重要性阈值时触发；两个条件缺一不可，若文件不存在则跳过，也不应自行创建。
主要能力与触发条件：新增模块、包或顶层目录；重命名、移动或删除文档引用的文件；构建、测试命令或工具链变化；引入新约定或模式；影响文档化入口点的 API/接口变更；文本项目的结构重组；需要安装步骤的新依赖。跳过的情形：现有架构内的缺陷修复、既有结构内新增内容、小重构、遵循已有模式的测试补充、拼写与格式修改。
使用方式：先定位根目录的 CLAUDE.md 或 AGENTS.md；用 git diff 或回忆变更，判断哪些影响项目导航与工作流；通读现有文档了解结构与语气；找出引用已删除文件、缺少新模块条目、命令过时、约定失效等陈旧或缺失部分；按原则编辑并保持原有风格；最后向用户总结更新内容与原因以便核对。
更新原则：可添加每个新模块/目录的一行描述、变化后的构建/测试/lint 命令、未来会话应遵循的新约定、新依赖的安装步骤、文件移动后的新路径。不要加入实现细节、临时绕过或 TODO、文件名已显而易见的信息、与 README.md 重复的内容。风格上匹配原有语气，优先使用条目列表，删除陈旧信息，尽量在既有章节内追加，表述要具体，例如写 make test-integration 而不是“运行集成测试”。
限制与范围：只更新项目级文件，不涉及工作区或全局文件；若两者同时存在，更新包含相关章节的那个（信息同属两者时都更新）。参考文件 references/update-examples.md 提供常见场景的前后对比示例。其它细节暂未提供。