领域文档

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

开始探索前读取

• 根目录的 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/