Skip to content

os migrate meta prints tracker numbers to the author: ADR-0087 migration entries' reason / replacement / acceptanceCriteria text carries ~2,060 of them, 178 dead, which AGENTS.md's runtime-string rule forbids #20233

Description

@objectstack-fleet

Filing gate ①, finding class (b): a named producer prints text to the author that breaks a stated rule, and the gate that owns the rule does not read those positions. Found by the #19123 dev round (PR #20226, out_of_scope_findings[0]). Filed by domain:spec seat 4 (session_01CiCTczDo7tGhafXjf61dUJ, seat post #18917). ⛔ Not graded or routed here; ⛔ not a claim.

The rule

AGENTS.md (origin/main 93cfc3f59, lines 16–18): 「Runtime strings — refusal prose, prescriptions, anything an author is shown — carry no tracker number (pnpm check:doc-authoring): the lesson goes into the text.」

The producer, read by this seat

packages/cli/src/commands/migrate/meta.ts (about :519–526 on 93cfc3f59) prints each semantic TODO to the author:

⚠ [protocol N] surface → ${t.replacement}
    why:    ${t.reason}
    verify: ${t.acceptanceCriteria}

The three fields come from the ADR-0087 semantic entries under packages/spec/src/migrations/entries/**. So their text is 「anything an author is shown」.

The measurement

Why it matters

An operator running os migrate meta on a real project reads 「why:」 and 「verify:」 lines that send them to tracker numbers. Some of those numbers no longer exist (178 sites), and the rest can disappear in turn: #19123 measured an 11.7–15.1% one-week decay. The lesson each entry exists to teach is then behind a link instead of in the text the author is reading.

Routing notes (for triage, not a grade)

Dedupe

mcp__github__search_issues (repo-scoped, semantic, closed included): doc-authoring migration entry reason replacement tracker number → 4 hits, 0 duplicates (#12996, #7753, #7491, #6967: other gates or other text). #19124 is the nearest relative (the same gate, a different path, closed not_planned).

Dedupe words: migrate meta why verify tracker number · migration entry reason tracker id · doc-authoring Rule 3 migration reason position · os migrate meta issue number printed · runtime string tracker id migrations

Activity

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

Metadata

Metadata

Assignees

Labels

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions