FinClaw V1 Sub-Packet: 工程仓库旧 docs 标 deprecated
状态：Pending 日期：2026-05-16 Lane：Engineering / Docs Owner：Engineering Agent A Parent Packet：v1-engineering-implementation-task-packet.md 对齐 Action Item：AL-10
1. 目标
按 v1-governance-engineering-alignment.md §8 与 D-10 决策，在工程仓库 fin-claw/docs/design/01..09-*.md 9 份旧设计文档每个首行加 deprecated 标记，并提供清晰的替代指引（指向治理库 V1 docs）。
注意：D-10 已决议不迁移这些旧 docs 到新工程仓库 /Users/mlabs/Programs/CurvatureLabs/finclaw/；本 sub-packet 仅在旧仓库 /Users/mlabs/Programs/fin-claw/ 内执行（保留只读对照参考）。
2. 允许读取
见 frontmatter must_read / reference_only。
3. 禁止范围
- 不删除旧 docs（D-10 保留旧仓库主分支演进权）；
- 不在旧 docs 中重写产品定义；
- 不把旧 docs 链接到新工程仓库
CurvatureLabs/finclaw/（避免读者误以为 CurvatureLabs 仓库继承旧 docs）； - 不在 deprecated 标记中暴露内部决策（D-XX 编号可引用，但不展开决策细节）。
4. Acceptance Criteria
| AC ID | 验收项 |
|---|---|
| AC-1 | 旧仓库 fin-claw/docs/design/01..09-*.md 全 9 份首行加 > DEPRECATED: see governance v1 docs |
| AC-2 | 每个 deprecated 标记后跟 1 行替代指引（如 > 替代位置: projects/finclaw/design/v1/v1-product-object-and-schema-design.md） |
| AC-3 | 新增 fin-claw/docs/design/README.md：列出 9 份旧 docs + 替代治理库路径表 |
| AC-4 | fin-claw/docs/README.md 顶部加 1 段说明：本 docs 目录已停止维护，权威设计在治理库；含治理库 entry 链接 |
| AC-5 | fin-claw/README.md 顶部加治理库链接（v1-prd.md + v1-governance-engineering-alignment.md） |
| AC-6 | v1-governance-engineering-alignment.md §8 状态由「待决定」→「completed: deprecated marker added」 |
5. 回写位置
- 旧工程仓库
fin-claw（feature branchfeature/deprecate-old-docs）； - v1-governance-engineering-alignment.md §8 / §9.AL-10 状态刷新；
- Hand-off anchor →
handoff-anchors/v1-eng-impl-sub-8-deprecate-old-docs.yaml； - 不解除任何下游依赖（本 sub-packet 是清理类，独立）。
6. 风险与裁决项
- 风险 R-1：旧仓库团队成员仍在按 docs/design 改代码 → deprecated 标记必须包含「请勿基于本 docs 进行新设计」的明确指令；
- 裁决项 J-1：是否同时归档旧 docs 到
archive/目录由项目发起人决定；本 sub-packet 默认不归档（D-10 保留主分支演进）。
7. 与其他 Sub-Packet 的关系
- 独立运行；
- 与 sub-1 ~ sub-7 无文件冲突（sub-1 ~ sub-7 工作在
CurvatureLabs/finclaw/新仓库；本 sub-packet 工作在旧fin-claw/）； - 注意：执行 Agent 必须在正确的 worktree 中操作（旧仓库），不要把 deprecated 标记加到新仓库。