Domain Docs（领域文档）

Engineering skill 探索代码库时应如何消费本 repo 的领域文档。

Before exploring, read these（探索前阅读）

• Repo root 的 CONTEXT.md，或
• 若存在 root 的 CONTEXT-MAP.md——指向每 context 一个 CONTEXT.md。读与 topic 相关的每个。
• docs/adr/——读 touch 将工作区域的 ADR。Multi-context repo 也查 src/<context>/docs/adr/ 的 context-scoped 决定。

若任一不存在，proceed silently。Don't flag absence；don't suggest upfront 创建。Producer skill（/grill-with-docs）在 term 或 decision 实际 resolved 时 lazy 创建。

File structure（文件结构）

Single-context repo（多数 repo）：

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

Multi-context repo（root 有 CONTEXT-MAP.md）：

/
├── CONTEXT-MAP.md
├── docs/adr/                          ← system-wide decisions
└── src/
    ├── ordering/
    │   ├── CONTEXT.md
    │   └── docs/adr/                  ← context-specific decisions
    └── billing/
        ├── CONTEXT.md
        └── docs/adr/

Use the glossary's vocabulary（使用词汇表词汇）

Output 命名 domain concept（issue title、refactor proposal、hypothesis、test name）时，用 CONTEXT.md 定义的 term。Don't drift 到 glossary explicitly avoid 的同义词。

若需要的 concept 不在 glossary，那是 signal——要么 invent 项目不用的 language（reconsider），要么 real gap（note 给 /grill-with-docs）。

Flag ADR conflicts（标记 ADR 冲突）

Output contradict 现有 ADR 时 explicit surface，而非 silent override：

Contradicts ADR-0007 (event-sourced orders) — but worth reopening because…