principle (entity)
Generated from solutions/ontological/lib/model/entities/principle/schema.ts.
Schema version: 1.
Description
Section titled “Description”A Principle is a broad value the project leans on for design judgment. Principles are upstream of Standards: a Principle says what is valued (“prefer deterministic over LLM when possible”); a Standard says how that value lands as a scoped rule on specific paths.
A Principle is not:
- A Standard (Standards enforce; Principles guide).
- A Rule. It is a value that lets the project reason about edge cases — including when not to apply it.
Properties
Section titled “Properties”| Field | Type | Required | Description |
|---|---|---|---|
type | string | yes | Dispatch tag for the validator framework. |
schema_version | string | Numeric 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). | |
id | string | yes | Immutable identifier in canonical P-NNNN shape per D-0002-entity-identifier-shape: ‘P-’ + 4 zero-padded chars [0-9A-Z] (Principles use incrementing numbering). Never renamed once assigned. |
status | string | Lifecycle stage. open/* states are active; closed/* are terminal. open/draft: actively being authored; open/published: stable for downstream reference; closed/retired: the principle no longer drives design judgment but is retained for historical reference. | |
title | string | yes | Human-readable headline. Frontmatter is canonical; the body opens with # <title> for readability. |
created | string | yes | ISO date the entity was first authored. |
last_reviewed | string | ISO date the entity was last reviewed. Optional: never in any per-type required set. | |
related | array | Cross-references to other principles or standards. Slug is optional per D-0002-entity-identifier-shape. | |
tags | array | Free-form labels. MUST include exactly one principle/tags field, adding the contains/minContains/maxContains constraint. | |
need_human_review | boolean | Review-tracking flag. |
status
Section titled “status”open/draftopen/publishedclosed/retired