depa-codument 0.4.1

package/src/templates/codument/std/attractors/knowledge-tiers.md

@@ -0,0 +1,128 @@
+# Knowledge Tiers & 信息晋升（std/attractors/knowledge-tiers.md）
+
+> codument 的**知识分层地图 + 信息晋升阶梯 + 真源优先级**。它回答三个问题：
+> 1. 一条信息该落到哪个目录（**分层与职责**）；
+> 2. 它什么时候、怎样从临时记录**晋升**为长期真源（**晋升阶梯**）；
+> 3. 事实冲突时谁说了算（**真源优先级**）。
+>
+> 借鉴 attractor-guided-engineering 的"目录职责 + 源真优先级 + 信息晋升"纪律，按 codument 的 **track 中心**模型重构。具体文件级目录规范见 [model-driven-docs.md](./model-driven-docs.md) 与 [std/spec/folder-manifest.md](@codument/std/spec/folder-manifest.md)。
+
+## 1. 心法：attractor / carrier / projection 三层
+
+- **attractor（吸引子本身）**：少量高层不变量——领域如何划界、行为契约、结构关系。
+- **carrier（吸引子的载体）**：把不变量外化成可版本化、可审计的文档——即 `attractors/` + `docs/modeling/` + `docs/impl/` + `behaviors/` + `decisions/`。**长期 owner 文档 = 吸引子的载体。**
+- **projection（瞬时投影）**：当前代码/测试——吸引子的瞬时实现。
+
+> 推论：chat 是临时上下文，**文件才是仓库记忆**。重要输入先落文件再 `@`；重要结论按职责分类写回，而不是留在对话里。track 是一次迭代的轨迹；轨迹中稳定下来的真理必须**收敛**进 owner 文档。
+
+## 2. 知识分层表
+
+| 层 | 目录 | 装什么 | 时效 | 是谁的真源 |
+|---|---|---|---|---|
+| 结构不变量 | `attractors/` | project/product 吸引子、本表、docs 规范 | 稳定·就地改 | 高层不变量、知识纪律 |
+| 领域本体 | `docs/modeling/` | canonical + derived 建模真源 | 稳定·就地改 | "当前领域本体是什么" |
+| 实现/运维 | `docs/impl/` | 架构、howto、规则、参考、排障 | 稳定·就地改 | "实现与维护怎么做" |
+| 能力契约 | `behaviors/`（`codument/behaviors/`） | 行为登记表（行为 case、测试生成依据） | 稳定·就地改 | "系统对外承诺什么行为" |
+| 承重决策 | `decisions/`（`decision://`） | 从 track 提升的长期决策 | 稳定·追加 | "为什么这么定" |
+| 长期教训 | `memory/`（`memory://`） | lessons / incidents / patterns / summaries | 稳定·追加 | "反复踩的坑 / 复用模式" |
+| 候选工作 | `backlog/` | 跨 track 的下一步候选 + 自主度 | 活的·就地改 | "下一个该做什么"（非真源） |
+| 跨 track 路线 | `missions/<id>/roadmap.md` | 一组相关 track 的阶段路线、依赖、进度证据 | 活的·就地改 | "多个 track 如何排布"（非行为真源） |
+| 迭代工作面 | `tracks/<id>/` | proposal、design、discussion、`track.xml`、`behavior_deltas/`、`analysis/`、`decisions*`、`reports/` | **带日期·迭代内可变** | "本次要建什么 / 怎么收口 / 发生了什么" |
+| 轨迹历史 | `archive/YYYY-MM/...` | 已完成 track | **带日期·归档后不可变** | "历史上做过什么" |
+
+> 工具性目录（`std/`、`config/`、`workflows/`、`sop/`）不是知识层，不在晋升阶梯内。
+
+## 3. AGE 扁平类目 → codument 层级映射
+
+attractor-guided-engineering 把这些都摊在 `docs/` 根下；codument 把**迭代类**收进 `tracks/`、把**持久类**收进 fractal 子目录或 tier。**关键判断：凡是 fractal（modeling/impl 的类目）或某 tier 已覆盖的，codument 就不在 `docs/` 根另设 AGE 式顶层目录。**
+
+**持久 / owner 类（A 档）——已被 fractal 子目录 / tier 覆盖，不需另设 docs 顶层目录：**
+
+| AGE 持久目录 | codument 已有对应（就地） | 载体类型 |
+|---|---|---|
+| `docs/context/` 强制上下文 + 源真优先级 + 约定 | `attractors/project.md`·`product.md` + 本文件（优先级）；工程约定→`docs/impl/global/rules/` | tier(attractors) |
+| `docs/design/` 应用层 owner | `docs/modeling/`（domain 的 `objects/`·`policies/`·`workflows/`）+ `behaviors/` | **fractal** + tier |
+| `docs/architecture/` 技术基线 + 边界 | `docs/impl/global/overview/` + `docs/impl/<plane>/overview/` + `.../rules/` + `code-map.md` | **fractal** |
+| `docs/references/` 查阅 + code map + API/schema/兼容表 | `docs/impl/<plane>/reference/` 类目 + modeling `code-map.md` | **fractal** |
+| `docs/lessons/` durable 教训 | `codument/memory/`（lessons/incidents/patterns） | tier(memory) |
+| `docs/examples/` 示例 + 骨架 | 文档内示例→`docs/impl/<plane>/examples/`；工作文档骨架→`std/operations/plan-track.md` + `std/spec/track-xml-spec.md` 的内嵌示例 | **fractal** + std |
+| `docs/process/` 流程/规程 | `codument/sop/`（`std/sop/` 内置 + 顶层 `sop/` 自定义） | sop |
+| `docs/skills/` 可复用 prompt/playbook | `std/operations/`（操作）+ `std/sop/`（规程）+ attractor-check profile | std |
+
+**迭代 / 轨迹类（B/C 档）——收进 `tracks/`，归档后沉淀：**
+
+| AGE 类目 | codument 落点 |
+|---|---|
+| `docs/input/` 原始输入 | `tracks/<id>/`（proposal 前的原始材料）/ track 描述 |
+| `docs/discussions/` 澄清 | `tracks/<id>/`（discuss 记录）；协议见 `std/sop/questioning.md` |
+| `docs/requirements/` 可实现需求 | `tracks/<id>/proposal.md` + `behavior_deltas/` |
+| `docs/plans/` 执行与收口 | `track.xml`（TaskSpace/Schedule/Hooks） |
+| `docs/logs/` `docs/audits/` `docs/testing/` 证据 | `tracks/<id>/reports/` + `archive/` |
+| `docs/bugs/` `docs/retrospectives/` | 复发的进 `memory/`（incidents/patterns） |
+| `docs/backlog/` 候选工作 | `codument/backlog/README.md`（候选 + 自主度，活的清单，非 owner 真源） |
+| 跨 track roadmap / mission | `codument/missions/<id>/roadmap.md`（阶段路线 + 依赖 + 证据，非 owner 真源） |
+
+> 只有 `context`→`attractors/`、`lessons`→`memory/` 不靠 fractal 而靠 tier——因为它们跨领域、不属于某个 modeling/impl 平面。其余持久类都落在 fractal 类目里。
+
+## 4. 信息晋升阶梯（核心）
+
+信息从"临时"走向"长期"的固定路径。每一跳都有**触发条件**——满足才晋升，避免把临时噪音沉淀成真源，也避免让真理烂在 chat / track 里。
+
+```text
+外部输入 / 对话
+   │  [建 track / discuss 时，落文件]
+   ▼
+tracks/<id>/ ── proposal.md · design.md · discussion · behavior_deltas/ · track.xml · reports/
+   │
+   ├─[行为变更]──────────────▶ behaviors/      （归档必做：delta 应用进登记表）
+   │
+   ├─[稳定领域知识]──────────▶ docs/modeling/ + docs/impl/   ★ 要补强的弱环
+   │     触发：需求澄清后概念/对象/字段语义/生命周期/policy/workflow/架构已稳定
+   │     时机：discuss 期即可**实时**更新（不必等归档）；归档时兜底补齐
+   │
+   ├─[承重的一次性决策]──────▶ decisions/      （decision://）
+   │
+   └─[可复用教训 / gap 模式]──▶ memory/         （lessons/incidents/patterns）
+         │
+         └─[同类问题跨多 track 复发]──▶ 方法层：std/sop/ · std/operations/ · attractor-profile check · operation-hook · validation 守卫
+               （codument 版 "prose 教训 → 可复用方法 → 固化检查"；先 sop/prompt，再考虑固化为 check/hook）
+```
+
+## 5. 何时晋升（触发条件表）
+
+| 从 → 到 | 触发 |
+|---|---|
+| track → `docs/modeling`/`docs/impl` | 需求澄清后某概念/行为/policy/workflow/架构**稳定**，将成为后续迭代依赖的基线 → 收敛进 owner 文档，**不要只留在 proposal** |
+| track → `behaviors/` | 任何对外行为新增/变更（归档必做） |
+| track → `decisions/` | 一个原本一次性的取舍变成"以后都按这个来"的承重决策 |
+| track/复盘 → `memory/` | 出现可复用的教训、非显然的 incident、值得记住的 pattern |
+| `memory/` → 方法层(sop/skill/check) | **同一类问题反复出现**：先提炼为可复用 sop/prompt；若仍复发，再固化为 attractor-check profile / operation-hook / validation 守卫（按项目误报容忍度调优） |
+| 任意 → `migration-map` | owner 文档路径移动/拆分/合并/被吸收 |
+
+> 反向**不**晋升：被否决的方案、未稳定的猜测、纯过程噪音留在 track / `memory` 即可，不污染 owner 文档。
+
+## 6. 真源优先级（冲突时谁赢）
+
+| 问题 | 主真源 |
+|---|---|
+| 当前领域本体是什么 | `docs/modeling/`（canonical）；能力契约看 `behaviors/` |
+| 可执行真相（数据/接口/schema） | 源码 / 测试 / schema / config（owner 文档只解释意图） |
+| 本次 track 要建什么 | `tracks/<id>/proposal.md` + `behavior_deltas/` |
+| 本 track 怎么执行/收口 | `tracks/<id>/track.xml` |
+| 实现/运维怎么做 | `docs/impl/` |
+| 发生了什么 | `tracks/<id>/reports/` + `archive/` |
+| 长期必须为真 | `docs/modeling/` + `docs/impl/` + `behaviors/` + `decisions/` + `attractors/` |
+
+**冲突裁决**：可执行真源（源码/测试/schema）> owner 文档（需重新校验后才是吸引子）> track 局部 > chat。若解冲突会改变用户可见行为 / 数据形状 / 接口 / 权限 / 外部集成 → **停下确认**，并把冲突归类为 `实现漂移 | 文档漂移 | 有意的遗留行为` 写进 track 再动。
+
+## 7. 时效性
+
+- **稳定 owner 层**（attractors / docs/modeling / docs/impl / behaviors / decisions）：**就地更新**，不因内容变化就新建带日期副本；带受控 frontmatter（`last_verified`，schema 见 model-driven-docs.md）。
+- **迭代/轨迹层**（tracks / archive / reports）：带日期；归档后不可变。
+- **新鲜度模式**：owner 文档标 `stale|unknown` 时，进入研究/对齐优先——不直接拿可执行真相去"修"文档、也不拿陈旧文档去"改"代码，先把漂移归类记录。
+
+## 8. 路由
+
+- 文件级目录规范（modeling/impl 怎么写、frontmatter）：[model-driven-docs.md](./model-driven-docs.md) → [docs-modeling-fractal](@codument/std/docs-modeling-fractal/index.md) / [docs-impl-fractal](@codument/std/docs-impl-fractal/index.md)。
+- 每个标准文件夹"装什么"的自描述与补齐：[std/spec/folder-manifest.md](@codument/std/spec/folder-manifest.md)。
+- 晋升动作落在流程里：归档晋升见 `std/operations/archive-track.md`；docs 同步见 `std/operations/artifact-sync.md`；澄清期实时更新见 `std/sop/questioning.md`。

