ExerciseSpec

ExerciseSpec ● ACTIVE

Contract: v0.9.4 • View Schema ↗

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

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

Metadata Properties (metadata)

Field	Type	Required	Description
id	string	Yes	Canonical unique identifier for the exercise specification (e.g. us.ap.c2.spanish.frq1.v1).
referenceCode	string	Yes	CamelCase alias for reference_code supported for backward compatibility.
reference_code	string	Yes	Standardized reference code identifying the concrete exercise in question banks.
name	string	No	Human-readable exercise name or assignment title.
standard	string	No	Parent educational standard identifier (e.g. AP_SPANISH, LOMLOE, IB).
level	string	No	Educational grade or academic level range.
subject	string	No	Academic subject or topic area.
version	string	No	Semantic version tag of the exercise specification.
description	string	No	Pedagogical purpose and problem context of this assessment instrument.

Specification Body (spec)

Field	Type	Required	Description
exerciseType	string	No	Interaction format code linking to an ExerciseType (e.g. free_text, split_pane).
evaluationMode	string	No	Grading execution mode (e.g. DETERMINISTIC, RUBRIC_AI, HYBRID).
immediateFeedback	boolean	No	Whether formative feedback is presented immediately upon student completion.
timeLimitMinutes	integer	No	Suggested time limit allocated for completing the assessment in minutes.
rubricRef	string	No	Canonical reference code to the evaluation rubric (BLOCK_RUBRIC C0/C2).
theme	string	No	Syllabus curricular theme or core topic area (e.g. Familias y Comunidades).
prompt	object	No	Stimulus text, instructions, and source materials presented to the student.
items	object[]	No	Sub-questions or item components for multi-part examination prompts.

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

apiVersion: colabedu.ai/v1beta1
kind: ExerciseSpec
metadata:
  type: external_assessment
  organization: ACTFL/Avant
  year: 2024
  id: us.tx.c2.aappl.lote.presentational.spanish3.v1
  title: "AAPPL Mock - LOTE Presentational Speaking (Spanish III)"
  targetCourseRef: us.tx.c0.teks.lote.spanish_3.v1
spec:
  context: |
    # Presentation on Customs

    Your teacher wants you to talk about an important tradition celebrated in
    Texas or in a Spanish-speaking country (such as Cinco de Mayo or the Rodeo).
  exercises:
    - id: q1
      type: audio_response
      prompt: "Record a 1-minute presentation describing the celebration, why it is important, and what activities are performed."
      expectedOutputFormat: audio
      maxScore: 4.0
      targetCompetencies:
        - lote-presentational

The ExerciseSpec resource (Exercise Specification) defines the pedagogical structure of an assessment instrument (C1/C2). It combines a context (a text, problem, or general stimulus) with a set of specific exercises, linking each question to the competencies or learning objectives it evaluates.