backlog (entity)

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

Schema version: 3.

Description

A Backlog item is a stray idea captured before triage — deliberately unstructured, cheap to write, parked until someone decides whether it becomes real work. Two usage patterns coexist: a multi-item dump file (ideas struck through or deleted as they move on) and a single-candidate file (the whole file is one idea; on promotion it becomes an archive pointer to the artifact it produced).

A Backlog item is not:

• A Task. A Task has a spec and is dispatchable; a backlog item earns that shape at promotion.
• A Milestone. Same boundary, larger grain.

Properties

Field	Type	Required	Description
type	string		Artifact type — used by the frontmatter validator to dispatch to this schema. Optional today (the validator falls back to the parent directory name).
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		Immutable identifier per D-0002-entity-identifier-shape: ‘B-’ + 4 base-36 chars [0-9A-Z]. Matches the filename; never renamed once assigned. Optional on legacy multi-item dump files.
state	string		Lifecycle stage. Absent means the file is still a raw idea or an ongoing dump. promoted/<entity> records that this backlog file was turned into a real artifact; pair with result:. closed/abandoned/closed/duplicate record discard without promotion. closed/delivered records that the item was built directly, without a promoted artifact in between; pair with result: (a PR link or a short note of what shipped).
title	string		Human-readable headline. Frontmatter is canonical; the body opens with # <title> for readability.
created	string		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 entities as wikilinks (slug optional per D-0002-entity-identifier-shape). Each per-type schema may add an items.pattern constraint narrowing the admissible link shapes.
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.
created_at	string		ISO 8601 timestamp the entity was authored, finer than created. Optional: stamped by tooling that authors entities, never required.
provenance	string		What authored the entity when it was not written by hand: a skill invocation, tool, or import source (e.g. sdlc:capability-map packages/ts). Optional: absent means hand-authored.
status	string		OKF v0.2’s own document-maturity key — DISTINCT from the entity’s own lifecycle state field (do not confuse the two). Optional: absent means OKF makes no maturity claim about this document.
description	string
resource	string
stale_after	string
generated	object
verified	array
sources	array
usage_window	object
likely_type	string		Non-binding triage hint: the entity-type slug this item will likely become (task, milestone, decision, driver, …). Recorded by the triager; never constrains the promotion outcome — state/result record what actually happened.
result	string		Wikilink to the artifact this backlog file resolved to, or — for closed/delivered — a freeform PR link or short note of what shipped. Required when state: starts with promoted/, or is closed/duplicate or closed/delivered. The conditional rules narrow result:’s pattern to a wikilink for every state but closed/delivered.

Enums

state

• promoted/task
• promoted/milestone
• promoted/decision
• closed/abandoned
• closed/duplicate
• closed/delivered

status

• draft
• stable
• deprecated