yuxuanhui
33 lines
988 B
Markdown
33 lines
988 B
Markdown
# Domain Docs
|
||
|
||
本仓库采用 single-context 布局：
|
||
|
||
- 根目录 `CONTEXT.md`：领域术语及模型。
|
||
- `docs/adr/`：架构决策记录。
|
||
|
||
## 探索前读取
|
||
|
||
探索代码库前，阅读根目录 `CONTEXT.md`，
|
||
以及 `docs/adr/` 中与当前工作相关的决策。
|
||
|
||
若将来存在根目录 `CONTEXT-MAP.md`，
|
||
先按其中索引读取相关上下文的 CONTEXT.md 和 ADR。
|
||
|
||
文档不存在时直接继续，无需报告缺失或建议提前创建。
|
||
领域术语和决策实际明确后，由 `/domain-modeling`
|
||
按当前任务授权按需创建。
|
||
|
||
## 使用领域词汇
|
||
|
||
任务标题、重构建议、假设和测试名称中的领域概念，
|
||
使用 CONTEXT.md 已定义的术语。
|
||
|
||
遇到尚未收录的概念，先核对项目现有用语；
|
||
确有缺口时，将其作为当前任务中供 `/domain-modeling`
|
||
处理的候选。
|
||
|
||
## 揭示决策冲突
|
||
|
||
建议或实现方向与现有 ADR 冲突时，
|
||
明确指出 ADR 编号、冲突内容及重新讨论的理由。
|