# Prompt: 历史文档归拢 + 激进 prune（交 Codex 执行 · Claude 复核）

- **日期**：2026-07-23
- **分工（PROJECT_MAP §6）**：Claude 出本 prompt + 复核；Codex 执行；Owner 审本 prompt 后才交 Codex。
- **STOP 约定**：Codex 执行完 STOP，列出改动 + 未验证项，等 Owner/Claude 复核。**不要 push。**

## ⚙️ 执行环境（2026-07-23 补 · 防上次「跑了没落地」重演）
- **工作树（唯一）**：`/Users/nancy/Documents/AICoding/VS_Code/tvu-design-system`，分支 `master`。所有 `git mv`/`git rm`/commit **必须在此路径执行并 commit 到本工作树**。上一轮执行结果未出现在此工作树（HEAD 仍 `061110aa`，无任何 commit 触碰 `docs/_archive/`，reflog/stash/dangling 均无）——极可能跑在错 cwd 或一次性沙箱、未持久化。**执行前先 `pwd` 确认在上述路径，执行后 `git log --oneline -2` 自证 commit 已落本工作树。**
- **Claude 已对活仓预验（勿再当未知量）**：KEEP-LIVE 6 项全在位；DELETE 精确 = **25**（6 明列非 md + 19 个 `_plans`/`_plans/_archive` 下 `next-session-pickup*`/`new-session-prompt*`/`session-plan-2026-07-16*`）；ARCHIVE ≈ 81–83。DELETE guard（==25）成立，可正常执行不会卡。

## 目的
Owner 在瘦身仓库、根治「AI 读错」。历史文档从**活文档树**移走 → 归拢进 `docs/_archive/`（保留子路径结构）；低价值一次性件直接 `git rm`（git 可找回，故删得动手）；描述**当前架构契约**的文档保留。力度 = **激进 prune**。前置 slim（commit `caa5b755`）已完成并 push。

## 硬约束
- 只动下面明列的文件。**DO NOT TOUCH** 清单里的东西绝对不碰。
- `git mv` 用于 ARCHIVE、`git rm` 用于 DELETE；**保留子路径结构**（`docs/_archive/retrospection/…`、`docs/_archive/_reports/…` 等），使归档件之间的相对链接不失效。
- 每个 DELETE 文件删前 `rg -F "<basename>"` 复核入站引用；命中活文档/脚本的**先报告、别删**。
- 不 push；commit message 英文；干净原子（建议 2 个 commit：一个 archive-move，一个 delete + link-fix）。
- 完成后 STOP。

## A. KEEP-LIVE（6 项，**留原地，不移不删**）
1. `docs/internal/retrospection/design-spec-canonical-alignment-tracker.md` — 排期 living 真源，被 AGENTS.md/`scripts/new-backlog.mjs`/`figma-sync/audit-translation-completeness.mjs`/meta-rules/STATUS/WRAP-UP/PROJECT_GOAL 引用。**misfiled 在 retrospection/ 但本轮不迁**（迁移需改 7 处含 2 个脚本的引用，风险高，另议）。archive 扫描时**排除它**。
2. `docs/internal/_metrics/phase0-ledger.md` — 现役 append-only 账本，`skills/tvu-design-{code,mockup}` 每任务读写。
3. `docs/internal/_plans/README.md` — `_plans/` 活归档约定。
4. `docs/internal/_design-kickoffs/.gitkeep` — 保活 `pnpm design:kickoff` 目录。
5. `docs/superpowers/specs/2026-07-22-ds-rule-consumption-design.md` — L3 `.ds-sync` driver patch 的 SoT（`.design-sync/NOTES.md:133` 依赖）。
6. `docs/superpowers/specs/2026-07-23-ds-rule-consumption-L5-enforcement-design.md` — 活代码 `src/tokens/variables.css:456` 引它做 element base layer provenance。

## B. DELETE（25 项，`git rm`，可找回）
全是低价值一次性流程件 / 派生产物 / 陈旧证据，无一描述架构契约。

**精确非 md（6）**：
- `docs/internal/retrospection/2026-05-13-r7-test-evidence/figma-truth-reference.png`
- `docs/internal/retrospection/2026-05-13-r7-test-evidence/v1-broken.png`
- `docs/internal/retrospection/2026-05-13-r7-test-evidence/v3-close-loop.png`
- `docs/internal/_reports/consumer-verify-0.8.0-dark.png`
- `docs/internal/_reports/consumer-verify-0.8.0-light.png`
- `docs/internal/_reports/2026-07-16-platform-analysis-dashboard.html`（其 `.md` 源保留→归 ARCHIVE）

