FinClaw 文档 IA 深度审查包

日期：2026-05-15
Controller：FinClaw Controller
权威条款：R4 控制包
状态：Proposed / audit only — 不改任何正文

§1 当前目录树

FinClaw 在 Gov 中的完整目录树（56 个文件，合计约 9 251 行）。

projects/finclaw/
├── README.md                                              (102 行)
├── strategic-whitepaper.md                                (420 行)
├── product-definition.md                                  (719 行)
├── mvp-product-definition.md                              (646 行)
├── design/
│   ├── foundation/
│   │   ├── product-object-and-advisor-design.md           (209 行)
│   │   └── terminology-and-object-naming.md               (58 行)
│   ├── v1/
│   │   ├── v1-design-kickoff-packet.md                    (343 行)
│   │   ├── v1-prd.md                                      (485 行)
│   │   ├── v1-collaboration-and-task-packet-plan.md       (162 行)
│   │   ├── v1-user-journey-and-interaction-flow.md        (329 行)
│   │   ├── v1-product-object-and-schema-design.md         (365 行)
│   │   ├── v1-ui-ux-interaction-design.md                 (220 行)
│   │   ├── v1-agent-orchestration-design.md               (185 行)
│   │   ├── v1-evaluation-initial-plan.md                  (241 行)
│   │   ├── v1-evaluation-review-and-acceptance-plan.md    (153 行)
│   │   └── v1-trial-operations-plan.md                    (192 行)
│   └── task-packets/
│       ├── v1-user-journey-interaction-flow-task-packet.md       (77 行)
│       └── v1-product-object-schema-design-task-packet.md       (78 行)
└── reference-experience/
    ├── README.md                                          (35 行)
    ├── aifinlab-finclaw-evaluation.md                     (177 行)
    ├── aifinlab-skill-layer-evaluation.md                 (506 行)
    ├── aifinlab-team-alignment-brief.md                   (81 行)
    ├── aifinlab-personal-domain-review-checklist.md       (107 行)
    ├── external-evaluation-repositories-synthesis.md      (54 行)
    ├── fin-chelae-finclaw-evaluation.md                   (148 行)
    ├── finrobot-evaluation.md                             (198 行)
    └── martinpmm-finclaw-evaluation.md                    (153 行)

references/finclaw/
├── external-reference-candidate-scan.md                   (99 行)
├── aifinlab-finclaw-analysis.md                           (237 行)
├── fin-chelae-finclaw-analysis.md                         (268 行)
└── martinpmm-finclaw-analysis.md                          (280 行)

evaluation/finclaw/
├── README.md                                              (55 行)
├── case-library.md                                        (684 行)
├── case-schema.md                                         (375 行)
├── cases/
│   ├── README.md                                          (仅目录，行数未单独统计)
│   ├── crypto-asset-snapshot-colloquial.yaml              (118 行)
│   ├── crypto-event-narrative-understanding.yaml          (108 行)
│   ├── crypto-thesis-risk-controversy.yaml                (109 行)
│   ├── evidence-degradation-source-uncertainty.yaml       (106 行)
│   ├── snapshot-to-watch-questions.yaml                   (108 行)
│   └── strategy-hypothesis-pre-execution-checkpoint.yaml  (110 行)
├── reports/
│   ├── README.md                                          (9 行)
│   └── first-batch-reference-cross-analysis.md            (210 行)
├── runs/
│   └── README.md                                          (5 行)
└── seeds/
    ├── README.md                                          (61 行)
    └── market-cognition-snapshot/
        ├── types.ts
        ├── example-btc.json
        ├── prompt-template.md
        └── eval-case.yaml

source/project-prealignment/finclaw/
├── source-note-finclaw-whitepaper-v0.1.md                 (72 行)
├── gap-mapping-finclaw-whitepaper-v0.1.md                 (185 行)
└── product-definition-supplement.md                       (224 行)

controllers/finclaw/
├── state.md                                               (94 行)
└── checkpoints/
    ├── 2026-05-13-current-session-recovery.md             (72 行)
    ├── 2026-05-13-admin-batch4-pickup.md                  (84 行)
    └── 2026-05-14-controller-rewrite-dispatch-pickup.md   (157 行)

packets/sync/ (FinClaw 相关)
├── finclaw-program-controller-handoff-2026-05-09.md       (143 行)
├── finclaw-mvp-engineering-alignment-2026-05-09.md        (144 行)
├── finclaw-evaluation-to-product-translation-batch-1.md   (225 行)
├── finclaw-case-library-adapter-upgrade-handoff.md        (47 行)
├── labs-fintecai-finclaw-project-doc-audit-2026-05-14.md  (149 行)
└── labs-fintecai-finclaw-canonical-reader-surface-proposal-2026-05-15.md (157 行)

另有游离路径：

controllers/finclaw-reviewer/
└── checkpoints/
    └── 2026-05-13-current-session-recovery.md             (66 行)

§2 文件角色标签

projects/finclaw/

文件	角色
`README.md`	`support / project-hub` — 项目 thin entry，角色路由
`strategic-whitepaper.md`	`canonical / strategy`
`product-definition.md`	`canonical / product-definition`
`mvp-product-definition.md`	`canonical / mvp-definition`
`design/foundation/product-object-and-advisor-design.md`	`support / design-baseline`
`design/foundation/terminology-and-object-naming.md`	`support / terminology-baseline`
`design/v1/v1-design-kickoff-packet.md`	`support / design-control`
`design/v1/v1-prd.md`	`support / prd-draft`
`design/v1/v1-collaboration-and-task-packet-plan.md`	`support / collaboration-plan`
`design/v1/v1-user-journey-and-interaction-flow.md`	`support / design-output`
`design/v1/v1-product-object-and-schema-design.md`	`support / design-output`
`design/v1/v1-ui-ux-interaction-design.md`	`support / design-output`
`design/v1/v1-agent-orchestration-design.md`	`support / design-output`
`design/v1/v1-evaluation-initial-plan.md`	`support / design-output`
`design/v1/v1-evaluation-review-and-acceptance-plan.md`	`support / design-output`
`design/v1/v1-trial-operations-plan.md`	`support / design-output`
`design/task-packets/v1-user-journey-interaction-flow-task-packet.md`	`support / task-packet`
`design/task-packets/v1-product-object-schema-design-task-packet.md`	`support / task-packet`
`reference-experience/README.md`	`evidence / reference-experience-hub`
`reference-experience/aifinlab-finclaw-evaluation.md`	`evidence / reference-evaluation`
`reference-experience/aifinlab-skill-layer-evaluation.md`	`evidence / reference-evaluation`
`reference-experience/aifinlab-team-alignment-brief.md`	`evidence / collaboration-material`
`reference-experience/aifinlab-personal-domain-review-checklist.md`	`evidence / review-checklist`
`reference-experience/external-evaluation-repositories-synthesis.md`	`evidence / reference-evaluation`
`reference-experience/fin-chelae-finclaw-evaluation.md`	`evidence / reference-evaluation`
`reference-experience/finrobot-evaluation.md`	`evidence / reference-evaluation`
`reference-experience/martinpmm-finclaw-evaluation.md`	`evidence / reference-evaluation`

references/finclaw/

文件	角色
`external-reference-candidate-scan.md`	`reference / candidate-scan`
`aifinlab-finclaw-analysis.md`	`reference / reference-analysis` (desk research)
`fin-chelae-finclaw-analysis.md`	`reference / reference-analysis`
`martinpmm-finclaw-analysis.md`	`reference / reference-analysis`

evaluation/finclaw/

文件	角色
`README.md`	`evaluation / eval-hub`
`case-library.md`	`evaluation / case-library`
`case-schema.md`	`evaluation / case-schema`
`cases/README.md`	`evaluation / cases-index`
`cases/*.yaml` (6 个)	`evaluation / eval-case`
`reports/README.md`	`evaluation / reports-index`
`reports/first-batch-reference-cross-analysis.md`	`evaluation / report`
`runs/README.md`	`evaluation / runs-index` (near-empty placeholder)
`seeds/README.md`	`evaluation / engineering-seeds-hub`
`seeds/market-cognition-snapshot/*`	`evaluation / engineering-seed`

source/project-prealignment/finclaw/

文件	角色
`source-note-finclaw-whitepaper-v0.1.md`	`source / source-note`
`gap-mapping-finclaw-whitepaper-v0.1.md`	`source / gap-mapping`
`product-definition-supplement.md`	`source / supplement`

