id: https://mlsysbook.ai/taxonomy/schema name: mlsys_taxonomy title: ML Systems Taxonomy Metamodel (LinkML) description: Formal LinkML metamodel for the Machine Learning Systems Taxonomy, covering the canonical single-source taxonomy document (taxonomy/taxonomy.yml — subject groups, areas, subjects, concepts, controlled relationships, practitioner guides, and SKOS hierarchy), textbook passage alignment (mlsysbook-alignment.yml), external coverage checklists (taxonomy/coverage/*.yml), inter-tagger agreement records (taxonomy/agreement/*.yml), and the chapter coverage ledger (coverage-ledger.yml). version: "0.4-draft" license: https://creativecommons.org/licenses/by/4.0/ prefixes: linkml: https://w3id.org/linkml/ mlsys: https://mlsysbook.ai/taxonomy/ skos: http://www.w3.org/2004/02/skos/core# dcterms: http://purl.org/dc/terms/ owl: http://www.w3.org/2002/07/owl# default_prefix: mlsys default_range: string imports: - linkml:types enums: ModelStatusEnum: description: Lifecycle status of a top-level taxonomy model document. permissible_values: editorial-draft: description: Scoped editorial draft for community and expert review. release-candidate: description: Pre-1.0 or post-1.0 release candidate under external governance review (-rcN). normative-release: description: Externally governed normative taxonomy release (1.0 and later non-draft versions). DraftStatusEnum: description: Review status of individual concept, relationship, subject, or alignment assertions. permissible_values: draft: description: Authored draft assertion awaiting formal version-bound review provenance. GapStatusEnum: description: Status of a declared candidate scope gap in the framework. permissible_values: candidate: description: Candidate scope gap declared for investigation, not a verified absence claim. FrameworkVersionEnum: description: Supported versions of the ML Systems Taxonomy framework. permissible_values: 0.1-draft: description: Initial area and subject row inventory. 0.2-draft: description: Added top-level groups and readable hierarchical codes. 0.3-draft: description: Connected concept graph with controlled relation vocabulary and practitioner guides. "0.4-draft": description: Taxonomy release 0.4-draft. ConceptScopeEnum: description: Scope boundary of a concept or concept family within ML systems engineering. permissible_values: core: description: Core ML systems engineering concept applicable across system regimes. background: description: Foundational ML, mathematics, or computer systems concept used as background. model-extension: description: Concept specific to particular model families or architectures. generative-extension: description: Concept specific to generative models, LLMs, or diffusion pipelines. agent-extension: description: Concept specific to tool-using, planning, or multi-agent ML systems. physical-extension: description: Concept specific to embodied, robotic, or cyber-physical ML systems. specialist: description: Domain-specialist or regulatory/hardware niche concept. SourceKindEnum: description: Kind of external design reference or reading source. permissible_values: curriculum: description: University course syllabus or curriculum. documentation: description: Official framework, library, or platform documentation. engineering-guide: description: Practitioner engineering guide or operational handbook. research: description: Peer-reviewed research paper or technical report. paper: description: Conference or journal publication. standard: description: Formal industry, safety, or international standard. taxonomy: description: Established classification scheme or body of knowledge. textbook: description: Published textbook or monograph. RelationKindEnum: description: High-level semantic category of a controlled relationship verb. permissible_values: mechanism: description: How a technique operates, produces an artifact, or realizes an abstraction. constraint: description: Directional effect on a cost, bound, capacity, or system quantity. tradeoff: description: Symmetric tension or competing design alternative. evaluation: description: Measurement or detection of a system property or failure mode. dependency: description: Strict requirement or common building-block reliance. failure: description: Causal production or mitigation of a fault, hazard, or degradation. composition: description: Taxonomic specialization or structural part-whole membership. RelationshipBasisEnum: description: Epistemic basis for a relationship assertion between two concepts. permissible_values: editorial-synthesis: description: Authored synthesis grounded in cited reading sources under stated conditions. AlignmentDepthEnum: description: Teaching depth assessment status for a textbook passage link. permissible_values: not-assessed: description: Passage link identifies a related section without certifying coverage depth. AlignmentRelationEnum: description: Semantic relationship between a field concept and a textbook learner-graph node. permissible_values: related-passage: description: The textbook section discusses or illustrates the field concept. ChecklistStatusEnum: description: Coverage judgment for an external benchmark topic against the taxonomy. permissible_values: covered: description: Directly represented by one or more field concepts. partial: description: Placed under an existing subject row, with specific sub-mechanism not yet promoted to a distinct concept. missing: description: In scope for ML systems engineering but not yet represented. out-of-scope: description: Outside the declared scope boundary of the ML Systems Taxonomy. LedgerDispositionEnum: description: Reconciliation disposition of a chapter primary concept declaration against field concepts. permissible_values: mapped-to: description: Directly corresponds to one or more field concepts. broader-than: description: Chapter declaration spans multiple narrower component field concepts. narrower-than: description: Chapter declaration is a specific instance of a broader field concept. candidate-new: description: Candidate for promotion to a new field concept. out-of-scope: description: Chapter-local pedagogical construct outside field taxonomy scope. ConceptRoleEnum: description: Role of a chapter concept declaration in a chapter contract. permissible_values: primary: description: Primary chapter concept declaration gated by human reconciliation. secondary: description: Secondary chapter concept declaration inventoried without blocking the gate. ReviewerKindEnum: description: Kind of reviewer that recorded a chapter reconciliation decision. permissible_values: human: description: Human editorial reviewer. ai: description: Automated AI reviewer (visible in inventory, cannot pass the human gate). RelationIdEnum: description: Controlled 17-verb relationship vocabulary used across the ML Systems Taxonomy graph. permissible_values: specializes: description: A is a narrower or more specific case of B. annotations: forward: is a kind of inverse: has kinds such as kind: composition hierarchical_dag: true part-of: description: A is a component or stage within B. annotations: forward: is part of inverse: includes kind: composition hierarchical_dag: true alternative-to: description: A and B are competing options for the same job (symmetric). annotations: forward: is an alternative to inverse: is an alternative to kind: tradeoff hierarchical_dag: false requires: description: A cannot work, or cannot be correct, without B. annotations: forward: requires inverse: is required by kind: dependency hierarchical_dag: true uses: description: A commonly relies on B as a building block, without strict necessity. annotations: forward: uses inverse: is used by kind: dependency hierarchical_dag: false implements: description: A is a concrete mechanism or technique that realizes B. annotations: forward: implements inverse: is implemented by kind: mechanism hierarchical_dag: false enables: description: A makes B possible or practical. annotations: forward: enables inverse: is enabled by kind: mechanism hierarchical_dag: false produces: description: A creates or emits B as an output or artifact. annotations: forward: produces inverse: is produced by kind: mechanism hierarchical_dag: false reduces: description: A lowers the amount, cost, or magnitude of B. annotations: forward: reduces inverse: is reduced by kind: mechanism hierarchical_dag: false increases: description: A raises the amount, cost, or magnitude of B. annotations: forward: increases inverse: is increased by kind: mechanism hierarchical_dag: false determines: description: A sets or shapes B (direction not simply up/down). annotations: forward: determines inverse: is determined by kind: mechanism hierarchical_dag: false limits: description: A places a limit or ceiling on B. annotations: forward: limits inverse: is limited by kind: constraint hierarchical_dag: false trades-off: description: Improving A tends to worsen B, or vice versa (symmetric). annotations: forward: trades off against inverse: trades off against kind: tradeoff hierarchical_dag: false measures: description: A quantifies, evaluates, or tests B. annotations: forward: measures inverse: is measured by kind: evaluation hierarchical_dag: false detects: description: A reveals or identifies occurrences of B. annotations: forward: detects inverse: is detected by kind: evaluation hierarchical_dag: false causes: description: A can lead to the failure, harm, or degradation B. annotations: forward: can cause inverse: can be caused by kind: failure hierarchical_dag: false mitigates: description: A protects against, prevents, or recovers from B. annotations: forward: mitigates inverse: is mitigated by kind: failure hierarchical_dag: false classes: FieldModel: class_uri: skos:ConceptScheme description: Aspect model projected from the single canonical taxonomy (taxonomy/taxonomy.yml) defining the field concept inventory, controlled relation vocabulary, propositional edges, and views. attributes: schema_version: range: integer required: true equals_number: 1 description: Integer schema version of the document (must equal 1). id: identifier: true required: true pattern: ^[A-Za-z0-9][A-Za-z0-9._-]*$ description: Permanent machine-readable identifier for this record. title: slot_uri: dcterms:title required: true description: Human-readable title of the document or source. scope: slot_uri: skos:scopeNote required: true description: Declared scope boundary or scope note. status: range: ModelStatusEnum required: true description: Editorial review lifecycle status of the record. background_boundary: required: false description: Rule distinguishing core ML systems concepts from imported background concepts. limitations: multivalued: true required: false description: Explicit caveats on what the model does and does not claim. learning_paths: required: false description: Policy note or ordered list of guided learning paths. sources: range: FieldSource multivalued: true inlined_as_list: true required: true description: External curricula, standards, documentation, or research sources. families: range: ConceptFamily multivalued: true inlined_as_list: true required: true description: Coarse navigation groupings of field concepts. concepts: range: Concept multivalued: true inlined_as_list: true required: true description: Technical concepts belonging to this model, subject, or view. relations: range: ControlledRelation multivalued: true inlined_as_list: true required: false description: Controlled relationship verbs with forward and inverse readings. retired: range: RetiredConcept multivalued: true inlined_as_list: true required: false description: Permanent redirect records for withdrawn or merged concept identities. relationships: range: Relationship multivalued: true inlined_as_list: true required: true description: Directed, condition-qualified technical propositions between concepts. views: range: FieldView multivalued: true inlined_as_list: true required: true description: Named subsets of field concepts rendered as diagrams. FieldSource: class_uri: dcterms:BibliographicResource description: External curriculum, standard, documentation, or research source warranting field concepts. attributes: id: identifier: true required: true pattern: ^[A-Za-z0-9][A-Za-z0-9._-]*$ description: Permanent machine-readable identifier for this record. title: slot_uri: dcterms:title required: true description: Human-readable title of the document or source. url: slot_uri: dcterms:source required: true pattern: ^https://[^\s<>"{}|\\^`]+$ description: Canonical HTTPS URL for the external reference source. kind: range: SourceKindEnum required: true description: Category of source or semantic category of relationship. scope: required: true description: Declared scope boundary or scope note. ConceptFamily: class_uri: skos:Collection description: Coarse navigation grouping of field concepts sharing a core engineering question. attributes: id: identifier: true required: true pattern: ^[a-z0-9]+(-[a-z0-9]+)*$ description: Permanent machine-readable identifier for this record. label: slot_uri: skos:prefLabel required: true description: Canonical human-readable term or heading in sentence case. scope: range: ConceptScopeEnum required: true description: Declared scope boundary or scope note. question: required: true description: Core engineering question answered by this group, area, or family. references: range: FieldSource multivalued: true required: true description: Identifiers of external reading sources warranting this record. Concept: class_uri: skos:Concept description: A permanent, chapter-independent technical concept in machine learning systems. attributes: id: identifier: true required: true pattern: ^mlsys\.[a-z0-9]+(-[a-z0-9]+)*$ description: Permanent machine-readable identifier for this record. label: slot_uri: skos:prefLabel required: true description: Canonical human-readable term or heading in sentence case. home: required: false pattern: ^[A-Za-z0-9][A-Za-z0-9._-]*$ description: Identifier of the primary candidate home subject row (every concept in UnifiedTaxonomyModel names its home subject row; optional only in standalone FieldModel fixtures). definition: slot_uri: skos:definition required: true description: Single-sentence technical definition stating what the item is and what it changes. family: range: ConceptFamily required: true description: Identifier of the owning concept family. status: range: DraftStatusEnum required: true description: Editorial review lifecycle status of the record. aliases: slot_uri: https://mlsysbook.ai/taxonomy/scheme#entryTerm multivalued: true required: false description: Search entry terms retained for retrieval; legacy entries may denote narrower mechanisms or implementations and do not assert synonymy. scope: range: ConceptScopeEnum required: false description: Declared scope boundary or scope note. added_in: required: false pattern: ^[0-9]+\.[0-9]+(\.[0-9]+)?(-(draft|rc[0-9]+))?$ description: Release that first admitted this concept, the date-of-entry part of a Z39.19 history note (section 6.2.3). references: range: FieldSource multivalued: true required: false description: Identifiers of external reading sources warranting this record. ControlledRelation: class_uri: owl:ObjectProperty description: Controlled verb in the relationship vocabulary with explicit forward and inverse readings. attributes: id: identifier: true required: true pattern: ^[a-z0-9]+(-[a-z0-9]+)*$ description: Permanent machine-readable identifier for this record. forward: slot_uri: skos:prefLabel required: true description: Active verb phrase read from source concept to target concept. inverse: required: true description: Passive verb phrase read from target concept back to source concept. kind: range: RelationKindEnum required: true description: Category of source or semantic category of relationship. meaning: slot_uri: skos:definition required: true description: Formal definition of what the controlled relationship verb asserts. RetiredConcept: description: Permanent redirect record for a retired concept identity pointing to its active replacement. attributes: id: identifier: true required: true pattern: ^mlsys\.[a-z0-9]+(-[a-z0-9]+)*$ description: Permanent machine-readable identifier for this record. label: slot_uri: skos:prefLabel required: false description: Former canonical human-readable term of the retired concept, retained to prevent label collision reuse. aliases: slot_uri: https://mlsysbook.ai/taxonomy/scheme#entryTerm multivalued: true required: false description: Former alternative entry terms of the retired concept. replaced_by: range: Concept required: true pattern: ^mlsys\.[a-z0-9]+(-[a-z0-9]+)*$ description: Active concept identifier that supersedes the retired identity. version: range: FrameworkVersionEnum required: true description: Taxonomy version in which this record or retirement took effect. reason: required: true description: Editorial explanation for a retirement, scope gap, or tagging disagreement. Relationship: class_uri: owl:Axiom description: Directed, condition-qualified technical proposition linking two field concepts. attributes: id: identifier: true required: true pattern: ^[A-Za-z0-9][A-Za-z0-9._-]*$ description: Permanent machine-readable identifier for this record. source: range: Concept required: true pattern: ^mlsys\.[a-z0-9]+(-[a-z0-9]+)*$ description: Subject concept identifier at the tail of the directed relationship. target: range: Concept required: true pattern: ^mlsys\.[a-z0-9]+(-[a-z0-9]+)*$ description: Object concept identifier at the head of the directed relationship. relation: range: RelationIdEnum required: false description: Controlled relation identifier from the 17-verb vocabulary. kind: range: RelationKindEnum required: true description: Category of source or semantic category of relationship. predicate: required: true description: Specific verb phrase refining the controlled relation for this edge. conditions: required: true description: Explicit regime, workload, or assumption under which the proposition holds. references: range: FieldSource multivalued: true required: true description: Identifiers of external reading sources warranting this record. basis: range: RelationshipBasisEnum required: true description: Epistemic basis of the relationship assertion. status: range: DraftStatusEnum required: true description: Editorial review lifecycle status of the record. reference_role: required: false description: Role played by the cited reading sources for this relationship. FieldView: description: Named subset of field concepts for overview or thematic diagram generation. attributes: id: identifier: true required: true description: Permanent machine-readable identifier for this record. title: required: true description: Human-readable title of the document or source. concepts: range: Concept multivalued: true required: true pattern: ^mlsys\.[a-z0-9]+(-[a-z0-9]+)*$ description: Technical concepts belonging to this model, subject, or view. FrameworkModel: class_uri: skos:ConceptScheme description: Aspect model projected from the single canonical taxonomy (taxonomy/taxonomy.yml) organizing field concepts into groups, areas, and subjects with multi-dimensional facets and scope notes. attributes: schema_version: range: integer required: true equals_number: 1 description: Integer schema version of the document (must equal 1). id: identifier: true required: true pattern: ^[A-Za-z0-9][A-Za-z0-9._-]*$ description: Permanent machine-readable identifier for this record. title: slot_uri: dcterms:title required: true description: Human-readable title of the document or source. version: range: FrameworkVersionEnum slot_uri: owl:versionInfo required: true description: Taxonomy version in which this record or retirement took effect. status: range: ModelStatusEnum required: true description: Editorial review lifecycle status of the record. scope: slot_uri: skos:scopeNote required: true description: Declared scope boundary or scope note. rationale: multivalued: true required: false description: Editorial placement principles or justification for a hierarchy/ledger assertion. row_rule: required: false description: Editorial rule defining what qualifies as a subject row. secondary_policy: required: false description: Policy governing secondary concept links across subject rows. relationship_semantics: required: false description: Explanation of how subject membership differs from SKOS broader/narrower. context_policy: required: false description: Policy governing context lenses vs dedicated system-type areas. book_mapping_policy: required: false description: Policy governing chapter pointers and section-level passage links. warrant_policy: required: false description: Policy governing how external sources warrant subject boundaries. competency_policy: required: false description: Policy separating subject knowledge from observable task competency. tagging_rules: multivalued: true required: false description: Operational rules for tagging questions, chapters, slides, and labs. placement_examples: range: PlacementExample multivalued: true inlined_as_list: true required: false description: Worked examples illustrating the home rule on boundary concepts. sources: range: FrameworkSource multivalued: true inlined_as_list: true required: true description: External curricula, standards, documentation, or research sources. dimensions: range: DimensionSet inlined: true required: true description: Cross-cutting facet vocabularies (activities, layers, concerns, contexts). groups: range: SubjectGroup multivalued: true inlined_as_list: true required: false description: Top-level structural bands of the taxonomy. areas: range: SubjectArea multivalued: true inlined_as_list: true required: true description: Subject areas organized under the top-level groups. gaps: range: ScopeGap multivalued: true inlined_as_list: true required: false description: Declared candidate scope gaps tracked for future taxonomy versions. FrameworkSource: class_uri: dcterms:BibliographicResource description: External body of knowledge, curriculum, or benchmark warranting subject boundaries. attributes: id: identifier: true required: true pattern: ^[A-Za-z0-9][A-Za-z0-9._-]*$ description: Permanent machine-readable identifier for this record. title: slot_uri: dcterms:title required: true description: Human-readable title of the document or source. url: slot_uri: dcterms:source required: true pattern: ^https://[^\s<>"{}|\\^`]+$ description: Canonical HTTPS URL for the external reference source. role: required: true description: Role played by an external source or a chapter concept declaration. DimensionSet: description: Cross-cutting facet vocabularies for classifying subject rows. attributes: activities: range: DimensionFacet multivalued: true inlined_as_list: true required: true description: Engineering lifecycle activities involved in this subject. layers: range: DimensionFacet multivalued: true inlined_as_list: true required: true description: System stack layers involved in this subject. concerns: range: DimensionFacet multivalued: true inlined_as_list: true required: true description: Cross-cutting system qualities and concerns addressed by this subject. contexts: range: DimensionFacet multivalued: true inlined_as_list: true required: false description: Deployment or workload context lenses applicable to this subject. DimensionFacet: description: A single facet term within an activity, layer, concern, or context dimension. attributes: id: identifier: true required: true pattern: ^[a-z0-9]+(-[a-z0-9]+)*$ description: Permanent machine-readable identifier for this record. label: slot_uri: skos:prefLabel required: true description: Canonical human-readable term or heading in sentence case. SubjectGroup: class_uri: skos:Collection description: Top-level structural band of the ML Systems Taxonomy (e.g., Foundations, Stack, Lifecycle, Qualities, System types). attributes: id: identifier: true required: true pattern: ^[a-z0-9]+(-[a-z0-9]+)*$ description: Permanent machine-readable identifier for this record. code: slot_uri: skos:notation required: false pattern: ^[A-Z]$ description: Short hierarchical human-readable code (e.g., P, P4, P4.5). label: slot_uri: skos:prefLabel required: true description: Canonical human-readable term or heading in sentence case. question: required: true description: Core engineering question answered by this group, area, or family. SubjectArea: class_uri: skos:Collection description: One of the 20 subject areas grouping cohesive engineering subjects under a group band. attributes: id: identifier: true required: true pattern: ^[a-z0-9]+(-[a-z0-9]+)*$ description: Permanent machine-readable identifier for this record. code: slot_uri: skos:notation required: false pattern: ^[A-Z]\d+$ description: Short hierarchical human-readable code (e.g., P, P4, P4.5). group: range: SubjectGroup required: false description: Identifier of the parent top-level subject group. label: slot_uri: skos:prefLabel required: true description: Canonical human-readable term or heading in sentence case. display_label: required: false description: Compact label used in tight matrix cells and navigation sidebars. question: required: true description: Core engineering question answered by this group, area, or family. scope: slot_uri: skos:scopeNote required: true description: Declared scope boundary or scope note. status: range: DraftStatusEnum required: false description: Editorial review lifecycle status of the record. includes: multivalued: true required: false description: Topics explicitly included within this area or subject boundary. excludes: multivalued: true required: false description: Neighboring topics explicitly excluded and cross-referenced via [[id]]. warrants: range: FrameworkSource multivalued: true required: false description: External source identifiers warranting this area or subject boundary. warrant_role: required: false description: Epistemic role of the cited design warrants. inventory_status: required: false description: Population status of the subject row concept inventory. rows: range: SubjectRow multivalued: true inlined_as_list: true required: true description: Citeable subject rows belonging to this subject area. SubjectRow: class_uri: skos:Collection description: A citeable subject row owning the primary home for a set of technical concepts. attributes: id: identifier: true required: true pattern: ^[a-z0-9]+(-[a-z0-9]+)*$ description: Permanent machine-readable identifier for this record. code: slot_uri: skos:notation required: false pattern: ^[A-Z]\d+\.\d+$ description: Short hierarchical human-readable code (e.g., P, P4, P4.5). label: slot_uri: skos:prefLabel required: true description: Canonical human-readable term or heading in sentence case. display_label: required: false description: Compact label used in tight matrix cells and navigation sidebars. definition: slot_uri: skos:definition required: true description: Single-sentence technical definition stating what the item is and what it changes. status: range: DraftStatusEnum required: false description: Editorial review lifecycle status of the record. includes: multivalued: true required: false description: Topics explicitly included within this area or subject boundary. excludes: multivalued: true required: false description: Neighboring topics explicitly excluded and cross-referenced via [[id]]. warrants: range: FrameworkSource multivalued: true required: false description: External source identifiers warranting this area or subject boundary. warrant_role: required: false description: Epistemic role of the cited design warrants. inventory_status: required: false description: Population status of the subject row concept inventory. concepts: multivalued: true required: false pattern: ^mlsys\.[a-z0-9]+(-[a-z0-9]+)*$ description: Technical concepts belonging to this model, subject, or view (optional when derived from Concept.home). secondary_concepts: multivalued: true required: false pattern: ^mlsys\.[a-z0-9]+(-[a-z0-9]+)*$ description: Concepts homed elsewhere that have strong secondary relevance here. book_chapters: multivalued: true required: false pattern: ^v(?:ol)?[1-4]/\d{2}$ description: MLSysBook volume/chapter codes (vN/NN) teaching this subject. activities: multivalued: true required: true description: Engineering lifecycle activities involved in this subject. layers: multivalued: true required: true description: System stack layers involved in this subject. concerns: multivalued: true required: true description: Cross-cutting system qualities and concerns addressed by this subject. contexts: multivalued: true required: false description: Deployment or workload context lenses applicable to this subject. ScopeGap: description: Declared candidate topic boundary or gap tracked for future taxonomy versions. attributes: id: identifier: true required: true pattern: ^[a-z0-9]+(-[a-z0-9]+)*$ description: Permanent machine-readable identifier for this record. topic: required: false description: Name of the external benchmark topic or candidate gap topic. label: required: false description: Canonical human-readable term or heading in sentence case. subject_row: required: false description: Identifier of the subject row where a candidate gap would live. reason: required: true description: Editorial explanation for a retirement, scope gap, or tagging disagreement. status: range: GapStatusEnum required: true description: Editorial review lifecycle status of the record. PlacementExample: description: Worked example explaining why a concept lives in its primary subject home. attributes: concept: required: true pattern: ^mlsys\.[a-z0-9]+(-[a-z0-9]+)*$ description: Identifier of the field concept. home: required: true pattern: ^[a-z0-9]+(-[a-z0-9]+)*$ description: Identifier of the primary home subject row. why: required: true description: One-sentence explanation of why this placement or step order holds. GuidesModel: description: Aspect model projected from the single canonical taxonomy (taxonomy/taxonomy.yml) defining role profiles, production symptom triage guides, and sequential learning paths. attributes: schema_version: range: integer required: false equals_number: 1 description: Integer schema version of the document (must equal 1). roles_note: required: false description: Methodological note explaining how role profiles should be read. roles: range: RoleProfile multivalued: true inlined_as_list: true required: true description: Practitioner role profiles mapping core and working subjects. symptoms_note: required: false description: Methodological note explaining how production symptom guides work. symptoms: range: ProductionSymptom multivalued: true inlined_as_list: true required: true description: Production failure symptoms mapped to causes, checks, and levers. paths_note: required: false description: Methodological note explaining how learning paths work. learning_paths: range: LearningPath multivalued: true inlined_as_list: true required: true description: Policy note or ordered list of guided learning paths. RoleProfile: description: Practitioner role profile mapping core and working-knowledge subjects. attributes: id: identifier: true required: true pattern: ^[a-z0-9]+(-[a-z0-9]+)*$ description: Permanent machine-readable identifier for this record. label: slot_uri: skos:prefLabel required: true description: Canonical human-readable term or heading in sentence case. summary: slot_uri: skos:definition required: true description: One-sentence summary of the engineering responsibilities of this role. core: multivalued: true required: true pattern: ^[a-z0-9]+(-[a-z0-9]+)*$ description: Subject rows a strong practitioner in this role is expected to know deeply. working: multivalued: true required: false pattern: ^[a-z0-9]+(-[a-z0-9]+)*$ description: Subject rows a practitioner in this role is expected to work with. ProductionSymptom: description: Production failure symptom mapped to graph-connected root causes, diagnostic checks, and mitigation levers. attributes: id: identifier: true required: true pattern: ^[a-z0-9]+(-[a-z0-9]+)*$ description: Permanent machine-readable identifier for this record. label: slot_uri: skos:prefLabel required: true description: Canonical human-readable term or heading in sentence case. signal: slot_uri: skos:definition required: true description: Observable production telemetry or failure behavior triggering triage. causes: multivalued: true required: true pattern: ^mlsys\.[a-z0-9]+(-[a-z0-9]+)*$ description: Field concepts representing likely root causes or bottlenecks. checks: multivalued: true required: false pattern: ^mlsys\.[a-z0-9]+(-[a-z0-9]+)*$ description: Field concepts representing diagnostic metrics, profilers, or tests. quantities: multivalued: true required: false pattern: ^mlsys\.[a-z0-9]+(-[a-z0-9]+)*$ description: Field concepts naming the measured quantity the symptom is observed through (the metric that moves), listed apart from causes so a check or lever may connect through it without the metric posing as a cause. levers: multivalued: true required: true pattern: ^mlsys\.[a-z0-9]+(-[a-z0-9]+)*$ description: Field concepts representing architectural or operational mitigations. LearningPath: description: Ordered sequence of subjects forming a study path for a target audience. attributes: id: identifier: true required: true pattern: ^[a-z0-9]+(-[a-z0-9]+)*$ description: Permanent machine-readable identifier for this record. label: slot_uri: skos:prefLabel required: true description: Canonical human-readable term or heading in sentence case. audience: required: true description: Target reader or engineering persona for a learning path. steps: range: LearningPathStep multivalued: true inlined_as_list: true required: true description: Ordered sequence of subject steps forming the learning path. LearningPathStep: description: Single step in a learning path pointing to a subject row and explaining why it comes at this stage. attributes: subject: required: true pattern: ^[a-z0-9]+(-[a-z0-9]+)*$ description: Identifier or code of the target subject row. why: required: true description: One-sentence explanation of why this placement or step order holds. BookAlignmentModel: description: Root document for taxonomy/mlsysbook-alignment.yml recording candidate section links between field concepts and MLSysBook chapters. attributes: schema_version: range: integer required: true equals_number: 1 description: Integer schema version of the document (must equal 1). status: range: DraftStatusEnum required: false description: Editorial review lifecycle status of the record. meaning: required: false description: Formal definition of what the controlled relationship verb asserts. links: range: BookAlignmentLink multivalued: true inlined_as_list: true required: true description: Candidate passage links between field concepts and book sections. BookAlignmentLink: description: Candidate passage link from a field concept to a section-backed book concept node. attributes: concept: required: true pattern: ^mlsys\.[a-z0-9]+(-[a-z0-9]+)*$ description: Identifier of the field concept. book_concept: required: true description: Identifier of the section-backed concept node in the book learner graph. status: range: DraftStatusEnum required: true description: Editorial review lifecycle status of the record. depth: range: AlignmentDepthEnum required: true description: Assessment status of teaching depth for the linked passage. relation: range: AlignmentRelationEnum required: false description: Controlled relation identifier from the 17-verb vocabulary. TaxonomyHierarchyModel: class_uri: skos:ConceptScheme description: Aspect model projected from the single canonical taxonomy (taxonomy/taxonomy.yml) defining the polyhierarchical SKOS broader/narrower slice. attributes: schema_version: range: integer required: true equals_number: 1 description: Integer schema version of the document (must equal 1). id: identifier: true required: true description: Permanent machine-readable identifier for this record. title: slot_uri: dcterms:title required: true description: Human-readable title of the document or source. scope: slot_uri: skos:scopeNote required: true description: Declared scope boundary or scope note. status: range: ModelStatusEnum required: true description: Editorial review lifecycle status of the record. sources: range: FrameworkSource multivalued: true inlined_as_list: true required: true description: External curricula, standards, documentation, or research sources. topics: range: TaxonomyTopic multivalued: true inlined_as_list: true required: true description: Topics in the SKOS hierarchy pilot or external coverage checklist. top_concepts: multivalued: true required: true pattern: ^mlsys\.topic\.[a-z0-9]+(-[a-z0-9]+)*$ description: Root topic identifiers in the SKOS hierarchy pilot. hierarchy: range: HierarchyAssertion multivalued: true inlined_as_list: true required: true description: Explicit SKOS broader/narrower assertions between topics and concepts. collections: range: TaxonomyCollection multivalued: true inlined_as_list: true required: true description: Navigation collections derived from field concept families. TaxonomyTopic: class_uri: skos:Concept description: Umbrella topic node in the SKOS broader/narrower hierarchy pilot. attributes: id: identifier: true required: true pattern: ^mlsys\.topic\.[a-z0-9]+(-[a-z0-9]+)*$ description: Permanent machine-readable identifier for this record. label: slot_uri: skos:prefLabel required: true description: Canonical human-readable term or heading in sentence case. definition: slot_uri: skos:definition required: true description: Single-sentence technical definition stating what the item is and what it changes. status: range: DraftStatusEnum required: true description: Editorial review lifecycle status of the record. HierarchyAssertion: description: Asserted SKOS broader/narrower relationship with explicit editorial rationale. attributes: narrower: required: true pattern: ^mlsys\.([a-z0-9]+(-[a-z0-9]+)*|topic\.[a-z0-9]+(-[a-z0-9]+)*)$ description: More specific concept or topic in a SKOS hierarchy assertion. broader: required: true pattern: ^mlsys\.topic\.[a-z0-9]+(-[a-z0-9]+)*$ description: More general umbrella topic in a SKOS hierarchy assertion. rationale: required: true description: Editorial placement principles or justification for a hierarchy/ledger assertion. status: range: DraftStatusEnum required: true description: Editorial review lifecycle status of the record. TaxonomyCollection: class_uri: skos:Collection description: Navigation collection derived from a field concept family. attributes: id: identifier: true required: true pattern: ^mlsys\.collection\.[a-z0-9]+(-[a-z0-9]+)*$ description: Permanent machine-readable identifier for this record. label: slot_uri: skos:prefLabel required: true description: Canonical human-readable term or heading in sentence case. scope_note: slot_uri: skos:scopeNote required: true description: Note explaining the browsing scope of a SKOS collection. family: required: true pattern: ^[a-z0-9]+(-[a-z0-9]+)*$ description: Identifier of the owning concept family. CoverageChecklistModel: description: Root document for external coverage benchmark checklists (taxonomy/coverage/*.yml). attributes: schema_version: range: integer required: false equals_number: 1 description: Integer schema version of the document (must equal 1). id: identifier: true required: true description: Permanent machine-readable identifier for this record. title: required: true description: Human-readable title of the document or source. basis: required: true description: Epistemic basis of the relationship assertion. held_out: range: boolean required: true description: Whether this benchmark or agreement run was held out from design. topics: range: CoverageChecklistTopic multivalued: true inlined_as_list: true required: true description: Topics in the SKOS hierarchy pilot or external coverage checklist. CoverageChecklistTopic: description: Single benchmark topic evaluated against the taxonomy. attributes: topic: required: true description: Name of the external benchmark topic or candidate gap topic. sources: multivalued: true required: false description: External curricula, standards, documentation, or research sources. status: range: ChecklistStatusEnum required: true description: Editorial review lifecycle status of the record. concepts: multivalued: true required: false pattern: ^mlsys\.[a-z0-9]+(-[a-z0-9]+)*$ description: Technical concepts belonging to this model, subject, or view. subject: required: false pattern: ^[a-z0-9]+(-[a-z0-9]+)*$ description: Permanent identifier of the target subject row. note: required: false description: Editorial justification naming which definition clause covers the topic. CoverageLedgerModel: description: Root document for taxonomy/coverage-ledger.yml reconciling chapter primary declarations against field concepts. attributes: schema_version: range: integer required: true equals_number: 1 description: Integer schema version of the document (must equal 1). decisions: range: CoverageLedgerDecision multivalued: true inlined_as_list: true required: true description: Audited reconciliation decisions for chapter primary concept declarations. CoverageLedgerDecision: description: Audited reconciliation decision for a chapter primary concept declaration. attributes: chapter: required: true description: Volume and chapter folder identifier (e.g., vol2/08_fleet_orchestration). label: required: true description: Canonical human-readable term or heading in sentence case. role: range: ConceptRoleEnum required: true description: Role played by an external source or a chapter concept declaration. disposition: range: LedgerDispositionEnum required: true description: Reconciliation disposition of the chapter concept against field concepts. field_concepts: multivalued: true required: false pattern: ^mlsys\.[a-z0-9]+(-[a-z0-9]+)*$ description: Field concept identifiers mapped to this chapter concept declaration. rationale: required: true description: Editorial placement principles or justification for a hierarchy/ledger assertion. evidence: range: LedgerEvidenceQuote multivalued: true inlined_as_list: true required: true description: Verbatim manuscript section quotes supporting the reconciliation decision. inventory_id: required: true description: Deterministic hash identifier of the chapter concept declaration. reviewer: required: true description: Human or model reviewer that audited the reconciliation decision. reviewer_kind: range: ReviewerKindEnum required: true description: Whether the reviewer was human or ai. reviewed_on: required: true pattern: ^\d{4}-\d{2}-\d{2}$ description: ISO-8601 date on which the reconciliation decision was recorded. source_hash: required: true pattern: ^[0-9a-f]{64}$ description: SHA-256 digest of the manuscript section text. field_hash: required: false pattern: ^[0-9a-f]{64}$ description: SHA-256 digest of the mapped field concept definitions. LedgerEvidenceQuote: description: Verbatim section quote from a chapter supporting a coverage ledger decision. attributes: section: required: true description: Quarto section anchor identifier (#sec-...) in the chapter manuscript. quote: required: true description: Verbatim quote from the manuscript section. AnyValue: class_uri: linkml:Any description: Dynamic mapping value used for arbitrary tagger-name keys in agreement records. AgreementRecordModel: description: Root document for inter-tagger agreement benchmark records (taxonomy/agreement/*.yml). attributes: schema_version: range: integer required: false equals_number: 1 description: Integer schema version of the document (must equal 1). id: identifier: true required: true pattern: ^[A-Za-z0-9][A-Za-z0-9._-]*$ description: Permanent machine-readable identifier for this agreement sample. title: slot_uri: dcterms:title required: true description: Human-readable title of the agreement benchmark sample. basis: required: true description: Sampling methodology and experimental protocol for the agreement runs. items: range: AgreementSampleItem multivalued: true inlined_as_list: true required: true description: Fixed sample of items tagged across all runs in this record. runs: range: AgreementRun multivalued: true inlined_as_list: true required: true description: Recorded independent tagging runs over the fixed item sample. AgreementSampleItem: description: Single sampled item in an inter-tagger agreement benchmark. attributes: n: range: integer required: true minimum_value: 1 description: 1-based sample index within the agreement record. id: required: false description: Stable identifier of the sampled question or artifact. track: required: false description: Domain track of the sampled item (e.g., cloud, edge, mobile, global). level: required: false description: Depth or seniority level of the sampled item (e.g., L1 to L6+). AgreementRun: description: Single multi-tagger evaluation run over the fixed agreement sample. attributes: id: identifier: true required: true pattern: ^[A-Za-z0-9][A-Za-z0-9._-]*$ description: Identifier of the agreement run within the record. held_out: range: boolean required: true description: Whether this run evaluated a fresh sample that did not shape the tagging rules. note: required: false description: Context note describing the taxonomy version and rule set tested in this run. taggers: range: AnyValue required: true annotations: dict_key_pattern: ^[A-Za-z0-9][A-Za-z0-9 ._-]*$ dict_value_array_ref: AgreementItemTag description: Mapping from independent tagger identifier to its list of AgreementItemTag records. AgreementItemTag: description: Subject and concept tags assigned to a single sample item by one tagger. attributes: n: range: integer required: true minimum_value: 1 description: 1-based sample index matching AgreementSampleItem.n. subject: required: true pattern: ^[a-z0-9]+(-[a-z0-9]+)*$ description: Subject row identifier assigned by the tagger. concepts: multivalued: true required: false pattern: ^mlsys\.[a-z0-9]+(-[a-z0-9]+)*$ description: Field concept identifiers assigned by the tagger. proposed: required: false description: Candidate concept proposed by the tagger when existing concepts were insufficient. reason: required: false description: Reason recorded when no existing concept was assigned. TaxonomyReleaseDocument: tree_root: true class_uri: skos:ConceptScheme description: Root schema for the compiled public JSON release (downloads/mlsys-taxonomy.json) published alongside mlsys-taxonomy.schema.json. attributes: name: slot_uri: dcterms:title required: true description: Official name of the published taxonomy release. version: range: FrameworkVersionEnum slot_uri: owl:versionInfo required: true description: Published version string of the taxonomy release. status: range: ModelStatusEnum required: true description: Editorial lifecycle status of the release. url: slot_uri: dcterms:identifier required: true pattern: ^https://[^\s<>"{}|\\^`]+$ description: Canonical landing URL for the taxonomy explorer. license: range: ReleaseLicense inlined: true required: true description: License governing reuse of the taxonomy release artifacts. citation: slot_uri: dcterms:bibliographicCitation required: true description: Formatted plain-text citation for the current taxonomy release. note: slot_uri: skos:editorialNote required: true description: Scope and review disclaimer accompanying the release. tagging_rules: multivalued: true required: true description: Operational rules for tagging external items with subject and concept identities. placement_examples: range: PlacementExample multivalued: true inlined_as_list: true required: true description: Worked examples illustrating the home rule on boundary concepts. groups: range: ReleaseGroup multivalued: true inlined_as_list: true required: true description: Top-level structural bands containing subject areas and subjects. concepts: range: ReleaseConcept multivalued: true inlined_as_list: true required: true description: Full inventory of field concepts with home subject pointers and book passages. gaps: range: ReleaseGap multivalued: true inlined_as_list: true required: true description: Declared candidate scope gaps published with the release. relations: range: ControlledRelation multivalued: true inlined_as_list: true required: true description: Controlled 17-verb relationship vocabulary with forward and inverse phrases. relationships: range: ReleaseRelationship multivalued: true inlined_as_list: true required: true description: Directed, condition-qualified propositions between field concepts. retired: range: RetiredConcept multivalued: true inlined_as_list: true required: true description: Permanent redirect records for retired concept identities. guides: range: GuidesModel inlined: true required: true description: Practitioner role profiles, production symptom triage guides, and learning paths. ReleaseLicense: description: License metadata block in the compiled taxonomy JSON release. attributes: name: required: true description: Short license identifier (e.g., CC BY 4.0). url: required: true pattern: ^https://[^\s<>"{}|\\^`]+$ description: Canonical URL for the license deed. ReleaseGroup: class_uri: skos:Collection description: Top-level group entry in the compiled taxonomy JSON release outline. attributes: code: slot_uri: skos:notation required: true pattern: ^[A-Z]$ description: Single-letter group code (F, S, P, Q, T). id: identifier: true required: true pattern: ^[a-z0-9]+(-[a-z0-9]+)*$ description: Permanent machine-readable group identifier. label: slot_uri: skos:prefLabel required: true description: Human-readable group title. question: required: true description: Core engineering question answered by this group. areas: range: ReleaseArea multivalued: true inlined_as_list: true required: true description: Subject areas belonging to this group. ReleaseArea: class_uri: skos:Collection description: Subject area entry in the compiled taxonomy JSON release outline. attributes: code: slot_uri: skos:notation required: true pattern: ^[A-Z]\d+$ description: Hierarchical area code (e.g., P4). id: identifier: true required: true pattern: ^[a-z0-9]+(-[a-z0-9]+)*$ description: Permanent machine-readable area identifier. label: slot_uri: skos:prefLabel required: true description: Human-readable area title. question: required: true description: Core engineering question answered by this area. scope: slot_uri: skos:scopeNote required: true description: Scope boundary of this subject area. subjects: range: ReleaseSubject multivalued: true inlined_as_list: true required: true description: Citeable subjects belonging to this area. ReleaseSubject: class_uri: skos:Collection description: Subject entry in the compiled taxonomy JSON release outline. attributes: code: slot_uri: skos:notation required: true pattern: ^[A-Z]\d+\.\d+$ description: Hierarchical subject code (e.g., P4.3). id: identifier: true required: true pattern: ^[a-z0-9]+(-[a-z0-9]+)*$ description: Permanent machine-readable subject identifier. label: slot_uri: skos:prefLabel required: true description: Human-readable subject title. definition: slot_uri: skos:definition required: true description: Single-sentence definition of the subject boundary. includes: multivalued: true required: true description: Topics explicitly included in this subject. excludes: multivalued: true required: true description: Neighboring topics excluded from this subject with [[row-id]] cross-references. contexts: multivalued: true required: true description: Applicable system context lenses for this subject. concepts: multivalued: true required: true pattern: ^mlsys\.[a-z0-9]+(-[a-z0-9]+)*$ description: Primary concepts homed in this subject. related_concepts: multivalued: true required: true pattern: ^mlsys\.[a-z0-9]+(-[a-z0-9]+)*$ description: Secondary concepts cross-linked to this subject. taught_in: range: ReleaseChapterPointer multivalued: true inlined_as_list: true required: true description: MLSysBook chapters that teach this subject at chapter grain. ReleaseChapterPointer: description: Resolved chapter pointer in the compiled taxonomy JSON release. attributes: volume: required: true pattern: ^vol[1-4]$ description: Book volume identifier (vol1 to vol4). chapter: required: true description: Human-readable chapter title. url: required: true pattern: ^https://[^\s<>"{}|\\^`]+$ description: Canonical URL to the chapter or section on mlsysbook.ai. ReleaseConcept: class_uri: skos:Concept description: Concept record in the compiled taxonomy JSON release. attributes: id: identifier: true required: true pattern: ^mlsys\.[a-z0-9]+(-[a-z0-9]+)*$ description: Permanent machine-readable concept identifier. label: slot_uri: skos:prefLabel required: true description: Canonical human-readable concept term. aliases: slot_uri: https://mlsysbook.ai/taxonomy/scheme#entryTerm multivalued: true required: true description: Search entry terms retained for retrieval, without an assertion of lexical equivalence. definition: slot_uri: skos:definition required: true description: Single-sentence technical definition. background: range: boolean required: true description: True when the concept originated outside ML systems (scope=background). home: required: true pattern: ^[A-Z]\d+\.\d+$ description: Readable code of the concept's home subject. home_id: required: true pattern: ^[a-z0-9]+(-[a-z0-9]+)*$ description: Permanent identifier of the concept's home subject. added_in: required: false pattern: ^[0-9]+\.[0-9]+(\.[0-9]+)?(-(draft|rc[0-9]+))?$ description: Release that first admitted this concept, the date-of-entry part of a Z39.19 history note (section 6.2.3). warrant: range: ReleaseWarrant inlined: true required: true description: Computed Z39.19 section 5.3.5 warrant counts for this concept. book_passages: range: ReleaseChapterPointer multivalued: true inlined_as_list: true required: true description: Candidate section-level book passages discussing this concept. ReleaseWarrant: description: Warrant counts computed from recorded evidence at build time; never authored by hand. attributes: literary: range: integer required: true description: Covered topics citing this concept in non-book checklists (papers, courses, standards). corpus_chapters: range: integer required: true description: Book chapters whose text contains the concept's label or an alias. organizational: range: integer required: true description: Covered MLSysBook chapter topics citing this concept plus section-level book links. user_proxy: range: integer required: true description: StaffML questions tagged with this concept; term-assignment frequency, a proxy, not user search data. ReleaseGap: description: Declared scope gap entry in the compiled taxonomy JSON release. attributes: id: identifier: true required: true pattern: ^[A-Za-z0-9][A-Za-z0-9._-]*$ description: Permanent identifier of the declared gap. topic: required: true description: Name of the candidate topic left open. subject: required: true pattern: ^[A-Z]\d+\.\d+$ description: Readable code of the subject row where the gap resides. status: range: GapStatusEnum required: true description: Status of the declared gap (candidate). reason: required: true description: Reason the topic remains a declared gap in this version. ReleaseRelationship: class_uri: owl:Axiom description: Relationship entry in the compiled taxonomy JSON release. attributes: source: required: true pattern: ^mlsys\.[a-z0-9]+(-[a-z0-9]+)*$ description: Source concept identifier. relation: range: RelationIdEnum required: true description: Controlled relation verb from the 17-relation vocabulary. target: required: true pattern: ^mlsys\.[a-z0-9]+(-[a-z0-9]+)*$ description: Target concept identifier. statement: required: true description: Specific forward predicate phrase refining the relation. conditions: required: true description: Explicit condition under which the relationship holds. StaffMLLabelsDocument: description: Compact StaffML consumer labels projection (staffml/app/src/data/mlsys-taxonomy.json) generated from the compiled framework and field models. attributes: version: range: FrameworkVersionEnum required: true description: Published version string of the taxonomy release. explorer: required: true pattern: ^https://[^\s<>"{}|\\^`]+$ description: Canonical landing URL for the taxonomy explorer. areas: range: StaffMLLabelArea multivalued: true inlined_as_list: true required: true description: Ordered taxonomy areas with display codes, group metadata, and subject IDs. subjects: range: AnyValue required: true annotations: dict_key_pattern: ^[a-z0-9]+(-[a-z0-9]+)*$ dict_value_ref: StaffMLLabelSubject description: Mapping from subject row identifier to StaffMLLabelSubject metadata. concepts: range: AnyValue required: true annotations: dict_key_pattern: ^mlsys\.[a-z0-9]+(-[a-z0-9]+)*$ dict_value_ref: StaffMLLabelConcept description: Mapping from concept identifier (mlsys.*) to StaffMLLabelConcept metadata. StaffMLLabelArea: description: Area entry in the compact StaffML taxonomy labels projection. attributes: id: required: true pattern: ^[A-Z]\d+$ description: Hierarchical area code (e.g., F1, P4). slug: required: true pattern: ^[a-z0-9]+(-[a-z0-9]+)*$ description: Permanent machine-readable area slug identifier. label: required: true description: Full human-readable area title. short: required: true description: Short display label for UI cards and sidebar navigation. group: required: true description: Human-readable title of the parent group. group_id: required: true pattern: ^[a-z0-9]+(-[a-z0-9]+)*$ description: Permanent machine-readable parent group slug identifier. group_code: required: true pattern: ^[A-Z]$ description: Single-letter code of the parent group. question: required: true description: Core engineering question answered by this area. subjects: multivalued: true required: true pattern: ^[a-z0-9]+(-[a-z0-9]+)*$ description: Ordered subject row identifiers belonging to this area. StaffMLLabelSubject: description: Subject metadata entry in the compact StaffML taxonomy labels projection. attributes: code: required: true pattern: ^[A-Z]\d+\.\d+$ description: Hierarchical subject code (e.g., P4.3). label: required: true description: Full human-readable subject title. short: required: true description: Short display label for UI cards. area: required: true description: Full human-readable parent area title. area_id: required: true pattern: ^[A-Z]\d+$ description: Hierarchical parent area code. area_slug: required: true pattern: ^[a-z0-9]+(-[a-z0-9]+)*$ description: Permanent machine-readable parent area slug identifier. definition: required: true description: Single-sentence definition of the subject boundary. StaffMLLabelConcept: description: Concept metadata entry in the compact StaffML taxonomy labels projection. attributes: label: required: true description: Canonical human-readable concept term. subject: required: true pattern: ^(|[a-z0-9]+(-[a-z0-9]+)*)$ description: Home subject row identifier (empty string for background concepts). UnifiedTaxonomyModel: class_uri: skos:ConceptScheme description: Canonical single-source-of-truth document (taxonomy/taxonomy.yml) unifying the subject classification framework, field concept graph, practitioner guides, and SKOS hierarchy. attributes: schema_version: range: integer required: true equals_number: 1 description: Integer schema version of the document (must equal 1). id: identifier: true required: true pattern: ^[A-Za-z0-9][A-Za-z0-9._-]*$ description: Permanent machine-readable identifier for the subject framework. status: range: ModelStatusEnum required: true description: Editorial lifecycle status of the taxonomy. version: range: FrameworkVersionEnum slot_uri: owl:versionInfo required: true description: Current taxonomy release version string. title: slot_uri: dcterms:title required: true description: Human-readable title of the taxonomy. scope: slot_uri: skos:scopeNote required: true description: Declared scope boundary of the subject classification framework. relationship_semantics: required: false description: Explanation of how subject membership differs from SKOS broader/narrower. row_rule: required: false description: Editorial rule defining what qualifies as a subject row. secondary_policy: required: false description: Policy governing secondary concept links across subject rows. warrant_policy: required: false description: Policy governing how external sources warrant subject boundaries. context_policy: required: false description: Policy governing context lenses vs dedicated system-type areas. book_mapping_policy: required: false description: Policy governing chapter pointers and section-level passage links. competency_policy: required: false description: Policy separating subject knowledge from observable task competency. rationale: multivalued: true required: false description: Editorial placement principles for concepts and subjects. tagging_rules: multivalued: true required: false description: Operational rules for tagging questions, chapters, slides, and labs. placement_examples: range: PlacementExample multivalued: true inlined_as_list: true required: false description: Worked examples illustrating the home rule on boundary concepts. dimensions: range: DimensionSet inlined: true required: true description: Cross-cutting facet vocabularies (activities, layers, concerns, contexts). groups: range: SubjectGroup multivalued: true inlined_as_list: true required: false description: Top-level structural bands of the taxonomy. areas: range: SubjectArea multivalued: true inlined_as_list: true required: true description: Subject areas organized under the top-level groups. gaps: range: ScopeGap multivalued: true inlined_as_list: true required: false description: Declared candidate scope gaps tracked for future taxonomy versions. sources: range: FrameworkSource multivalued: true inlined_as_list: true required: true description: External curricula, standards, and benchmarks warranting subject boundaries. field_id: required: true pattern: ^[A-Za-z0-9][A-Za-z0-9._-]*$ description: Permanent machine-readable identifier for the field concept graph. field_title: required: true description: Human-readable title of the field concept graph. field_scope: required: true description: Declared scope boundary of the field concept graph. background_boundary: required: false description: Rule distinguishing core ML systems concepts from imported background concepts. limitations: multivalued: true required: false description: Explicit caveats on what the model does and does not claim. learning_paths: required: false description: Policy note or ordered list of guided learning paths. field_sources: range: FieldSource multivalued: true inlined_as_list: true required: true description: External reading sources warranting field concepts and relationships. families: range: ConceptFamily multivalued: true inlined_as_list: true required: true description: Coarse navigation groupings of field concepts. concepts: range: UnifiedConcept multivalued: true inlined_as_list: true required: true description: Full inventory of technical concepts with required primary subject `home` pointers. relations: range: ControlledRelation multivalued: true inlined_as_list: true required: true minimum_cardinality: 17 description: Controlled 17-verb relationship vocabulary with forward and inverse readings. retired: range: RetiredConcept multivalued: true inlined_as_list: true required: false description: Permanent redirect records for withdrawn or merged concept identities. relationships: range: Relationship multivalued: true inlined_as_list: true required: true description: Directed, condition-qualified technical propositions between concepts. views: range: FieldView multivalued: true inlined_as_list: true required: true description: Named curated subsets of field concepts (`all` view is auto-derived). guides: range: GuidesModel inlined: true required: true description: Practitioner role profiles, production symptom triage guides, and learning paths. skos_hierarchy: range: TaxonomyHierarchyModel inlined: true required: false description: Explicit SKOS broader/narrower hierarchy assertions and family collections. UnifiedConcept: class_uri: skos:Concept description: A permanent technical concept in UnifiedTaxonomyModel with a required primary subject home. attributes: id: identifier: true required: true pattern: ^mlsys\.[a-z0-9]+(-[a-z0-9]+)*$ description: Permanent machine-readable identifier for this record. label: slot_uri: skos:prefLabel required: true description: Canonical human-readable term or heading in sentence case. home: required: true pattern: ^[a-z0-9]+(-[a-z0-9]+)*$ description: Identifier of the primary candidate home subject row. definition: slot_uri: skos:definition required: true description: Single-sentence technical definition stating what the item is and what it changes. family: range: ConceptFamily required: true description: Identifier of the owning concept family. status: range: DraftStatusEnum required: true description: Editorial review lifecycle status of the record. aliases: slot_uri: https://mlsysbook.ai/taxonomy/scheme#entryTerm multivalued: true required: false description: Search entry terms retained for retrieval, without an assertion of lexical equivalence. scope: range: ConceptScopeEnum required: false description: Whether the record belongs to core ML systems or imported background knowledge. added_in: required: false pattern: ^[0-9]+\.[0-9]+(\.[0-9]+)?(-(draft|rc[0-9]+))?$ description: Release that first admitted this concept, the date-of-entry part of a Z39.19 history note (section 6.2.3). references: range: FieldSource multivalued: true required: false description: Identifiers of external reading sources warranting this record.