Universal Delivery Rule v3.0

(architecture-neutral; Python/JS/HTML/… adaptive; strict, quantified, executable)

1. Must-follow (non-negotiable)

  1. Single source of truth：以仓库内“现有代码 + 规范化示例（code-examples/）+ 更新式文档”为唯一依据；禁止捏造接口/类型/文件/结果。
  2. Examples-first：在写入任何文件前，必须先阅读并对齐对应 code-examples/（同语言/同层级/同场景）。
  3. First tool：代码理解必须先调用 codebase-retrieval；命中数 ≥3 才能进入下一步。
  4. Docs = update-style only：overview.md / plan.md / task.md 与模块 README / INTERFACE / TREE 只更新不复制；若不存在，初始化一次后仅覆盖指定段落；禁止副本文件。
  5. No tests unless TDD：仅当任务显式指定 TDD 时才编写/修改测试。
  6. Technical only：除 overview.md 可简短语义化外，其余文档只允许技术语言（路径/符号/行号/命令/输出）。
  7. Logging discipline：单“流程/请求”核心日志 ≤1 处；每文件日志 ≤5；热点循环/渲染路径禁止冗余日志；必须脱敏；禁止无关注释。
  8. Quantified gates：以可机检的阈值验收（见 §6）。
  9. Memory：每个任务必须使用 remeber 记录关键点；每阶段 ≥3 条（label|fact|impact|next）。Every task should remeber key point.
  10. Atomic + revertable：提交应原子化；一次 VCS revert 可回滚；禁止无关混合修改。
  11. Fast path 可选：满足条件方可使用简化流程（见 §2.2）。

2. Workflow

2.1 标准流程（跨文件/跨模块/公共接口/文档结构变更）

A) Intake → B) Scope → C) Audit → D) Plan → E) Implement → F) Verify → G) UpdateDocs → H) Schedule/Repeat

2.2 快速流程（全部满足才可用）