controllers/finclaw/

文件	角色
`state.md`	`controller-state`
`checkpoints/2026-05-13-current-session-recovery.md`	`controller-state / checkpoint`
`checkpoints/2026-05-13-admin-batch4-pickup.md`	`controller-state / checkpoint`
`checkpoints/2026-05-14-controller-rewrite-dispatch-pickup.md`	`controller-state / checkpoint`

packets/sync/ (FinClaw)

文件	角色
`finclaw-program-controller-handoff-2026-05-09.md`	`sync`
`finclaw-mvp-engineering-alignment-2026-05-09.md`	`sync`
`finclaw-evaluation-to-product-translation-batch-1.md`	`sync`
`finclaw-case-library-adapter-upgrade-handoff.md`	`sync`
`labs-fintecai-finclaw-project-doc-audit-2026-05-14.md`	`sync`
`labs-fintecai-finclaw-canonical-reader-surface-proposal-2026-05-15.md`	`sync`

游离文件

文件	角色
`controllers/finclaw-reviewer/checkpoints/2026-05-13-current-session-recovery.md`	`controller-state / checkpoint` (orphan — 不在 registry)

§3 命名问题清单

N-1 packet 前缀不一致

问题：同为 FinClaw 项目的 sync packet，较早期使用 finclaw-* 前缀，较新的使用 labs-fintecai-finclaw-* 前缀。

当前文件名	前缀
`finclaw-program-controller-handoff-2026-05-09.md`	`finclaw-`
`finclaw-mvp-engineering-alignment-2026-05-09.md`	`finclaw-`
`finclaw-evaluation-to-product-translation-batch-1.md`	`finclaw-`
`finclaw-case-library-adapter-upgrade-handoff.md`	`finclaw-`
`labs-fintecai-finclaw-project-doc-audit-2026-05-14.md`	`labs-fintecai-finclaw-`
`labs-fintecai-finclaw-canonical-reader-surface-proposal-2026-05-15.md`	`labs-fintecai-finclaw-`

规范推断：document-change-scope-policy.md §3 规定 FinClaw 的 sync 路径为 packets/sync/finclaw-*。labs-fintecai-finclaw-* 前缀实际上是 Admin-owned 的跨 Controller 审计包，而非 Controller-owned 的项目 sync。两种前缀语义不同但未显式说明。

建议：

FinClaw Controller-owned 的 sync packet 保持 finclaw-* 前缀。
Admin-owned 的审计/分发包保持 labs-fintecai-finclaw-* 前缀，视为 Admin scope 而非 FinClaw scope。
若 Admin 决定统一前缀，应在 R4 或后续 batch 中全库仲裁。
当前不 rename。

N-2 两个 packet 缺日期后缀

文件名	问题
`finclaw-evaluation-to-product-translation-batch-1.md`	缺日期后缀
`finclaw-case-library-adapter-upgrade-handoff.md`	缺日期后缀

已执行新名：

finclaw-evaluation-to-product-translation-batch-1.md → finclaw-evaluation-to-product-translation-batch-1-2026-05-12.md
finclaw-case-library-adapter-upgrade-handoff.md → finclaw-case-library-adapter-upgrade-handoff-2026-05-11.md

影响：docs-manifest.json sync_paths、sidebars.js。

N-3 source 文件版本号含点号

文件名	问题
`source-note-finclaw-whitepaper-v0.1.md`	`v0.1` 含 `.`，违反 kebab-case
`gap-mapping-finclaw-whitepaper-v0.1.md`	同上

建议新名：

source-note-finclaw-whitepaper-v0-1.md
gap-mapping-finclaw-whitepaper-v0-1.md

影响：sidebars.js、strategic-whitepaper.md Changelog 中的 source_refs 引用。

N-4 task-packet 与 v1 design 文件名对象名不一致（`and` 缺失）

task-packet 文件名	对应 v1 design 文件名	差异
`v1-user-journey-interaction-flow-task-packet.md`	`v1-user-journey-and-interaction-flow.md`	task-packet 缺 `and`
`v1-product-object-schema-design-task-packet.md`	`v1-product-object-and-schema-design.md`	task-packet 缺 `and`

R4 §4："跨目录指向同一对象时，对象名严格一致（含是否带 and、连字符位置）"。

建议新名：

v1-user-journey-and-interaction-flow-task-packet.md
v1-product-object-and-schema-design-task-packet.md

影响：docs-manifest.json design_support_paths、sidebars.js、v1-collaboration-and-task-packet-plan.md 内链、v1-design-kickoff-packet.md 内链。

N-5 v1-evaluation 系列后缀不规范

文件名	问题
`v1-evaluation-initial-plan.md`	后缀 `-initial-plan` 不在 R4 §4 标准后缀集
`v1-evaluation-review-and-acceptance-plan.md`	后缀 `-plan` 合规，但与上文形成不必要歧义

建议：

若两份文件分工为"初步方案"和"复核验收方案"，可保持语义后缀，但应统一：v1-evaluation-plan.md（初步）+ v1-evaluation-review-and-acceptance-plan.md（复核）；或合并为一份 v1-evaluation-plan.md。
当前 defer，待 Design Packet review 后决定是否合并。

N-6 `finclaw-reviewer` controller 未注册但被引用

位置：projects/finclaw/README.md L93 引用了 controllers/finclaw-reviewer/checkpoints/。

问题：controllers/registry.md 中没有 finclaw-reviewer 条目。该 controller 目录实际只有一个旧 checkpoint 文件（2026-05-13-current-session-recovery.md）。

建议：

从 projects/finclaw/README.md 移除该引用，或向 Admin 提交注册请求。
旧 checkpoint 可 move 到 controllers/finclaw/checkpoints/2026-05-13-reviewer-session-recovery.md，合并到主 Controller 状态树。

影响：projects/finclaw/README.md Controller 恢复表。

N-7 checkpoint 格式不一致

文件	YAML frontmatter	checkpoint_id
`2026-05-13-current-session-recovery.md`	无	无
`2026-05-13-admin-batch4-pickup.md`	有	有
`2026-05-14-controller-rewrite-dispatch-pickup.md`	有	有

建议：给 2026-05-13-current-session-recovery.md 补 YAML frontmatter，与其他 checkpoint 格式对齐。

N-8 reference-experience vs references 双文件

三个参考项目（aifinlab、fin-chelae、martinpmm）同时出现在两个位置，文件名后缀不同但语义清楚：

`references/finclaw/` (desk research)	`projects/finclaw/reference-experience/` (hands-on evaluation)
`aifinlab-finclaw-analysis.md`	`aifinlab-finclaw-evaluation.md`
`fin-chelae-finclaw-analysis.md`	`fin-chelae-finclaw-evaluation.md`
`martinpmm-finclaw-analysis.md`	`martinpmm-finclaw-evaluation.md`

判断：按 R4 §4 后缀规范（*-reference-analysis.md = desk research；*-reference-evaluation.md = 复现体验证据），两组文件角色不同，双位置合理。但当前后缀缺少 reference- 前缀：

建议新名（若 rename）：

references/finclaw/aifinlab-finclaw-reference-analysis.md
projects/finclaw/reference-experience/aifinlab-finclaw-reference-evaluation.md
同理其他两组。

影响：docs-manifest.json reference_paths、sidebars.js、llms.txt。改链范围大。建议 defer 到全库 rename 批次。

N-9 docs-manifest / sidebars 与实际文件不同步（公共入口，仅记录）

以下为 Admin-owned 公共入口问题，本 audit 仅记录，不直接改动：

docs-manifest.json 的 design_support_paths 缺 7 个新 V1 design 文件（v1-user-journey-and-interaction-flow.md 等）。
sidebars.js 缺同样 7 个新 V1 design 文件。
docs-manifest.json 的 sync_paths 缺 labs-fintecai-finclaw-canonical-reader-surface-proposal-2026-05-15.md。
本 audit 包 (finclaw-doc-ia-audit-2026-05-15.md) 落盘后，也需登记到 sync_paths。

处置：随本 audit 向 Admin 提交公共入口修正短请求（见 §7.3）。

§4 处置建议

projects/finclaw/

