add-coder 0.1.0

package/templates/core/templates/TERMINOLOGY.md

@@ -0,0 +1,81 @@
+# ADD 模板术语权威规范
+
+> **定位**：项目所有 ADD 模板的术语唯一真相源。模板修改、守卫校验、LLM prompt 均以此为准。
+> **消费方**：16 个模板、`doc-format-guard.sh`、`pre-tool-use.sh`、`AGENTS.md`、`.qoder/hooks/lib/vocabulary.sh`
+> **关联 Plan**：`{{projectName}}-add-template-standardization-plan-v1.md`
+
+---
+
+## 一、术语层级
+
+```
+ADD 范式层（纵向，所有 Plan 通用）:
+  Step ───── 大写 S，ADD 工作流阶段    例: "Step 3: 代码实现"
+
+实施层（横向，Plan 内部）:
+  Round ──── 大写 R，多轮 Plan 的原子事务    例: "第1轮 ── 类型收敛"
+  Task ───── 大写 T，单文件/模块工作单元      例: "Task 1: 抽取 BaseChatSchema"
+```
+
+Step 和 Round 不冲突——Step 是纵向流程，Round 是 Step 3 内部的事务拆分。单轮 Plan 只用 Step，多轮 Plan 在 Step 3 内部用 Round。
+
+**Phase 已废弃**：单轮 Plan 中 Task 打组带来注意力分散，多轮 Plan 直接用 Round 拆分即可，不需要 Phase 中间层。
+
+## 二、禁止词与替代词
+
+| 禁止 | 替代 | 原因 |
+|------|------|------|
+| `轮次` | `Step` 或 `Round`（视上下文） | 与两概念都冲突 |
+| `阶段` | (已废弃) | Phase 概念已全局移除 |
+| `步骤` | `Task` | 与 Task 撞名 |
+| `第X步骤` | `Task X` | 同上 |
+
+## 三、各模板术语适用表
+
+| 模板 | 应出现的词 | 不应出现的词 |
+|------|--------|---------|
+| `plan-template.md` | Step, Task | Round, 轮次, 阶段, 步骤 |
+| `simple-plan-template.md` | Step, Task | Round, 轮次, 阶段, 步骤 |
+| `spec-template.md` | Requirement | Step,Task |
+| `tasks-template.md` Task | Step, Round |
+| `checklist-template.md` | (无固定术语) | 阶段, 步骤 |
+| `handoff-single-round-template.md` | Step | Round, 轮次 |
+| `handoff-multi-round-template.md` | Step, Round, Task 阶段, 步骤 |
+| `add-route-template.md` | Step, Task | Round, 轮次 |
+| `add-route-template-heavyweight.md` | Step, Task | Round, 轮次 |
+| `review-template.md` | (无固定术语) | 阶段, 步骤 |
+| `review-implementation-template.md` | (无固定术语) | 阶段, 步骤 |
+| `review-runtime-template.md` | (无固定术语) | 阶段, 步骤 |
+| `report-template.md` | (无固定术语) | — |
+| `runtime-report-template.md` | (无固定术语) | — |
+| `fix-verification-template.md` | (无固定术语) | — |
+| `handoff-template.md` | Step | Round, 轮次 |
+
+## 四、标题层级规范
+
+```
+##  X. 章节名           ← 一级章节（X = 一/二/三 或 1/2/3）
+### X.X 子章节名        ← 二级章节
+#### 子子章节名          ← 三级章节
+```
+
+- §A/§B 字母分区 → 统一改用数字（如 `§A` → `### 3.1 源码关联`）
+- plan-template 一级编号用中文数字（一/二/三），handoff 用阿拉伯数字（1/2/3），不变
+- 禁止 `#####` 四级标题
+
+## 五、占位符规范
+
+所有模板占位符统一 `{ }` 包裹。守卫检测到未替换占位符 → 阻断写入。
+
+```
+{需求名} {核心内容} {版本号} {ISO 时间戳}
+{N} {描述} {检查项1} {确认项2}
+{项目名} {变更描述} {文件路径} {关键字}
+{ACTION_1} {ACTION_2} {ACTION_3}
+```
+
+## 六、修订记录
+
+| 版本 | 日期 | 变更 |
+|------|------|------|
+| v1 | 2026-07-04 | 初版：四层术语 + 禁止词 + 模板适用表 + 标题层级 + 占位符 |

