Skip to content

Levels of Personalization

Generated artifact. Do not edit manually.

Generated by: scripts/build_compendia.py Regenerate with: python3 scripts/build_compendia.py --compendium runtime-workflows --web-and-tex Source of truth: docs/concept/runtime-workflows/source/

Language / Sprache: English (EN) · Deutsch (DE) | PDF: English PDF · Deutsches PDF

Compendium: §1 Personalization · §2 Learning Workflow · §3 SRS Sync · §4 Import/Export · §5 Portable Host · §6 Coach Contract · §7 Coach Topology · §8 OAuth & Session · §9 Coach Behavior · §10 Plugin Lifecycle

1. Levels of Personalization

This chapter specifies how SkillPilot narrows from the published curriculum catalog down to individual atomic mastery. Catalog navigation precedes the four personalization levels and is never persisted as learner scope.

These four levels remain distinct from Learning Units (Lerneinheiten, LearningUnit) — recursively composed didactic units with intended outcomes and derived completion whose placement belongs to the resolved educational context rather than forming a fifth personalization level.

1.1. Before Level 1: catalog navigation

Learners first choose a catalog area such as school, university and higher education, or languages and continuing education to locate an appropriate root curriculum. This step aids discovery only and stores nothing on the learner record.

1.2. Level 1: Base Curriculum

The learner selects one published root curriculum providing the complete goal universe from which subsequent levels narrow without copying or altering canonical goals (for example Gymnasium (DE), a university degree catalog, or a CEFR language skill landscape).

Only root curricula explicitly listed in curricula/curriculum_manifest.json are selectable in the UI and eligible for Champion registration:

{
  "curricula": [
    { "id": "a0e13c56-c25f-4742-9272-3a1a603ee52e", "title": "Gymnasium (DE)" }
  ]
}

Every manifest ID must exist under curricula/, must never point to a module or contained sub-landscape, and is verified by CI against the computed root set.

1.3. Level 2: Personal Curriculum

The Personal Curriculum is the learner's committed, durable scope inside the Base Curriculum — defining which authored curriculum view applies rather than temporary study focus. For German school curricula, the semantic selection order is:

  1. Jurisdiction (including an explicit canonical view where available);
  2. Duration model (such as G8 or G9 where relevant);
  3. Stage (lower secondary, upper secondary, or explicitly both);
  4. Selected subjects;
  5. Course profile per selected subject (where applicable).

Course profile is a per-subject attribute: Mathematics LK and Physics GK may coexist, LK never implies upper secondary, and missing stage data never silently defaults to cross-stage scope. Level 2 resolves the applicable composition view and bounds focus, frontier, progress, and completion; changing Level 2 revalidates focus and activeGoal without altering canonical goal IDs or erasing global mastery.

Single first-party editor contract: Level 2 is edited exclusively in SkillPilot's first-party WebGUI (on the start screen before launching a session and in the Cockpit afterward) over shared backend validation, normalization, and save rules. The OpenAI ChatClient neither presents nor mutates Level 2; if configuration is incomplete, it halts domain coaching and refers the learner back to the WebGUI.

1.4. Level 3: Learning Focus and Active Goal

Level 3 is intentionally lightweight and comprises two parts:

  • Level 3a — Focus: one or more scope roots selecting the active learning corridor (such as Grade 7, Q1, or Analysis; structural program units are not themselves canonical goals).
  • Level 3b — Active atomic goal: at most one concrete, assessable atomic goal serving as the immediate working target.

Focus widening follows the learner-facing ancestor path toward the root: the backend publishes valid broader ancestors that add unmastered target goals (nearest suitable ancestor first, preserving independent multi-root corridors in goalIds), and automatic widening is proposed only upon genuine completion of the current focus (never merely because the frontier is blocked), requiring learner confirmation.

Under the 4 November 2026 Assessment-Gated Completion clarification, requires alone never writes mastery to prerequisites; valid passed application assessments derive globally effective recognition of ordinary goals, so widening focus never reopens recognized competences.

1.5. Level 4: Mastery and the orthogonal timeline axis

Mastery is the learner's single durable outcome per stable atomic goal UUID — mastered or not mastered — remaining global across composition views and Level 2/3 changes without partial-mastery states. Effective mastery \(M_{\mathrm{eff}} = M \cup W\) combines stored explicit mastery \(M\) with assessment-gated recognition \(W\) (while assessment and memorization goals stay explicit; runtime migration remains pending, see 2.4). Cluster and scope percentages express the weighted share of effectively mastered atomic goals, never partial mastery of one goal.

Orthogonal curriculum timeline: A dated course or exam schedule is an execution-plan overlay answering when targets inside Level 2 should be addressed (see Unified Learning-Plan Status and Curriculum Time Axis and Pacing), not a fifth personalization level.