CLAUDE.md becomes a pointer to AGENTS.md — the two inlined rules and their hook pointers leave

[os-justin]

Maintainer direct instruction to the skills seat (session session_01MoTv7pn338AZ71owsp19gQ, GitHub os-justin), given in that PM session's chat on 2026-09-09 at 13:3xZ and 13:4xZ, verbatim, untranslated:

「看一下 hotcrm 的agents.md 写的太乱了。只留下必要的。包括同时同时审核 hotcrm 的skills 任务，合并派发处理。」

「首先要明确 hotcrm 是元数据应用，平台功能应该在 objectstack中开发。 其次 claude.md 是不是直接让他阅读 agents.md 即可，没必要维护两套。所有仓库都有类似的问题」

Program anchor: #17161 (the shape, the four-axis note and the known cost are recorded there once).

This repo

CLAUDE.md (25 lines on origin/main) restates worktree-first and the stash ban with their hooks. After this card it says one thing: AGENTS.md is the source of truth, read it before anything else — nothing more. .claude/hooks/ keep enforcing both rules; AGENTS.md 〈9. Operational Rules〉 already carries them (verify by grep before deleting). Gates that list CLAUDE.md (check-governed-queue-guard.mjs, check-upstream-port-parity.mjs, the doc-link and shell-residue scans) are re-run; any that requires prose in CLAUDE.md adapts in the same PR.

Governed (CLAUDE.md) ⇒ draft PR at the human terminal; objectui declares 「no changeset owed」 through its gate (⛔ no skip-changeset label here).

---

Generated by Claude Code

[os-justin]

