# learning-ontology Specification

## ADDED Requirements

### Requirement: Uploaded materials produce a source-backed ontology

The system SHALL analyze uploaded learning materials into concepts,
prerequisites, examples, questions, rubrics, and source evidence.

#### Scenario: material ingestion creates ontology candidates

- **GIVEN** an operator uploads learning materials
- **WHEN** the ingestion workflow completes
- **THEN** the system creates ontology candidate nodes and edges
- **AND** links each supported candidate to source evidence.

#### Scenario: gaps are identified separately from verified content

- **GIVEN** the ontology builder detects a missing prerequisite or weakly
  supported concept
- **WHEN** it proposes missing content
- **THEN** the proposed content is marked as generated or inferred
- **AND** it is not treated as canonical until reviewed or validated.

### Requirement: Generated study assets keep lineage

The system SHALL preserve provenance for generated learning materials.

#### Scenario: visual teaching asset is generated

- **GIVEN** a concept needs a diagram or slide-like explanation
- **WHEN** the asset generation workflow runs
- **THEN** the generated asset stores its prompt, model configuration, source
  concept, source evidence, and review state.