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