docs(archive): 归档机制说明（判定标准/SOP/债务滚动/只读约束）

Author: Aparencia

docs/archive/README.md

@@ -0,0 +1,66 @@
+# 文档归档机制
+
+> 唯一权威入口：归档判定标准、日收工 SOP、技术债滚动规则、只读约束。
+> 关联：[文档编写规范](../standards/documentation.md)、[技术债务管理](../standards/tech-debt.md)、[归档模板](../templates/archive-template.md)。
+
+## 目的
+
+为已实施完成的文档提供"生命终态"去向：按天快照（`YYYY-MM-DD` 子文件夹）、git mv 保留历史、不可变可追溯。
+
+## 目录结构
+
+```
+docs/archive/
+├── README.md            # 本说明 + 归档日期索引
+├── 2026-08-10/          # 某日归档
+│   ├── README.md        # 当日索引：归档清单 + 债务摘要
+│   ├── tech-debt.md     # 当日权威债务清单（滚动）
+│   └── ...已实施文档快照
+```
+
+## 归档对象判定
+
+**可归档（生命终态）**：已落地实施的方案/设计文档、已验收的实施文档、已验证的知识卡（索引标 `[ ] 已归档`）、被取代的 ADR、已发布版本的规划文档、已执行的 spec/plan。
+
+**不归档（持续活跃）**：standards/、templates/、knowledge/index.md、当前生效 ADR、CHANGELOG、README、versions/ 内容（按版本粒度独立沉淀，与本品并行不重叠）。
+
+**判定核心**：内容已实施完成、不再需要活跃维护 → 归档。归档时同步更新活跃区索引。
+
+## 日收工归档 SOP（每个工作日，< 15 分钟）
+
+1. **整理昨日债务**：读 `docs/archive/<昨日>/tech-debt.md`，逐条核对（代码/提交验证）：已偿 → closed（注偿还提交）；未偿 → 继承为 carried
+2. **识别今日新债务**：扫描今日提交中的 TODO/FIXME/HACK、妥协方案 → 登记 open
+3. **筛选今日已实施文档**：`git log --since=<今日>` 筛 docs 变更 → 按判定标准 → 先确认待归档文档已入库（git 跟踪）再 `git mv` 入今日归档夹（保留历史链）
+4. **写当日 README**：归档清单 + 债务摘要
+5. **更新活跃区索引**：链接改指归档路径 + 标 `[ ] 已归档`
+6. **原子提交**：`docs(archive): archive YYYY-MM-DD`；add 时列出归档夹与涉及文件，禁止 `-A` 目录级 add 波及未跟踪文件
+
+首次归档（基线）无昨日清单可整理，跳过第 1 步。
+
+## 技术债滚动规则
+
+- 任何时刻，债务状态以**最新一日**归档的 `tech-debt.md` 为唯一权威；旧归档仅历史追溯
+- 昨日未偿债务今日保留为 `carried`（只写 ID + 一行摘要，表格列类型/优先级/来源归档照抄首次登记值，全文以首次登记日为准）
+- 无新增债务的归档日，仍须继承昨日清单（"最新归档必有权威清单"）
+- 编号沿用 TD-XXX，类型沿用四类分类（有意/无意/环境变化/腐化），字段：`来源归档`、`状态`（open/carried/closed）
+
+## 只读约束
+
+| 约束 | 保证 |
+|------|------|
+| 技术债只认最新归档 | 上方滚动规则 |
+| 旧归档仅可阅读已达成内容 | 除最新一日外禁止修改归档文件；归档与提交原子化，git 历史可审计 |
+| 时间戳命名 | `YYYY-MM-DD`；空白日不建夹 |
+
+## 首次基线执行备忘（2026-08-10）
+
+基线归档首次执行发现两处偏差，机制条款已同步防再犯：
+
+- 3 份计划文档（biolum 设计/实施、机制实施计划）归档前未入库，`git mv` 退化为普通移动、无法保留历史 → 已按 A-1 补充"先入库再 mv"
+- `git add -A docs/superpowers` 将 2 份 08-07 计划（deepsea-life-elements-design、payment-phase1）连带入库，位置未变但混入归档提交 → 已按 A-2 补充"精确 add"
+
+## 归档索引
+
+| 归档日期 | 内容摘要 | 未偿债务 |
+|----------|---------|----------|
+| 2026-08-10 | 基线归档：性能优化/笔记创新/生物发光实施文档 + biolum 设计实施计划 + 本机制 spec | 1（TD-001） |