CourseSpec

CourseSpec ● ACTIVE

Contract: v0.9.4 • View Schema ↗

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

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

Metadata Properties (metadata)

Field	Type	Required	Description
id	string	Yes	Canonical unique identifier for the course specification (e.g. course.ib.spanish_b.sl.v1).
reference_code	string	Yes	Standardized reference code identifying the course instance across jurisdictions.
referenceCode	string	Yes	CamelCase alias for reference_code supported for backward compatibility.
name	string	No	Human-readable title or course label displayed in user interfaces.
title	string	No	Descriptive course title or subject name.
description	string	No	Detailed pedagogical description of the course, target cohort, and competency scope.
author	string	No	Authoring institution, curriculum designer, or publisher.
version	string	No	Semantic version tag of the course specification.
authority	string	No	Educational authority scope (GLOBAL, NATIONAL, DISTRICT, SCHOOL, TEACHER).
tags	array	No	Taxonomy tags and curricular keywords for catalog indexing.

Specification Body (spec)

Field	Type	Required	Description
standardRef	string	No	Canonical reference to the inherited StandardSpec (e.g. standard.ib.spanish_b).
pathway_template_ref	string	No	Reference code to the underlying official PathwayTemplate curriculum framework.
modality	string	No	Academic delivery track and pacing modality.
academic_year	string	No	Applicable academic cycle or cohort school year (e.g. 2026-2027).
target_weeks	integer	No	Estimated instructional duration in calendar weeks.
misconceptionRefs	string[]	No	References to targeted misconception and diagnostic error libraries.
misconceptionRefsOverride	boolean	No	Whether course misconception libraries override (true) or merge with (false) standard defaults.
units	object[]	No	Ordered sequence of pedagogical teaching units and thematic modules.

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

apiVersion: colabedu.ai/v1beta1
kind: CourseSpec
metadata:
  reference_code: "course.ib.spanish_b.sl"
  name: "IB Spanish B — Standard Level"
  description: "IB Spanish B course for Standard Level (SL). Target CEFR level: B2."
  author: "ColabEdu Core"
  version: "0.9.4"
  authority: "GLOBAL"
spec:
  standardRef: "standard.ib.spanish_b"
  pathway_template_ref: "tmpl.ib.spanish_b.sl.v1"
  modality: "FULL_YEAR"
  academic_year: "2026-2027"
  target_weeks: 36
  misconceptionRefs:
    - library.misconceptions.spanish_l2.base
    - library.misconceptions.spanish_l2.intermediate
  misconceptionRefsOverride: true

The CourseSpec (Course Specification) resource adapts a general educational standard (StandardSpec) to a specific course and grade level (such as IB Spanish B SL or 2nd Grade ESO). It enables overriding the default misconception libraries configured at the standard level for this specific course.