Directive
Directive
● ACTIVE
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 OPS Layer 3 (C3) Directive resource defines immutable behavioral rules or “hard” conditions for the AI evaluation engine.
Unlike rubrics (which define qualitative levels of competence), directives impose systematic quantitative penalties or global rules (e.g., deductions for spelling errors) that the LLM must inexorably execute during the correction process.