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;agent 转向后"可问责"定位待蓝图重估) | 当前 milestone 状态 |
| MP-3 | kelly_cap 字段语义与下游消费协议(已退役 2026-06-04,见 ADR-021) | superseded | ADR-021 · kelly_cap 退役 |
| MP-4 | 任务→必含字段动态组合契约(7 task_type × 17 字段矩阵;discriminated union) | signed | 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 子代理对照解剖 |
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(M1+ 实施初期补)
原"待写" ADR-005 / ADR-006 / ADR-007 / ADR-009 均已起草(draft,见 §1,状态列标注):ADR-007 owner 已签 accepted(M1 龙头);ADR-005/006/009 待 owner 签。本工作流命名空间下已无纯空缺待写 ADR(与 whitepaper-rewrite 同号 ADR 不同物)。§1 表含 accepted 与 draft。
5. 关联资产
- 主架构 §23 ADR INDEX 段:架构主稿 §23
- 变更协议:变更协议
- anti-bloat-guard:主架构防膨胀守门
- 27 项待拍板 owner map:pending-decisions-owner-map