ADR 0022: A primary source is not corroboration - `mcp.md` stays `emerging` at three

decision

ADR 0022: A primary source is not corroboration - `mcp.md` stays `emerging` at three

About this note
Field Value
Status accepted
Date 260807
Deciders chamin
On this pageContextDecisionAlternatives consideredConsequences

Context#

../topics/mcp.md has recorded the same complaint three times, and each time it was rediscovered rather than remembered.

At one source it said the topic had no primary source. At two it said "the count rose and the corroboration did not", because S10 (client-side catalog cost) and S12 (deployment topology) confirm nothing of each other's. Its scope caveat then went further and admitted the note was "scoped by accident rather than by design", with resources, prompts, sampling, the handshake and any spec version at all at zero.

S23 (Google's MCP stateless-updates announcement, 2026-08-05) arrives as the note's first primary source - the first that is about MCP rather than teaching it on the way past something else - and the first anywhere in this brain to pin a specification version (2026-07-28, superseding 2025-11-25). It closes the handshake gap by documenting its deletion (claim 179), closes the spec-version gap, and closes sampling by documenting its deprecation (claim 183). It also gives the note its first authorization mechanism (claim 182).

So the obvious move was to advance the topic to established, and the obvious move is wrong. S23 overlaps S10 and S12 on almost nothing. Transport mechanics, catalog cost and deployment topology are three disjoint subjects, and no two sources in this note confirm the same mechanic. The comparison that settles it is ../topics/agent-security.md, advanced to established by ADR-0019 on three independent corroborating groups, not on a source count and not on the arrival of a good source.

The tension is that "primary" and "corroborated" are different axes, and the note's own language had been quietly conflating them by treating "no primary source" as the headline defect.

Decision#

mcp.md stays emerging at three sources. A primary source fixes a topic's scope defect and supplies nothing toward its corroboration defect. Status in this brain tracks corroboration.

Stated generally, so it stops being rediscovered: advancing a topic's status requires two sources that confirm the same mechanic, and neither a source count nor the arrival of a primary source substitutes for it. A primary source is recorded in the status line as what it is - the thing that makes a note scoped by design rather than by accident - and it moves the status only if it also corroborates something already there.

Not a one-way door. Reversible the moment a second source touches the transport core.

Alternatives considered#

Consequences#