dafang cs-domain
先执行 CodeStable preflight：读 .codestable/attention.md；缺失先 cs-onboard；不读外部 AI 入口替代（详见 .codestable/reference/execution-conventions.md）。
cs-domain 管三件事：术语（CONTEXT.md）、决策（ADR）、拓扑（单 context ↔ 多 context）。所有产物在 .codestable/requirements/ 下。
拓扑判断
每次启动先扫一眼，确定项目当前处于哪种拓扑：
.codestable/requirements/CONTEXT-MAP.md存在 → 多 context 模式- 只有
.codestable/requirements/CONTEXT.md→ 单 context - 都没有 → 项目还没起 domain 文档，按需 lazy 创建
单 context 路径
.codestable/requirements/
├── CONTEXT.md # 术语表
├── adrs/ # 顺序编号 ADR
│ ├── 001-xxx.md
│ └── 002-xxx.md
└── {capability}.md # 能力 doc（cs-req 产出，不归本技能管）
多 context 路径
.codestable/requirements/
├── CONTEXT-MAP.md # 子 context 列表 + 关系
├── adrs/ # 系统级 ADR（跨 context）
├── ordering/
│ ├── CONTEXT.md # 子 context 术语
│ └── adrs/ # 子 context 特定 ADR
└── billing/
├── CONTEXT.md
└── adrs/
CONTEXT.md 写作规范
CONTEXT.md 是术语表，不是 spec。只写"X 是什么"，不写"X 怎么实现"。
格式：
# {Context 名}
{一两句描述这个 context 是什么、为什么存在。}
## Language
**Order**:
{一两句话定义。}
_Avoid_: Purchase, transaction
**Invoice**:
A request for payment sent to a customer after delivery.
_Avoid_: Bill, payment request
规则：
- 下定义，不描述行为——写 "X 是什么"，不写 "X 做什么"
- 同义词列在
_Avoid_——多个词指同一概念时挑最好的，其他列为禁用 - 只收项目特有术语——通用编程概念（timeout、error type）不进
- 聚类用子标题——同领域术语自然分组就给小节
ADR 写作
何时该写（守门 3 判据，必须同时满足）
- 难以回退——以后改主意成本明显
- 不带上下文就难理解——读者会问"为什么这么做"
- 真实权衡的结果——有备选方案，因为具体原因挑了一个
三条少一条就不写。轻易能回退的决定不写、不奇怪的决定不写、没真备选的决定不写。
路径与编号
- 单 context：
.codestable/requirements/adrs/NNN-{slug}.md - 多 context 子系统 ADR：
.codestable/requirements/{ctx}/adrs/NNN-{slug}.md - 多 context 系统级 ADR（跨 context）：
.codestable/requirements/adrs/NNN-{slug}.md - 编号 3 位（001、002...）；扫对应 adrs/ 目录最大编号 + 1
{slug}kebab-case，能让人一眼想起决策内容
Frontmatter
---
id: 001
title: 选择 X 而不是 Y
status: proposed | accepted | superseded | deprecated | partially-superseded
date: YYYY-MM-DD
supersedes: [003] # 可选
superseded_by: [015, 017] # 可选
relates_to: [requirements/{slug}, 002] # 可选
---
正文（Nygard 四节）
# {Title}
## Context
{决策面对的问题、约束、当时的状况。}
## Decision
{我们决定做什么。}
## Consequences
{这个决定带来的正负影响、新出现的约束。}
## Alternatives Considered
{讨论过的备选方案 + 为什么没选。}
写 ADR 时用 CONTEXT.md 里已定义的术语；用到新术语就顺手 _Avoid_ 别名补到 CONTEXT.md。
单 → 多 context 升级
显式触发——用户必须明确说"这项目要分子系统了"才升级。不要因为 CONTEXT.md 长就自动建议。
升级流程：
- 跟用户对齐子 context 列表（典型 2-4 个，超过 5 个先质疑是不是切得太细）
- 创建
CONTEXT-MAP.md：列子 context + 它们之间的关系（事件流、共享类型、调用方向） - 为每个子 context 建子目录 +
CONTEXT.md+adrs/ - 把原
CONTEXT.md的术语按归属拆到各子 context；跨多个 context 的术语留在CONTEXT-MAP.md顶层 Language 节 - 把原
adrs/下的 ADR 按影响范围分：跨 context 的留原位（系统级），单 context 内部的 mv 到对应{ctx}/adrs/ - 不动
{capability}.md——能力 doc 归 cs-req 管，升级时 cs-req 跟进归类（cs-domain 不替它做）
退出条件
- 写 ADR：文件落盘 + 编号正确 + frontmatter 完整 + Nygard 四节齐
- 写 CONTEXT：术语进对位置（单/多 context 拓扑判断正确）+ 同义词列到
_Avoid_ - 升级拓扑：CONTEXT-MAP.md + 子目录创建完 + 术语拆分完 + ADR 分级完