package/templates/core/templates/add-route-template-heavyweight.md

@@ -0,0 +1,288 @@
+# {需求域名}-{核心内容}-add-route-v{版本号}
+
+> **定位**：Plan → ADD Step执行映射。不重复 Plan 的架构设计和 Specs 的任务细节——只定义每个 ADD Step 在本 Plan 中的具体动作、输入、产出。
+>
+> **模式**：重型（Heavyweight）——每一步产出检查强制执行"验证并更新项目状态"，包含 `check_spec_sync` 文档-代码交叉校验。适用于后端系统、多层管线、审计合规场景。
+>
+> **绑定**：Plan: `{plan-path}` · Spec: `{spec-path}` · Tasks: `{tasks-path}` · Handoff: `{handoff-path}`
+
+---
+
+## Step 0：文档先行（Documentation First）
+
+**目的**：代码动工前，确认 Plan + Specs + Handoff 三元组齐全，项目文档反映即将实现的变更。
+
+**输入**：
+- 上游 Review（触发来源）
+- Plan 文档
+- 规划说明书、架构文档等项目知识库
+
+**动作**：
+1. 确认 Specs 三元组就绪：`spec.md` + `tasks.md` + `checklist.md`
+2. 调用 `find_related_docs` 检索受影响的架构/规范/需求文档
+3. 按检索结果更新项目文档（`docs/*/knowledge/`），或声明"本次变更无需更新项目文档"并说明理由
+4. 确认 Handoff 就绪（含 round 边界、ADD-7 策略表、回滚方案）
+
+**产出**：
+- [ ] 验证并更新项目状态：Specs 三元组路径确认
+- [ ] 验证并更新项目状态：项目文档已更新（或无需更新声明已记录）
+- [ ] 验证并更新项目状态：Handoff 就绪
+
+### §0.8 DPS 闸门（上游文档质量校验）
+
+> **重型强制**：Step 0 完成后、进入 Step 1 前，调用 `check_dps` 验证上游文档质量。Plan 概括度 → Review 注意力稀释 → Specs 遗漏 → 实现偏差，这是首要根因。
+
+调用 `check_dps({ planKeyword: "{planKeyword}" })`。
+
+| DPS | 判定 | 动作 |
+|-----|:--:|------|
+| ≥ 85 | 🟢 | 进入 Step 1 |
+| 70–84 | 🟡 | 回退补齐短板（补 Review 缺失维度 / Specs 缺失 Requirement） |
+| < 70 | 🔴 | 回退细化 Plan 本身（粒度不足是下游漂移的根因） |
+
+- [ ] DPS 已通过（≥ 85），可进入 Step 1
+
+---
+
+## Step 1：功能分析与审计打点定义
+
+**目的**：定义本次变更涉及的所有审计打点，扩展 `AgentAuditPhase`。
+
+**输入**：
+- Plan §3 的 Task 列表
+- `src/lib/agent-audit-logger.ts` 当前 `AgentAuditPhase` 联合类型
+
+**动作**：
+1. 列出本次变更涉及的所有业务环节
+2. 在 `AgentAuditPhase` 联合类型中新增需要的字面量
+
+**产出**：
+- [ ] 验证并更新项目状态：本次审计打点清单已同步到 tasks.md Step 1 区域
+
+| 字面量 | 使用场景 | Task |
+|-------|---------|------|
+| `NEW_PHASE` | 描述 | Task N |
+
+---
+
+## Step 2：审计基础设施确认
+
+**目的**：确认 `agentAudit()` 通道可用，无需新建 logger 文件。
+
+**输入**：
+- `src/lib/agent-audit-logger.ts`
+- Step 1 的 AgentAuditPhase 扩展
+
+**动作**：
+1. 确认 `agentAudit(phase, detail, extra?)` 接受 Step 1 新增的字面量
+2. 确认三通道输出正常（console + file + AuditLog 表）
+3. 确认辅助函数可用（`agentAuditNodeStart/End/Error`、`agentAuditRetrieval` 等）
+
+**产出**：
+- [ ] 验证并更新项目状态：`agentAudit()` 通道确认可用，状态已同步到 checklist.md ADD 规则合规项
+
+---
+
+## Step 3：业务逻辑实现与审计植入
+
+**目的**：按 Plan 的 Task 依赖拓扑，逐 Task 实施代码 + 嵌入审计点。
+
+**输入**：
+- Plan §3 修复方案（每个 Task 的改动文件、操作、代码模板）
+- Plan §4 依赖与约束
+- `tasks.md` 的 Task 清单
+- Handoff 的 ADD-7 审计策略表
+
+**动作**：
+
+### §3.0 前置守卫（重型强制）
+
+调用 `check_add_route_status` 确认 add-route 文件有效存在，不通过则禁止进入代码实现。
+
+### Task 映射表
+
+| # | Task | 文件 | 审计植入点 | 新增字面量 | 依赖 | 状态 |
+|---|------|------|-----------|-----------|------|------|
+| 1 | {Task名} | `file.ts` | `agentAudit("PHASE", ...)` | `PHASE_NAME` | 无 | ⬜ |
+| 2 | {Task名} | `file.ts` | 无（结构变更） | — | Task 1 | ⬜ |
+
+### 依赖拓扑
+
+```
+Task N ──→ Task M（说明依赖原因）
+```
+
+### 每个 Task 完成后（重型强制执行）
+
+1. 验证该 Task 的 checklist `[T]` 项
+2. 调用 `record_dev_operation` 记录 ADD-7 审计
+3. **验证并更新项目状态**：将该 Task 在 `tasks.md` 中逐子项勾选为 `[x]`
+
+**产出**：
+- [ ] 验证并更新项目状态：全部 Task 的 `[T]` 项通过，`tasks.md` 已完成项已逐项勾选
+- [ ] 验证并更新项目状态：每个文件有 `record_dev_operation` 记录，`checklist.md` ADD-7 审计项已确认
+- [ ] 验证并更新项目状态：调用 `check_spec_sync` 确认 spec 文档勾选状态与实际代码一致
+
+---
+
+## Step 3.5：实现审查
+
+**目的**：代码完成后，验证意图与实现无语义鸿沟（ADD-10）。
+
+**输入**：
+- `checklist.md`
+- `review-implementation-template.md`
+
+**动作**：
+1. 逐项执行 `checklist.md` 中所有 `[T]` 编译期检查项
+2. 按 `checklist-template.md` 执行跨项目联调检查
+3. 读取 `review-implementation-template.md`，生成 `review-implementation.md`
+4. 所有 `[T]` 项通过后，生成 `review-runtime.md`（含 `[R]` 待验证清单）
+5. **重型强制**：调用 `check_spec_sync` 确认 `tasks.md` / `checklist.md` 全部已完成项的勾选状态正确，不一致项立即同步更新
+
+**产出**：
+- [ ] 验证并更新项目状态：`checklist.md` 全部 `[T]` 项已通过并勾选
+- [ ] 验证并更新项目状态：`review-implementation.md` 已生成
+- [ ] 验证并更新项目状态：`review-runtime.md` 已生成（含 `[R]` 待验证清单）
+- [ ] 验证并更新项目状态：`check_spec_sync` 通过——spec 文档勾选状态与代码一致
+
+---
+
+## Step 4：审计数据验证
+
+**目的**：编译 + 审计完整性检查。
+
+**输入**：
+- 全部修改文件
+- MCP 工具：`check_phase_symmetry`、`check_failure_path`、`check_spec_sync`
+
+**动作**：
+1. `npx tsc --noEmit` —— 零类型错误
+2. `npm run lint` —— 无新增 lint 问题
+3. 调用 `check_phase_symmetry` 验证打点标记完整性
+4. 调用 `check_failure_path` 验证失败路径审计等价（ADD-6）
+5. **重型强制**：调用 `check_spec_sync` 确认 spec 文档与实际代码一致
+
+**产出**：
+- [ ] `tsc --noEmit` 通过
+- [ ] `npm run lint` 通过
+- [ ] 对称性验证通过
+- [ ] 失败路径审计等价验证通过
+- [ ] 验证并更新项目状态：`check_spec_sync` 通过，checklist.md 编译检查项已同步勾选
+
+### §4.6 RAHS 闸门（下游执行健康度校验）
+
+> **重型强制**：Step 4 各项检查完成后，调用 `check_rahs` 量化本轮注意力漂移程度。范围扩散 + 审计漏记 + 类型错误是最常见的漂移信号。
+
+调用 `check_rahs({ planKeyword: "{planKeyword}" })`。
+
+| RAHS | 判定 | 动作 |
+|------|:--:|------|
+| ≥ 90 | 🟢 | 进入 Step 5 |
+| 70–89 | 🟡 | 自检：范围扩散？审计漏记？类型错误？ |
+| < 70 | 🔴 | 注意力漂移严重，返工回退 Step 3 |
+
+- [ ] RAHS 已通过（≥ 90），可进入 Step 5
+
+---
+
+## Step 5：AI 自动合规检查
+
+**目的**：扫描全部修改文件的 ADD-1~ADD-7 合规性。
+
+**输入**：
+- 全部修改文件的代码
+- MCP 工具：`check_add_compliance`
+
+**动作**：
+1. 对每个修改文件调用 `check_add_compliance(code, projectPattern="event-based")`
+2. 汇总合规报告，标注违规项和风险等级
+
+**产出**：
+- [ ] 验证并更新项目状态：合规报告已生成，违规项处理决策已记录
+- [ ] 验证并更新项目状态：`checklist.md` ADD 规则合规检查项已同步勾选
+
+---
+
+## Step 6：从审计数据定位问题
+
+> **仅当 Step 4/5 发现异常时进入。**
+
+**目的**：根据审计日志定位问题根因。
+
+**动作**：
+1. 查询审计日志（`query_audit_logs` 或直接 grep）
+2. 对照 Plan 验收到位情况
+
+**产出**：
+- [ ] 验证并更新项目状态：问题清单已记录（含文件路径和根因分析），已同步到 `tasks.md` 对应 Task 的异常标记
+
+---
+
+## Step 7：修复并验证
+
+> **仅当 Step 6 发现问题时进入。**
+
+**动作**：
+1. 按问题优先级逐个修复
+2. 修复后回到 Step 4 重新验证
+
+**产出**：
+- [ ] 验证并更新项目状态：所有问题已修复，`checklist.md` 回归验证项已重新勾选
+- [ ] 验证并更新项目状态：Step 4/5 复验通过
+
+---
+
+## Step 8：收敛判断 + Handoff 更新 + Step 0 第二部分
+
+**目的**：功能收敛判定，更新 Handoff，回到架构文档做最终校准。
+
+**输入**：
+- Handoff 文档
+- 架构文档（`docs/*/knowledge/01-架构/`）
+- `checklist.md` 最终状态
+
+**动作**：
+1. **收敛判断**：全部 `[T]` 项通过 + `[R]` 清单已生成 + RAHS ≥ 90 → 功能收敛
+2. **RAHS 最终核定**：调用 `check_rahs({ planKeyword: "{planKeyword}" })`，RAHS ≥ 90 方可收敛，< 90 回退修复
+3. **验证并更新项目状态**：`tasks.md` 全部 Task 已完成 + 全部子项已勾选，`checklist.md` 全部可验证项已勾选
+4. **验证并更新项目状态**：调用 `check_spec_sync` 做最终交叉校验——Plan 预期、spec 勾选状态、git diff 实际变更、ADD-7 审计记录四者一致
+5. **Handoff 更新**：更新 Handoff 的 §7（实际产出与偏离）、§8（验证结果）、§9（后置确认）
+6. **Step 0 第二部分**：回架构文档做最终校准——验证 `{{docsDir}}/knowledge/01-架构/` 下相关文档已反映变更
+7. **ADD-7 回查**：`query_audit_logs` 确认全部 `record_dev_operation` 记录已落库，按 action/targetId 交叉验证
+
+**产出**：
+- [ ] 验证并更新项目状态：收敛判定结果
+- [ ] 验证并更新项目状态：`tasks.md` + `checklist.md` 全部完成项已勾选
+- [ ] 验证并更新项目状态：`check_spec_sync` 四者一致确认
+- [ ] 验证并更新项目状态：Handoff 已更新
+- [ ] 验证并更新项目状态：架构文档已校准
+- [ ] 验证并更新项目状态：ADD-7 审计记录已落库确认
+
+---
+
+## Step 9：Report Closure（运行时发现关闭 — 条件性操作）
+
+**目的**：仅 runtime-fix plan 执行。关闭 gateway.md 运行时发现。
+
+**输入**：
+- `report-handoff-template.md`
+- `gateway.md`
+
+**动作**：
+1. 按 `report-handoff-template.md` 在 handoff 中追加 Report Closure 章节
+2. 在 gateway.md 中为被修复的发现追加 `- [x]` 标记
+3. 运行 `npx tsx scripts/check-boundary-report.ts` 验证关闭
+
+**产出**：
+- [ ] 验证并更新项目状态：handoff 已追加 Report Closure 章节
+- [ ] 验证并更新项目状态：gateway.md 发现已追加 `- [x]` 标记
+- [ ] 验证并更新项目状态：`check-boundary-report.ts` 已关闭类型无残留
+
+---
+
+## 附录：文件清单
+
+| 文件 | 操作 | Task | targetType | ADD-7 状态 |
+|------|------|------|-----------|------------|
+| `path/to/file.ts` | MODIFY | Task N | TYPE | ⬜ |

