Reference Implementation
About the working open-source reference implementation — what it is, and where the substrate schemas, reporter contract, and state machines live.
The Standard does not depend on the reference implementation. The reference implementation is a working open-source artifact you may consult, published separately under the MIT License. The Standard is the normative text; the implementation merely demonstrates one conformant way to produce the records.
What it is
The reference implementation provides the JSON schemas for the Charter, decision records, the Article 50 disclosure block, and the conformance signals, together with a reporter that reads machine-readable signals and computes a self-declared conformance level. It is a real artifact to build against — not the Standard itself.
Where the substrate lives: the schemas, the conformance-signal reporter contract, and the state machines are published under standard/v5.0/ in this repository, under the MIT License. The links below resolve to the real files.
Substrate references
- standard/v5.0/README.md — substrate overview and bundle contents
- standard/v5.0/schemas/decision-record.schema.json — decision-record JSON schema (Charter, Article 50 disclosure, and signal schemas alongside it under
schemas/) - standard/v5.0/conformance/signal-vocabulary.md — 23-signal conformance vocabulary
- standard/v5.0/conformance/reporter-api-spec.md — conformance reporter API contract
- standard/v5.0/mode-drift/layer-4-attestation.schema.json — Layer 4 attestation schema
For narrative guidance, start from Companion C — Implementation Guidance and the downloads.
← Back to the Decision Provenance Standard