driver (entity)

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

Schema version: 1.

Description

A Driver is a motivating force behind a Product — a pain-point to remove, a use-case to enable, or an opportunity to capture. Drivers are the root of the why chain (D-7F2M-why-what-verify-chain): Goals address Drivers, Requirements elaborate Goals, and AcceptanceCriteria verify Requirements.

A Driver is not:

• A Goal (a Goal is the desired outcome; the Driver is the reason the outcome matters).
• A Task or Backlog item (those are work; a Driver explains why work is worth doing).

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 DR-NNNN shape per D-0002-entity-identifier-shape: ‘DR-’ + 4 zero-padded chars [0-9A-Z] (Drivers use incrementing numbering; ‘D’ is taken by Decision). Never renamed once assigned.
status	string		Lifecycle stage. open/* states are active; closed/* are terminal. open/proposed: hypothesized, not yet evidence-backed; open/validated: backed by cited evidence; closed/resolved: the driver has been fully addressed; closed/retired: no longer motivating work.
title	string	yes	Human-readable headline stating the driver in one line. Frontmatter is canonical; the body opens with # <title> for readability.
created	string	yes	ISO date the driver was first authored.
last_reviewed	string		ISO date the driver was last reviewed.
related	array		Cross-references to other entities as wikilinks (any AA-NNNN id per D-0002-entity-identifier-shape). Slug is optional.
tags	array		Free-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_review	boolean		Review-tracking flag.
kind	string	yes	The flavour of motivation: pain-point (friction to remove), use-case (workflow to enable), or opportunity (upside to capture).
product	string	yes	Wikilink to the Product this driver motivates (PR-NNNN per D-0002-entity-identifier-shape). Slug is optional.

Enums

status

• open/proposed
• open/validated
• closed/resolved
• closed/retired

kind

• pain-point
• use-case
• opportunity