Exercise Types Catalog (C1)

Architecture: Open Assessment Standard (OAS v1beta1)
Layer: C1 (Exercise Types / Structural Templates)

In the OAS architecture, an Exercise Type is a subject-blind UI skeleton. It contains no specific questions or curricular laws — it contains the widget logic and base evaluation engine. Content (C2) and the rubric (C0) are injected at runtime.

---

Available Types

referenceCode	Title	Evaluation	Status
core.etype.split_pane_essay.v1	Guided Essay (Split-Pane)	AI Rubric	Active
core.etype.mixed_quiz.v1	Composite Quiz	Deterministic	Active
core.etype.multimodal_mcq.v1	Multimodal MCQ + Chatbot	AI + Deterministic	Active
core.etype.grouping.v1	Grouping (Drag & Drop)	Deterministic	Active
core.etype.matching.v1	Matching	Deterministic	Active
core.etype.ordering.v1	Ordering	Deterministic	Active
core.etype.socratic_tutor.v1	Socratic Tutor	AI Log + transcript	Active
core.etype.socratic_debate.v1	Socratic Debate	AI Log + rubric	Active
core.etype.syntactic_analysis.v1	Interactive Syntactic Analysis	Deterministic	Active
global.exercise_type.mcq.v1	Multiple Choice (MCQ)	Deterministic	Active
global.exercise_type.free_text.v1	Free Text / Essay	AI Rubric	Active
global.exercise_type.guided_activity.v1	Guided Activity with Tutor	AI Log + rubric	Active
global.exercise_type.document_submission.v1	Document Submission	OCR + AI rubric	Active
global.exercise_type.whiteboard.v1	Digital Whiteboard	Gemini Vision (PNG)	New

---

Type Details

core.etype.split_pane_essay.v1 — Guided Essay

The student reads the source text in the left panel (markdown_viewer_widget) and writes their response in the right panel (markdown_editor_widget). Report includes rubric breakdown and spelling diff table.

Use cases: literary commentary, historical essay, scientific summary, primary source analysis.

---

core.etype.mixed_quiz.v1 — Composite Quiz

The ui_components are intentionally empty — the question sequence is defined by the C2 block (AssessmentItem). Freely combine MCQ, fill-in-the-blank, short answer and other widgets in a single adaptive flow.

Use cases: IB Paper 1-style exam, mixed reading comprehension test.

---

core.etype.multimodal_mcq.v1 — Multimodal MCQ

Three simultaneous widgets:

• document_viewer_widget (top panel) — displays the C2 document or instructions
• mcq_form_widget (bottom panel) — MCQ + free text questions mixed
• chatbot_companion_widget (floating) — Socratic companion with proactive hints

Use cases: reading comprehension with chart, historical image analysis, scientific paper reading.

---

core.etype.grouping.v1 — Grouping

Drag-and-drop widget where the student drags elements into categories defined in the C2 block.

Use cases: classify organisms by kingdom, group causes/consequences, sort historical sources by type.

---

core.etype.matching.v1 — Matching

Student matches elements from two columns. Deterministic evaluation with configurable partial credit.

Use cases: vocabulary and definitions, dates and events, formulas and names.

---

core.etype.ordering.v1 — Ordering

Drag-and-drop to order a list of elements by a criterion (chronological, logical, etc.).

Use cases: steps of the scientific method, historical chronology, order of mathematical operations.

---

core.etype.socratic_tutor.v1 — Socratic Tutor

Chat interface (chat_interface_widget in socratic mode). The AI follows a guided questioning script — it does not give direct answers but leads the student to discover them. Report includes conversation transcript and rubric breakdown.

Use cases: IB Individual Oral preparation, philosophical analysis, historical roleplay.

---

core.etype.socratic_debate.v1 — Socratic Debate

Variant of the Socratic tutor in debate mode. The student defends a position and the AI counters with opposing arguments. Includes transcript + evaluative feedback.

Use cases: ethical dilemma debate, thesis defense, AP oral exam preparation.