package/templates/core/templates/add-route-template.md

@@ -0,0 +1,242 @@
+# {需求域名}-{核心内容}-add-route-v{版本号}
+
+> **定位**：Plan → ADD Step执行映射。不重复 Plan 的架构设计和 Specs 的任务细节——只定义每个 ADD Step 在本 Plan 中的具体动作、输入、产出。
+>
+> **绑定**：Plan: `{plan-path}` · Spec: `{spec-path}` · Tasks: `{tasks-path}` · Handoff: `{handoff-path}`
+
+---
+
+## Step 0：文档先行（Documentation First）
+
+**目的**：代码动工前，确认 Plan + Specs + Handoff 三元组齐全，项目文档反映即将实现的变更。
+
+**输入**：
+- 上游 Review（触发来源）
+- Plan 文档
+- 规划说明书、架构文档等项目知识库
+
+**动作**：
+1. 确认 Specs 三元组就绪：`spec.md` + `tasks.md` + `checklist.md`
+2. 调用 `find_related_docs` 检索受影响的架构/规范/需求文档
+3. 按检索结果更新项目文档（`docs/*/knowledge/`），或声明"本次变更无需更新项目文档"并说明理由
+4. 确认 Handoff 就绪（含 round 边界、ADD-7 策略表、回滚方案）
+
+**产出**：
+- [ ] Specs 三元组路径确认
+- [ ] 项目文档更新（或无需更新声明）
+- [ ] Handoff 就绪
+
+---
+
+## Step 1：功能分析与审计打点定义
+
+**目的**：定义本次变更涉及的所有审计打点，扩展 `AgentAuditPhase`。
+
+**输入**：
+- Plan §3 的 Task 列表
+- `src/lib/agent-audit-logger.ts` 当前 `AgentAuditPhase` 联合类型
+
+**动作**：
+1. 列出本次变更涉及的所有业务环节
+2. 在 `AgentAuditPhase` 联合类型中新增需要的字面量
+
+**产出**：
+- [ ] 本次审计打点清单（含 字面量名和使用场景）
+
+| 字面量 | 使用场景 | Task |
+|-------|---------|------|
+| `NEW_PHASE` | 描述 | Task N |
+
+---
+
+## Step 2：审计基础设施确认
+
+**目的**：确认 `agentAudit()` 通道可用，无需新建 logger 文件。
+
+**输入**：
+- `src/lib/agent-audit-logger.ts`
+- Step 1 的 AgentAuditPhase 扩展
+
+**动作**：
+1. 确认 `agentAudit(phase, detail, extra?)` 接受 Step 1 新增的字面量
+2. 确认三通道输出正常（console + file + AuditLog 表）
+3. 确认辅助函数可用（`agentAuditNodeStart/End/Error`、`agentAuditRetrieval` 等）
+
+**产出**：
+- [ ] `agentAudit()` 通道确认可用
+
+---
+
+## Step 3：业务逻辑实现与审计植入
+
+**目的**：按 Plan 的 Task 依赖拓扑，逐 Task 实施代码 + 嵌入审计点。
+
+**输入**：
+- Plan §3 修复方案（每个 Task 的改动文件、操作、代码模板）
+- Plan §4 依赖与约束
+- `tasks.md` 的 Task 清单
+- Handoff 的 ADD-7 审计策略表
+
+**动作**：
+
+### Task 映射表
+
+| # | Task | 文件 | 审计植入点 | 新增字面量 | 依赖 | 状态 |
+|---|------|------|-----------|-----------|------|------|
+| 1 | {Task名} | `file.ts` | `agentAudit("PHASE", ...)` | `PHASE_NAME` | 无 | ⬜ |
+| 2 | {Task名} | `file.ts` | 无（结构变更） | — | Task 1 | ⬜ |
+
+### 依赖拓扑
+
+```
+Task N ──→ Task M（说明依赖原因）
+```
+
+### 每个 Task 完成后
+
+1. 验证该 Task 的 checklist `[T]` 项
+2. 调用 `record_dev_operation` 记录 ADD-7 审计
+
+**产出**：
+- [ ] 全部 Task 的 `[T]` 项通过
+- [ ] 每个文件有 `record_dev_operation` 记录
+
+---
+
+## Step 3.5：实现审查
+
+**目的**：代码完成后，验证意图与实现无语义鸿沟（ADD-10）。
+
+**输入**：
+- `checklist.md`
+- `review-implementation-template.md`
+
+**动作**：
+1. 逐项执行 `checklist.md` 中所有 `[T]` 编译期检查项
+2. 按 `checklist-template.md` 执行跨项目联调检查
+3. 读取 `review-implementation-template.md`，生成 `review-implementation.md`
+4. 所有 `[T]` 项通过后，生成 `review-runtime.md`（含 `[R]` 待验证清单）
+
+**产出**：
+- [ ] `checklist.md` 全部 `[T]` 项已通过
+- [ ] `review-implementation.md` 已生成
+- [ ] `review-runtime.md` 已生成
+
+---
+
+## Step 4：审计数据验证
+
+**目的**：编译 + 审计完整性检查。
+
+**输入**：
+- 全部修改文件
+- MCP 工具：`check_phase_symmetry`、`check_failure_path`
+
+**动作**：
+1. `npx tsc --noEmit` —— 零类型错误
+2. `npm run lint` —— 无新增 lint 问题
+3. 调用 `check_phase_symmetry` 验证打点标记完整性
+4. 调用 `check_failure_path` 验证失败路径审计等价（ADD-6）
+
+**产出**：
+- [ ] `tsc --noEmit` 通过
+- [ ] `npm run lint` 通过
+- [ ] 对称性验证通过
+- [ ] 失败路径审计等价验证通过
+
+---
+
+## Step 5：AI 自动合规检查
+
+**目的**：扫描全部修改文件的 ADD-1~ADD-7 合规性。
+
+**输入**：
+- 全部修改文件的代码
+- MCP 工具：`check_add_compliance`
+
+**动作**：
+1. 对每个修改文件调用 `check_add_compliance(code, projectPattern="event-based")`
+2. 汇总合规报告，标注违规项和风险等级
+
+**产出**：
+- [ ] 合规报告已生成
+- [ ] 所有违规项有处理决策（修复/豁免/记录）
+
+---
+
+## Step 6：从审计数据定位问题
+
+> **仅当 Step 4/5 发现异常时进入。**
+
+**目的**：根据审计日志定位问题根因。
+
+**动作**：
+1. 查询审计日志（`query_audit_logs` 或直接 grep）
+2. 对照 Plan 验收到位情况
+
+**产出**：
+- [ ] 问题清单（含文件路径和根因分析）
+
+---
+
+## Step 7：修复并验证
+
+> **仅当 Step 6 发现问题时进入。**
+
+**动作**：
+1. 按问题优先级逐个修复
+2. 修复后回到 Step 4 重新验证
+
+**产出**：
+- [ ] 所有问题已修复
+- [ ] Step 4/5 复验通过
+
+---
+
+## Step 8：收敛判断 + Handoff 更新 + Step 0 第二部分
+
+**目的**：功能收敛判定，更新 Handoff，回到架构文档做最终校准。
+
+**输入**：
+- Handoff 文档
+- 架构文档（`docs/*/knowledge/01-架构/`）
+
+**动作**：
+1. **收敛判断**：全部 `[T]` 项通过 + `[R]` 清单已生成 → 功能收敛
+2. **Handoff 更新**：更新 Handoff 的 §7（实际产出与偏离）、§8（验证结果）、§9（后置确认）
+3. **Step 0 第二部分**：回架构文档做最终校准——验证 `{{docsDir}}/knowledge/01-架构/` 下相关文档已反映变更
+4. **ADD-7 回查**：`query_audit_logs` 确认全部 `record_dev_operation` 记录已落库，按 action/targetId 交叉验证
+
+**产出**：
+- [ ] 收敛判定结果
+- [ ] Handoff 已更新
+- [ ] 架构文档已校准
+- [ ] ADD-7 审计记录已落库确认
+
+---
+
+## Step 9：Report Closure（运行时发现关闭 — 条件性操作）
+
+**目的**：仅 runtime-fix plan 执行。关闭 gateway.md 运行时发现。
+
+**输入**：
+- `report-handoff-template.md`
+- `gateway.md`
+
+**动作**：
+1. 按 `report-handoff-template.md` 在 handoff 中追加 Report Closure 章节
+2. 在 gateway.md 中为被修复的发现追加 `- [x]` 标记
+3. 运行 `npx tsx scripts/check-boundary-report.ts` 验证关闭
+
+**产出**：
+- [ ] handoff 已追加 Report Closure 章节
+- [ ] gateway.md 发现已追加 `- [x]` 标记
+- [ ] `check-boundary-report.ts` 已关闭类型无残留
+
+---
+
+## 附录：文件清单
+
+| 文件 | 操作 | Task | targetType | ADD-7 状态 |
+|------|------|------|-----------|------------|
+| `path/to/file.ts` | MODIFY | Task N | TYPE | ⬜ |

package/templates/core/templates/add-route-template.schema.json

@@ -0,0 +1,35 @@
+{
+    "template": "add-route-template.md",
+    "shared_by": [
+        "add-route-template.md",
+        "add-route-template-heavyweight.md"
+    ],
+    "sections": [
+        {
+            "id": "step0",
+            "heading": "## Step 0",
+            "required": true
+        },
+        {
+            "id": "step3",
+            "heading": "## Step 3",
+            "required": true
+        },
+        {
+            "id": "step8",
+            "heading": "## Step 8",
+            "required": true
+        }
+    ],
+    "placeholders": [
+        "{需求域名}",
+        "{核心内容}",
+        "{版本号}"
+    ],
+    "forbidden_terms": [
+        "Phase",
+        "Round",
+        "轮次",
+        "阶段"
+    ]
+}