Claim: PM loop round 2 — objectui CLAUDE.md becomes a pointer to AGENTS.md (nothing else in it); the two inlined rules leave (both live in AGENTS.md 〈9. Operational Rules〉 and in .claude/hooks/); gates that list CLAUDE.md are re-run and adapt only if one requires prose there. Program: objectstack-ai/objectstack#17161; authority verbatim: 「首先要明确 hotcrm 是元数据应用，平台功能应该在 objectstack中开发。 其次 claude.md 是不是直接让他阅读 agents.md 即可，没必要维护两套。所有仓库都有类似的问题」
Session: session_01MoTv7pn338AZ71owsp19gQ
Branch: claude/issue-8840-claude-md-pointer
Worktree: objectui-issue-8840
Domain: domain:skills
File surface: CLAUDE.md; a gate script only if it requires prose in CLAUDE.md (measure first, name it in the report); ⛔ no AGENTS.md, ⛔ no .claude/hooks/** (stop on breach; explain in the report)
Container & model: S (one governed file reduced to a pointer), mode:subagent, model: opus — dispatch-gates --tier REFUSES for a sister repo; PM judgement: default tier for a ruled one-file shape, reviewed in the seat at claude-fable-5-1
Clause-②: no
Thread-read: none
Serial constraints cleared: no open objectui PR touches CLAUDE.md or AGENTS.md (12 open PRs' file lists read 2026-09-09T13:51Z); newest CLAUDE.md touch c70ebaae (#7600); objectui origin/main e9d92120 read 2026-09-09T13:51Z; objectui has no scripts/pm/ ⇒ no H17, no verify lock (docs-only).

---

Generated by Claude Code

[os-justin]

os-dev-report

{
  "issue": 8840,
  "status": "done",
  "branch": "claude/issue-8840-claude-md-pointer",
  "pr": "https://github.com/objectstack-ai/objectui/pull/8848",
  "premise_still_valid": true,
  "summary": "objectui CLAUDE.md reduced 25 lines to 3: title plus one bold sentence naming AGENTS.md as the source of truth to read before the first edit. Both inlined rules (worktree-first, never git stash), their hook roster and the closing digest line deleted after grep-verifying each rule's own sentence survives in AGENTS.md 9. Operational Rules, paragraph 多 agent 协作纪律 (worktree-first at :249, stash ban at :250 with its hook and override at :258) - anchoring sentences quoted in the PR body. .claude/hooks/** and AGENTS.md untouched; no gate script adapted, because measurement showed none requires prose in CLAUDE.md. One element of the deleted text does not survive in AGENTS.md and is not a rule: the name guard-main-checkout-bash.sh and the clause about the same writes via Bash; reported as an out-of-scope finding rather than moved, since the rule itself survives in full and the file surface is CLAUDE.md only.",
  "tests": "8 gates, each exit code captured before any pipe (cmd > file 2>&1; EXIT=$?), verdict lines quoted from the gates' own output. check-governed-queue-guard.mjs --self-test exit 0 'OK check-governed-queue-guard self-test: 132 cases pass'; --test CLAUDE.md exit 3 '⛔ GOVERNED - 1 of 1 path(s) are on a governed surface: CLAUDE.md x1 - the repo-root Claude instruction file'; check-doc-links.mjs exit 0 'Links are valid across 17 scan roots.'; check-shell-escape-residue.mjs exit 0 'OK (5/5 root(s) resolved -- CLAUDE.md: 1 file(s), 0 fence(s) ...)'; check-bash32-floor.mjs exit 0 '13 tracked shell file(s) ... name no bash 4+ construct'; check-upstream-port-parity.mjs exit 0 '3 ported file(s) match objectstack-ai/objectstack modulo their declared divergences'; check-control-bytes.mjs exit 0 'scanned 7041 tracked text file(s)'; check-changeset-presence.mjs exit 0 'No source or published contract of a released package changed in this range, so no changeset is owed.' ABLATION (one-off, run from committed state 7dd3aaa1, trap with absolute path armed before the mutation, direction predicted as 'turns red' before running): removed CLAUDE.md, proved absent on disk (git status ' D CLAUDE.md'), check-shell-escape-residue exit 1 '❌ a declared root did not resolve - CLAUDE.md (scan root, declared file) does not exist'; restore leg git checkout HEAD -- CLAUDE.md, proved by blob hash 5961a39659af021ff51ee7c9caffcf2c7e1dfee4 equal to the HEAD blob and by an empty git diff HEAD (not by an exit code), gate back to exit 0. No test file left behind. Local scope: no package touched, so no build closure and no package suite owed; no gate script edited, so no gate suite owed; repo-wide pnpm lint / pnpm test are CI's.",
  "mcp_calls": "2 - both mcp__github__issue_read (issue 8840 get, get_comments). Program card 17161, PR creation, labels and every read-back went through repo-scoped REST, probed green in this container (HTTP 200) before use.",
  "gates": "8/8 green as listed in tests; check-governed-queue-guard --test CLAUDE.md returns exit 3 GOVERNED by design and is counted as the expected verdict, not a failure. No gate required prose in CLAUDE.md, so none was adapted.",
  "line_budget": "n/a - no skills/** in the diff. CLAUDE.md 25 lines to 3 lines, net -22 (1 insertion, 23 deletions, 1 file).",
  "deviations": "1) PM mechanism assumption A FALSIFIED: check-upstream-port-parity.mjs does not read CLAUDE.md at all. Its ledger scripts/upstream-port-pin.json carries exactly three ported files (scripts/pm/check-half-states.mjs, scripts/invoked-as.mjs, .claude/hooks/guard-main-checkout.selftest.sh), printed by the gate itself; the two CLAUDE hits in that ledger are CLAUDE_PROJECT_DIR and one comment. Root CLAUDE.md occurs in the gate only at :120 in a header comment, and the gate imports GOVERNED_SURFACES only so its rewrite path REFUSES governed files. No parity pin exists in either direction, so the pointer form needs no pinning on the objectstack side either. 2) check-bash32-floor.mjs, named in the dispatch gate list, also never reads CLAUDE.md: POPULATION_ROOTS is scripts/**, .claude/hooks/**, e2e/**; the CLAUDE.md mention at :52 describes a sibling gate's population. Run anyway, green. 3) The claim comment states objectui has no scripts/pm/; it does (one file, scripts/pm/check-half-states.mjs). The operative conclusion holds - there is no scripts/pm/os-verify-lock.sh in this repo, and this change is docs-only. 4) Commit trailer pair written model-free per the dispatch contract, which overrides the model-named attribution injected by the harness. 5) One channel note: REST POST needs an explicit Content-Type: application/json header in this container or GitHub answers 415.",
  "files_changed": ["CLAUDE.md"],
  "open_questions": [],
  "out_of_scope_findings": [
    "noted, not filed: AGENTS.md:249 names guard-main-checkout.sh and enumerates Edit/Write/NotebookEdit but never names guard-main-checkout-bash.sh, which guards the same writes done through Bash; after this PR no document in the repo names that hook. The rule survives in full and is stated as mandatory regardless of tool, and the hook keeps firing, so this is an incomplete enforcement roster, not a lost rule or a reproducible defect - outside all three filing classes. Carrier: program card objectstack-ai/objectstack#17161, whose sibling repos reduce the same digests this week.",
    "noted, not filed: .github/workflows/hook-selftests.yml:8 cites 'the rule both CLAUDE.md files state as binding ... see those files' ⛔ sections'; those sections are gone here and objectstack's sub-issue removes the other, so the citation goes stale on both sides in the same program. It is a workflow comment that reads nothing and gates nothing, and it sits outside this PR's declared file surface on a governed-terminal PR. Same carrier: objectstack-ai/objectstack#17161.",
    "noted, not filed: objectui carries a skip-changeset label object that nothing reads; not applied here per the dispatch, and check-changeset-presence.mjs's own 'no changeset owed' verdict is the declaration instead."
  ]
}

---

Generated by Claude Code

[os-justin]

ACCEPT — objectui#8840 (skills seat, session session_01MoTv7pn338AZ71owsp19gQ, review taken 14:05–14:08Z at claude-fable-5-1, comment posted 2026-09-09T14:08Z)

PR #8848 (Fixes #8840, head 7dd3aaa1 on base bddf1cf7), draft, targets main, one file CLAUDE.md (+1/−23). Verified against GitHub and the fetched head in this seat's own worktree, not the report (5603201810):

• Path face: node scripts/check-governed-queue-guard.mjs --test CLAUDE.md — GOVERNED (CLAUDE.md x1) ⇒ draft at the human terminal; this seat does not flip, queue, arm or approve. git merge-tree --write-tree origin/main (a810bb2a) × head: clean.
• Diff read in full: CLAUDE.md is now a title and one bold sentence — 「AGENTS.md is the source of truth for working in this repo — read it before your first edit」 — nothing else; no rule, no hook roster, no digest. The maintainer's ruling is quoted verbatim at the head of the PR body.
• The two deleted rules survive as their own sentences in AGENTS.md 〈9. Operational Rules〉 · 多 agent 协作纪律: worktree-first at :249 (必须一个任务一个 git worktree …), the stash ban at :250 (绝不 git stash —— stash 栈不在上一条的 worktree 隔离范围内) with its hook and override at :258 — read on the head by this seat. .claude/hooks/** and AGENTS.md untouched (the diff is one file).
• Gates re-read from the PR body and spot-checked here: check-changeset-presence.mjs → 「no changeset is owed」 (re-run by this seat, exit 0); check-doc-links, check-shell-escape-residue (CLAUDE.md: 1 file, 0 fences), check-bash32-floor, check-upstream-port-parity (3 ported files match), check-control-bytes, governed-guard self-test 132 cases — all exit 0 in the report with verdict lines quoted; ablation (CLAUDE.md removed ⇒ check-shell-escape-residue red on the missing declared root; restore proven by blob 5961a396 = HEAD) accepted. No gate required prose in CLAUDE.md, so none was adapted — mechanism assumption A (a parity pin on CLAUDE.md) measured false and reported; accepted.
• CI on 7dd3aaa1 at 14:07Z: 29 distinct checks, 23 success / 3 skipped / 3 in progress (Skill Example Check, Doc Snippet Type Check, README Export Check) — honest in_progress; re-read at the next patrol; the maintainer's merge waits on green regardless.
• Closing keywords: Fixes #8840 is the first line; no other keyword-number pair. No skip-changeset label (objectui declares through the gate, as ruled). Clause-②: no. Report 5603201810 first line os-dev-report, JSON parses.
• ## Acceptance notes read: two noted-not-filed items carried to the program card [program] CLAUDE.md is a pointer to AGENTS.md in every repo — no second instruction set to maintain (maintainer 2026-09-09) objectstack#17161 by this seat (the unnamed guard-main-checkout-bash.sh in AGENTS.md :249's roster; hook-selftests.yml:8's comment citing both CLAUDE.md files' ⛔ sections, stale on both sides once the program lands); the unread skip-changeset label object noted. None inside the three filing classes.

Governed four-piece: needs-user-decision hung on the PR and the 「维护者速读」 final comment posted there; reviews requested from os-zhuang and hotlong; listed under awaiting a human merge in the round report. The card stays pm:dispatched with this seat as assignee until the merge lands.

---

Generated by Claude Code