跳到主要内容

ADR-0002 · 生态级文档状态对齐 2026-06-11

2026-06-11 owner 通审通过（决定见 §5）；本 ADR 与 5 份 ecosystem 文档 delta 在 W7b 一并 commit。whitepaper.md 按方案 A（保守，加 hand-off banner，正文不动）落地。

1. 背景与触发​

ecosystem/ 下 5 份 active 文档全部 last-updated 2026-05-18 ~ 2026-05-28，距今 3 周未动；与 projects/finbayes 在此期间已发生实质性的活线决议之间存在张力。owner 2026-06-11 cleanup 中拍板"本轮就把 ecosystem 改名一起做 → 全面重写"。

实际盘点结果（grep）：ecosystem/ 不存在 finclaw → finbayes 改名残留——唯一一处 martin-FinClaw 提及在 glossary.md 是第三方项目专有名，不改。

"全面重写"的实质 = 生态文档与下列下游活线决议对齐：

下游活线决议触发的 ecosystem 修订面
arch-rewrite ADR-022 术语整顿glossary.md 术语对齐（问责→判断跟进+校准；三态结算→两层验证枚举；I-NN' → INV-NN）
whitepaper-rewrite ADR-009 战略立场降级 audit-trail（凭证 / 画像 / 付费层级 从 v2 不可妥协边界降为 v3 当前版本立场）+ arch-rewrite 2026-06-07 17 文件撤"FinBayes 不下单 / 不持账户凭证 / 不替决策" identity 级硬护栏current-baseline.md §10 金融风险边界 + object-registry.md FinBayes "当前不拥有" 段 + recovery-anchor.md "必须避免的误写" 段 + whitepaper.md 凭证相关章节
arch-rewrite ADR-024 基线切换 + ADR-025/026/028 骨架范式定型FinBayes "当前阶段状态" 从 "产品定义就绪 / 工程实施前置" 更新到 "阶段 1 主体已完成（ReAct pivot + 工具广度反超 martin + 灵魂重写）/ 阶段 2 战略对齐 + 反向矫正 未启动"
projects/finbayes/engineering/skeleton-architecture/ 落地（2026-06-11）object-registry.md FinBayes "当前拥有" 段补 WHAT 层骨架 + 工程架构契约层；recovery-anchor.md 当前阶段判断段更新
projects/finbayes-arch-rewrite 工作流活线维持 + 部分归档（W5）recovery-anchor.md 恢复路径段更新；current-baseline.md §13 证据锚点段更新

2. 级别判定​

按 change-protocol §1：L3 生态级变更。owner 同时担任生态发起人 + finbayes Controller，本轮 owner 自签视为通过；为审计追溯起见仍立 ADR。

3. 范围与边界​