package/src/templates/codument/std/attractors/model-driven-docs.md

@@ -0,0 +1,293 @@
+# Docs Knowledge Attractor
+
+## 目的
+
+当 docs profile 启用时，本文件是项目知识维护的入口 attractor。
+
+文档系统由两套并列的分形标准组成：
+
+```text
+docs/modeling/  # 建模真源与派生建模
+docs/impl/      # 实现、操作、示例、参考、排障知识
+```
+
+创建或更新 docs 前，必须先阅读详细标准：
+
+- [docs-modeling-fractal/index.md](@codument/std/docs-modeling-fractal/index.md)：`docs/modeling/` 的规范标准。
+- [docs-impl-fractal/index.md](@codument/std/docs-impl-fractal/index.md)：`docs/impl/` 的规范标准。
+
+本文件只保留路由规则、通用元数据、track 同步检查清单。不要把具体建模文件模板或实现平面细则塞回本文件；这些内容应维护在两份分形标准中。
+
+> **上层语义**：一条信息该落 `docs/` 还是 track/behaviors/decisions/memory、何时从 track **晋升**进 owner 文档、冲突时谁是真源——见 [knowledge-tiers.md](./knowledge-tiers.md)。每个标准文件夹"装什么"由其 `index.md` 的**目录职责块**就地声明，规范与补齐见 [std/spec/folder-manifest.md](@codument/std/spec/folder-manifest.md)。
+
+## 真源边界
+
+保持这些真源互相分离：
+
+- `codument/behaviors/`：能力契约（行为）注册表，面向行为 case 与测试生成。
+- 源码、测试、配置：可执行真源。
+- `docs/modeling/`：规范化建模真源与派生建模。
+- `docs/impl/`：实现与运维知识。
+- `codument/decisions/`：从 track 局部决策中提升出的长期决策。
+- `codument/memory/`：长期 lessons、incidents、patterns、summaries。
+
+`docs/` 不应复制全部 behavior 或全部代码。它保存的是本体、心智模型、派生设计、实现指导、运维知识，以及让 AI 从知识进入代码的 code map。
+
+## 根结构
+
+默认根结构：
+
+```text
+docs/
+  index.md
+  migration-map.md
+  _assets/
+  modeling/
+  impl/
+```
+
+规则：
+
+- `docs/modeling/` 与 `docs/impl/` 是根层唯一两套正式知识系统。
+- `docs/migration-map.md` 是根级迁移台账，不是知识平面。
+- `docs/_assets/` 保存辅助资产，不是正式正文真源。
+- implementation plane 必须放在 `docs/impl/` 下。
+- modeling plane 必须放在 `docs/modeling/` 下。
+
+Good：
+
+```text
+docs/modeling/
+docs/impl/global/
+docs/impl/runtime/
+docs/impl/commands/
+```
+
+Bad：
+
+```text
+docs/modeling/
+docs/<global-implementation-knowledge>/
+docs/<implementation-plane>/
+```
+
+## 通用 Frontmatter（受控精简 schema）
+
+每份正式 Markdown 文档以 frontmatter 开头。**保持小而稳**——下面是唯一允许的字段集，不要再加数组型大字段。
+
+固定字段（每份文档都写）：
+
+```yaml
+---
+knowledge_plane: domain        # 平面名；docs/modeling|impl 已由路径表达 system，故不写 knowledge_system
+doc_role: canonical            # canonical|derived|guide|rules|howto|example|reference|troubleshooting|compat|legacy
+status: active                 # active|draft|compat|legacy|deprecated
+last_verified: YYYY-MM-DD       # 最后一次与源码/事实核对的日期
+---
+```
+
+条件字段（只在有意义时写，且**各最多一行**）：
+
+- `context:`：建模 context 名——**仅 modeling 文档**。
+- `derived_from:`：**只写一个**最近的 canonical 父来源——仅 derived 文档。**禁止堆成多行清单**。
+- `canonical_source:`：compat/legacy 文档指回的 canonical 来源。
+
+明确**不进 frontmatter**（这是当年 yaml 过重的根因）：
+
+- 代码路径 → 写 `code-map.md` 或正文（impl 正文可写）。
+- `code_paths` / `topics` 等数组、长 `derived_from` 清单 → 写正文；长来源关系用 `code-map.md` 承载。
+- 文档路径与 frontmatter 语义必须一致。
+
+## Modeling System
+
+`docs/modeling/` 包含所有建模平面。**递归规则同构，类目词汇随领域而变**：
+
+```text
+docs/modeling/<modeling-plane>/
+  index.md            # 只导航
+  glossary.md
+  contexts/
+    index.md
+    <context>/
+      index.md
+      code-map.md
+      <category>/     # 类目由该 plane 的建模视角决定，不是固定三件套
+```
+
+必需 plane：`domain`（canonical 本体）。其他 derived plane（`backend`、`surface`、`runtime`、`api`、`storage`、`pipeline`……）由项目按领域自定义。
+
+类目示例（**不是强制目录名**）：`domain` 常用 `objects/policies/workflows/`；`backend` 用 `routes/storage/contracts/...`；其他领域用 `sources/transforms/sinks` 等。
+
+如何为本领域选类目、各文件写法见 [docs-modeling-fractal/index.md](@codument/std/docs-modeling-fractal/index.md)。
+
+## Implementation System
+
+`docs/impl/` 包含所有实现平面。**递归规则同构，类目词汇可按领域替换**：
+
+```text
+docs/impl/<implementation-plane>/
+  index.md            # 只导航
+  <category>/         # 推荐默认六类，可领域自定义
+    <topic>/<leaf>.md
+```
+
+推荐 plane：`global`（跨 plane 实现知识）。其他 plane（`backend`、`surface`、`runtime`、`storage`、`pipelines`、`agents`、`operations`……）由项目自定义。
+
+推荐默认类目（**起点，非法律**）：`overview / howto / rules / examples / reference / troubleshooting`；领域不适配时可在 plane 第一层替换为自定义类目集。详见 [docs-impl-fractal/index.md](@codument/std/docs-impl-fractal/index.md)。
+
+## 同名文件夹演化
+
+主题较小时优先使用单文件。
+
+当出现以下情况时，升级为同名文件夹：
+
+- 单文件已经难以导航。
+- 出现多个稳定子主题。
+- 多人或多分支编辑频繁冲突。
+- AI 反复无法定位正确章节。
+- 一个文件混入了多个不相关关注点。
+
+演化方式：
+
+```text
+<name>.md
+-> <name>/index.md
+-> <name>/<subtopic>.md
+```
+
+规则：
+
+- 保留原概念名称。
+- 新的 `index.md` 只做导航。
+- 优先直接放子 `.md` 文件，不要过早增加更深目录。
+- 如果旧路径被引用过，更新局部链接与 `docs/migration-map.md`。
+- 不要为了结构好看拆分小文档。
+
+## Migration Map
+
+使用唯一根级迁移映射：
+
+```text
+docs/migration-map.md
+```
+
+模板：
+
+```markdown
+---
+knowledge_system: impl
+knowledge_plane: global
+doc_role: reference
+status: active
+last_verified: YYYY-MM-DD
+---
+
+# Documentation Migration Map
+
+| Old Path | New Path | Status | Notes |
+|----------|----------|--------|-------|
+```
+
+状态：
+
+- `migrated`：同职责迁移。
+- `absorbed`：有价值内容被吸收到新的 canonical/derived 文档。
+- `compat`：旧路径仍作为兼容说明保留。
+- `deprecated`：明确废弃。
+
+## Assets
+
+非正文辅助材料放入 `docs/_assets/`：
+
+```text
+docs/_assets/
+  sql/
+  scripts/
+  schemas/
+  ui/
+  data/
+```
+
+规则：
+
+- 正式知识保持 Markdown-first。
+- Markdown 文档解释 asset 的用途。
+- 除非 Markdown 文档明确引用，否则 AI 不应把原始资产当成 canonical prose。
+- `_assets/` 不构成第三套知识系统。
+
+## Track Knowledge Sync
+
+当 docs profile 启用时，每个 Codument track 都必须检查是否需要更新 docs。
+
+> **两个时机，别只在归档**：
+> - **澄清/实现期（实时）**：discuss 一旦把某概念/行为/policy/架构**澄清并稳定**，**当轮就**把它收敛进对应 owner 文档（`docs/modeling`/`docs/impl`），而不是只写进 proposal 等归档再补。这是 owner 文档保持新鲜的主路径。
+> - **归档期（兜底）**：`codument-archive-track` 按显式 hook 对该 track 全量复查、补齐遗漏（见 `std/operations/artifact-sync.md`）。
+>
+> 晋升判定（落 `docs/` 还是 behaviors/decisions/memory、何时晋升）见 [knowledge-tiers.md](./knowledge-tiers.md) §4–§5。
+
+以下变化应加入 docs sync 任务：
+
+- domain context、object、field semantics、lifecycle、status、invariant。
+- object behavior、command、query、mutation、side effect、failure semantics。
+- policy、guard、permission、validation、governance rule。
+- workflow 或 state transition。
+- derived modeling object、policy、workflow、contract、storage relation、read model、sync flow。
+- implementation architecture、framework convention、runtime convention、operations procedure。
+- 未来实现者必须理解的 public contract 或 user-visible behavior。
+- troubleshooting knowledge。
+- 文档路径移动、拆分、合并或吸收。
+
+每次 docs sync 应执行：
+
+1. 判断更新属于 `docs/modeling/` 还是 `docs/impl/`。
+2. 判断 plane。
+3. 判断 context 或 category。
+4. 判断 document role。
+5. 更新最小正确文档。
+6. 添加或维护 frontmatter。
+7. derived modeling docs 按需维护 `derived_from`。
+8. 仅在导航变化时更新 `index.md`。
+9. 代码入口或测试变化时更新 `code-map.md`。
+10. 路径移动或旧文档被吸收时更新 `migration-map.md`。
+11. **新建目录时**按 [folder-manifest.md](@codument/std/spec/folder-manifest.md) 写"目录职责"块（自定义类目目录必填）。
+12. 如果无需更新 docs，记录具体原因。
+
+## Routing Table
+
+> 下表用**默认类目词汇**（domain 用 objects/policies/workflows；impl 用六类）。换领域时按各 index.md 的"生成式步骤"替换类目名，路由逻辑不变。
+
+| Change Type | Target |
+|-------------|--------|
+| 新增 domain term | `docs/modeling/domain/glossary.md` |
+| 新增 modeling plane | `docs/modeling/<plane>/index.md` |
+| 新增 modeling context | `docs/modeling/<plane>/contexts/<context>/index.md` |
+| 新增 modeling object | `docs/modeling/<plane>/contexts/<context>/objects/<object>/data.md` |
+| 新增 object behavior | `docs/modeling/<plane>/contexts/<context>/objects/<object>/behavior.md` |
+| 跨对象 modeling rule | `docs/modeling/<plane>/contexts/<context>/policies/<policy>.md` |
+| 多步骤 modeling process | `docs/modeling/<plane>/contexts/<context>/workflows/<workflow>.md` |
+| 代码位置变化 | 最近的 `code-map.md` |
+| 跨 plane 实现架构 | `docs/impl/global/overview/<topic>.md` |
+| 跨 plane 实现规则 | `docs/impl/global/rules/<rule>.md` |
+| plane 实现总览 | `docs/impl/<plane>/overview/<topic>.md` |
+| 可重复实现任务 | `docs/impl/<plane>/howto/<operation>.md` |
+| plane 实现规则 | `docs/impl/<plane>/rules/<rule>.md` |
+| 示例 | `docs/impl/<plane>/examples/<example>.md` |
+| 查询表或映射 | `docs/impl/<plane>/reference/<reference>.md` |
+| 故障诊断 | `docs/impl/<plane>/troubleshooting/<issue>.md` |
+| 旧文档移动或吸收 | `docs/migration-map.md` |
+| 原始 SQL/script/schema/UI 材料 | `docs/_assets/...` 并由 Markdown 引用 |
+
+## Quality Checklist
+
+- [ ] 更新是否只属于 `docs/modeling/` 或 `docs/impl/` 其中之一？
+- [ ] plane 是否正确？
+- [ ] 路径是否符合该 plane 的分形语法？
+- [ ] frontmatter 是否与路径一致？
+- [ ] modeling docs 是否显式标明 context？
+- [ ] derived modeling docs 是否按需维护 `derived_from`？
+- [ ] modeling 是否使用 objects、policies、workflows，而不是临时分类？
+- [ ] impl 是否使用 overview、howto、rules、examples、reference、troubleshooting，而不是临时分类？
+- [ ] index 文件是否只承担导航职责？
+- [ ] 代码路径是否写在 `code-map.md` 或正文中，而不是 modeling frontmatter？
+- [ ] 路径移动时是否更新 `migration-map.md`？
+- [ ] 非正文资产是否放在 `_assets/`？

