docs(agents): ADR 合并禁令写入 AGENTS.md —— PD #14 + 两处动手前的分叉 (#6801)

[os-project-manager]

Fixes #6801

Fixes 而非 Part of:这张卡的交付面就是「AGENTS.md 里的一条款」,验收项(原文引用、
范围界定、撤回机制及其实测上限、交叉引用 #6785、CLAUDE.md 的取舍表态)全部在本 PR 内落
地,没有一项被范围性排除或推给决策箱。#6741 作为父裁决单仍开着(它还有 #6799 的 SKILL 半
边、#6785 的门禁半边),但那不是这张卡的范围。

落地了什么

#6741 要求 1 是一条 AGENTS.md 条款,此前从未落笔 —— origin/main 上 AGENTS.md 全文
搜不到任何与该裁决匹配的文字(前提复核见下)。补上三处,一处是权威落点,两处是手真正
会动的位置:

位置	行	性质
Prime Directive #14	AGENTS.md:142-150	权威落点(全文)
多 agent 协作纪律 §7 合并队列条	AGENTS.md:292-296	动手前的分叉(指针)
Post-Task Checklist 第 2 条	AGENTS.md:991-993	动手前的分叉(指针)

只有 PD #14 承载完整条款;另外两处是短指针,不复述裁决原文 —— 一句逐字引用在三个文件
里各存一份,迟早会漂。

PD #14 里逐项对着验收写的东西

• 原文引用、未翻译(AGENTS.md:144),与 ⛔ Discipline: ADRs are confirmed and merged by the maintainer only — no AI seat may merge, queue, or auto-merge a docs/adr/** PR #6741 同形,单独成 blockquote:
  「adr 只能由维护者自己确认,人工合并,ai 不得擅自合并。」
• 范围界得很死(AGENTS.md:146):起草 ADR、推分支、开 PR、评审中修订 —— 对每个座位
  照旧开放,本条一个字都不碰;被保留的只有落地:合并 / 加入合并队列 / 调
  enable_pr_auto_merge。判据取 PR 的文件面(不是它的自述),混合 diff 不按比例判 ——
  一条路径命中就够,要落别的就把 ADR 拆成单独 PR。「已复核 + 已批准 + 全绿」明确不构成
  例外:按 PD [WIP] Add Chinese version of the documentation #13,accepted ADR 就是那个决定,合并它等于采纳一个治理立场 —— 正好是
  「CI 绿」零信息量的那一类。worked example 用 docs(adr): ADR-0123 — layered master data, template/override linkage and the resolution organization (#4585) #6668。
• 撤回机制(AGENTS.md:148):已挂上/已入队时,只有转回 draft 才真的把它从合并队列里
  拿掉;disable_pr_auto_merge 单独调用只解除 arming、不解除队列成员资格。两件都做,再
  以远程读数确认它既不在队里也不在 origin/main 上。
• ⚠️ 并且记下这个机制的实测上限(AGENTS.md:150):draft 不是屏障。docs(adr),chore(devx): reconstruct ADR-0079 + make every cited ADR number resolve #6732 的远程读数
  是 draft: true 且 merged: true,merged_at = 2026-08-08T14:38:56Z,merged_by =
  os-project-manager —— 正是在那次 disable + 转 draft 的反转之后被合并的。draft 是减速带,
  屏障是 [governance] Enforce the ADR merge prohibition on the GitHub side — prose did not propagate; two seats merged docs/adr/** PRs within an hour of the ruling #6785。
• 交叉引用 [governance] Enforce the ADR merge prohibition on the GitHub side — prose did not propagate; two seats merged docs/adr/** PRs within an hour of the ruling #6785(同段),并把它存在的理由写成本条自己的失效记录:裁决落地后一小时内,
  两个不同的 AI 座位合了 ADR PR —— docs(adr): ADR-0048 addendum — publish-time / marketplace namespace exclusivity contract #6671 14:23:32Z / os-zhuang,docs(adr),chore(devx): reconstruct ADR-0079 + make every cited ADR number resolve #6732 14:38:56Z /
  os-project-manager;维护者确认两次都不是他本人,事后追认、仅限这两次、明示不设先例。
  末句写死:读到这里的座位并不因此获得判例外的资格 —— 本条没有例外可判。
• 兄弟条款 release workflow: publish pushes tags + npm but its version commit never reaches main — twice now (rc.3 c6a52d3, rc.4 a10cbc77); landing the commit must be part of the publish lane #6170(版本发布必须人工)以「同形」一句交叉引用,不在本 PR 里另立规则(见下面
  的范围外发现)。

三个判断,卡里没有替我定的

1. #6170 在 AGENTS.md 里没有家,所以「并排放」这个形状不存在

卡里说「先查 #6170 的发布禁令是否已经在 AGENTS.md 里有家,有的话并排放,那个配对是自然的
形状」。查了:没有。AGENTS.md 全文没有任何禁止 AI 座位执行发布动作的条款;该禁令目前
只存在于 .claude/skills/pm-dispatch/SKILL.md:2458-2468,即只有 PM 车道读得到的那一个文件
—— 与本卡描述的传播失败模式一模一样。

所以本条按自己的道理选址,而不是去贴一个不存在的邻居:PD #14 紧接 PD #13(#6741 要求 1
指定的自然位置,也是唯一一条已经管着 ADR 权威的 directive),外加两处分叉。⛔ 我没有顺手把
#6170 的禁令也写进 AGENTS.md —— 那超出本卡范围,已另行立单:#6830(未认领、未打标签,
留给 PM 分诊)。

2. 分叉为什么放在 §7 和 Post-Task 第 2 条

这两处是仓里仅有的两个指示座位去 arm auto-merge 的地方:§7 的
「arm auto-merge on a PR that is already green, accepted and non-draft」,和 Post-Task
第 2 条的「arm auto-merge so the queue lands it」。#6732 的成因不是谁决定要合 ADR,是照章执
行那条一般规则;所以分叉必须落在一般规则本身里,而不是只写在一条 directive 里等人事后
对照。两处都只有三四行、都指回 PD #14。

⛔ 考虑过但没有加的位置:Documentation Guardrails 表(AGENTS.md:546-554)。那张表管的是
「这个路径能不能编辑」,而本条恰恰允许编辑 docs/adr/**(起草照旧开放),只禁止落地。往
那张表里加一行会把编辑权和合并权混成一谈,正好糊掉本条最要紧的那条界线。

3. ⛔ 没有内联进 CLAUDE.md —— 判断与理由

CLAUDE.md 的自述判据是:只内联「遗漏会浪费或损坏其他 agent 的工作」的那几条(目前四条:
认领 issue、worktree-first、不许 stash、不许改 content/docs/releases/)。这四条同形:伤害
落在并行 agent 的在飞工作上、静默发生、事后基本不可逆。ADR 越权合并不是这个形状 —— 伤害落
在治理与维护者的决定权上,而且它有一个别的三条都没有的东西:正在建的机器执行层(#6785,
CODEOWNERS + 必需检查)。

正面理由(诚实记下,因为它不弱):CLAUDE.md 是被自动注入上下文的,AGENTS.md 要主动读 ——
那两个越权座位很可能上下文里有前者、没读过后者。但这恰恰是本卡自己的论点反过来用:已经
被实测证伪的是「把规则写进散文就能传播」;再加第四份散文拷贝不解决传播失败,只是把一句
必须逐字保持的裁决原文再复制一遍(漂移面 +1),同时稀释一张「这四条是会毁掉别人工作的」清单
的信号 —— 那张清单的力量来自它短且同质。真正的传播修复是 #6785:平台层拒绝,与任何座位读没
读过任何文件无关。

所以:AGENTS.md 一处权威 + 两处动手前指针,不进 CLAUDE.md。这是可推翻的判断 —— 维护者
若要它进,那是 CLAUDE.md 里加一段指向 PD #14 的事,几分钟的活。

前提复核(卡说的是线索,不是规格)

• origin/main @ e120a5a1d:AGENTS.md 里 grep -i adr 的 16 处命中全部是 ADR 编号引用或
  PD [WIP] Add Chinese version of the documentation #13 的「accepted ADR 有约束力」,没有一处涉及合并/入队/auto-merge 的禁令。前提成立。
• docs(pm-dispatch): ADR merge prohibition in Guardrails + ACCEPT path fork; probe-and-revive as the standing backstop; replay-wake identity check (#6741, #6747) #6799(SKILL 半边)尚未落地(open)—— 见 issue 上 PM 的更正评论。本 PR 的文件面是
  AGENTS.md,与它的 .claude/skills/pm-dispatch/SKILL.md 不相交,无序列化冲突。PD feat: Comprehensive CRM example demonstrating all ObjectStack protocol features #14 的
  措辞是自足的,不依赖 docs(pm-dispatch): ADR merge prohibition in Guardrails + ACCEPT path fork; probe-and-revive as the standing backstop; replay-wake identity check (#6741, #6747) #6799 落不落地。
• docs(adr),chore(devx): reconstruct ADR-0079 + make every cited ADR number resolve #6732 / docs(adr): ADR-0048 addendum — publish-time / marketplace namespace exclusivity contract #6671 的时间、merged_by、draft 状态都是从 GitHub 现读的(不是转抄卡里的表格),
  特别是 docs(adr),chore(devx): reconstruct ADR-0079 + make every cited ADR number resolve #6732 的 draft: true + merged: true —— 那条实测上限就靠它。

验证 —— 这是散文,没有机器读者断言它的内容

说清楚这一点,而不是造出测试形状的证据:本 PR 改的是一份 Markdown 规程文件,仓里没有任何
gate 断言这条款的内容为真(唯一会读 AGENTS.md 正文的是
scripts/docs-audit/check-audit-scope.mjs,它只锚定 RELEASE-OWNED 那一行,与本 diff 无关)。
下面的门禁绿只证明我没弄坏任何东西,不证明这条款写得对 —— 对不对由维护者判。

卡点名必须保持绿的两条,以及所有可能读到 markdown / 文档面的 gate,逐条真跑:

✓ check-skill-frame-sync self-test: 12 cases pass.
✓ check-skill-frame-sync: 4 copies of the decision frame are structurally isomorphic across 3 files
  binding sentence present in all 4; 4 count mention(s) agree; 42 markdown files scanned for undeclared copies.

✓ check-skill-compatibility-version self-test: 18 cases pass.
✓ check-skill-compatibility-version: 11 SKILL.md file(s) reconciled against 77 workspace packages

✓ check-skill-frame-freshness self-test: 12 cases pass.
  3/3 framework files are byte-identical to the ref (wording differences are not drift).

check-nul-bytes: OK (scanned 6367 tracked text file(s); ... no raw ASCII control bytes).
✓ doc authoring guard: 373 files clean — no bare metadata literals.
✓ docs-accuracy-audit scope is in sync with content/docs/: 178 hand-written doc(s).
✓ release-owned pages are in scope and read-only: 9 page(s) ... review-only.
check-role-word: OK (44 baselined file(s), no new occurrences).
✓ check-quick-reference-counts self-test: 9 cases pass.  ✓ 13 section(s) match.
check-adr-anchors: OK (EXIT=0; 118 decision number(s); 19898 citation(s) across 3255 file(s) resolve).
check-release-notes: OK — every released major has a curated, navigable release page.
✓ release-github-releases --self-test: 49 assertions.

pnpm test / pnpm typecheck 没跑,也不应该跑:diff 是 1 个 Markdown 文件、0 个包、0 行
TS —— 没有「受影响的包」这个东西。ESLint / TypeScript Type Check 两个必需 job 由 CI 在本 PR 上
跑,结论以那里为准(我会等它们收敛)。

字节纪律:node scripts/check-nul-bytes.mjs 绿,另加对改动文件的加宽自扫
(0x00-0x08 / 0x0b / 0x0c / 0x0e-0x1f / 0x7f),干净。

无 changeset —— skip-changeset

只改仓根一份 Markdown 规程文件,packages/ 下没有任何包被触碰,没有版本会动,发布说明也
无话可说。标签由本座位手工打上并读回(读回结果写在报告里),不是在正文里声明一下就算数。

⛔ 明确没做的事

• docs/adr/** 一个字没动(卡的硬范围)。
• CI 门禁([governance] Enforce the ADR merge prohibition on the GitHub side — prose did not propagate; two seats merged docs/adr/** PRs within an hour of the ruling #6785)、PM skill(docs(pm-dispatch): ADR merge prohibition in Guardrails + ACCEPT path fork; probe-and-revive as the standing backstop; replay-wake identity check (#6741, #6747) #6799)都没碰 —— 各自有卡。
• 没往 AGENTS.md 里补 release workflow: publish pushes tags + npm but its version commit never reaches main — twice now (rc.3 c6a52d3, rc.4 a10cbc77); landing the commit must be part of the publish lane #6170 的发布禁令(范围外,已立 [docs] AGENTS.md carries no version-release prohibition either — #6170's ruling lives only in the PM lane's SKILL.md #6830)。
• 没改 CLAUDE.md(判断见上)。

---

Generated by Claude Code

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

1 Skipped Deployment

Project	Deployment	Actions	Updated (UTC)
objectstack	Ignored		Aug 8, 2026 11:38pm