Transforming curriculum documents into source-grounded knowledge graphs
This project provides a configurable pipeline for transforming curriculum PDFs into structured, provenance-preserving knowledge graph artifacts aligned to the Learning Commons ontology.
The pipeline separates source reconstruction from curriculum-semantic interpretation so that each stage can be inspected, validated, and audited independently.
Pipeline at a glance
flowchart LR
A[Curriculum PDF] --> B[Page IR Extraction]
B --> C[Page IR Verification]
C --> D[Document IR]
D --> E[Academic Standards]
E --> F[Learning Components]
The five conceptual stages are:
- Page IR Extraction — reconstruct the visible structure of each PDF page.
- Page IR Verification — verify likely cross-page continuations and conservatively update page-boundary metadata.
- Document IR — deterministically stitch verified page structures into a document-level representation while preserving provenance.
- Academic Standards — extract, reconcile, identify, hierarchize, and validate source-grounded standards.
- Learning Components — decompose eligible standards into atomic skills, resolve duplicates, and connect them back to the standards they support.
The current implementation is document- and configuration-driven rather than tied to a single curriculum or country.
Architecture Pipeline documentation
What the documentation covers
- Architecture explains the system boundaries, trust model, provenance strategy, deterministic invariants, and relationship between the major representations.
- Pipeline documents the operational flow from PDF extraction through the final Academic Standards + Learning Components graph.
- Development contains local development and contributor-oriented material.
Note
The production pipeline currently builds hasChild relationships within the
Academic Standards hierarchy and supports relationships from Learning Components
to Standards Framework Items. Other Learning Commons relationship types may exist in
the shared schema but are not constructed by the current pipeline.
Have a use case or feature request?
If you are working with curriculum data in government, education, research, or the
social sector, we'd like to hear about the workflows this system should support.
Raise an issue in the project repository with
[FEATURE REQUEST] in the title.

