Reference · Cheat sheet

`domain-modeling`

压缩自 Lesson 0004 与 skill 原文。冲突时以 SKILL.md / 格式文件为准。

身份

Model-invoked · vocabulary underneath（地板）
主动改领域模型；仅读 CONTEXT.md ≠ 本 skill
产物：glossary（CONTEXT*）+ 稀有 ADR（docs/adr/）

主动 vs 被动

被动（any skill）	主动（本 skill）
读 CONTEXT/ADR；输出用官方词	挑战 / sharpen / 场景 / 对代码 / inline 写 / 条件 ADR
缺文件 → 静默继续	懒创建：首词 → CONTEXT；首真决策 → docs/adr

谁 prose 调用

grill-with-docs   → grilling + domain-modeling
triage (if needed)→ grilling + domain-modeling
wayfinder         → chart destination / resolve (default)
improve-arch      → grilling loop 内维持模型
人类 /domain-modeling → 单独钉词或当 reference

布局信号

CONTEXT-MAP.md 存在 → multi；改相关 per-context CONTEXT
仅根 CONTEXT.md → single（默认）
皆无 → 首次决议建根 CONTEXT

single:  /CONTEXT.md + /docs/adr/
multi:   /CONTEXT-MAP.md
         /docs/adr/              (system)
         /src/<ctx>/CONTEXT.md
         /src/<ctx>/docs/adr/    (local)

会话五步

Challenge — 与 glossary 冲突立刻点破
Sharpen — 模糊/过载 → canonical + _Avoid_
Scenarios — 具体场景压边界
Cross-ref code — 陈述 vs 实现矛盾必须 surface
Update inline — 决议即写；禁止攒批

CONTEXT = glossary only（非 spec / scratch / 实现决策池）。

CONTEXT 词条形

**Term**:
One or two sentences: what it IS.
_Avoid_: synonym1, synonym2

opinionated · 紧 · 仅项目特有概念 · 可分组
本仓库范例：Issue tracker / Issue / Decision ticket / Triage role

ADR 三条件（全满足才写）

Hard to reverse
Surprising without context
Real trade-off

# {Short title}

{1–3 sentences: context, decision, why.}

路径 docs/adr/0001-slug.md；可选 Status / Options / Consequences 仅在有增益时。

消费侧（domain.md）

探索前读 CONTEXT 或 MAP + 相关 ADR
缺文件不催建
输出用 glossary 词；缺词 = 信号
与 ADR 冲突要显式标明，禁止静默覆盖

vs codebase-design

domain-modeling：领域词是什么
codebase-design：模块形状（depth/seam/…）

微调旋钮

纪律/门槛 → SKILL.md
词条/ADR 形态 → CONTEXT-FORMAT.md / ADR-FORMAT.md
读侧习惯 → 目标仓 docs/agents/domain.md
布局默认 → setup Section C
自动触发 → description；勿误加 user-only 开关

副作用 / 下一步

写：CONTEXT* ·（稀）docs/adr · 不写业务码/tracker
下一步：回到调用方 flow（to-spec / triage outcome / wayfinder / 主 flow…）