Taxonomy

Taxonomy ● ACTIVE

Contract: v0.9.4 • View Schema ↗

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

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

Metadata Properties (metadata)

Field	Type	Required	Description
id	string	Yes	Canonical unique identifier for the taxonomy node (e.g. loc.es or std.lomloe.v1).
reference_code	string	Yes	Standardized reference code used across curriculum specifications.
name	string	No	Readable name of the taxonomy concept, country, or standard.
title	string	No	Official title of the standard or educational level.
type	string	No	Taxonomy type classifier (e.g. location_country, standard, subject_area).
category	string	No	Faceted category discriminator (LOCATION, STANDARD, MASTERY_SCALES, COMPETENCY).
active	boolean	No	Whether this taxonomy element is actively usable in curriculum pipelines.
countryRef	string	No	ISO country code or global reference.
version	string	No	Semantic version tag of the taxonomy definition.

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

apiVersion: colabedu.ai/v1beta1
kind: Taxonomy
metadata:
  id: loc.es
  type: location_country
  active: true
  name: "España"
  flag: "🇪🇸"
  languages: ["es-ES"]
spec:
  regions:
    - id: loc.es.mad
      name: "Comunidad de Madrid"
      active: true
      flagAsset: "assets/flags/en/mad.svg"
    - id: loc.es.cat
      name: "Catalunya"
      active: true
      languages: ["ca-ES"]
      flagAsset: "assets/flags/en/cat.svg"
  orgLevels:
    - id: org.lvl.es.infantil
      name: "Infantil"
    - id: org.lvl.es.primaria
      name: "Primaria"

The Taxonomy resource allows defining and structuring hierarchical concepts such as geographical locations (countries, regions), organizational levels of the educational system, or curriculum standards grouped by subject and level.

This structure is fundamental for organizing and filtering other resources within the system (such as rubrics and exercises). It is also the backbone of the CLI scaffolding pipeline, which uses taxonomy identifiers to discover, fetch, and auto-generate evaluation rubrics from official curriculum documents.

Variants and Spec Behaviors

Depending on the metadata.type property, the specification adapts:

• location_country: Defines national boundaries, regions, and organizational education levels (orgLevels).
• standard: Configures official frameworks (e.g. IB, AP, LOMLOE) with levels and subjects.
• bundle_course: Groups complete curriculum units (units) mapping to evaluation criteria.

Relationship to Rubrics

Taxonomy bundles are the source of truth for rubric generation. The taxonomy rubrics scaffold CLI command reads a bundle_course spec to derive the rubric structure:

bundle_course (Taxonomy)
    └── units[]  →  rubric criteria[]  →  BLOCK_RUBRIC (C0 Layer)

Each unit in the bundle maps to one criterion in the generated rubric, inheriting id, name, description, and suggested_hours.

Related CLI Commands

# Discover official source documents for a bundle
bash ce-cli.sh taxonomy sources discover --referenceCode bundle.us.ap.spanish_language.hl

# Download the curriculum PDF
bash ce-cli.sh taxonomy sources fetch --referenceCode bundle.us.ap.spanish_language.hl

# Generate rubric YAML (AI-powered levels from the PDF)
bash ce-cli.sh taxonomy rubrics scaffold --referenceCode bundle.us.ap.spanish_language.hl --ai true

See the CLI Tutorial for the full end-to-end walkthrough.