Skip to content

standard (entity)

Generated from solutions/ontological/lib/model/entities/standard/schema.ts.

Schema version: 1.

A Standard prescribes a rule that applies to a scoped set of paths and explains its application. Standards are the enforceable layer of project governance: where a Principle states a value and a Decision records a choice, a Standard says what to do (or not do) here — and, where possible, a deterministic validator checks it.

A Standard is not:

  • A Principle. A Principle is a broad value; a Standard is a scoped, often checkable rule. Standards typically operationalize Principles.
  • A Decision. A Decision records why this and not that; a Standard is one possible output of a Decision.
  • A Convention. A Convention is informal; a Standard is normative and reviewable.
FieldTypeRequiredDescription
typestringyesDispatch tag for the validator framework.
schema_versionstringNumeric string version of the per-type schema this instance conforms to. Compare numerically when ordering versions. Independent of any product version. The value 0 is a documented sentinel meaning ‘pre-SDLC-managed’ — audit treats it as intentional, not stale. Optional in frontmatter: never in any per-type required set (audit flags a MISSING stamp as drift, not the validator).
idstringyesImmutable identifier in canonical S-NNNN shape per D-0002-entity-identifier-shape: ‘S-’ + 4 zero-padded chars [0-9A-Z] (Standards use incrementing numbering). Never renamed once assigned.
statusstringLifecycle stage. open/* states are active; closed/* are terminal. Standards move from open/draft → open/proposed → open/active; closed/superseded means a newer Standard replaces this one; closed/deprecated means the rule no longer applies.
titlestringyesHuman-readable headline. Frontmatter is canonical; the body opens with # <title> for readability.
createdstringyesISO date the entity was first authored.
last_reviewedstringISO date the entity was last reviewed. Optional: never in any per-type required set.
relatedarrayCross-references. Entries are wikilinks — typically to other entities by id (slug optional per D-0002-entity-identifier-shape), but may also reference non-entity planning docs by their wikilink slug.
tagsarrayFree-form labels. Required at the common level, defaulting to []. Per-type schemas may add a contains constraint (e.g. Principle requires exactly one principle/<category> tag).
need_human_reviewbooleanReview-tracking flag.
applies_toobjectyesScope of the rule. Required. paths is a list of glob patterns naming where the rule binds.
supersedesstringWikilink to the Standard this one replaces, if any. Slug is optional per D-0002-entity-identifier-shape.
superseded_bystringWikilink to the Standard that replaces this one, if any. Required when status is closed/superseded. Slug is optional per D-0002-entity-identifier-shape.
deprecation_notestringShort note on why the standard was deprecated. Required when status is deprecated.
  • open/draft
  • open/proposed
  • open/active
  • closed/superseded
  • closed/deprecated