本 ADR 范围内：

  • 5 份 ecosystem/*.md 全面对齐到 2026-06-11 下游事实源
  • 全部 last-updated 升 2026-06-11
  • 全部 status 保持 active（已是 active）
  • 凭证立场用"当前版本立场（v3 战略白皮书 §10）"措辞替换 v2"硬护栏"措辞，但显式标记保留方向性约束——"FinBayes 第一阶段产品立场（current state，可演化）：不下单 / 不持有账户凭证 / 不替最终决策"，与下游 FinBayes 战略白皮书 §10 + ADR-009 audit-trail 一致

本 ADR 范围外：

  • ecosystem 对象本身的删除 / 新增 / 重命名（仅 state 对齐，不动 3+2 结构）
  • 任何 projects/ 文档的同步性修订（projects/finbayes 在 W1-W6 已对齐）
  • 任何工程仓的修订

4. 5 份文档 delta 摘要​

详细 diff 见落地 commit 65b70c9（docs(ecosystem): align ecosystem docs to FinBayes activity state + 凭证立场降级 + ADR-022 (ADR-0002)）；通审用 delta 草稿留存于仓外工作目录 .agents/finbayes/cleanup-2026-06-11/ecosystem-rewrite/（不入库）。

4.1 object-registry.md​

  • 表 §"FinBayes" 当前状态：Active / 产品定义就绪 / 工程实施前置 → Active / 阶段 1 主体已完成 / 阶段 2 战略对齐 + 反向矫正 未启动
  • §"FinBayes" 当前拥有：补一句"通用 AI Agent 骨架（WHAT 层） + FinBayes 工程架构实例（子系统 / 契约事实源）"
  • §"FinBayes" 当前不拥有：用"第一阶段产品立场（current state，可演化）"措辞替代硬约束措辞；引用 ADR-009 audit-trail
  • 全表 last-updated 升 2026-06-11

4.2 current-baseline.md​

  • §1 当前状态总览：FinBayes 行 "第一阶段状态" 列改为 "阶段 1 主体已完成；阶段 2 未启动"
  • §10 金融风险边界：在两段开头加引言"以下边界为各产品第一阶段产品立场（current state，可演化），不再作为 identity 级 hard constraint"
  • §13 证据锚点：新增一行"FinBayes 活线 milestone 状态 | governance/workstreams/finbayes-arch-rewrite/CURRENT-MILESTONE.md"
  • §14 当前未决问题：新增一项"FinBayes 认知 / 执行边界 + 交易执行约束方案的最终形态（详见战略白皮书 §10 未决六）"

4.3 recovery-anchor.md​

  • "五个核心对象的当前口径" FinBayes 行 关键边界列：把 "不下单、不调仓、不持有账户凭证、不替用户承担最终决策责任" 改为 "第一阶段产品立场（current state，可演化）：FinBayes 提供金融认知输出与判断跟进；不主动下单 / 不持有账户凭证 / 不替用户承担最终决策——后续随用户体验与使用证据可调"
  • "必须避免的误写" 第 3 项 措辞更新："把 FinBayes 的条件化行动判断、反方证据或复盘提示误写成无授权真实交易执行" 保留 + 增一句"反之亦不应误写为 'FinBayes 永远不可能接触执行' 的 identity 级 hard constraint，详见战略白皮书 §10 未决六"
  • "当前阶段判断" 段：在末段补 "其中 FinBayes 阶段 1 主体已完成；阶段 2 未启动（详见 CURRENT-MILESTONE.md）"
  • "恢复路径" 步骤 1 ~ 3 顺序不变；步骤 3 末段补 "若需理解 FinBayes 活线决议，先读 governance/workstreams/finbayes-arch-rewrite/CURRENT-MILESTONE.md"

4.4 whitepaper.md​

风险大：397 行 + 涉及多处凭证 / 认知-执行分工 措辞。建议只动 frontmatter + 几个最关键的句子，不做正文 paradigm shift。

提议方案 A（保守，推荐）：

  • frontmatter last-updated 升 2026-06-11
  • 加 hand-off banner 在头部：「凭证 / 认知-执行分工 立场已由 v2 不可妥协边界降为 v3 当前版本立场（详见 FinBayes ADR-009 audit-trail）；本白皮书相关章节正文待 v2.0 全面重写时同步修订」
  • 正文不动

提议方案 B（重写，需更长会话）：识别所有 "FinBayes 不下单 / 不持账户凭证" 类硬措辞、按 ADR-009 措辞改写。预计 6-10 处修改。

草案默认采用方案 A。owner 选 B 则单独排期。

4.5 glossary.md​

  • frontmatter last-updated 升 2026-06-11
  • 应用 ADR-022 术语整顿：
    • 添加新术语条目：判断跟进 + 校准（取代 "问责"）
    • 添加：两层验证枚举（取代 "三态结算"）
    • 添加：市场结构分轴（取代 "市场结构横切维度"）
    • 添加：INV-NN（取代 I-NN'）
  • 添加一条：AI Agent 骨架（WHAT 层）— FinBayes 工程架构上游的领域无关骨架定义
  • 添加一条：判断台账复盘 — FinBayes 阶段 2 灵魂线候选

5. 决定 (Decision)​

owner 同意以本 ADR 为本次 ecosystem 全面重写的 audit trail；5 份文档 delta 草案落盘 .agents/finbayes/cleanup-2026-06-11/ecosystem-rewrite/；owner 通审通过后 W7b 一次性 commit 到 ecosystem/ 与 governance/decisions/。

6. 后果 (Consequences)​

  • ecosystem 与 projects/finbayes 状态一致；不再误导新读者 FinBayes "尚未启动工程实施"
  • 凭证立场可演化 audit-trail 在 ecosystem 层落地（避免下游 cold-read 误认为 identity 级 hard constraint）
  • glossary 与 ADR-022 术语整顿对齐

7. 公示期​

本 ADR L3 级，按 change-protocol §6.3 L4 才需 7 天公示。owner 自签当日生效。