Rubric

BLOCK_RUBRIC ● ACTIVE

Contract: v0.9.4 • View Schema ↗

Specification Standard: Open Pedagogy Specification (OPS) ce-specs-registry: schemas/assessment/rubric.schema.yaml

⚡ Live Schema Contract Definition (Auto-synced from schemas/assessment/rubric.schema.yaml) ▼

Metadata Properties (metadata)

Field	Type	Required	Description
id	string	Yes	Canonical unique identifier for the rubric (e.g. global.c0.ap.spanish.rubric.v1).
reference_code	string	Yes	Official reference code identifying this rubric in grading workflows.
referenceCode	string	Yes	CamelCase alias for reference_code supported for backward compatibility.
name	string	No	Internal programmatic name of the rubric.
displayName	string	No	Human-readable label displayed in teacher grading dashboards.
description	string	No	Detailed description of the rubric, exam purpose, and statutory basis.
tags	array	No	Keywords to facilitate catalog search and taxonomy filtering.
country	string	No	ISO country code or standard jurisdiction (e.g. ES, US, MX, GLOBAL).
version	string	No	Semantic version tag of the rubric contract.
status	string	No	Lifecycle state (ACTIVE = normative and verified for grading).

Specification Body (spec)

Field	Type	Required	Description
scale	string	No	Scoring scale reference (e.g. ebau_10, lomloe_10, actfl_ap_5, ib_7).
taxonomy_crosswalks	object[]	No	Mappable transversal competencies and key skill alignments.
criteria	object[]	No	List of analytical grading criteria with weights, descriptors, and levels.

📦 Canonical YAML Example (Auto-synced from examples/assessment/rubric.example.yaml) ▼

apiVersion: colabedu.ai/v1beta1
kind: BLOCK_RUBRIC
metadata:
  id: global.c0.ap.spanish_literature.essay.text_comparison.v1.v1.6a4ae1
  displayName: "Essay - Text Comparison"
  description: "Scoring guidelines for AP Spanish Literature based on a 0-5 scale."
  tags:
    - "AP"
    - "Spanish Literature"
  version: "1.0.0"
spec:
  scale: "actfl_ap_5"
  criteria:
    - id: "content"
      name: "Content"
      levels:
        - score: 5
          label: "Sobresaliente"
          descriptor: "The essay compares the theme in both texts using relevant evidence."
        - score: 3
          label: "Notable"
          descriptor: "The essay compares the theme in both texts; evidence is appropriate but uneven."
        - score: 1
          label: "Insuficiente"
          descriptor: "The essay may attempt to address one or both texts but does not discuss the theme."

The Rubric resource is part of Layer 0 (C0) of OPS, acting as the immutable or “normative” source of truth for exercise grading.

Rubrics map the grading criteria of official exams (such as AP or IB) or evaluation blocks defined in educational laws (such as LOMLOE or TEKS) to a quantifiable structure for AI.