Recipe

Recipe ● ACTIVE

Contract: v0.9.4 • View Schema ↗

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

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

Metadata Properties (metadata)

Field	Type	Required	Description
id	string	Yes	Canonical unique identifier for the recipe (e.g. global.c1.ib.paper2.recipe.v1).
reference_code	string	Yes	Standardized reference code identifying the recipe in the grading compiler.
referenceCode	string	Yes	CamelCase alias for reference_code supported for backward compatibility.
name	string	No	Human-readable name or title of the evaluation recipe.
title	string	No	Descriptive title of the recipe.
version	string	No	Semantic version tag of the recipe.

Specification Body (spec)

Field	Type	Required	Description
exerciseTypeRef	string	No	Reference code to the required interaction format (ExerciseType C1).
rubricRef	string	No	Reference code to the grading rubric (BLOCK_RUBRIC C0/C2).
evaluatorPersonaRef	string	No	Reference to the AI didactic persona or tone profile (Persona C3).
writtenTemplate	string	No	Prompt template used for written student work assessment.
oralTemplate	string	No	Prompt template used for audio/oral student work evaluation.
pedagogicalConfig	object	No	Fine-grained behavioral parameters (e.g. spelling tolerance, CEFR boundary strictness).

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

apiVersion: colabedu.ai/v1beta1
kind: Recipe
metadata:
  id: global.c1.ib.spanish_a.literature.hl.2026.v1.v1.cf8880
  title: "Recipe for IB 2026 - Spanish A Literature HL - Assessment Outline"
  version: "1.0.0"
workflow_parameters:
  scoring: true
  report_format: PDF
pedagogical_assembly:
  rubric:
    layers:
      - level: C0
        block_id: global.c0.ap.spanish_literature.essay.text_comparison.v1.v1.6a4ae1
        status: ACTIVE
spec:
  assembly:
    param_refs:
      - global.exercise_type.free_text.v1
    rubric_refs:
      - global.c0.ap.spanish_literature.essay.text_comparison.v1.v1.6a4ae1
    directive_refs: []

The Recipe resource functions as a linker or pedagogical “assembly recipe”. It links workflow engine configurations (such as whether a score should be calculated or a report issued) with Layer 0 pedagogical components (rubrics and objectives) and exercise types.

A Recipe tells the system what elements to combine to generate or evaluate an exam.