package/src/templates/codument/std/attractors/project-memory.md

@@ -0,0 +1,48 @@
+# Project Memory Attractor（std/attractors/project-memory.md）
+
+> 当 `memory` profile（`config/attractor-profiles.xml`）启用时，本文件定义**长期项目记忆**如何提升。它是 `memory/` tier 的吸引子，地位与 `model-driven-docs.md`（docs tier 吸引子）并列。分层与晋升总览见 [knowledge-tiers.md](./knowledge-tiers.md)。
+
+## 目的
+
+项目记忆**不替代** behaviors、docs、源码。它记录**跨 track 应当影响未来工作**的耐久教训。
+
+## 记忆类别
+
+- `lessons`：来自已完成 track 的可复用学习——约束、权衡、应指导未来实现的经验法则。
+- `incidents`：重要失败、回归、故障、迁移问题或调查记录，应当可被后来检索。
+- `patterns`：被验证的重复做法、协作协议、设计惯用法、校验实践。
+- `summaries`：跨多条记忆或一段已完成工作的周期性综合。
+
+## 提升规则
+
+只有当一条记忆**耐久到足以影响未来 track** 时才提升。
+
+Good：
+
+- 记录某迁移策略为何成功/失败。
+- 记录一个反复踩的坑及其暴露它的诊断信号。
+- 记录多个未来 track 应复用的稳定设计 pattern。
+- 证据积累足够后，对一批相关记忆做 summary。
+
+Bad：
+
+- 把普通任务日志拷进记忆。
+- 存本应在 behaviors/docs/源码/测试里的事实。
+- 建一个所有分支都要改的中心 `index.md`。
+- 把未解决的猜测当耐久教训提升。
+
+## 存储形态
+
+按分钟级、track-更新时间排序；**每条记忆目录自包含**，避免全局索引文件（跨分支/贡献者会冲突）：
+
+```text
+codument/memory/<category>/YYYY-MM/YYYY-MM-DD-HHmm-slug/
+```
+
+## 复发即固化（与 knowledge-tiers 阶梯衔接）
+
+`memory/` 里**同一类问题反复出现**时，不要停在 prose 记忆——按 [knowledge-tiers.md](./knowledge-tiers.md) §5 再向上固化为可复用方法：`std/sop/` 规程 / `std/operations/` / `attractor-profile` check / `operation-hook` / validation 守卫（按项目误报容忍度调优）。
+
+## 复查
+
+归档前检查该 track 是否产出耐久的 lessons/incidents/patterns/summaries。**没有就不要造记忆条目。**

