IR-0003: 重订宪法（治理体系 v2）

[randypanding]

IR-0003：重订宪法（治理体系 v2）

状态：signed（randypanding，2026-08-21，对话内签署）
核心附件：specs/IR-0003/constitution.md（宪法 v2.2，经红笔审查后签署）
关联：#128（IR-0001）、#129（spec v3）、#126/#127（方法论）

job

将治理体系从"散文 ADR + 期望状态脚本"重构为 IR/spec 宪法体系：以宪法 v2 为治理
唯一真相源；旧 ADR 归档不删除（标 active/superseded/archived 迁 archive 仓留墓碑索引）；
并补齐五大能力——独立仲裁内核、管家层（永不自醒+统一入口）、验证三层梯
（确定性关卡/校准 verifier/指导层）、硬谓词信任门（shadow 域解锁）、状态可视化
（label 唯一真相源 + Project 只读投影板）。

关键裁决（摘自宪法 v2.2，红队挑战对象）

1. 判断不可压缩；LLM 永无合并权（归自动合并基础设施）/approve 权/授权裁决权。
2. 信任门 = 硬谓词白名单（缺证据=拒绝）+ shadow 域解锁（≥50 例一致且零逃逸）；
   废除 spec v3 的 risk-score 标量与 ceiling 40（spec v4 修订）。
3. 验证三层梯：T1 确定性关卡全景 / T2 校准 verifier（LLM-as-a-Verifier 范式，
   arXiv:2607.05391 + 同名开源项目，持证上岗+校准+标注负债申报）/ T3 指导层（品味残余）。
4. 判定物有效性宪法化：变异分数 + 负控制 + 跨族生成 + 每周种子缺陷演习 + holdout 泄漏诱饵。
5. 管家六职（账本/卫生/仲裁转介/预算/停滞/审计包），唤醒矩阵驱动，永远不自己醒来。
6. 统一入口协议：各仓 AGENTS.md 同一协议块，卡 issue 唯一工作凭证，agent 无需人类补提示词。
7. 公共知识署名规则：凡引入的外部范式/工具/基准必须注明源头（可审计可追溯）。
8. 业务模式推论：agent 任务轨迹成为第四观测类；archive 仓升级为数据飞轮战略资产；
   自训练模型与 provider 模型同一入职考试；FDE 交付复用主流水线（现在不建）。

与 IR-0001 的关系

继承并扩展 IR-0001；冲突条款以本宪法为准，修订清单见 specs/IR-0001/AMENDMENTS-v4.md。

人类愿意接受的验收证据

• 宪法文件合并入 specs/IR-0003/ 且经跨族红队挑战（报告贴于 spec PR）。
• 旧 ADR 迁移完成，adr-required 关卡改查墓碑索引后通过（W1-C1）。
• W1 全部卡合并后：干净容器陌生 agent 仅读 AGENTS.md 完成认领并开 PR（AC-2 复测）。

非目标

• 不删除任何历史 ADR/记录（归档 ≠ 删除）。
• 不建设训练管线/客户交付管线/多角色组织治理（宪法 §13 非推论清单）。
• 不改变现行 rulesets 语义（新增式落地，可整体回退）。

预算与可逆性

• W1 各卡走 C1 流程（PR+ADR+owner-merge）；全部设施新增式可拆。
• 红队：本 IR 的 spec（宪法 v2.2）由跨族红队（LongCat-2.0，与执行者不同族）挑战后合并。

[cloudbrid-agent]

spec-author 完成（BEH-01）：spec PR → #162
计量：model=glm-4.5-air tokens=2455 latency=18314ms
状态转移由 conductor 跟进（state:spec）。

[randypanding]

spec PR 已开：https://github.com/Cloudbird-Software/.github/pull/163（跨族红队进行中，报告将贴于 PR 评论；清零前请勿合并）

[randypanding]

WavePlan（specs/IR-0003/wave-plan.md，随 PR #163）

• W0 编排底座（W0-C1: 第一期 LLM 接入与计量（secret + wrapper + AR-3 修订 ADR） #130-134，进行中）
• W1 立宪与骨架：archive+ADR 迁移 · arbiter 内核 · 入口协议+Project 板 · holdout 仓 · 管家骨架
• W2 测试合规内核：quality/ + spec lint + test-first 拓扑 + 计量 wrapper + OCR shadow
• W3 Bug 流水线 + patrol
• W4 红队与 holdout 设施
• W5 整洁关卡全量 + 信任门 + 度量

