Skip to content

Requirements ownership

Requirements describe outcomes, constraints, and acceptance criteria. They do not own implementation detail. Exact interfaces and workflows belong in specifications, current structure belongs in architecture, and risks and mitigations belong in security.

Stable IDs

Prefix Owner
REQ-CORE-* Cross-cutting demo behavior
REQ-SETUP-* Bootstrap, configuration, and rendering
REQ-DEPLOY-* Provisioning and publication
REQ-GEN-* Historical synthetic data
REQ-STREAM-* Live events and streaming transforms
REQ-AN-* Eventhouse and Lakehouse analytics
REQ-MLAI-* Machine learning, ontology, and agents
REQ-BI-* Power BI semantic model and report
REQ-OPS-* Readiness, monitoring, recovery, and CI
REQ-SEC-* Security and governance outcomes
REQ-DOCS-*, REQ-PUBLISH-* Documentation and publishing
THREAT-*, SEC-* Security threats and controls
IMP-* Improvement or implementation item tracked in a module backlog
ENH-* Optional enhancement idea tracked in a module backlog

IDs are permanent. Retire an obsolete ID in traceability.md; do not reuse it for a different outcome.

Traceability states

Only these states are allowed:

State Meaning
proposed Draft outcome that has not been accepted.
accepted Normative outcome; implementation is absent or incomplete.
implemented Exact implementation evidence exists; verification is incomplete.
verified Exact implementation and verification evidence exist.
blocked The outcome cannot progress until a named external or upstream gate is resolved.
retired The outcome is no longer required and its replacement or rationale is recorded.

Module ownership

Each module has one requirements page and one backlog. A backlog contains only:

  • ## Open
  • ## Settled — do not reopen

Completed-work histories do not belong in backlogs. Git history and traceability.md retain completion evidence.