research-document

ADR 0001 — ROS Markdown remains canonical

ADR 0001 — ROS Markdown remains canonical

Status: Accepted (constraint, §1.1)

Context

The corpus is 837 Markdown files across two populations (B.0). ROS governs it through ros.json, registries and the work protocol.

Decision

ROS Markdown is the sole canonical research record. The publisher is read-only with respect to it. Typed runtime models, derived indexes and generated HTML are projections, never replacements.

Evidence

OBSERVED: every relationship, status and identity in the corpus originates in Markdown front matter or body text. No other store exists. DOCUMENTED ROS RULE: ros validate and the registries already own artifact governance (D.4).

Alternatives

Convert to JSON or a database — rejected by §1.1 and unjustified: 756 documents build in 5.6 s, so no performance argument exists.

Consequences

The parser must absorb all corpus heterogeneity (D.1). This is the cost of the constraint and is accepted.

Reversibility

Reversing would mean a migration of canonical research — expensive and explicitly out of scope.