跳到主要内容

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 / §27anti-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-008LLM Provider 接口抽象:统一 OpenAI-compatibleaccepted
ADR-009Prompt 版本化策略(代码/数据混合 + 规范§9 作适应度函数)—— 实现 M1+/M7accepted(2026-05-31;§4 六项已决,第6项提示词保密标 M2+)综合层认知输出规格;架构 §19
ADR-010输出端凭证过滤位置:综合层语义级 + Output Pipeline 格式级 双处accepted架构主稿 §9 / §17 / §20
ADR-011FB-RESUME 长周期 Session 失忆防御协议(状态硬化 + Resume Prompt 标准化 + dump SOP)acceptedCURRENT-MILESTONE.md · FinBayes 当前状态单一事实源
ADR-012SVA-9 战略愿景对齐九层防御方案(L0.5-L8 九层 + 与既有 6 层关系)accepted战略不变量 codify · L0.5 层(10 条核心);承接 ADR-001 工程范式 + ADR-003 工程实施栈与协作
ADR-013codify 哲学换轨(Build-Y 优先 + Require-X-when-Y 条件式 + 三级硬度)—— SVA-9 L0.5 层方法论 SOPaccepted13 条契约型不变量 deep design spec;承接 ADR-009 战略立场降级 audit
ADR-014实现语言与核心运行时技术栈(Python 追认 + 多语言演进触发器/兜底)accepted(2026-05-31 签)架构主稿
ADR-015M0 验收 gate 从 scalar-U 重定为底线向量 + M0 close(密度短板转横切表达项→M2;R6 已坐实 close)accepted当前 milestone 状态;证据 FinTecEval runs/2026-05-31-R4/R5/R6;对价 MP-4/MP-5
ADR-016M1 范围界定:M1 = 状态化 only,认知核实化拆为 M1.5(解 arch §25 ↔ 字段演化矩阵不一致)acceptedarch §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-019posterior 用户面翻译措辞对齐 MP-3(「仓位上界·非仓位建议」)superseded(ADR-021,2026-06-04)ADR-021 · kelly_cap 退役
ADR-020可问责金融 Agent 定位 + 三判官评测架构(事实闸门 / 校准账本 / 真人偏好)accepted(2026-06-03;agent 转向后"可问责"定位待蓝图重估)当前 milestone 状态
MP-3kelly_cap 字段语义与下游消费协议(已退役 2026-06-04,见 ADR-021supersededADR-021 · kelly_cap 退役
MP-4任务→必含字段动态组合契约(7 task_type × 17 字段矩阵;discriminated union)signedtasks-fields-mapping.yaml;承接 ADR-008 supplement §3
MP-5字段暴露面分层契约(user_widget / internal_audit / both + 用户面 block list)signedfield-surface-mapping.yaml;承接 战略白皮书 §5 用户产品不暴露体系本身
ADR-021kelly_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 trailaccepted(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 执行 locusmilestone 工作流执行 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-008LLM 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. 关联资产