finbayes-arch-rewrite 工作流 ADR 索引
0. 范围与 namespace 说明
本索引列出 finbayes-arch-rewrite 工作流下所有已 accepted 的 ADR + supplement。本索引为 arch-rewrite namespace——同号 ADR 在其它工作流可能指代不同决议（如 ADR-008 在本工作流为「LLM Provider 接口抽象」，在 finbayes-whitepaper-rewrite 工作流为「StructuredCognitionResult 输出契约」+ supplement「机制层输出契约扩展」）。跨工作流引用任何 ADR-NNN 须显式带 <workstream>/ADR-NNN 前缀；不带前缀默认指本工作流（详见 §3 跨工作流同号 ADR 消歧）。承接 Step 5 RCA R6 整改表 3（F1 + C3-T4：ADR namespace + INDEX）。
1. ADR 列表
| ADR-NNN | 标题 | 状态 | 关联 |
|---|---|---|---|
| ADR-001 | 工程范式：Harness Workflow + 里程碑切片 + 走通骨架试点 | accepted | 全篇（特别是 架构主稿 §25 / §27） |
| ADR-002 | 架构文档结构：分层章节 + C4 画图 + 决策独立成档 + 业务建模思路 | accepted | 全篇文档结构（架构主稿 全章节） |
| ADR-003 | 工程实施栈与协作模式：OpenSpec + Archon + Claude Code 主理 + Codex 实现 | accepted | 架构主稿 §25 / §27；anti-bloat-guard |
| ADR-004 | 自然语言到任务的识别策略：LLM Function Calling 主导 | accepted | 架构主稿 §4 / §9 / §10 / §21 |
| ADR-005 | 内部并发原语：Python asyncio（结构化并发 TaskGroup）—— 业务并发在 M2 兑现 | accepted（2026-05-31 随 ADR-014 签） | 架构 §12 |
| ADR-006 | 部署形态优先级：本地优先单机（远程托管远期） | accepted（2026-05-31 签） | 架构 §14 |
| ADR-007 | 状态写入两步（candidate→confirmed）—— M1 状态化龙头决策 | accepted（2026-05-31 D1-D5 全签） | 架构 §11.4/§11.5；上承 ADR-016 |
| ADR-008 | LLM Provider 接口抽象：统一 OpenAI-compatible | accepted | |
| ADR-009 | Prompt 版本化策略（代码/数据混合 + 规范§9 作适应度函数）—— 实现 M1+/M7 | accepted（2026-05-31；§4 六项已决，第6项提示词保密标 M2+） | 综合层认知输出规格；架构 §19 |
| ADR-010 | 输出端凭证过滤位置：综合层语义级 + Output Pipeline 格式级 双处 | accepted | 架构主稿 §9 / §17 / §20 |
| ADR-011 | FB-RESUME 长周期 Session 失忆防御协议（状态硬化 + Resume Prompt 标准化 + dump SOP） | accepted | CURRENT-MILESTONE.md · FinBayes 当前状态单一事实源 |
| ADR-012 | SVA-9 战略愿景对齐九层防御方案（L0.5-L8 九层 + 与既有 6 层关系） | accepted | 战略不变量 codify · L0.5 层（10 条核心）；承接 ADR-001 工程范式 + ADR-003 工程实施栈与协作 |
| ADR-013 | codify 哲学换轨（Build-Y 优先 + Require-X-when-Y 条件式 + 三级硬度）—— SVA-9 L0.5 层方法论 SOP | accepted | 13 条契约型不变量 deep design spec；承接 ADR-009 战略立场降级 audit |
| ADR-014 | 实现语言与核心运行时技术栈（Python 追认 + 多语言演进触发器/兜底） | accepted（2026-05-31 签） | 架构主稿 |
| ADR-015 | M0 验收 gate 从 scalar-U 重定为底线向量 + M0 close（密度短板转横切表达项→M2；R6 已坐实 close） | accepted | 当前 milestone 状态；证据 FinTecEval runs/2026-05-31-R4/R5/R6；对价 MP-4/MP-5 |
| ADR-016 | M1 范围界定：M1 = 状态化 only，认知核实化拆为 M1.5（解 arch §25 ↔ 字段演化矩阵不一致） | accepted | arch §25；字段演化矩阵；落地 ADR-007 |
| ADR-017 | 会话记忆装配策略：分层记忆 + 可替换装配口（长期检索方法待定，RAG 不预设为最优） | accepted（框架；检索方法挂 ADR-014 触发点待评） | 架构 §11.1 Snapshotted；承 ADR-014/ADR-007 |
| ADR-018 | 真算切片 LLM 输出抖动鲁棒性强制验收（done 充要 5 条：抖动 fixture + 容错解析 + 单点不击穿降级 + 异常纪律 + 真 provider live 烟测） | accepted（2026-06-01） | 当前 milestone 状态 |
| ADR-019 | posterior 用户面翻译措辞对齐 MP-3（「仓位上界·非仓位建议」） | superseded（ADR-021，2026-06-04） | ADR-021 · kelly_cap 退役 |
| ADR-020 | 可问责金融 Agent 定位 + 三判官评测架构（事实闸门 / 校准账本 / 真人偏好） | accepted（2026-06-03）；"可问责"伞形概念已由 ADR-022 重新摆位为「判断跟进+校准」组件能力 | 当前 milestone 状态 |
| MP-3 | kelly_cap 字段语义与下游消费协议（已退役 2026-06-04，见 ADR-021） | superseded | ADR-021 · kelly_cap 退役 |
| MP-4 | 任务→必含字段动态组合契约（7 task_type × 17 字段矩阵；discriminated union） | signed（落地载体已由 ADR-028 降为内循环软质量指引、不作 forced toolChoice；ADR-029（proposed）拟进一步降为 prompt 协议；字段语义不变） | tasks-fields-mapping.yaml；承接 ADR-008 supplement §3 |
| MP-5 | 字段暴露面分层契约（user_widget / internal_audit / both + 用户面 block list） | signed | field-surface-mapping.yaml；承接 战略白皮书 §5 用户产品不暴露体系本身 |
| ADR-021 | kelly_cap 退役（移除字段 + 退役 MP-3 / ADR-019 / 不变量 I-06'） | accepted（2026-06-04） | supersedes MP-3 + ADR-019；落地 FinBayes 684d69d |
| ADR-022 | 术语整顿与统一编号命名规范（问责→判断跟进+校准、交易决策参考材料、市场结构分轴、去撇号 INV-NN 等 + 阶段3重定义） | accepted（2026-06-05） | 修订「行动判断」弃用决议 + 重新摆位 ADR-020；底稿 术语审词裁决表 + 代号与编号索引 |
| ADR-023 | 方案 Z 对 martin-FinClaw 立场修正（只读不复用 → 研究/借鉴/集成，守不 rebase 单体）+ Phase 0→3 借鉴 audit trail | accepted（2026-06-04） | 记录方案 Z 立场修正；落地 金融真智能体骨架蓝图 9 子代理对照解剖 |
| ADR-024 | 基线选定 CurvatureLabs/FinBayes（承认 5/20-5/26 已有路线）+ 工作流执行范式 | accepted（2026-06-06） | 四方对比 + 两阶段框架；上游 CURRENT-MILESTONE |
| ADR-025 | agent 骨架范式定型：纯 ReAct + 输出要素规范 + 快慢两条线 + 不架控制墙铁律 | accepted（2026-06-07） | 七仓核证锚 agent-skeleton-paradigm-catalog；附下位对齐 backlog（波1-3）；上游 §9 |
| ADR-026 | INV-13 S1AlwaysActive 从「主回路外强制必跑 + N=3 强制回路」重定义为「s1 字段必含输出 schema」 | accepted（2026-06-07） | 承接 ADR-025 §决策5；同步矫正 ADR-008-supplement §2.6 / contracts/yaml / 不变量层 / 评测维度 |
| ADR-028 | ADR-025/026 骨架范式即时生效声明 + 阶段 1 Step 1.0-1.7 范围按 ReAct + 三线重判 + 闸门定义校准（vs martin 6 维度 ≠ FinBayes 旧版 Package C）+ 同 provider 同条件硬约束 + 主控会话角色合并 | accepted（2026-06-07 晚） | 上位 ADR-024/025/026；锁定 finclaw/cognition/ = static pipeline 错实现 实现抛弃目的保留；工程仓 commit 3abecb7/ef94dd8 audit trail 处理在内 |
| ADR-029 | 结构化认知载体重定位：MP-4/MP-5/react_cognition 的落地载体从 runtime 强制降级为 prompt 层协议引导（13 条契约不变量文字不动，改为评测期校验输出） | proposed / draft（待 owner 审议，非生效；转正路径 = §5.1 Phase A 实证，详下） | 触发证据 2026-06-09 BTC/NVDA 6-arm 实测；承接 ADR-013/ADR-025/ADR-028；部分修订 MP-4/MP-5 落地载体 |
| ADR-030 | DataHorizon ↔ FinBayes 数据接口分工：DH 管 provider 配置 + 生产高价值资产，FinBayes 自持取数容错（商品化数据直连 ccxt/vendor，vendor 仅回退） | proposed / draft（待 owner 审议，非生效） | 触发 2026-06-22 取数容错根因整改；承接 ADR-025；落地见 DataAcquisition 子系统设计 |
| ADR-031 | FinBayes 数据能力内化分诊：商品化直连 / 差异化归 DH + 首条目实时/盘后股价 | accepted；“DH 过渡桥/用量必降”部分由 ADR-033 覆盖 | 保留分诊三问、实时/盘后股价直连和当前免费档决策；见 ADR-033 |
| ADR-032 | FinBayes 执行边界：交易工具准入须带确认闸（用户确认 + 必要时 double-confirm；不硬禁交易动作执行，约束单位是交易动作、非泛执行） | accepted（owner 2026-06-24 签） | 触发 2026-06-24 办事级评测「裸执行」发现（commit 0e1d32b）；口径为 owner 既有方向（2026-06-24 校正收窄至交易工具）；关联 ADR-025 不架控制墙、ADR-007 状态两步、ADR-031 |
| ADR-033 | Data Horizon 独立定位 + FinBayes evidence-driven sourcing | accepted（owner 2026-08-25 签） | 传播 ecosystem ADR-0007；覆盖 ADR-031 中“DH 过渡桥/终局全量内化/用量必降”的部分，不改变商品化直连决策 |
ADR-029 状态提示：proposed，属阶段二 cognition 形态决策，尚未驱动工程；其 Phase A 实证（NVDA + 5 题分层样本复现 BTC 模式）即「人格/提示词预研线」，完成后才 PROPOSED→ACCEPTED。
ADR-027 留白：原 ADR-027 起草后由 owner revert（自创 P0/P1 术语违反 ADR-022 术语纪律），编号留空作 audit trail，下次新 ADR 跳号至 ADR-028。
2. supplement 列表
| supplement | 标题 | 状态 | 关联 |
|---|---|---|---|
| ADR-003 supplement 三阶段实施 SOP | 三阶段实施 SOP（plan / execute / verify）：SVA-9 的 L3 层落地物 | accepted | 承接 ADR-003 工程实施栈与协作；上承 ADR-012 SVA-9 L3 |
| ADR-003 supplement 2 milestone 执行 locus | milestone 工作流执行 locus = 工程仓 + gate 工具栈 uv/ruff/pytest（承 A3 实测，解 B4） | accepted | 承接 ADR-003 工程实施栈与协作；落地 当前 milestone 状态 |
跨工作流 supplement 不变（如 ADR-008 supplement 机制层输出契约扩展 仍归 finbayes-whitepaper-rewrite）。
3. 跨工作流同号 ADR 消歧
| 编号 | 本工作流（arch-rewrite） | finbayes-whitepaper-rewrite 工作流 |
|---|---|---|
| ADR-008 | LLM Provider 接口抽象（统一 OpenAI-compatible 接口契约） | 战略层与架构层关于结构化认知输出的对齐 + ADR-008 supplement 机制层输出契约扩展（StructuredCognitionResult 10 要素 + 1.1 升级 6 字段 + 1 元数据） |
跨工作流引用须显式带 <workstream>/ADR-NNN 前缀。本工作流未来若新增 ADR 与其它工作流编号冲突，按下一可用编号分配，不复用旧号；冲突归口由 变更协议 L3 流程裁决。
4. 原待写 ADR 的收口状态
原“待写” ADR-005 / ADR-006 / ADR-007 / ADR-009 已于 2026-05-31 全部由项目 owner 签为 accepted，状态与 §1、各 ADR frontmatter 及 contracts/adr-states.yaml 一致。本工作流命名空间下已无这四项遗留空缺。
5. 关联资产
- 主架构 §23 ADR INDEX 段：架构主稿 §23
- 变更协议：变更协议
- anti-bloat-guard：主架构防膨胀守门
- 27 项待拍板 owner map：pending-decisions-owner-map