用途：在完成任务、修复缺陷或发现新模式后，把有价值的经验写入 .trellis/spec/ 下的代码规范（code-spec）文档，形成可执行的契约与团队约定，供后续 AI 与开发者安全实现。
主要能力：区分 code-spec（<layer>/.md，说明如何安全实现，含签名、契约、矩阵、用例、测试点）与 guide（guides/.md，思考清单，指向规范）。当变更涉及命令/API 签名、跨层请求响应契约、数据库 schema/迁移、基础设施集成（存储、队列、缓存、密钥、环境变量）时，强制按 7 个部分输出：范围/触发、签名、契约、校验与错误矩阵、好/基准/坏用例、所需测试（含断言点）、错误与正确对照。
使用方式：先明确学到什么、为何重要、归属哪个规范文件；再分类更新类型（设计决策、项目约定、新模式、禁止模式、常见错误、约定、陷阱）；编辑前先读取目标规范，避免重复；按模板更新并保持具体、解释原因、给出契约与代码片段；必要时更新 index.md。可用 cat .trellis/spec/<category>/<file>.md 查看现有内容。
适用场景：功能实现、设计决策、缺陷修复、模式发现、踩坑记录、团队约定确立等。
限制：资料未提供安装命令、收费、平台与效果信息；规范更新需人工判断归属与深度，非触发类变更可酌情跳过。