# 领域文档

工程技能在探索代码库时应按以下规则读取领域文档。

## 开始探索前读取

- 根目录的 **`CONTEXT.md`**；或
- 如果根目录存在 **`CONTEXT-MAP.md`**，读取它指向的、与当前主题相关的各个 `CONTEXT.md`；
- **`docs/adr/`**：读取与即将处理区域相关的 ADR。在多上下文仓库中，还要检查 `src/<context>/docs/adr/` 下的上下文级决策。

如果这些文件或目录不存在，静默继续。不要标记缺失，也不要提前建议创建；`/domain-modeling` 技能会在术语或决策真正确定时按需创建它们。

## 使用术语表中的词汇

当输出中出现领域概念（例如 issue 标题、重构提案、假设或测试名称）时，使用 `CONTEXT.md` 定义的术语。如果术语表明确避免使用某个同义词，不要改用该同义词。

如果所需概念尚未出现在术语表中，这是一个信号：要么项目并不使用这个说法（应重新考虑），要么领域文档确实存在缺口（交由 `/domain-modeling` 记录）。

## 标记 ADR 冲突

如果输出与现有 ADR 冲突，应明确指出，而不是静默覆盖：

> _与 ADR-0007 冲突（事件溯源订单），但值得重新打开，因为……_

## 文件结构

单上下文仓库（大多数仓库）：

```
/
├── CONTEXT.md
├── docs/adr/
│   ├── 0001-event-sourced-orders.md
│   └── 0002-postgres-for-write-model.md
└── src/
```