模块 2 · 第二定律

ADR
Why 比 How 重要

拓扑图只回答「怎么连」。拍板表、spec、测试日志才是本项目的 ADR 等价物——否则同一决策会Groundhog day反复吵。

ADR 五段（书第 19 章 → 本项目写法）

Title

例：1B 数据查询违禁词处理

Context

客服数据类回复不能乱承诺；又不能误转人工。

Decision

We will 回退 fact_text，不自动 transfer（customer+visitor 共用）。

Consequences

用户体验略硬；合规风险下降；需单测 sanitize 路径。

Compliance

pytest + 客服验收用例；改 sanitize_postprocess.py 必跑。

落点

docs/memory/MEMORY.md  §3 拍板表
docs/superpowers/specs/*.md
docs/memory/tests/**/TEST-LOG-*.md
app/utils/sanitize_postprocess.py

白话

让 AI 写功能前：先问「有没有 ADR/拍板？」没有就补 Context+Decision 再写代码。

Email-driven architecture = 只在聊天里说过，MEMORY 没写——后人必踩坑。