CurriculumMD

The reference format of the LearnSpec suite.

CurriculumMD describes what a content corpus must cover — a school syllabus, a professional certification framework, an internal training plan — without being pedagogical content itself.

It is the first meta format in the suite: it contains no lessons, quizzes or flashcards, only the reference learning objectives against which a LearnSpec corpus can be assessed. Alignment between a curriculum and a corpus is performed by the AI or the player — never by the spec itself.

CurriculumMD is a pure leaf format: it imports and references no other LearnSpec format. It is always the endpoint of a !ref, never the emitter.

Key principles

Principle	Description
Markdown-first	A .curriculum.md file is valid Markdown readable in any editor
File-native	The whole framework lives in a single file — no database required
Graceful degradation	Headings + lists — readable everywhere like an official syllabus
AI-native	Designed to be consumed by an LLM during alignment checks
Reference, not content	CurriculumMD describes what must be learned — not how to teach it

CurriculumMD inherits its frontmatter and validation rules from the shared Architecture Charter.

Format levels

Level	Mechanism	Purpose
0	Headings + objective lists	Minimal syllabus readable everywhere
1	YAML frontmatter	Institutional metadata, version, country, level
2	Inline per-objective attributes	Identifiers, Bloom level, weighting, mandatory flag

Quick example

# General Baccalaureate — Mathematics (Final Year)

## Domain 1 — Analysis

### 1.1 Numerical sequences

- Define a sequence by recurrence or by its general term
- Prove the convergence or divergence of a sequence
- Reason by induction

Status

CurriculumMD is a draft v0.1.

Next steps

• Read the full Specification.