用途：维护 CLAUDE.md 文件，在添加经验教训、更新约定或重构项目指令时使用，让该文件保持精简、准确与实用。
核心模式：在犯错或有新发现后，用“Update CLAUDE.md so you don't make that mistake again”这类指令，在上下文重置前把学习成果记录下来。
何时更新：应在同一错误出现两次、发现非显而易见的约定、识别出关键项目约束时添加规则；当规则不再适用（依赖变化、模式演进）、与其他规则重复冗余、或过于具体（一次性修复而非通用模式）时移除规则。
结构模板包含：项目名称与一两句简短目的；Key Commands（如 npm test 运行测试、npm run build 生产构建）；Conventions（约定，如对 Y 使用 X 模式、提交前总是执行 Z）；Mistakes to Avoid（避免的错误，如不要假设 X、记得先检查 Z）。
层级：分两级且都会加载。~/.claude/CLAUDE.md 作用于所有项目，用于个人偏好与全局模式；.claude/CLAUDE.md 作用于当前仓库，用于项目约定与技术栈规则。两者冲突时项目级覆盖全局级。
大小准则：保持在 500 行以内，因为 Claude 每次请求都会扫描。过长时可提取到引用文件，例如在“## API Patterns”下写“See api-patterns.md for details.”。
参考资料：structure-guide.md 用于章节组织，lesson-patterns.md 用于撰写有效规则，hierarchy.md 用于全局与项目范围的说明。