---

core.etype.syntactic_analysis.v1 — Syntactic Analysis

Specialized widget (syntactic_analysis_widget) that lets the student label syntactic constituents on a sentence. Includes a predefined set of allowed tags:

Subject · Verbal/Nominal Predicate · NP · VP · PP · AdjP · AdvP · Head · Determiner · Direct Object · Indirect Object · Prepositional Complement · Adverbial · Attribute · Predicative Complement · Agentive · Modifier · Nexus

Use cases: Spanish grammar (LOMLOE), EBAU exam preparation, IB grammar exercises.

---

global.exercise_type.mcq.v1 — Multiple Choice (Simple)

Classic MCQ with radio_button_group_widget. Deterministic evaluation. No companion or additional reference document.

Use cases: quick vocabulary test, direct comprehension questions, self-assessment.

---

global.exercise_type.free_text.v1 — Free Text / Essay

Open Markdown editor with no format restrictions. AI evaluates against the injected C0 rubric using free_text_rubric_evaluation.

Use cases: open exam response, personal reflection, free argumentative writing.

---

global.exercise_type.guided_activity.v1 — Guided Activity

Combines: split_screen_layout + document_viewer_widget + chatbot_companion_widget + markdown_editor_widget. The AI tutor guides the student step by step. Report logs tutor interaction and evaluates the final response.

Use cases: AI-assisted research task, staged writing, guided primary source analysis.

---

global.exercise_type.document_submission.v1 — Document Submission

Student uploads a file (file_picker_widget). The system extracts text via OCR and evaluates it with the C0 rubric using free_text_rubric_evaluation.

Use cases: handwritten work submission, portfolio, scanned document.

---

global.exercise_type.whiteboard.v1 — Digital Whiteboard New

The student draws freely on a canvas (whiteboard_widget). On submission, a PNG is captured and sent to Gemini Vision for automatic evaluation against the C0 rubric.

Interaction modes

Mode	Description
standalone	Full-screen canvas. Prompt in side panel or header.
split_pane	Left panel: C2 reference document. Right panel: drawing canvas.
overlay	Transparent whiteboard over an InteractiveLesson slide (ephemeral scratchpad, no AssessmentItem generated).

Widgets

• whiteboard_widget — Free-draw canvas (flutter_painter_v2)
• document_viewer_widget — Prompt / reference figure panel
• toolbar_widget — Color, thickness, undo/redo, clear

Evaluation

• vision_ai_evaluation — Gemini Vision evaluates the PNG against the C0 rubric
• stroke_metadata_log — Stroke log (time, number of corrections)

Default rubric: global.c0.whiteboard.stem.math.v1
Criteria: Completeness · Conceptual correctness · Clarity · Process visibility

Minimal configuration

spec:
  assembly:
    param_refs:
      - global.exercise_type.whiteboard.v1
    rubric_refs:
      - global.c0.whiteboard.stem.math.v1
  evaluation:
    capture_format: png
    evaluator: vision_ai

STEM

Equations, force diagrams, chemical reactions, geometry, functions, electrical circuits.

Other subjects

Concept maps, anatomical diagrams, geographic sketches, basic music notation.

---

The secret of subject-agnostic evaluation

If the UI is the same (e.g. split_pane_essay), how does the AI know it’s grading History and not Language? C0 Rubric injection.

C1 (Type)	C2 (Content)	C0 (Rubric)	Result
split_pane_essay	Poem by Lorca	Meter, Literary Figures	Literary evaluation
split_pane_essay	Constitution 1812	Causes, Consequences, Anachronisms	Historical evaluation
whiteboard	Physics problem	Force diagram, Units, Process	Visual STEM evaluation
syntactic_analysis	LOMLOE sentence	Allowed syntactic tags	Grammar evaluation

Lego Architecture

If ColabEdu launches a product for Medical Schools, not a single new screen needs to be programmed. New texts (C2) and medical rubrics (C0) are added to the catalog.