Skip to content

Content Integration: Architectural Framework

Generated artifact. Do not edit manually.

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

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

Compendium: §1 General Goal System · §2 Node Types · §3 View Projection · §4 Source & Resource Links · §5 Content Integration · §6 Source Rationales · §7 Goal Visualizations · §8 Learning-Goal Book · §9 Gymnasium Rollout · §10 MEM/FWU Plan · §11 Dual Package Releases

5. Content Integration: Architectural Framework

This chapter establishes the binding v1.1 architectural framework (Product Owner decision of 21 September 2026, GitHub Issue #50; PoC details in Physik-Libre PoC, PoC Operations, and Issue #54 Content Packages).

5.1. Three-Layer Separation and Personal Selection

Canonical Skill Graph (provider-neutral goalIds)
        ^
        |  referenced from outside via content/ packages
Optional Content-Link Packages (textbooks, simulations, tasks)
        ^
        |  activated per learner via ordinary SkillPilot ID
Personal Material Selection (Cockpit & Coach, default opt-in/off)

Core architectural invariants:

  • Provider-neutral canonical core: Canonical landscapes never hardcode or privilege external textbook, video, or publisher URLs; content packages under content/ point inward to stable canonical goalIds.
  • Ordinary SkillPilot-ID personalization: Learners select or deselect optional content packages directly in their ordinary Cockpit profile without special activation keys, teacher accounts, or third-party logins.
  • Operational kill-switch & privacy: Every external content package can be disabled centrally via an operational kill-switch without touching canonical landscapes or learner mastery. Outbound links remain plain, parameter-free URLs without SkillPilot IDs or tracking tokens; SkillPilot relicenses no third-party content.

5.2. Physics Pilot and Four Acceptance Criteria

The initial reference pilot binds open-licensed physics textbook sections (https://physikbuch.schule/) after Physics M7 stabilization and expands to Mathematics and LEIFIphysik under Issue #54. Every content-package integration is judged against four binding acceptance criteria:

| Criterion | Required Proof | | –- | –- | | 1. Unchanged core | Disabling or removing all content/ packages leaves canonical graphs, views, frontier logic, and mastery 100% intact. | | 2. Personal selection | Learners control package visibility through their ordinary SkillPilot profile without special keys or accounts. | | 3. Concrete utility | Active links resolve to goal-specific reading or practice sections and appear cleanly in Cockpit and Coach contexts without fabricated page summaries. | | 4. General viability | Adding a second provider or subject requires only a declarative content/ package and validation pass, zero core schema changes. | {cols="26%,74%"}