Skip to content

[P2][blocked] 文档:docs/archives 外迁 TokenDance 归档仓后删除 #1762

Description

@DeliciousBuding

背景

docs/archives/ 14 文件 3.3K LOC(analysis/plan/handoff/branch-hygiene),每个文件头部都已标注 pending external archive — see docs/history.mddocs/history.md:58 明令:

Do not recreate docs/archive/, docs/archives/, or docs/adr/ in AgentHub. Add new historical material to the external TokenDance docs archive and update this index.

AGENTS.md §8 也规定"过时长期文档…外迁规则见 docs/history.md"。即:方向已定(外迁后删),只是外部归档尚未落地

方案

  1. 把 14 个文件迁到外部 TokenDance docs 归档仓的 archive/agenthub/repo/docs/archives/ 路径(与 history.md 映射表一致)。
  2. 确认外部副本可访问后,删除本仓 docs/archives/
  3. 更新 docs/history.md 映射表与 docs/README.md 链接,指向外部归档。
  4. scripts/verify/verify-doc-ssot.py 的 archives 豁免规则保留(line 46/435),无需改。

依赖 / 阻塞

  • 阻塞于外部 TokenDance docs 归档仓的写权限/就位。本仓内无法独立完成外迁。
  • 在外部归档就位前,不得删除本仓副本(否则丢失唯一拷贝)。

风险

  • 低(纯文档),但误删未外迁的文件 = 数据丢失。必须先确认外部副本。

验收

  • 14 个文件在外部归档仓可访问
  • 本仓 docs/archives/ 已删除
  • history.md / README.md 链接更新为外部路径
  • scripts/verify/verify-doc-ssot.py 通过

Metadata

Metadata

Assignees

No one assigned

    Labels

    P2Medium priorityblocked:replanBlocked pending spec-driven replan or rescopedocumentationImprovements or additions to documentationlane-CParallel lane C

    Type

    No type

    Projects

    No projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions