# Domain Docs

各工程技能在探索代码库时，应按本文件读取本工作区的领域文档。

## 布局：单上下文

本工作区不是 monorepo（没有 pnpm-workspace / package.json workspaces），按**单上下文**处理。

```
d:\cherry\                          ← 工作区根 = 上下文根
├── CONTEXT.md                      ← 领域术语表（尚未创建，按需惰性生成）
├── CLAUDE.md                       ← 工作区约定
├── docs/                           ← ring-health-docs 仓库
│   ├── adr/                        ← 架构决策记录（尚未创建，按需惰性生成）
│   └── agents/                     ← 本目录：技能配置
└── repos/
    ├── ring-health-app/            ← Android App（Kotlin + Compose）
    └── ring-health-api/            ← 后端 API
```

注意：本工作区是**多仓库**（三个独立 git 仓库），但领域上是**单一上下文**——
三个仓库共用同一套术语（戒指、指标、连接态…），不需要 per-context 的 `CONTEXT.md`。

## Before exploring, read these

- **`CONTEXT.md`**（工作区根 `d:\cherry\CONTEXT.md`），或
- **`CONTEXT-MAP.md`**（工作区根，如果存在）：它指向每个上下文一份 `CONTEXT.md`，逐个读相关的。
- **`docs/adr/`**（`d:\cherry\docs\adr\`）：读与你即将改动的区域相关的 ADR。

这些文件不存在时，**静默继续**。不要指出它们缺失，也不要一上来就建议创建它们。
`/domain-modeling` 技能（经由 `/grill-with-docs` 和 `/improve-codebase-architecture` 到达）
会在术语或决策真正定下来时惰性创建。

## Use the glossary's vocabulary

当你的产出中出现领域概念（issue 标题、重构提案、假设、测试名），使用 `CONTEXT.md` 中定义的术语。
不要漂移到术语表明确避免的同义词。

如果你需要的概念还不在术语表里，这本身是个信号：要么你在发明项目不用的说法（重新考虑），
要么确实存在缺口（记下来交给 `/domain-modeling`）。

## Flag ADR conflicts

如果你的产出与既有 ADR 冲突，明确指出，而不是悄悄覆盖：

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