文件	处置	说明
`README.md`	rewrite-lite	移除 finclaw-reviewer 引用 (N-6)；确认 V1 设计包表格与实际文件一致
`strategic-whitepaper.md`	keep	canonical，不动文件名 (R4 §5)
`product-definition.md`	keep	canonical，不动文件名
`mvp-product-definition.md`	keep	canonical，不动文件名
`design/foundation/product-object-and-advisor-design.md`	keep
`design/foundation/terminology-and-object-naming.md`	keep
`design/v1/v1-design-kickoff-packet.md`	keep
`design/v1/v1-prd.md`	keep
`design/v1/v1-collaboration-and-task-packet-plan.md`	keep
`design/v1/v1-user-journey-and-interaction-flow.md`	keep
`design/v1/v1-product-object-and-schema-design.md`	keep
`design/v1/v1-ui-ux-interaction-design.md`	keep
`design/v1/v1-agent-orchestration-design.md`	keep
`design/v1/v1-evaluation-initial-plan.md`	defer	待 Design Packet review 后可能 rename 或与 acceptance-plan 合并 (N-5)
`design/v1/v1-evaluation-review-and-acceptance-plan.md`	defer	同上
`design/v1/v1-trial-operations-plan.md`	keep
`design/task-packets/v1-user-journey-interaction-flow-task-packet.md`	rename / executed	→ `v1-user-journey-and-interaction-flow-task-packet.md` (N-4)
`design/task-packets/v1-product-object-schema-design-task-packet.md`	rename / executed	→ `v1-product-object-and-schema-design-task-packet.md` (N-4)
`reference-experience/README.md`	keep
`reference-experience/aifinlab-finclaw-evaluation.md`	defer	rename 候选 (N-8)，待全库 rename 批次
`reference-experience/aifinlab-skill-layer-evaluation.md`	keep	无 references/ 对应物，不存在双文件问题
`reference-experience/aifinlab-team-alignment-brief.md`	keep
`reference-experience/aifinlab-personal-domain-review-checklist.md`	keep
`reference-experience/external-evaluation-repositories-synthesis.md`	keep
`reference-experience/fin-chelae-finclaw-evaluation.md`	defer	rename 候选 (N-8)
`reference-experience/finrobot-evaluation.md`	keep	无 references/ 对应物
`reference-experience/martinpmm-finclaw-evaluation.md`	defer	rename 候选 (N-8)

references/finclaw/

文件	处置	说明
`external-reference-candidate-scan.md`	keep
`aifinlab-finclaw-analysis.md`	defer	rename 候选 (N-8)
`fin-chelae-finclaw-analysis.md`	defer	rename 候选 (N-8)
`martinpmm-finclaw-analysis.md`	defer	rename 候选 (N-8)

evaluation/finclaw/

文件	处置	说明
`README.md`	keep
`case-library.md`	keep
`case-schema.md`	keep
`cases/README.md`	keep
`cases/*.yaml` (6 个)	keep	后续应建 case_id ↔ filename 映射表 (R4 §4)
`reports/README.md`	rewrite	当前仅 9 行占位；应补充报告层说明与链接
`reports/first-batch-reference-cross-analysis.md`	keep
`runs/README.md`	rewrite	当前仅 5 行占位；应补充 runs 目录用途与空目录预期
`seeds/README.md`	keep
`seeds/market-cognition-snapshot/*`	keep

source/project-prealignment/finclaw/

文件	处置	说明
`source-note-finclaw-whitepaper-v0.1.md`	rename / executed	→ `source-note-finclaw-whitepaper-v0-1.md` (N-3)
`gap-mapping-finclaw-whitepaper-v0.1.md`	rename / executed	→ `gap-mapping-finclaw-whitepaper-v0-1.md` (N-3)
`product-definition-supplement.md`	keep

controllers/finclaw/

文件	处置	说明
`state.md`	rewrite-lite	吸收本 audit 结论到 §6 任务队列
`checkpoints/2026-05-13-current-session-recovery.md`	rewrite-lite	补 YAML frontmatter (N-7)
`checkpoints/2026-05-13-admin-batch4-pickup.md`	keep
`checkpoints/2026-05-14-controller-rewrite-dispatch-pickup.md`	keep

controllers/finclaw-reviewer/ (orphan)

文件	处置	说明
`checkpoints/2026-05-13-current-session-recovery.md`	move	→ `controllers/finclaw/checkpoints/2026-05-13-reviewer-session-recovery.md`，合并到主 Controller；向 Admin 确认是否注销 finclaw-reviewer 目录 (N-6)

packets/sync/ (FinClaw)

文件	处置	说明
`finclaw-program-controller-handoff-2026-05-09.md`	keep
`finclaw-mvp-engineering-alignment-2026-05-09.md`	keep
`finclaw-evaluation-to-product-translation-batch-1.md`	rename / executed	→ `finclaw-evaluation-to-product-translation-batch-1-2026-05-12.md` (N-2)
`finclaw-case-library-adapter-upgrade-handoff.md`	rename / executed	→ `finclaw-case-library-adapter-upgrade-handoff-2026-05-11.md` (N-2)
`labs-fintecai-finclaw-project-doc-audit-2026-05-14.md`	keep	Admin-owned，不改
`labs-fintecai-finclaw-canonical-reader-surface-proposal-2026-05-15.md`	keep	Admin-owned，不改

N-10 design/ 全部 14 个文件均无 YAML frontmatter

所有 projects/finclaw/design/ 下的文件（foundation、v1、task-packets）均未使用 YAML frontmatter，仅在正文中以标题行标注状态和角色。与 checkpoint / sync packet 的 YAML frontmatter 实践不一致。

建议：defer。Design 文件加 frontmatter 属大范围格式统一，不阻塞当前 IA 审查。

N-11 v1 design 文件后缀多数不在 R4 §4 标准集内

R4 §4 标准后缀为 *-plan.md / *-audit.md / *-task-packet.md / *-reference-analysis.md / *-reference-evaluation.md。

符合（6 个）：*-plan.md × 4、*-task-packet.md × 2。

不符合（8 个）：-design.md × 4、-prd.md × 1、-kickoff-packet.md × 1、-naming.md × 1、-interaction-flow.md × 1。

判断：R4 §4 标准后缀集对 design output 类文件覆盖不足。PRD、kickoff packet、design baseline 等天然不属于五类之一。建议向 Admin 反馈：R4 §4 后缀集需补充 *-design.md、*-prd.md、*-packet.md（含 kickoff）等 design-output 后缀，或在 R4 §4 中声明 foundation / v1-design 类文件不受五类后缀强制约束。

N-12 evaluation cases case_id ↔ filename 风格不一致

位置	case_id 风格	文件名风格
`cases/*.yaml`	PascalCase-Kebab + `-01` (如 `Crypto-Asset-Snapshot-Colloquial-01`)	lowercase-kebab (如 `crypto-asset-snapshot-colloquial.yaml`)
`seeds/eval-case.yaml`	lowercase-kebab + `-01` (如 `snapshot-asset-btc-baseline-01`)	与 case_id 无对应关系 (`eval-case.yaml`)

R4 §4："YAML case 文件名应与 case_id 字段对齐；批量改名前先做 id ↔ filename 映射表。"

建议：在执行 rename 前，先统一 case_id 命名约定（全小写 kebab 或 PascalCase-Kebab），再对齐文件名。归入后续 rename 批次。

N-13 task-packet status 字段未回写

两个 task-packet 文件正文 status 仍为 Active / P0 Design Task，但对应 v1 design output 已标注 Accepted Initial Design。

建议：在低风险 rewrite-lite 批次中回写 task-packet status 为 Completed 或类似值。

N-14 references 文件含本机环境路径

references/finclaw/ 三份 -analysis.md 中引用了 /tmp/martinpmm-finclaw、/Users/mlabs/Programs/martinpmm-FinClaw 等本机路径。这些路径在 GitHub、Docusaurus 或其他 reader 环境中不可解析。

建议：defer。属长期清理项，可在 reference 文件 rewrite 时统一替换为 Git clone 指令或 URL。

§5 内容深度问题

5.1 需 rewrite 而非仅 rename 的问题

区域	问题	优先级
`evaluation/finclaw/reports/README.md`	仅 9 行占位，缺少报告层定位说明、已有报告清单、与 case-library 的关系、后续报告进入规则	P1
`evaluation/finclaw/runs/README.md`	仅 5 行占位，缺少 runs 目录用途、空目录预期、首批 run 产生条件	P2
`projects/finclaw/README.md`	finclaw-reviewer 引用无效 (N-6)；V1 设计包表格已正确列出全部文件但 sidebar/manifest 未同步 (N-9)	P1
`controllers/finclaw/state.md` §6 任务队列	需追加 R4 audit 跟踪项、本 audit 的 rename 批次	P2