package/src/templates/codument/std/docs-impl-fractal/index.md

@@ -0,0 +1,110 @@
+# Implementation / Engineering 分形标准
+
+> 本标准定义 legacy `docs/impl/` 的写作方式，并说明它如何迁移到新的 `codument/engineering/` XNL registry。它与 [docs-modeling-fractal](../docs-modeling-fractal/index.md) **用同一条递归规则**，区别只在「类目词汇」。
+>
+> 新项目长期工程知识优先写入 `codument/engineering/`；`docs/impl/` 可作为 legacy Markdown、展示层或迁移前兼容层。engineering registry 规范见 [engineering-registry.md](../spec/engineering-registry.md)。
+
+## 1. 一句话心法
+
+impl / engineering 树同样是递归的「知识节点」。**不变的是递归规则，可变的是每个 plane 选的类目词汇。**
+
+- **不变**：`plane → 类目 → 主题 → 叶子`；每层 `index` 只导航；一处真源、其余引用；本体不在这里，引用 `codument/modeling/` 或 `modeling://...`。
+- **可变**：有哪些 implementation plane；每个 plane 第一层用哪些类目。
+
+> engineering 与 modeling 的区别：modeling 装"结构真相"，engineering 装"如何实现、维护、排障"。两边都允许不同领域长出不同目录，不写死前后端。
+
+## 2. Plane 层
+
+新真源路径：`codument/engineering/<plane>/`。
+
+legacy Markdown 路径：`docs/impl/<plane>/`。
+
+- **`global`（推荐）**：跨 plane 的实现 / 维护知识（架构、框架约定、运维方法）。
+- **其他 plane（项目按领域命名）**：`backend`、`surface`、`runtime`、`storage`、`pipelines`、`agents`、`tools`、`operations`、`control-plane`、`data-plane`……
+- **本体不放这里**：domain ontology 属于 `codument/modeling/`；engineering 用 `modeling://...` 引用，不复制。
+
+每个 plane / 类目目录的 `index.md` 顶部带「目录职责」块（标准类目一行精简型，自定义类目完整型）——见 [folder-manifest.md](@codument/std/spec/folder-manifest.md)。
+
+## 3. 类目层 —— 类目在前、主题在后
+
+plane 第一层放**类目**，类目下放**主题**，主题下放叶子：
+
+```text
+codument/engineering/<plane>/<category>/<topic>.xnl
+docs/impl/<plane>/<category>/<topic>/<leaf>.md   # legacy / 展示层
+```
+
+### 推荐默认类目（强烈建议作为起点）
+
+对**大多数可维护系统**通用，先用这六类，缺哪类就不建：
+
+| 类目 | 装什么 | 何时读 |
+|------|--------|--------|
+| overview | 心智模型、架构、组成 | 需要建立方向感 |
+| howto | 可重复的维护操作（加接口、迁移、发布……） | 要动手改/维护 |
+| rules | 实现约束、约定、护栏 | 要避免越界 |
+| examples | worked example / 样例 | 要一个具体参照 |
+| reference | code map、API/schema/配置表、映射 | 要查表 |
+| troubleshooting | 故障模式、诊断、修复 | 要排障 |
+
+### 这只是默认，不是法律
+
+如果你的领域维护工作**不这样分解**，就在 plane 第一层换成你自己的类目集。**不变量是「类目在前、主题在后 + 每个类目语义单一」，不是这六个名字。** 例如：
+
+```text
+数据平台运维：  runbooks/  pipelines/  slas/  incidents/  dashboards/
+硬件 / 固件：    bringup/   drivers/   timing/  rma/        bench/
+```
+
+## 4. 叶子写作要点（按类目选自然小节）
+
+每个类目的叶子用对应小节即可，不强制统一模板：
+
+| 类目 | 建议小节 |
+|------|----------|
+| overview | Purpose · Mental Model · Main Components · Boundaries · Related Modeling/Impl Docs |
+| howto | When To Use · Preconditions · Steps · Verification · Rollback/Recovery · Related Rules |
+| rules | Rule · Applies To · Rationale · Examples · Enforcement · Exceptions · Related Modeling Docs |
+| examples | Scenario · Inputs · Walkthrough · Expected Output · Notes（大块原始数据放 `_assets/` 引用） |
+| reference | Scope · Table/Map · Source Of Truth · Update Procedure（生成物说明如何重生成/校验） |
+| troubleshooting | Symptoms · Likely Causes · Diagnosis · Fix · Prevention（长期 lesson 同步 project memory） |
+
+跨 plane 的 overview/rule 放 `codument/engineering/global/...`；过程中发现的规则沉淀到 `rules/` 并互链。
+
+## 5. Frontmatter（用受控精简 schema）
+
+字段集与含义在 [model-driven-docs.md](../attractors/model-driven-docs.md) 统一定义。impl 侧附加约定：
+
+- impl 文档**可在正文写代码路径**；frontmatter 保持稳定、低冲突，**不堆 `code_paths` / `topics` 数组**。
+- 实现规则**不复制** modeling policy——链接到 `docs/modeling/<plane>/contexts/<ctx>/policies/...`，本文件只写 enforcement。
+
+## 6. 在你自己的领域长出一个新 impl plane（生成式步骤）
+
+1. **定边界**：它覆盖哪个实现领域、不拥有什么（写进 plane `index.md` 的 Boundary / Not Owned Here）。
+2. **选类目集**：默认六类，或换成领域自定义类目集。
+3. **建骨架**：`index.md`(导航) + 各类目目录；类目→主题→叶子，叶子先单文件，太大再升级同名文件夹。**每个类目目录给其 `index.md` 写「目录职责」块**（自定义类目必填，见 [folder-manifest.md](@codument/std/spec/folder-manifest.md)）。
+4. **连真源**：规则/流程若依赖建模真源，链接到 `docs/modeling/.../{policies,workflows}/`，不复制。
+
+## 7. 反模式
+
+❌ plane 第一层混用「主题」和「类目」：
+
+```text
+docs/impl/runtime/{ architecture/  howto/  state/  rules/ }   # architecture/state 是主题不是类目
+```
+
+✅ 类目在前、主题在后：
+
+```text
+docs/impl/runtime/{ overview/  howto/  rules/  examples/  reference/  troubleshooting/ }
+                     └ overview/architecture/…   └ overview/state/…
+```
+
+❌ impl 复制 canonical modeling 真源：
+
+```text
+docs/modeling/domain/contexts/identity/policies/token-lifecycle.md   # 真源
+docs/impl/runtime/rules/token-lifecycle.md                            # 复制 → 错
+```
+
+✅ impl rule 引用 modeling policy，只描述本 plane 的 enforcement。