backlog (entity)
Generated from solutions/ontological/lib/model/entities/backlog/schema.ts.
Schema version: 2.
Description
Section titled “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
Section titled “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. | |
status | 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/<reason> records discard without promotion. | |
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. | |
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 — status/result record what actually happened. | |
result | string | Wikilink to the artifact this backlog file resolved to. Required when status: starts with promoted/ or is closed/duplicate. The conditional rules narrow result:’s pattern to match the specific status: value. |
status
Section titled “status”promoted/taskpromoted/milestonepromoted/decisionclosed/abandonedclosed/duplicate