discipline/_architecture.md
知识架构与模块化规范
本文件是「如何组织学科文档」的规范。目标：内容增长时单文档上下文可控、 耦合最小化、新增内容有明确去处。所有迭代必须遵守。
1. 分层结构
discipline/
├── README.md # 总览 + 文档地图（薄，只做路由）
├── _architecture.md # 本规范（稳定，极少改）
├── 01-vision.md # 愿景/边界（稳定核心）
├── 02-foundations.md # 公理/概念/符号/分类学（稳定核心）
├── 03-methods.md # 方法论地图（薄：路由 + 决策树）
├── 04-ai-era.md # AI 时代专章（稳定）
├── 05-agenda.md # 研究积压（薄：状态 + 指针）
├── 06-evidence.md # 证据标准（稳定核心）
├── 07-iteration.md # 迭代协议（稳定）
├── glossary.md # 术语表（唯一定义源）
├── methods/ # 七支柱详情（一支柱一文件）
├── protocols/ # 操作协议（测量/截断/冷启动/分布交付/校准/轮次模板）
├── benchmarks/ # 基准：设计 + 结果
├── knowledge/ # 机器可读知识（yaml，镜像文档）
├── literature/ # 文献：index + scans/
├── rounds/ # 轮次记录（append-only）+ changelog
└── cases/ # 案例库（规划中）
2. 分层职责与耦合规则
| 层 | 内容 | 稳定性 | 谁引用谁 |
|---|---|---|---|
| 稳定核心（01/02/04/06/07/glossary） | 公理、定义、标准、协议 | 高，变更需轮次决策 | 被所有层引用，不引用细节层 |
| 路由层（03/05/README） | 索引、状态、决策树 | 中 | 只链接，不复制内容 |
| 细节层（methods/、protocols/、benchmarks/、literature/、knowledge/） | 方法、协议、结果 | 低，随迭代增长 | 引用稳定核心，彼此尽量不引用 |
| 记录层（rounds/） | 决策与证据历史 | append-only | 引用其它层 |
耦合规则（强制）
1. 单一职责：每个概念只在一个地方定义；其它文档引用而非复制（术语引用 glossary）。
2. 单向依赖：细节层 → 稳定核心；稳定核心不反向依赖细节层。
3. 薄路由：README / 03 / 05 只做索引与状态，不承载实质内容。
4. 上下文预算：单文档建议 ≤ 150 行；超限必须拆分子文件（按支柱/协议/主题）。
5. 变更隔离：改细节层不要求改稳定核心；改稳定核心必须在轮次记录写明理由并扫引用。
6. 链接即耦合：文档间用相对链接；移动文件必须 rg 扫引用并同步更新。
3. 新增内容去处（决策表）
| 新增内容 | 去处 |
|---|---|
| 新术语 | glossary.md（唯一定义源） |
| 新方法/支柱细节 | methods/pillar-XX.md |
| 新操作流程 | protocols/（新协议文件） |
| 新数据集/实验结果 | benchmarks/dsf-bench.md（结果追加日期节） |
| 新案例 | cases/（一个案例一个文件） |
| 新研究问题 | 05-agenda.md（backlog） |
| 新文献 | literature/index.md + literature/scans/round-NN.md |
| 某轮决策/证据 | rounds/round-NN-*.md（append-only） |
4. 扩展流程（未来轮次）
- 判断内容属于哪层（§3 决策表）。
- 若落点文档超过上下文预算（>150 行）→ 先拆分，再写入。
- 更新 README 文档地图与 rounds/changelog。
- 运行 HTML 构建（scripts/build_discipline_docs.py），验证 /discipline。
- 新概念必须进 glossary；新决策必须进轮次记录。
5. 拆分的判据
- 一个文档出现 ≥3 个「详见另一节」且读者要来回跳 → 拆。
- 单文档 >150 行 → 拆（除非是轮次记录/扫描笔记这类历史性文件）。
- 两个主题被不同轮次独立修改 → 拆。
- 修改一处需要连带改 >2 个其它文档 → 重构耦合（本规范的 §2 规则）。