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 编号、冲突内容及重新讨论的理由。
|