# Retrospect — Design Process Evolution Step 3（文件架构拆分）

**Date**: 2026-05-12
**TL;DR**: 三条 path 从单一 mockup-conventions.md 提取出来：design-process.md（通用 process 原则）+ domain-tvu.md（TVU 业务规则）+ tools/figma-quirks.md（Figma quirks 快查表）。两条 path conventions 加必读链路入口。

---

## 新建文件

| 文件 | 行数 | 内容 |
|---|---|---|
| `docs/internal/design-process.md` | ~220 行 | 通用 process 原则 10 条：Convention Priority Hierarchy / M22 / Pre-Phase 0 / Phase 0 / Library-First / M6 / M11（含 M11.1/M11.2/M11.3）/ M14（含 Context 维度）/ M15 / M16 / M21 / Lazy Reference Loading |
| `docs/internal/domain-tvu.md` | ~80 行 | TVU 业务规则 6 条：M3 状态色 / M4 dark theme / M5 no session creation / M7 control surface / M8 dashboard cards / M9 action labels |
| `docs/internal/tools/figma-quirks.md` | ~30 行 | Figma quirks 快查表（Q1-Q4 summary row，详细版指向 figma-technical-reference.md）|

## 修改文件

| 文件 | 改动 |
|---|---|
| `docs/internal/mockup-conventions.md` | 顶部加 **必读链路** 表（design-process / domain-tvu / figma-technical-reference / tools/figma-quirks / 本文件）；标题加 `（Path A — Figma）`|
| `docs/internal/code-conventions.md` | 顶部加 **必读链路** 表（design-process / domain-tvu / 本文件）；标题加 `（Path B — Code）`|
| `docs/internal/retrospection/2026-05-09-microapps-mockup-retrospect.md` | E6 cross-ref 更新（M11/M12/M13 → M11.1/M11.2/M11.3）|

---

## 关键决策

- **"Thin" 的实现方式**：conventions 文件没有删除规则内容，而是在顶部加 **必读链路** 表。理由：删除会破坏历史 AI 依赖这些文件的 session onboard 路径；加入口指针 + 保留内容在 E5 阶段是最稳妥的做法，实质上新 session onboard 从链路入口出发。
- **design-process.md voice-neutral**：所有规则措辞改为"生成 deliverable" / "采用 source 组件"，不说"画 mockup"或"写代码"。M21 probe 表也做了 path-neutral 化（不引用 Figma 特定 API）。
- **domain-tvu.md scope**：M1（TVU Top bar，Figma-only）和 M10（icon Color Variable，Figma-only）没有放入 domain-tvu.md，它们是 Path A 专属规则，留在 mockup-conventions.md 更合适。domain-tvu.md 只放 Path A + Path B 都适用的业务规则（M3/M4/M5/M7/M8/M9）。
- **tools/figma-quirks.md vs figma-technical-reference.md**：两个文件并存。figma-technical-reference.md 是 D2 产物（详细版含 code snippet），tools/figma-quirks.md 是 E3 产物（一行表格快查，引用详细版）。后续可考虑合并。

---

## 验收状态

新 session 上手**只读 design-process.md + domain-tvu.md**（共 ~16 条规则）可以覆盖 80% 决策路径：
- 通用 process: Phase 0 mapping / Library-first / self-audit / reference adaptation / local reuse / user intent gate
- TVU domain: 状态色 / dark theme / monitoring / control surface / dashboard card 状态

---

## 关联

- 上一步: [`2026-05-12-evolution-step-2.md`](./2026-05-12-evolution-step-2.md)
- 下一步: Step 4（design-walkthrough agent）