ring-health-docs/agents/domain.md

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（事件溯源订单）冲突，但值得重新讨论，因为……