Skip to content

Human-Readable Source Rationales

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

6. Human-Readable Source Rationales

Every canonical learning goal in a SkillPilot skill landscape should be explainable back to official curricular evidence without requiring teachers or reviewers to inspect raw JSON ledgers or SPARQL outputs (operational commands live in Source Rationales Runbook).

6.1. Deterministic Explainability Envelope and Dual Evidence Routes

generateGoalSourceRationales.ts compiles a deterministic schemaVersion: 1 JSON envelope per goal combining two complementary evidence routes:

  • Status classification (sourceRationaleStatus): classic_source_reviewed (backed by reviewed official source extraction and mapping), partial (incomplete or broader topic-level coverage), or gap (missing source proof, surfaced honestly under limitations).
  • Classic source route (classicSourceRoute): Binds reviewed source-to-canonical mappings (exact or partial), official syllabus documents, section breadcrumbs, and short statutory locator excerpts.
  • MEM SPARQL route (memSparqlRoute): Cross-references external Metadata for Educational Media (MEM) / FWU ontology alignments (MEM SPARQL Audit) where available.

Candidate source records are ranked deterministically:

  1. exact mappings precede partial mappings;
  2. active/current state syllabi precede retired legacy snapshots;
  3. sources matching the learner's selected jurisdiction precede nationwide or cross-state backup evidence.

In standalone curriculum package mode (11), the runtime serves generation-bound evidence via Catalog 1.2 discovery rather than hardcoded repository paths, failing closed without falling back to stale static files. Official syllabus quotes remain strictly bounded short citation locators (never full-document reproductions) to respect statutory/publisher copyright boundaries.