用途：在完成实现、修复缺陷或形成设计决策后，把有价值的编码知识写回 .trellis/spec/ 下的代码规范文档，形成可复用的团队与 AI 记忆。
主要能力：要求 spec 是可执行契约而非纯原则文本，包含具体签名、payload 字段、环境变量键与边界行为，以及可测试的校验/错误行为。对 infra 或跨层契约，强制包含 Scope/Trigger、Signatures（命令/API/DB）、Contracts（请求/响应/env）、Validation & Error Matrix、Good/Base/Bad Cases、Tests Required（含断言点）、Wrong vs Correct（至少一对）。支持记录设计决策、项目约定、新模式、禁用模式、常见错误、坑点。
使用方式：先明确学到什么、为什么重要、应归属哪个文件；再分类更新类型；编辑前读取目标文档避免重复并找到正确章节，命令为 cat .trellis/spec/<category>/<file>.md；按模板更新，必要时同步该分类的 index.md。项目区分 code-spec（backend/、frontend/，回答如何安全实现）与 guides/（回答实现前该考虑什么），后者应是简短清单并指向 spec。
适用场景：功能实现、设计决策、缺陷修复、发现新模式、踩坑、确立约定。
限制：不替代 break-loop 的深层缺陷分析；纯一次性实现细节可跳过；不清楚或资料未提供的收费、平台、效果、具体安装步骤暂未提供。