用途：trellis-meta 面向已在项目中运行 trellis init 的本地 Trellis 用户。阅读后，AI 应理解该用户项目内的 Trellis 架构、运行模型与定制入口，并按用户请求修改生成的 .trellis/ 与平台目录文件。
默认操作范围是用户项目内的本地文件：.trellis/（工作流、配置、任务、spec、workspace、脚本与运行时状态）；平台目录（.claude/、.codex/、.cursor/、.opencode/、.kiro/、.gemini/、.qoder/、.codebuddy/、.github/、.factory/、.pi/、.kilocode/、.agent/、.windsurf/ 等）；共享技能层 .agents/skills/。不要假设用户拥有 Trellis 源码仓库，不要默认修改全局 npm 安装目录或 node_modules。
使用方式：先读 references/local-architecture/overview.md 建立本地 Trellis 系统模型；若涉及特定 AI 工具，读 references/platform-files/platform-map.md 及相关平台文件说明；若要改变行为，读 references/customize-local/overview.md 再进入具体定制主题；编辑前先读用户项目中的实际文件，以本地内容为准。
参考文档涵盖本地架构（生成文件、工作流、任务系统、spec 系统、workspace 记忆、上下文注入）、平台文件（总览、平台映射、钩子与设置、agents、技能与命令）以及本地定制（工作流、任务生命周期、上下文加载、钩子、agents、技能或命令、spec 结构、项目本地约定）。
当前规则：.trellis/workflow.md 是本地工作流事实来源；.trellis/config.yaml 是项目级配置与任务钩子配置入口；.trellis/spec/ 存放项目特定编码约定与设计约束；.trellis/tasks/ 存放任务 PRD、技术笔记、研究文件与 JSONL 上下文；.trellis/workspace/ 存放开发者日志与跨会话记忆；平台设置/配置文件决定实际运行的钩子、agents、技能、命令、提示与工作流；.trellis/.template-hashes.json 与 .trellis/.runtime/ 是管理/运行时状态文件，编辑前需确认必要性。
限制：不要把 Trellis 上游源码当作本地定制默认目标；不要为实现项目需求修改全局 npm 安装目录或 node_modules/@mindfoldhq/trellis；不要用默认模板覆盖用户已修改的本地文件；不要把团队私有项目规则放入公开的 trellis-meta，应放入 .trellis/spec/ 或项目本地技能；不要把已移除的历史机制描述为当前 Trellis 行为。