**按规则（session 一次性件，共 19）**：`docs/internal/_plans/` 及 `_plans/_archive/` 下所有 `next-session-pickup*.md`、`new-session-prompt*.md`、`session-plan-2026-07-16*.md`。
→ **Codex：先 enumerate 这些 pattern 的精确文件列表，加上上面 6 个，确认 DELETE 总数 = 25。若 ≠ 25，STOP 报告差异,别删。**

## C. ARCHIVE（其余约 83 项 → `git mv` 到 `docs/_archive/`，保留子路径）
扫描以下目录，**移动除 A/B 之外的全部文件**到 `docs/_archive/<原子路径>`：
- `docs/internal/retrospection/**`（排除 A#1 与 B 的 3 png）
- `docs/internal/_reports/**`（排除 B 的 3 项）
- `docs/internal/_plans/**` 及 `_plans/_archive/**`（排除 A#3 README 与 B 的 19 项）
- `docs/internal/_metrics/**`（排除 A#2）→ 实际只剩 A#2，故此目录不移
- `docs/internal/_design-kickoffs/**`（排除 A#4 .gitkeep）
- `docs/internal/_archive/**`（`translation-md-pre-schema/axis-implementation-map.md` 等）
- 仅这两个 superpowers 文件：`docs/superpowers/plans/2026-07-22-ds-rule-consumption.md`、`docs/superpowers/plans/2026-07-23-ds-rule-consumption-L5-enforcement.md`

## D. 链接修复（archive 移动后）
`rg` 出**从 KEEP-LIVE 文档 + 根/活文档**（`docs/STATUS.md`、`docs/internal/STATUS-CHANGELOG.md`、`AGENTS.md`、`docs/PROJECT_GOAL.md`、`docs/V1_RELEASE_CHECKLIST.md`、`docs/meta-rules.md`、`docs/working-principles.md`、`docs/internal/{mockup,code}-conventions.md`）指向**被移动/删除文件**的 markdown 链接：
- 指向 ARCHIVE 文件 → 更新为新 `docs/_archive/…` 路径。
- 指向 DELETE 文件 → 就地加一句 `（原始件已于 2026-07-23 瘦身删除，git 历史可查）`，去掉死链。
- archive-to-archive 之间的相对链接因保留结构应仍有效；无需逐一改。
- 修不干净的 STOP 报告，别硬猜。

## DO NOT TOUCH（明确排除，防误扫）
- `docs/superpowers/plans/2026-07-23-ds-merge-two-systems.md`（活：合并计划）
- `docs/superpowers/plans/2026-07-23-repo-slim-execution-brief.md`（已执行的 slim brief）
- 本文件 `docs/internal/_prompts/2026-07-23-history-archive-prune.prompt.md` 及 `docs/internal/_prompts/**` 整个目录
- C 未点名的其余 `docs/superpowers/**`
- 任何 `src/`、`figma-data/`、`figma-sync/`、`scripts/`、`.design-sync/`、`.ds-sync/`、`package.json`、导出管道/gate

## E. 借线降级候选（**默认留 ARCHIVE，Owner 可另行批准降 DELETE**，Codex 本轮不删）
- `docs/internal/_reports/overnight-2026-05-09-summary.md`（raw run dump）
- `docs/internal/_reports/2026-07-10-{composition-contract-publish-scoping,design-net-gapA-scoping,f57-noncolor-token-eval,f58-rule-tiering-scoping}.md`（F55/F57/F58 scoping，F55 已 ship）
- `docs/internal/_design-kickoffs/{skip-release-to-be-published,v4-1827-ndi-into-ipsource}.md`（可由命令再生）
- `docs/internal/_plans/{t2-sample-generator-output-schema.draft,t2-sample-grid-contract.draft}.md`（已被实现取代）

## Claude 复核清单（Codex 执行后）
- [ ] `git diff --stat` + `--name-status`：仅 A 未动、B 全删(25)、C 全移到 `docs/_archive/`、D 链接改动；无越界。
- [ ] DELETE 总数 == 25;KEEP-LIVE 6 项原地未动。
- [ ] `pnpm build` + `node scripts/export-claude-design-bundle.mjs --no-zip` 干跑仍通过(确认没移/删到管道依赖)。
- [ ] `rg` KEEP-LIVE + 活文档无指向已删/已移旧路径的死链。
- [ ] `docs/_archive/` 子路径结构完整,归档件互链未失效抽查。
