Skip to content

AGENTS.md Prime Directive 14 says "CODEOWNERS routes review requests for docs/adr/ only, so nothing summons the maintainer on the other Tier H surfaces" — false once PR #25064 lands #25070

Open

Description

@objectstack-fleet

Filing gate ①: a factual error with a named location (AGENTS.md's documentation guardrail: an agent-read rule stating what the repository no longer does). It turns false the moment PR #25064 merges, so this card waits on it.

Blocked-by: #25046

Reader who acts: the domain:skills lane. AGENTS.md is a governed surface (Tier H), so one PR lands on an authorised APPROVED review. Filed by domain:skills seat 1 (seat post #7623, session_01M82feuetLzrCiBz41BJb7L). The finding comes from the #25046 dev's report (open_questions 2, out_of_scope_findings) and the contract review on PR #25064 (comment 6309771962, ③6), which escalated it to this seat as a follow-up. The lane label is self-applied under exception 二; grade and area:* belong to triage.

Dedupe (open and closed), objectstack, MCP search_issues (read 2026-10-21T06:44Z): 「AGENTS.md Prime Directive 14 CODEOWNERS routes review requests docs/adr only nothing summons the maintainer」 gives 79 hits. The top ten are #25046 (the parent), #24241, #20076, #20791, #19128, #17161, #18019, #17971, #16851 and #12896. None covers this sentence. #12896 is the nearest: an earlier stale clause of the same directive, a different sentence.

The sentence

AGENTS.md on origin/main 688052e14, Prime Directive 14, the paragraph that begins "Already armed or queued when you read this?", reads:

Behind it: the queue guard refuses a governed diff without its tier's record; CODEOWNERS routes review requests for docs/adr/ only, so nothing summons the maintainer on the other Tier H surfaces; the post-merge audit …

PR #25064 (for #25046) makes two changes:

  • .github/CODEOWNERS routes all six Tier H surfaces (docs/adr/, skills/, AGENTS.md, CLAUDE.md, docs/NORTH-STAR.md, .github/workflows/) and the enforcement chain to every GOVERNED_APPROVERS account;
  • the fleet relay requests review from those accounts at pr_create and pr_ready on a Tier H diff, because GitHub's own code-owner request fires only when a pull is opened ready or marked ready.

The middle clause then states the opposite of the repository's behaviour.

Done when

  • The clause is rewritten in place to say what is true after the landing: every Tier H surface is routed to the approvers by CODEOWNERS, and the relay requests their review on a draft. ⛔ The clause must not be read as a merge barrier: the live ruleset does not require code-owner review (contract review 6309771962, ①B), so the directive itself stays the barrier.
  • Net 0 lines in AGENTS.md. Pay line for line, ⛔ never by re-wrapping. Its ratchet and check:pm-governed-prose stay green.
  • No other file changes.

reach: every agent that reads AGENTS.md before acting on a governed PR; the sentence tells it that no one is summoned, so it may skip a summons the tooling now performs, or report a gap that does not exist.

Dedupe words: AGENTS.md Prime Directive 14 CODEOWNERS docs/adr only · nothing summons the maintainer Tier H · stale CODEOWNERS sentence

Activity

  1. objectstack-fleet commented on Oct 21, 2026

    @objectstack-fleet
    ContributorAuthor

    pm:blocked → pm:queue · domain:skills seat 1 (stay-behind, seat post #7623 r267) · session_01M82feuetLzrCiBz41BJb7L · 2026-10-21T08:53Z

    Unlock, double-checked.

    Scope as filed: one in-place rewrite of that clause, net 0 lines in AGENTS.md, no other file. AGENTS.md is Tier H, so the PR lands on an authorised approval. Since this merge, a relay pr_create on it requests both approvers by itself. This seat has signed off, so the next domain:skills seat claims it.


    Generated by Claude Code

  2. added
    area:devpathThe road — create, dev, verify, publish/install, connect an agent, iterate
    documentationImprovements or additions to documentation
    and removed on Oct 21, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    area:devpathThe road — create, dev, verify, publish/install, connect an agent, iteratedocumentationImprovements or additions to documentationdomain:skillspm:queuepriority:p2Medium: important, M3

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions