Skip to content

AGENTS.md: a rule's provenance cites the ADR / ruling record first, the commit sha second, never a bare tracker number — and runtime strings carry no numbers (ruling batch #195 item 3 letter C+D on #19123) #19294

Description

@os-project-manager

Path: AGENTS.md :14 (the provenance sentence) | Tier H — RULED (batch #195 item 3 letter C+D on #19123, maintainer 「同意」) | graded by domain:skills#2

Filed by the director seat, summon #25 (session_012GcsUbuqFGBibkEDMRC1eE), executing ruling batch #195 item 3 letter C+D on #19123 (maintainer 「同意」). ⛔ Filed bare: domain:*, priority:* and type are triage's production. Landing: AGENTS.md (Tier H — draft PR, human merge) ⇒ the skills lane.

What changes

AGENTS.md today says a rule's provenance lives in the PR that landed it. #19123 measured that 11.7%–15.1% of one week's merged-PR numbers are already deleted from GitHub (no 301; the commit → PR association is empty), so that convention points readers at objects this repository does not control and has measured itself destroying.

Replace that sentence with the order the ruling sets:

  1. A load-bearing internal anchor cites the ADR / ruling record when one exists (stable, in-repo, carries the narrative).
  2. Otherwise it cites the commit sha in this repository's history. A PR number may follow as a convenience link, ⛔ never as the citation.
  3. Runtime strings (refusal messages, prescriptions, anything printed to an author) carry no tracker numbers: the lesson is written into the text — the rule scripts/check-doc-authoring.mjs already enforces for every other package under the maintainer's words 「处理 issue 时犯的错应该总结成经验,保留 issue id没有意义」 ([finding] A tracker id sits in packages/core's plugin-registration refusal message — the ruled audience, in a package check-doc-authoring Rule 3's scanned root (packages/spec/src) cannot reach #13179).

Acceptance

Dedupe words: AGENTS.md provenance convention · cite ADR or commit sha not PR number · tracker number decay 404 · runtime strings no issue id · #19123


Generated by Claude Code

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions