From f3eabb29edf63b5cbe03e195cb7fa72be754122f Mon Sep 17 00:00:00 2001 From: Claude Date: Thu, 17 Sep 2026 23:07:02 +0000 Subject: [PATCH] docs(agents): a claim pre-check hit is a hint, not a claim AGENTS.md rule 2 handed the dev `git ls-remote --heads origin | grep issue-` as a one-command pre-check and said only what the command IS, never what a HIT means. The reading rule stood only in the fact layer (pm-dispatch references), which the dev definition never points at, so the layer holding the rule had no reader and the layer with the reader had no rule. The failure direction is the silent one: a stale head reads as "already claimed" and nothing goes red. One clause on the existing sentence states the reading. Paid in-file: the Skills section's restatement of the governed-surface queue mechanism retires, since Prime Directive #14 already carries it. Co-authored-by: Claude Claude-Session: https://claude.ai/code/session_01Gqi43smmqjJ5sUrhfoPeKu --- AGENTS.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 8b1fbe8fe4a..0dd75e3a6da 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -460,7 +460,8 @@ Even inside your own worktree, operate defensively: straight to `main`.** Name the branch after the issue it fixes: `claude/issue--`. The issue number is what makes in-flight work *discoverable* — `git ls-remote --heads origin | grep issue-` is a one-command pre-check, and the Duplicate Fix Guard - workflow warns on fix PRs whose branch names no declared issue. + workflow warns on fix PRs whose branch names no declared issue. A hit is a hint, not a + claim — most heads carry no PR: ⛔ never skip a card on one, the `Claim:` comment decides. ⛔ **Off `main` is literal — a stacked series, each PR branched off the one below, is NOT a supported form.** No tooling represents it: squash landing destroys the ancestry link, so every descendant rewinds behind what landed and @@ -796,8 +797,7 @@ working in its domain — browse the directory, never a hand-written list here: - `.claude/skills/` — repo-internal agent playbooks; every entry must carry `metadata.internal: true`. -⛔ **Both roots are governed surfaces** — human-merge only, or queued under **Prime Directive #14**'s pinned-approval -path; no per-PR check holds it: the queue guard refuses an unpinned governed diff at queue time. +⛔ **Both roots are governed surfaces** — human-merge only, or **Prime Directive #14**'s pinned-approval path. ---