W1 卡待红队清零后开出。

[randypanding]

W1 卡已开出（红队清零后，PR #163 待 owner merge）

• W1-C1: archive 仓创建与旧 ADR 归档迁移（重订宪法主体） #164 W1-C1 archive 仓 + 旧 ADR 归档迁移（state:ready）
• W1-C2: arbiter 仓与仲裁内核 v1（无 LLM/默认拒绝/CAS/台账） #165 W1-C2 arbiter 仓与仲裁内核（state:ready）
• W1-C3: 统一入口协议块 + Project 只读投影板 + dashboard 账本 #166 W1-C3 统一入口协议块 + Project 板 + dashboard（依赖: W1-C2）
• W1-C4: holdout 仓创建（条目 schema + 封存约定 + 泄漏诱饵） #167 W1-C4 holdout 仓创建（state:ready）
• W1-C5: 管家骨架（唤醒矩阵 + 审计日志 + dead-man 心跳 fail-closed） #168 W1-C5 管家骨架（state:ready）

宪法 v2.3 已经跨族红队清零（报告见 PR #163 评论）。本 IR 进入开发阶段。

[randypanding]

W2–W5 全量派卡（2026-08-22，wave-planner 执行）

W1 已收口（#164-168 全关闭，PR #195 已合并），现按波次计划一次派出全部剩余 14 张卡：

W2 测试合规内核（state:ready，可立即认领）

• W2-C1: quality/ 骨架 + contract.yaml + spec lint（EARS/禁词/追溯闭合）+ g010 #214 W2-C1 quality/ 骨架 + contract.yaml + spec lint + g010
• W2-C2: 测试产物拓扑（fail-before + lock-tests + g060 + Makefile 三命令） #215 W2-C2 测试产物拓扑（fail-before + lock-tests + g060 + Makefile）
• W2-C3: 计量 wrapper 完整版（invoke 聚合 + hash 链 + 预算通道） #216 W2-C3 计量 wrapper 完整版
• W2-C4: OCR shadow 接入（钉版 + 后处理 + post-fix precision 管线） #217 W2-C4 OCR shadow 接入

W3 Bug 流水线 + patrol（依赖 W2，解锁后置 ready）

• W3-C1: Bug 流水线（env-gate + 哨兵自证 + 三值判定 + cannot-reproduce） #218 W3-C1 Bug 流水线（三值判定）
• W3-C2: patrol 巡逻服务（三源场景 + 去重频控 + 毕业机制） #219 W3-C2 patrol 巡逻服务

W4 红队与 holdout 设施（依赖 W2）

• W4-C1: 语义熵分歧度量（k=5 跨族 + 聚簇 + 底噪扣减 + 交叉质询） #220 W4-C1 语义熵分歧度量
• W4-C2: 恶意合规 adversary（judge-deep 锁定 + 套件不充分判定） #221 W4-C2 恶意合规 adversary
• W4-C3: holdout 揭封 gate（hash 校验 + 计数化 + 详情回写 + 日志审计） #222 W4-C3 holdout 揭封 gate
• W4-C4: 活体演习链路（周种子缺陷注入 + 诱饵联动 + 缺席 fail-closed 演练） #223 W4-C4 活体演习链路

W5 整洁关卡全量 + 信任门（依赖 W3+W4）

• W5-C1: 整洁关卡组全量（结构 + AI 导航 + 抗复杂度 + 棘轮） #224 W5-C1 整洁关卡组全量
• W5-C2: 硬谓词信任门 + shadow 域解锁（替代 risk-score） #225 W5-C2 硬谓词信任门 + shadow 域解锁
• W5-C3: verifier 入职考试 CI + 校准集循环 + AI 可读性 rubric shadow #226 W5-C3 verifier 入职考试 + AI 可读性 rubric
• W5-C4: 度量 dashboard 完整版（北极星对同屏 + 四类指标 + 板字段） #227 W5-C4 度量 dashboard 完整版

依赖解锁目前由 conductor/owner 执行（BEH-04）；全部卡含 GWT AC + blastRadius + 预算，C1 路径须附 ADR。

[randypanding]

IR-0003 收口（owner 关单）。宪法 v2 建设波次 W0-W5 全部完成。

验收证据（对照本 IR「人类愿意接受的验收证据」）