5.2 evaluation 内容同步问题

case-schema.md §8 "Next Batch" 仍写"再创建 cases/ 和 runs/ 的首批 YAML"，但 cases/*.yaml 已存在 6 个文件。该段落过时，需回写。
cases/README.md 列表编号从 2 跳到 4（缺"3."），小瑕疵。
evaluation/finclaw/reports/first-batch-reference-cross-analysis.md 引用 projects/finclaw/reference-experience/*.md 而非 references/finclaw/*.md，导致与 references 目录的三份深度分析文件形成三层叙事并行（references → evaluation/reports → projects/reference-experience）。长期应收敛到单一索引 + 引用。

5.3 canonical 三件套内容深度观察

三份 canonical 文件在 2026-05-15 已经历 reader-surface 清洗，内容结构完整，目录、引用链和正文质量高。以下为可选改进方向（非阻塞）：

strategic-whitepaper.md §9 当前待决战略问题中，部分问题已在 product-definition.md 中有回应但未回链标注"已在下游收束"。
product-definition.md 和 mvp-product-definition.md 大量段落高度重复（产品承诺、场景表、对象表、验收标准）。这是有意的渐进下推（canonical → MVP 截取），但对 reader 而言增加阅读负担。可考虑 MVP 对重复段落改为引用 + delta。
三份文件均在 Changelog 中保留了 worklog 引用指向本地路径 ../../../CurvatureLabs/personal-domain-admin/worklog/。该路径在 Gov 仓库的任何 reader（GitHub、Docusaurus、外部 Agent）中不可访问。

5.3 V1 design 文件深度观察

7 个新 V1 design 文件（user-journey、schema、ui-ux、agent-orchestration、evaluation-initial、evaluation-review-acceptance、trial-ops）均在 2026-05-14 controller rewrite dispatch 中产出为初稿，checkpoint 标注为"accepted with blockers"。
这些文件尚未经过 Design Packet review 或 reader test。
v1-evaluation-initial-plan.md 和 v1-evaluation-review-and-acceptance-plan.md 功能边界有交叉，后续可能合并。

5.5 evaluation cases id ↔ filename 映射

已检查完成（见 N-12）。6 个 cases/*.yaml 的 case_id 使用 PascalCase-Kebab + -01（如 Crypto-Asset-Snapshot-Colloquial-01），而文件名使用 lowercase-kebab（如 crypto-asset-snapshot-colloquial.yaml）。seeds/eval-case.yaml 使用第三种风格 snapshot-asset-btc-baseline-01。三套风格并存。

5.6 packet 内部 status 张力

labs-fintecai-finclaw-canonical-reader-surface-proposal-2026-05-15.md 的 YAML status 为 absorbed，§8 勾选清单标注 L1 完成，但 §9 "Open Gaps" 措辞仍保留"虽已 absorbed，仍必须显式保留未关闭项"——读者层面"已全部完成"与"仍有 open gaps"存在张力。建议在后续清理中对齐措辞。

5.7 checkpoint 事实性过时

controllers/finclaw/checkpoints/2026-05-13-current-session-recovery.md 声称 User Journey / Schema 设计文档"尚未产出"，但 2026-05-14-controller-rewrite-dispatch-pickup.md 已确认初稿产出。前者在事实层面已被后者覆盖，属陈旧 checkpoint。

§6 Reader-test 计划

本批次 scope

本 audit 仅做 IA / 命名 / 处置建议，不改 canonical 内容或 reader surface。

触发条件与等级

后续动作	reader-test 等级	依据
task-packet rename (N-4)	L0 自检	日常 rename，单文件 link fix
source 文件 rename (N-3)	L0 自检	同上
packet 补日期 rename (N-2)	L0 自检	同上
`projects/finclaw/README.md` rewrite-lite	L0 自检	单文件 hub 页
`evaluation/finclaw/reports/README.md` rewrite	L0 自检	单文件占位补充
若 N-8 全量 rename 执行（`-analysis` / `-evaluation` 加 `reference-` 前缀）	L1	涉及 references + reference-experience 双目录、docs-manifest、sidebars、llms.txt
若 canonical 三件套内容改造（§5.2 建议）	L1	触及 canonical reader surface

调度建议

L0 由 FinClaw Controller 自检完成。
L1 推荐 Codex R-agent-low-context 视角，归档到 evidence/reader-tests/2026-05-15-finclaw-ia-l1/。

§7 风险与开放问题

7.1 open-gap 列表

ID	问题	状态
OG-1	packet 前缀规范（`finclaw-` vs `labs-fintecai-finclaw-`）需全库仲裁	blocked on Admin
OG-2	`finclaw-reviewer` controller 的去留（注册 or 注销）需 Admin 确认	blocked on Admin
OG-3	N-8 全量 rename 改链成本大（docs-manifest + sidebars + llms + cross-refs），需在全库 rename 批次中统一处理	deferred
OG-4	evaluation cases `case_id ↔ filename` 对齐检查未完成	pending
OG-5	7 个新 V1 design 文件未经 Design Packet review 或 reader test	pending
OG-6	`v1-evaluation-initial-plan.md` 与 `v1-evaluation-review-and-acceptance-plan.md` 是否合并待 Design Packet review	deferred
OG-7	canonical 三件套 Changelog 中 `worklog` 引用指向本地路径，Gov reader 不可访问	low-priority
OG-8	`product-definition.md` 与 `mvp-product-definition.md` 大量段落高度重复，可优化为引用 + delta	deferred
OG-9	R4 §4 标准后缀集对 design-output 类文件覆盖不足（N-11），需 Admin 补充或声明豁免	blocked on Admin
OG-10	evaluation `case-schema.md` §8 过时（称 cases 未创建，但已有 6 个）	pending
OG-11	references/finclaw/ → evaluation/reports → projects/reference-experience 三层叙事并行，长期需收敛	deferred
OG-12	evaluation case_id 三套命名风格并存（N-12），需统一后才可做 id↔filename 映射	pending

7.2 本 audit 不等于什么

不等于 FinClaw 项目正文统一重写完成。
不等于 Design Packet 审查完成。
不等于工程实现对齐完成。
不等于 reader-test 已执行。

7.3 公共入口修正短请求（提交给 Admin）

对象：FinClaw
需要更新的公共入口：docs-manifest.json (design_support_paths, sync_paths)、sidebars.js、llms.txt
原因：7 个新 V1 design 文件（v1-user-journey-and-interaction-flow 等）已于 2026-05-14 落盘但未登记到公共入口；低风险 rename 批次已重命名 task-packet、source prealignment 与两个 FinClaw sync packet，公共入口仍指向旧路径
新增入口：
  - design_support_paths: 7 个 v1 design 文件
  - sync_paths: labs-fintecai-finclaw-canonical-reader-surface-proposal-2026-05-15.md、finclaw-doc-ia-audit-2026-05-15.md（本包）
需要替换的旧入口：
  - projects/finclaw/design/task-packets/v1-user-journey-interaction-flow-task-packet.md -> projects/finclaw/design/task-packets/v1-user-journey-and-interaction-flow-task-packet.md
  - projects/finclaw/design/task-packets/v1-product-object-schema-design-task-packet.md -> projects/finclaw/design/task-packets/v1-product-object-and-schema-design-task-packet.md
  - source/project-prealignment/finclaw/source-note-finclaw-whitepaper-v0.1.md -> source/project-prealignment/finclaw/source-note-finclaw-whitepaper-v0-1.md
  - source/project-prealignment/finclaw/gap-mapping-finclaw-whitepaper-v0.1.md -> source/project-prealignment/finclaw/gap-mapping-finclaw-whitepaper-v0-1.md
  - packets/sync/finclaw-case-library-adapter-upgrade-handoff.md -> packets/sync/finclaw-case-library-adapter-upgrade-handoff-2026-05-11.md
  - packets/sync/finclaw-evaluation-to-product-translation-batch-1.md -> packets/sync/finclaw-evaluation-to-product-translation-batch-1-2026-05-12.md
移除入口：旧路径替换后移除
语义层：design support / sync
验收命令：DOC_CHANGE_SCOPE=finclaw,public-entrypoints npm run verify:change-scope && npm run build

§8 下一步执行建议

按风险从低到高排序：

低风险 rename 批次（Controller 自主）：N-2 packet 补日期、N-3 source v0.1→v0-1、N-4 task-packet 补 and 已执行；N-7 checkpoint 补 frontmatter 尚未执行，转入 rewrite-lite 批次。
低风险 rewrite-lite 批次（Controller 自主）：README 移除 finclaw-reviewer 引用 (N-6)；task-packet status 回写 (N-13)；case-schema.md §8 过时段落修正 (OG-10)；cases/README.md 编号跳跃修正。
evaluation placeholder 补充：reports/README.md、runs/README.md。
提交 §7.3 公共入口修正短请求给 Admin；同时反馈 R4 §4 后缀集不足 (OG-9)。
等待 Admin 仲裁：OG-1（前缀规范）、OG-2（finclaw-reviewer 去留）、OG-9（后缀集豁免）。
后续批次：OG-3 全量 rename、OG-5 Design Packet review、OG-6 evaluation plan 合并决策、OG-11 三层叙事收敛、OG-12 case_id 风格统一。

本 audit 为只读分析产出。后续任何 rename / merge / rewrite 执行前，应在 Controller 状态中记录执行批次并按 §6 reader-test 等级验证。

§9 执行记录：低风险 rename 批次

日期：2026-05-15

本批已执行：

projects/finclaw/design/task-packets/v1-user-journey-interaction-flow-task-packet.md -> projects/finclaw/design/task-packets/v1-user-journey-and-interaction-flow-task-packet.md
projects/finclaw/design/task-packets/v1-product-object-schema-design-task-packet.md -> projects/finclaw/design/task-packets/v1-product-object-and-schema-design-task-packet.md
source/project-prealignment/finclaw/source-note-finclaw-whitepaper-v0.1.md -> source/project-prealignment/finclaw/source-note-finclaw-whitepaper-v0-1.md
source/project-prealignment/finclaw/gap-mapping-finclaw-whitepaper-v0.1.md -> source/project-prealignment/finclaw/gap-mapping-finclaw-whitepaper-v0-1.md
packets/sync/finclaw-case-library-adapter-upgrade-handoff.md -> packets/sync/finclaw-case-library-adapter-upgrade-handoff-2026-05-11.md
packets/sync/finclaw-evaluation-to-product-translation-batch-1.md -> packets/sync/finclaw-evaluation-to-product-translation-batch-1-2026-05-12.md

同步回写范围：

projects/finclaw/
evaluation/finclaw/
source/project-prealignment/finclaw/
packets/sync/finclaw-*

未处理范围：

公共入口：INDEX.md、docs-manifest.json、sidebars.js、llms.txt、mkdocs.yml 等仍需 Admin 按 §7.3 收束。
Admin / governance / 历史 checkpoint：保留旧路径作为历史记录，不在本批修改。

验证：

git diff --check：通过。
DOC_CHANGE_SCOPE=finclaw npm run verify:change-scope：未通过；原因是工作区已有 Data Horizon / Trading Matrix / Admin / public-entrypoints 等本轮外部改动，非本批 rename 本身。

§10 Skill / Pattern Preflight

日期：2026-05-15

本节补记后续 rewrite-lite / 公共入口收束前应采用的个人域 eval 沉淀。读取依据：

personal-domain-admin/worklog/2026/05/2026-05-14-cross-project-comparison-matrix.md
personal-domain-admin/worklog/2026/05/2026-05-14-eval-anthropic-skills-reuse-candidates.md
personal-domain-admin/worklog/2026/05/2026-05-14-eval-vercel-monorepo-reuse-candidates.md
personal-domain-admin/worklog/2026/05/2026-05-14-eval-multica-reuse-candidates.md
personal-domain-admin/worklog/2026/05/2026-05-14-eval-bitfun-reuse-candidates.md
personal-domain-admin/worklog/2026/05/2026-05-14-eval-openharness-reuse-candidates.md

10.1 本轮选用的 patterns

来源	pattern / template	本轮用途
`anthropic-skills:A1`	`#pattern:progressive-disclosure`	维持 FinClaw `README.md` 作为薄入口；canonical / design / evaluation 按需深读，不把 audit 变成新主入口
`anthropic-skills:A3`	`#pattern:spec-by-reference`	R4、document-change-scope、reader-testing-protocol 作为权威 spec；FinClaw audit 只引用并执行，不复制公共规则
`anthropic-skills:B1`	`#pattern:trigger-engineering` / `#skill-idea:description-as-router`	后续 README / hub 页用“按任务选入口”而非平铺目录树
`vercel-monorepo:D1`	`#pattern:layered-agents-md` / `#template-idea:scoped-agent-rules`	Controller / project / evaluation 分层规则各就其位，避免把所有规则塞进项目正文
`multica:C1`	`#template-idea:thin-entry-point`	项目 README 与 Controller state 保持入口薄、厚材料留在 canonical / design / evaluation
`bitfun:A2`	`#pattern:safe-monolith-decomposition`	文档 IA rename / move 分批执行，先 audit，后低风险 rename，再 rewrite-lite，避免一次性大拆
`bitfun:A3`	`#pattern:layered-agents-md`	与 Vercel D1 共同约束“就近规则优先”思路，但不在 Gov 中新建未授权 AGENTS.md
`openharness:C1`	`#pattern:governance` / `#pattern:path-rules` (`sensitive-paths`)	后续若引入安全扫描或第三方 Skill，只引用已部署 sensitive-paths baseline；本批不安装新安全 Skill

10.2 Skill 选择结论

不安装新 Skill：当前任务是治理库 IA / 命名 / 文档分层，不需要引入第三方 Skill 包；安装前应另走 skill package vetting。
使用现有治理流程型能力：后续执行继续按 R4、scope policy、reader-testing-protocol、verification-before-completion 执行。
暂不启用 security / semgrep 类 Skill：本批不触及代码安全扫描；如后续引入，应先引用 OpenHarness sensitive-paths baseline 与 skill-lint。

10.3 对后续批次的约束

rewrite-lite 只改薄入口和状态同步，不把 reference / evaluation 结论提升为 canonical。
public-entrypoints 由 Admin 合并；FinClaw Controller 只提交短请求。
若开始 N-8 / OG-11 这类跨目录大收敛，先按 BitFun safe-decomposition 思路拆成 mapping audit -> rename -> relink -> reader-test。
若新增或改写任何 project hub，应继续用 Anthropic trigger-engineering：按 reader 意图路由，而不是按仓库结构展示所有文件。

§11 Skill-enabled Rerun 记录

日期：2026-05-15

按 §10 的 skill / pattern checklist 复跑后结论如下：

Checklist	复跑结论
`progressive-disclosure`	`projects/finclaw/README.md` 仍作为 thin entry；未把 audit 或 sync packet 提升为读者主入口
`spec-by-reference`	R4、scope policy、reader-testing-protocol 仍为权威规则；本包只记录执行和建议
`trigger-engineering`	当前未改 reader hub 文案；下一批 README rewrite-lite 应按任务意图路由
`layered-agents-md / scoped rules`	未新增未授权 AGENTS / rule 文件；Controller 状态、project docs、evaluation docs 仍分层
`thin-entry-point`	未将 reference / evaluation / source 结论并入 canonical；仅修正命名与引用
`safe-monolith-decomposition`	执行顺序保持 audit -> low-risk rename -> public-entrypoints handoff；未做 merge / move / canonical rewrite
`sensitive-paths / path-rules`	本批未安装第三方 Skill，也未做全仓敏感路径扫描；后续如引入安全 Skill 需另走 vetting

本次复跑新增发现并已修正：

§1 当前目录树已从旧文件名更新为 rename 后文件名。
§2 文件角色表已从旧文件名更新为 rename 后文件名。
N-2 的建议新名已从占位日期修正为实际执行日期：2026-05-12 / 2026-05-11。
§4 处置表已标注 N-2 / N-3 / N-4 为 rename / executed。

本次复跑未执行：

N-7 checkpoint frontmatter 补齐：属于 rewrite-lite，不属于 rename；留到下一批。
public-entrypoints relink：仍需 Admin 或显式 DOC_CHANGE_SCOPE=finclaw,public-entrypoints。

§12 执行记录：低风险 rewrite-lite 批次

日期：2026-05-15

本批已执行：

projects/finclaw/README.md：移除未注册 finclaw-reviewer controller 入口，保留 FinClaw Controller 作为恢复入口。
projects/finclaw/design/task-packets/v1-user-journey-and-interaction-flow-task-packet.md：状态从 active task 回写为首版输出已落盘，并反链正式设计输出。
projects/finclaw/design/task-packets/v1-product-object-and-schema-design-task-packet.md：状态从 active task 回写为首版输出已落盘，并反链正式设计输出。
evaluation/finclaw/case-schema.md：修正 §8 过时叙述，明确 cases/ 已存在，下一批重点转向 run result。
evaluation/finclaw/cases/README.md：修正使用规则编号跳跃。
evaluation/finclaw/reports/README.md：从 placeholder 扩展为 reports index，说明与 reference、cases、runs 的关系和写入规则。
evaluation/finclaw/runs/README.md：从 placeholder 扩展为 awaiting first structured runs，说明首批 run result 写入条件和建议命名。

仍未执行：

N-7 checkpoint frontmatter 补齐。
N-8 / OG-11 references、reference-experience、evaluation reports 三层叙事收敛。
V1 Design Packet 深度 review 与 reader-test。
public-entrypoints relink。

§13 执行记录：N-7 checkpoint frontmatter + N-10 V1 design frontmatter 补齐

日期：2026-05-15

本批已执行：

controllers/finclaw/checkpoints/2026-05-13-current-session-recovery.md：补齐 YAML frontmatter（checkpoint_id、type、status: superseded、superseded_by）；标注"未完成事项"已被 2026-05-14 checkpoint 覆盖；修正 task-packet 旧路径为 rename 后新路径。
7 个 V1 design 初稿全部补齐 YAML frontmatter：
- v1-user-journey-and-interaction-flow.md
- v1-product-object-and-schema-design.md
- v1-ui-ux-interaction-design.md
- v1-agent-orchestration-design.md
- v1-evaluation-initial-plan.md
- v1-evaluation-review-and-acceptance-plan.md
- v1-trial-operations-plan.md

同步修正：

v1-ui-ux-interaction-design.md：header 补充术语规范引用 terminology-and-object-naming.md（原缺失）。
v1-trial-operations-plan.md：header 补充 DAG 要求的上游引用 v1-product-object-and-schema-design.md 和 v1-agent-orchestration-design.md（原缺失）。

§14 V1 Design 7 个初稿深度内容审查

日期：2026-05-15

审查基线：v1-design-kickoff-packet.md §4 Design Packet DAG + Output Contract Matrix、v1-prd.md 全文、foundation/terminology-and-object-naming.md、foundation/product-object-and-advisor-design.md。

14.1 术语一致性

全部 7 个文档使用的核心对象术语与 terminology-and-object-naming.md 一致：

Market Cognition Snapshot / 市场认知快照 ✓
Market Cognition Thread / 市场认知线程 ✓
Pre-Execution Checkpoint / 执行前认知检查点 ✓
Financial Cognition Advisor / 金融认知顾问 ✓
FinAgents / 金融智能体 ✓
FinSkills / 金融技能 ✓
Strategy Hypothesis / 策略假设 ✓
Legacy Action Suggestion 均标记为 legacy ✓

未发现术语漂移。

14.2 DAG 依赖合规

按 kickoff §4.3 Mermaid 逐条核对 upstream doc headers：

边	上游	下游	下游 header 是否引用上游
B→E	PRD	User Journey	✓
B→F	PRD	Schema	✓
C→F	Product Object Design	Schema	✓
D→E	Terminology	User Journey	✓
D→F	Terminology	Schema	✓
E→G	User Journey	UI/UX	✓
F→G	Schema	UI/UX	✓
E→H	User Journey	Agent	✓
F→H	Schema	Agent	✓
F→I0	Schema	Eval Initial	✓
E→I0	User Journey	Eval Initial	✓
I0→G	Eval Initial	UI/UX	✓
I0→H	Eval Initial	Agent	✓
G→I1	UI/UX	Eval Review	✓
H→I1	Agent	Eval Review	✓
I0→I1	Eval Initial	Eval Review	✓
E→J	User Journey	Trial Ops	✓
G→J	UI/UX	Trial Ops	✓（本批新增）
I1→J	Eval Review	Trial Ops	✓

DAG 全边合规。Trial Ops 原缺失的 Schema 和 Agent 上游引用已在本批补齐。

14.3 逐文档内容审查

(1) v1-user-journey-and-interaction-flow.md（330 行）

结构完整：10 个用户状态、7 个任务路由、快照阅读路径、Thread 生命周期、风险挑战路径、Pre-Execution Checkpoint 路径、敏感信息分类、移动/桌面差异、下游承接清单。
与 foundation product-object-and-advisor-design.md §1 线程生命周期一致。
与 PRD §6 主路径一致。
内容缺口：§12 提到"试运营记录应能回流到 Evaluation and Trial Acceptance Plan"但未显式引用具体评测文档路径。低优先级，建议后续 design review 补齐。
深度评价：P0 输出中最厚的文档之一（330 行），内容充实、路径完整、边界清晰。可作为下游 UI/UX 和 Agent 的有效输入。通过。

(2) v1-product-object-and-schema-design.md（366 行）

结构完整：10 个对象定义、字段表、状态机、刷新变更记录、评测映射表。
Snapshot 28 个字段、Thread 16 个字段、Checkpoint 14 个字段均与 foundation 和 PRD 要求对齐。
§5.2 Forbidden Fields 与 kickoff 和 PRD 的非目标一致。
§12 Evaluation Mapping 与 6 个 YAML case 文件名一致。
内容缺口：§10 Model/Provider Boundary 定义了字段但未显式反链 PRD §8 模型策略段落。低优先级。
深度评价：最厚的设计文档（366 行），对象边界和字段覆盖充分。通过。

(3) v1-ui-ux-interaction-design.md（221 行）

9 个核心 Screen 定义、状态覆盖、Home/Entry/Snapshot/Thread/Checkpoint 流程。
与 Journey 的用户状态和快照阅读路径一致。
Sensitive Input UX 与 Schema 的 SensitiveInputHandling 一致。
深度不足：221 行是 7 个文档中第二短的。§2 Core Screens 列出 9 个 screen 但后续正文只有 7 个独立 section。Evidence Drawer 和 Refresh Diff 缺少独立段落——它们被嵌入在 Snapshot View 和 Thread View 中，但作为 kickoff §5 要求的 12 个 UI 覆盖点之一（"证据质量状态表达"），Evidence Drawer 值得独立段落。
内容缺口：未讨论组件层级结构、导航模式（tab / drawer / stack）、过渡动画约束或设计 token 基线。这些在 "Accepted Initial Design" 阶段可以缺省，但下一轮 design review 应补齐。
深度评价：满足 kickoff 定义的 UI/UX 初稿边界，但相比 Journey 和 Schema 的厚度明显薄。建议下一批 deepening 优先补齐 Evidence Drawer、Refresh Diff 独立段落和导航结构。条件通过。

(4) v1-agent-orchestration-design.md（186 行）

8 层编排架构、7 个任务路由、7 个顾问角色、8 个 FinSkills、写入规则矩阵、分歧处理、Boundary Guard、敏感输入。
与 foundation §2 顾问矩阵一致。
深度不足：186 行是最薄的文档。以下方面缺少设计细节：
- 多顾问协调流：当一个任务需要 3-4 个顾问时，如何编排？串行/并行/投票？kickoff §4.5 Output Contract 要求 Agent 设计说明"分歧处理"，§7 有分歧表但没有协调流程描述。
- 降级/回退路径：当 FinSkill 失败、来源不可用或模型低质量时，编排层如何降级？Journey §5 定义了 low-confidence 路径，但 Agent 文档未对接。
- Prompt / context 预算：编排层如何管理 context window 大小、顾问输出裁剪、多轮装载？这是工程前置设计关键缺口。
深度评价：满足 kickoff 的 "初稿" 边界，但作为 Engineering-start 前置输入不够充分。建议下一批 deepening 优先补齐多顾问协调流和降级路径。条件通过，需 deepening。

(5) v1-evaluation-initial-plan.md（242 行）

6 个 case 覆盖矩阵、A/B/C/D 评分标准、字段级检查（Snapshot/Thread/Checkpoint）、UX / Agent / Trial Ops 三个方向的反向约束、初始 run result YAML 模板。
反向约束设计清晰，能有效限制下游 UI 和 Agent 不绕过对象模型。
case_id 风格说明：§2 使用 Crypto-Asset-Snapshot-Colloquial-01（PascalCase-Kebab-NN），YAML 文件内 case_id 字段值也是此格式，与文件名 crypto-asset-snapshot-colloquial.yaml（kebab-case 无后缀）有风格差。这是设计选择而非 bug（filename ≠ case_id），但后续批量 evaluation runner 需要映射表。
深度评价：评测初始计划结构清晰，反向约束是整个 Design Packet 的核心质量保障机制。通过。

(6) v1-evaluation-review-and-acceptance-plan.md（154 行）

Gate 三层（Engineering-start / Trial-start / Acceptance）清晰。
8 个验收维度、量化指标、kill criteria 和 timebox。
内容缺口：未定义回归测试策略——当一个设计变更破坏了已通过 case 时该怎么办。建议 next batch 补齐。
深度评价：作为验收框架初稿，覆盖足够。通过。

(7) v1-trial-operations-plan.md（193 行）

参与者筛选、邀请/Onboarding、试用任务、反馈收集、人工复核、风险响应、商业信号、数据隐私、closeout 格式、stop/rollback。
与 PRD §11 试运营需求和 Evaluation Review 的 Trial Ops 反向约束一致。
内容缺口：§12 Open Items 列出"定义试用日历、参与者数量、trial owner"均待填充。这些是执行层面的空位，初稿阶段可接受。
深度评价：P1 输出中结构完整。通过。

14.4 跨文档一致性总结

检查项	结果
术语与 terminology doc 对齐	✓ 全部通过
DAG 依赖在 header 中声明	✓ 全部通过（2 处本批修正后通过）
Legacy 行动语义未被恢复	✓ 无一处恢复 Action Suggestion
Snapshot/Thread/Checkpoint 字段跨文档一致	✓ Schema 字段能覆盖 Journey/UI/Agent/Eval 引用
Forbidden execution fields 跨文档一致	✓ Schema §5.2、Agent §8、UI §7、Eval §4.3 一致
Sensitive input handling 跨文档一致	✓ 四类分级在 Journey/Schema/UI/Agent 中一致
Evaluation case 映射到 Schema 和 Journey	✓ Eval Initial §2 与 Schema §12 对齐
状态声明无自相矛盾	⚠ 全部声明 "Accepted Initial Design" 但无正式 acceptance 签章记录（未阻塞下游设计，但 Engineering-start gate 前需要 Controller 正式 review）

14.5 case_id ↔ filename 映射表

filename	case_id (YAML 内)	评估
`crypto-asset-snapshot-colloquial.yaml`	`Crypto-Asset-Snapshot-Colloquial-01`	词根一致，大小写/后缀不同
`crypto-event-narrative-understanding.yaml`	`Crypto-Event-Narrative-Understanding-01`	同上
`crypto-thesis-risk-controversy.yaml`	`Crypto-Thesis-Risk-Controversy-01`	同上
`snapshot-to-watch-questions.yaml`	`Snapshot-To-Watch-Questions-01`	同上
`strategy-hypothesis-pre-execution-checkpoint.yaml`	`Strategy-Hypothesis-Pre-Execution-Checkpoint-01`	同上
`evidence-degradation-source-uncertainty.yaml`	`Evidence-Degradation-Source-Uncertainty-01`	同上

结论：filename 用 kebab-case，case_id 用 PascalCase-Kebab-NN。6 对映射词根全部一致。风格差可接受但建议后续统一。

14.6 下一步建议

Agent Orchestration deepening（优先）：补齐多顾问协调流、降级路径、context 预算说明——这是 Engineering-start 前最大内容缺口。
UI/UX deepening：为 Evidence Drawer 和 Refresh Diff 补齐独立段落；补齐导航结构说明。
Evaluation regression 策略：在 Review/Acceptance Plan 中补齐回归测试条款。
case_id 风格统一（OG-12）：如后续需要 evaluation runner 自动化，应在 case-schema 或 cases/README 中声明 filename → case_id 映射约定。
正式 Controller review：7 个文档均声明 "Accepted" 但无签章。建议 Engineering-start gate 前在 controller state 或 sync packet 中记录正式 review。

§15 执行记录：N-10 收尾 + V1 Design deepening 批次

日期：2026-05-15

15.1 N-10 收尾：剩余 7 个 design/ 文件 frontmatter

已补齐 YAML frontmatter 的文件：

projects/finclaw/design/v1/v1-design-kickoff-packet.md（type: design-control）
projects/finclaw/design/v1/v1-prd.md（type: design）
projects/finclaw/design/v1/v1-collaboration-and-task-packet-plan.md（type: design）
projects/finclaw/design/foundation/terminology-and-object-naming.md（type: design-foundation）
projects/finclaw/design/foundation/product-object-and-advisor-design.md（type: design-foundation）
projects/finclaw/design/task-packets/v1-user-journey-and-interaction-flow-task-packet.md（type: task-packet）
projects/finclaw/design/task-packets/v1-product-object-and-schema-design-task-packet.md（type: task-packet）

加上 §13 已补齐的 7 个 V1 设计初稿，N-10 全部 14 个 design/ 文件 frontmatter 补齐完成。

15.2 Agent Orchestration deepening

在 v1-agent-orchestration-design.md 中新增三个段落：

§10A Multi-Advisor Coordination：定义 sequential / parallel-then-merge / challenge-after-draft 三种协调模式、merge 规则和顾问预算（每轮最多 5 次调用）。
§10B Degradation and Fallback Paths：定义 6 种失败场景（skill 超时、来源不可用、模型低质量、全部顾问失败、Boundary Guard 拒绝、context 超限）的检测方式、回退行为和用户可见效果。
§10C Context Budget Management：定义 8 级 context 优先序和预算规则（80% 阈值触发裁剪、顾问接收 scoped subset、刷新任务必须装载上一版快照全文）。

新增约 100 行设计内容，填补 §14 标记的 Engineering-start 前最大内容缺口。

15.3 UI/UX deepening

在 v1-ui-ux-interaction-design.md 中新增两个独立段落：

§6A Refresh Diff View：定义刷新对比的布局结构（header、summary bar、变化分区、execution boundary reminder）、Desktop 三列展示 vs Mobile 时间线卡片、无实质变化时的处理规则。
§6B Evidence Drawer：定义跨 Snapshot/Thread/Checkpoint 共用的证据展示组件（触发方式、内容结构、badge 映射表、Mobile bottom-sheet vs Desktop side-panel 行为），并明确不暴露内部 prompt / agent trace。

新增约 70 行设计内容，补齐 §14 标记的 Core Screens 覆盖缺口。

15.4 Evaluation regression 策略

在 v1-evaluation-review-and-acceptance-plan.md 中新增：

§9A Regression Testing：定义回归触发条件（schema/boundary/advisor/UI/model 变更）、回归范围映射表、通过标准（不允许已通过 case 降级）和回归证据字段（regression_trigger、previous_grade、regression_result）。

新增约 40 行。

15.5 本批未执行

N-8 / OG-11 三层叙事收敛：仍属 deferred 大 scope。
V1 Design 正式 Controller review 签章：建议单独批次处理，需要与 controller state 联动。

§16 Admin 裁定回写

日期：2026-05-15 来源：commit bfc72a8（Admin: process FinClaw audit §7.3 public entry request + OG-1/2/9 rulings）

16.1 OG-1（前缀规范）→ closed

Admin 裁定已写入 R4 §4：finclaw-* 用于 Controller-owned sync，labs-fintecai-finclaw-* 用于 Admin-owned 跨 Controller 包。不做统一 rename。

16.2 OG-2（finclaw-reviewer 去留）→ closed

Admin 裁定注销。controllers/finclaw-reviewer/ 目录已删除，checkpoint 已迁移至 controllers/finclaw/checkpoints/2026-05-13-reviewer-session-recovery.md。projects/finclaw/README.md 中的 finclaw-reviewer 引用已在 §12 rewrite-lite 批次中移除。

16.3 OG-9（R4 §4 后缀扩展）→ closed

Admin 裁定已写入 R4 §4：*-design.md / *-prd.md / *-packet.md 等 design-output 类文件不受五类标准后缀强制约束，但需保持项目内一致。

16.4 public-entrypoints relink → closed

Admin 已完成：7 个 V1 design 文件加入 sidebars.js 和 docs-manifest.json design_support_paths；audit 包和 reader-surface proposal 加入 sync_paths；task-packet rename、source rename、sync packet 日期后缀联动均已同步。

16.5 验证

DOC_CHANGE_SCOPE=finclaw npm run verify:change-scope：通过（11 changed files）。
npm run build：通过。
git diff --check：通过（当前工作区无 whitespace 问题）。

16.6 剩余 Open Gaps

ID	状态	说明
OG-1	closed	Admin 裁定
OG-2	closed	Admin 裁定
OG-3	closed	Controller scope rename 已完成，公共入口由 Admin 按需维护
OG-4	closed	§14.5 映射表已产出
OG-5	closed	§14 深度审查完成
OG-6	closed	两文档职责清晰分离（评测设计 vs 验收门禁），不合并
OG-7	closed	worklog 本地路径已替换为 `(personal-domain-admin, not in Gov repo)`
OG-8	closed	accepted-by-design — 重复服务于 PD / MVP 独立可读性，不优化
OG-9	closed	Admin 裁定
OG-10	closed	§12 已修正 case-schema §8
OG-11	closed	三层角色已澄清，references/finclaw/ 补 README 声明关系
OG-12	closed	case-schema §7.1 补充 filename ↔ case_id 映射约定

全部 12 个 OG 已关闭。

§1 当前目录树​

§2 文件角色标签​

projects/finclaw/​

references/finclaw/​

evaluation/finclaw/​

source/project-prealignment/finclaw/​

controllers/finclaw/​

packets/sync/ (FinClaw)​

游离文件​

§3 命名问题清单​

N-1 packet 前缀不一致​

N-2 两个 packet 缺日期后缀​

N-3 source 文件版本号含点号​

N-4 task-packet 与 v1 design 文件名对象名不一致（and 缺失）​

N-5 v1-evaluation 系列后缀不规范​

N-6 finclaw-reviewer controller 未注册但被引用​

N-7 checkpoint 格式不一致​

N-8 reference-experience vs references 双文件​

N-9 docs-manifest / sidebars 与实际文件不同步（公共入口，仅记录）​

§4 处置建议​

projects/finclaw/​

references/finclaw/​

evaluation/finclaw/​

source/project-prealignment/finclaw/​

controllers/finclaw/​

controllers/finclaw-reviewer/ (orphan)​

packets/sync/ (FinClaw)​

N-10 design/ 全部 14 个文件均无 YAML frontmatter​

N-11 v1 design 文件后缀多数不在 R4 §4 标准集内​

N-12 evaluation cases case_id ↔ filename 风格不一致​

N-13 task-packet status 字段未回写​

N-14 references 文件含本机环境路径​

§5 内容深度问题​

5.1 需 rewrite 而非仅 rename 的问题​

5.2 evaluation 内容同步问题​

5.3 canonical 三件套内容深度观察​

5.3 V1 design 文件深度观察​

5.5 evaluation cases id ↔ filename 映射​

5.6 packet 内部 status 张力​

5.7 checkpoint 事实性过时​

§6 Reader-test 计划​

本批次 scope​

触发条件与等级​

调度建议​

§7 风险与开放问题​

7.1 open-gap 列表​

7.2 本 audit 不等于什么​

7.3 公共入口修正短请求（提交给 Admin）​

§8 下一步执行建议​

§9 执行记录：低风险 rename 批次​

§10 Skill / Pattern Preflight​

10.1 本轮选用的 patterns​

10.2 Skill 选择结论​

10.3 对后续批次的约束​

§11 Skill-enabled Rerun 记录​

§12 执行记录：低风险 rewrite-lite 批次​

§13 执行记录：N-7 checkpoint frontmatter + N-10 V1 design frontmatter 补齐​

§14 V1 Design 7 个初稿深度内容审查​

14.1 术语一致性​

14.2 DAG 依赖合规​

14.3 逐文档内容审查​

(1) v1-user-journey-and-interaction-flow.md（330 行）​

(2) v1-product-object-and-schema-design.md（366 行）​

(3) v1-ui-ux-interaction-design.md（221 行）​

(4) v1-agent-orchestration-design.md（186 行）​

(5) v1-evaluation-initial-plan.md（242 行）​

(6) v1-evaluation-review-and-acceptance-plan.md（154 行）​

(7) v1-trial-operations-plan.md（193 行）​

14.4 跨文档一致性总结​

14.5 case_id ↔ filename 映射表​

14.6 下一步建议​

§15 执行记录：N-10 收尾 + V1 Design deepening 批次​

15.1 N-10 收尾：剩余 7 个 design/ 文件 frontmatter​

15.2 Agent Orchestration deepening​

15.3 UI/UX deepening​

15.4 Evaluation regression 策略​

15.5 本批未执行​

§16 Admin 裁定回写​

16.1 OG-1（前缀规范）→ closed​

16.2 OG-2（finclaw-reviewer 去留）→ closed​

§1 当前目录树

§2 文件角色标签

projects/finclaw/

references/finclaw/

evaluation/finclaw/

source/project-prealignment/finclaw/

controllers/finclaw/

packets/sync/ (FinClaw)

游离文件

§3 命名问题清单

N-1 packet 前缀不一致

N-2 两个 packet 缺日期后缀

N-3 source 文件版本号含点号

N-4 task-packet 与 v1 design 文件名对象名不一致（`and` 缺失）

N-5 v1-evaluation 系列后缀不规范

N-6 `finclaw-reviewer` controller 未注册但被引用

N-7 checkpoint 格式不一致

N-8 reference-experience vs references 双文件

N-9 docs-manifest / sidebars 与实际文件不同步（公共入口，仅记录）

§4 处置建议

projects/finclaw/

references/finclaw/

evaluation/finclaw/

source/project-prealignment/finclaw/

controllers/finclaw/

controllers/finclaw-reviewer/ (orphan)

packets/sync/ (FinClaw)

N-10 design/ 全部 14 个文件均无 YAML frontmatter

N-11 v1 design 文件后缀多数不在 R4 §4 标准集内

N-12 evaluation cases case_id ↔ filename 风格不一致

N-13 task-packet status 字段未回写

N-14 references 文件含本机环境路径

§5 内容深度问题

5.1 需 rewrite 而非仅 rename 的问题

5.2 evaluation 内容同步问题

5.3 canonical 三件套内容深度观察

5.3 V1 design 文件深度观察

5.5 evaluation cases id ↔ filename 映射

5.6 packet 内部 status 张力

5.7 checkpoint 事实性过时

§6 Reader-test 计划

本批次 scope

触发条件与等级

调度建议

§7 风险与开放问题

7.1 open-gap 列表

7.2 本 audit 不等于什么

7.3 公共入口修正短请求（提交给 Admin）

§8 下一步执行建议

§9 执行记录：低风险 rename 批次

§10 Skill / Pattern Preflight

10.1 本轮选用的 patterns

10.2 Skill 选择结论

10.3 对后续批次的约束

§11 Skill-enabled Rerun 记录

§12 执行记录：低风险 rewrite-lite 批次

§13 执行记录：N-7 checkpoint frontmatter + N-10 V1 design frontmatter 补齐

§14 V1 Design 7 个初稿深度内容审查

14.1 术语一致性

14.2 DAG 依赖合规

14.3 逐文档内容审查

(1) v1-user-journey-and-interaction-flow.md（330 行）

(2) v1-product-object-and-schema-design.md（366 行）

(3) v1-ui-ux-interaction-design.md（221 行）

(4) v1-agent-orchestration-design.md（186 行）

(5) v1-evaluation-initial-plan.md（242 行）

(6) v1-evaluation-review-and-acceptance-plan.md（154 行）

(7) v1-trial-operations-plan.md（193 行）

14.4 跨文档一致性总结

14.5 case_id ↔ filename 映射表

14.6 下一步建议

§15 执行记录：N-10 收尾 + V1 Design deepening 批次

15.1 N-10 收尾：剩余 7 个 design/ 文件 frontmatter

15.2 Agent Orchestration deepening

15.3 UI/UX deepening

15.4 Evaluation regression 策略

15.5 本批未执行

§16 Admin 裁定回写

16.1 OG-1（前缀规范）→ closed

16.2 OG-2（finclaw-reviewer 去留）→ closed