PathwayTemplate

The PathwayTemplate resource represents the official curriculum framework of a subject under an educational standard (e.g., IB Spanish B SL, AP Spanish Language, or LOMLOE Spanish Literature).

---

Pedagogical Concept

Within the Pedagogy as Code (OPS) architecture, PathwayTemplate bridges the gap between statutory standards and classroom operations:

1. Thematic Structuring: Defines mandatory teaching units, core topics, and prescribed subtopics established by educational bodies (State Ministries, College Board, International Baccalaureate).
2. Official Assessment Weighting: Encapsulates instructional hour allocations and official examination weights (e.g., Paper 1: 25%, Paper 2: 50%, Individual Oral: 25%).
3. Foundation for Course Instances: Educators and schools do not construct curricula from scratch; they instantiate a CourseSpec that inherits from an official PathwayTemplate and specializes it into specific delivery modalities (Full Year, Intensive, or Remediation).

---

Canonical YAML Schema (colabedu/v1)

# --- UNIVERSAL OPS ENVELOPE ---
api_version: "colabedu/v1"
kind: "PathwayTemplate"

metadata:
  reference_code: "tmpl.ib.spanish_b.sl.v1"
  title: "IB Spanish B SL — Official Pathway Template"
  version: "1.0.0"
  authority: "GLOBAL"
  tags: ["ib", "dp", "spanish_b", "sl", "curriculum"]

spec:
  standard_ref: "global.standard.ib.dp"
  subject_ref: "subj.world_languages.spanish"
  education_level: "High School (11-12)"
  total_recommended_hours: 150

  # Official Assessment Weighting
  assessment_components:
    - code: "paper_1"
      title: "Paper 1: Receptive Skills (Reading & Listening)"
      weight_percentage: 25
    - code: "paper_2"
      title: "Paper 2: Productive Skills (Written Task)"
      weight_percentage: 50
    - code: "internal_oral"
      title: "Internal Assessment: Individual Oral"
      weight_percentage: 25

  # Prescribed Units and Topics
  units:
    - id: "unit_1_identities"
      title: "Identities (Identidades)"
      recommended_hours: 30
      topics:
        - id: "lifestyles"
          title: "Lifestyles and personal wellbeing"
          competency_refs: ["ib.lang_b.receptive.text", "ib.lang_b.productive.writing"]
        - id: "subcultures"
          title: "Subcultures in the Hispanic World"
          competency_refs: ["ib.lang_b.intercultural.awareness"]

---

Specification Fields

Metadata (metadata)

Field	Type	Required	Description
reference_code	string	Yes	Canonical template identifier (e.g., tmpl.ib.spanish_b.sl.v1).
title	string	Yes	Official descriptive title.
version	string	Yes	Semantic version (1.0.0).
authority	string	Yes	Sovereignty scope (GLOBAL, NATIONAL, DISTRICT).

Spec Body (spec)

Field	Type	Required	Description
standard_ref	string	Yes	Reference ID to educational standard (StandardSpec or Taxonomy).
subject_ref	string	Yes	Reference ID to subject area (SubjectArea).
total_recommended_hours	number	No	Prescribed instructional hours.
assessment_components	array	No	Official examination breakdown with weight percentages.
units	array	Yes	Thematic units composing the course framework.
units[].topics	array	Yes	Topics included in each unit.
units[].topics[].competency_refs	string[]	No	Competencies evaluated in each topic.