1. 宪法文件合并入 specs/IR-0003/ 且经跨族红队挑战：PR spec(IR-0003): 宪法 v2.2 + spec v4 修订 + 波次计划 #163（spec/IR-0003：宪法 v2.2 + spec v4 修订 + 波次计划，LongCat-2.0 跨族红队后签署）——W1 期完成。
2. 旧 ADR 迁移完成、adr-required 关卡改查墓碑索引后通过：W1-C1（W1-C1: archive 仓创建与旧 ADR 归档迁移（重订宪法主体） #164，ADR-0053）；本波次新增 ADR-0060..0073 按索引世界流程落位（agent-registry#79 + archive#2，含 verify_migration born-in-archive 例外勘误）。
3. W1 全部卡合并后 AC-2 复测：TEST-CARD e2e: 入口协议演习卡（自动关闭） #206 演习卡 + test(drill): 入口协议 e2e 演习——陌生 agent 全路径（W1-C3 #206，ADR-0055） #212 e2e + fix(conductor): sender_role 两级解析（GOV_TOKEN 成员资格 + APP_TOKEN 仓级 admin 兜底）（W1-C3 #166，ADR-0055） #213 修复链——W1 期完成。
4. （新增）W2-W5 十四卡全部合并关单：

波次	卡	PR 链	ADR
W2	#214-217	ts#27-29/#30 · ciw#53/#54 · gh#231 · ar#4	0060-0063
W3	#218-219	ciw#57/#58 · gh#241/#243	0064/0065
W4	#220-223	ciw#55/#56/#59-62 · gh#244-247 · holdout#2 · reg#81 · arc#5	0066-0069
W5	#224-227	ts#31-38 · ciw#63/#64 · arbiter#4 · arc#6/#7 · reg#82 · gh#249-255	0070-0073

波次退出判据状态（诚实口径）

• W2：test-first→锁定→实现 git 历史可证（[P1] 模板无完整性校验：template-service 派生零 checksum 验证 #30 双 commit 拓扑+CI 红绿记录）✅；OCR shadow 实跑有记录（ciw#53 PR 内 7m29s+drop_rate 指标）✅——「2 个仓」的接入面 workflow_call 已就绪，fleet 推广属后续。
• W3：bug 流水线三值判定 live e2e（demo(W3-C1): 复现判定 e2e——故意红 fixture（BUG-9001） #236/demo(W3-C1): 证伪场景——base 上不显现（BUG-9002） #237/demo(W3-C1): BUG-9002 同指纹三次上报（去重演示·加固后） #242 demo 单实录）✅；「一个真 bug 全链路」待生产期首个真实 bug（机制全就位）；误关率抽样机制运转 ✅。
• W4：红队完整攻击报告（adversary 弱/强套件双形态、entropy 植入歧义定位条款）✅；演习红率 100%（1/1，gitleaks 样本→org-hygiene 红）✅——「≈100%」随周演习持续验证。
• W5：整洁关卡/信任门/考试 CI/dashboard 全量就位 ✅；「连续若干 PR 无误报阻断」「第一域 shadow 数据累积」为运行期指标——机制已上线、数据已开始累积（trust-shadow 首条 would-reject 记录、OCR shadow 首日 JSONL、北极星账本 管家账本 dashboard（factory-floor） #200 v2 版式、演习台账）。

收口健康检查（2026-08-21T22:2x）

• governance-drift success（§12 待接入计数、§17 协议块一致、全节绿）
• .github / template-service / CI-Workflows main CI 全绿；butler-heartbeat 正常
• IR-0002（IR-0002: drift-check §12 活体误报治理（区分「从未接入」与「接入后消失」） #143）已于本波次前置收口（PR feat(governance): §12 待接入计数汇总行 + IR-0002 (a)/(b) 分类器自测入 CI（IR-0002 #143 收口，ADR-0034/0058） #228 + 自测入 CI）

遗留与 owner 待办（不阻塞本 IR）

• canary（agent-registry governance-tests）main 连续红：C4/C5/C6 预期与本波次后的现实脱靶——需裁决修正方向 #257：agent-registry canary main 连续红（既有故障，早于本波次；C4/C5 预期脱靶需 owner 裁决，C6 钉点机械修复可派卡）
• owner 配置：verdict environment 的 HOLDOUT_UNSEAL_TOKEN（细粒度 PAT，仅 holdout contents+issues:write）；patrol issue_mode draft→gh 的启用决策；metrics.yaml 季度配额回填；verifier 金丝雀月度轮换
• 后续卡建议：v1 大版本 tag 推进与全 fleet 钉点刷新流程化、INV-08 镜像对账覆盖新增阈值段、棘轮分批收紧、月度 agent 定位校准