Superadmin · Content · Canonical sequencing

Learning Pathways

Design multilingual learning routes that sequence lessons, assignments, standardized exams, practice, projects, remediation, and mastery rules.

← Back to Content Command Center + New Pathway Draft ⬆ Import Source Document { } View JSON Schema Publishing Queue

🛤️ Canonical sequencing layer Planned · No runtime yet

Learning Pathways are the canonical sequencing layer above Lessons, Assignments, Standardized Exams, practice, projects, documents, and remediation. They support online learning, exam preparation, skill mastery, tutor-guided flows, and self-paced learning.

This Control Center establishes the product architecture honestly. It does not write to Firestore or upload files. Use it to align the canonical model and review the planned authoring surfaces before enabling writes, publishing, and downstream assignment.

🌐Multilingual pathways

Planned · Architecture

Pathways carry a primary language_code plus an available_languages list. Translations are versioned alongside the canonical sequence.

📚Multi-subject pathways

Planned · Architecture

A single pathway may span more than one canonical subject — useful for STEM, humanities, and interdisciplinary projects.

🎯Grade / course aligned

Planned · Architecture

Targeting via grade_refs and course_refs. A pathway can be reused across grades by carrying multiple references.

🎓Exam prep

Planned · Architecture

Pathways with a target_exam_ref sequence skill drills, practice sets, and full standardized-exam dry runs ahead of the test date.

🛟Remediation

Planned · Architecture

Branch nodes activate when checkpoints fail; re-teach lessons, scaffolded practice, and re-checks fold back into the main sequence.

🏗️Project-based learning

Planned · Architecture

Project nodes carry milestones, rubrics, and tutor checkpoints — supporting CV-style or syllabus-driven projects.

🛠️ Builder preview UI skeleton · No writes

A non-functional preview of the planned authoring surfaces. All inputs are disabled — this page does not submit forms or persist data.

📑 Pathway metadata

Identity and routing fields written to LearningPathways/{pathway_id}.

Title

Pathway type

Status

🌐 Language & translation

Primary language plus the available translation set. Publishing will require a translation review per language.

Primary language

Available languages

en es + add

Translation status

🎯 Grade · subject · course

Canonical taxonomy references — never raw strings. Multi-select supported.

Subject refs

subjects/mathematics

Grade refs

grades/g8grades/g9

Course refs

courses/algebra-1

Target exam refs

— none —

🧩 Nodes

Ordered sequence of canonical references. See the Node Type Library below.

📘

Lesson · Intro to linear equations

Lessons/<id> · order 1

Lesson

✏️

Exercise Set · Solve 1-step equations

ExerciseSets/<id> · order 2

Exercise

✅

Checkpoint · score ≥ 0.8

mastery_rule · branch_on_failure

Checkpoint

🎚️ Mastery rules

Govern advancement: completion, score thresholds, and branch-on-failure routing.

Completion threshold

Score threshold

Branch on failure

🛟 Remediation branches

When a checkpoint fails, the pathway can route into a remediation sub-sequence before resuming.

🔁

Re-teach lesson · linear equations basics

activated when checkpoint score < 0.75

Branch

✏️

Scaffolded practice · 5 items

re-check returns to main sequence

Practice

🚀 Publishing readiness

Validation checklist before the pathway can move to the Publishing Queue.

Title and pathway_type set

At least one canonical taxonomy reference

All nodes resolve to existing canonical content

Translations reviewed for every available language

Mastery rules valid (thresholds in [0,1])

AI-generated drafts marked human-reviewed

🧩 Node type library

Every node in nodes[] references canonical content already governed elsewhere. Pathways do not own content — they orchestrate it.

📘Lesson

Connects to a canonical Lesson from the Lessons module.

📝Assignment

Connects to an Assignment template; fans out via Tetrahedron later.

✏️Exercise Set

Connects to a skill-tagged exercise bank for targeted practice.

🎓Standardized Exam

Connects to a canonical exam definition for prep or dry-run use.

🏗️Project

Connects to a canonical project template with rubric and milestones.

📄Uploaded Document

Connects to an Imports/Repository document — CV, syllabus, reading, or brief.

🤖AI Generated Task

Drafts an exercise or activity via AI; flagged for human review before publishing.

💬Reflection

Short metacognitive prompt or self-report between content blocks.

🛟Remediation Activity

Branch node activated when a checkpoint or mastery rule fails.

🤝Tutor Checkpoint

Scheduled tutor checkpoint — surfaces to partner tutors via Octahedron.

{ } Canonical JSON schema preview Schema preview · Not live data

The shape SuperAdmin will author and publish. Read-only on this page — no copy or validate calls fire.

{
  "pathway_id": "lp_<uuid>",
  "title": "Linear Equations · Grade 8 → Algebra I",
  "pathway_type": "course_sequence",
  "language_code": "en",
  "available_languages": ["en", "es"],
  "country_code": "US",
  "grade_refs": ["grades/g8", "grades/g9"],
  "subject_refs": ["subjects/mathematics"],
  "course_refs": ["courses/algebra-1"],
  "target_exam_refs": [],
  "nodes": [
    { "type": "lesson",        "ref": "Lessons/<id>",        "order": 1 },
    { "type": "exercise_set",  "ref": "ExerciseSets/<id>",   "order": 2 },
    { "type": "checkpoint",    "rule": "score >= 0.8",             "order": 3 },
    { "type": "assignment",    "ref": "Assignments/<id>",      "order": 4 },
    { "type": "project",       "ref": "Projects/<id>",         "order": 5 }
  ],
  "mastery_rules": {
    "completion_threshold": 0.9,
    "score_threshold": 0.75,
    "branch_on_failure": "remediation_node"
  },
  "ai_generation_policy": {
    "enabled": false,
    "human_review_required": true,
    "allowed_node_types": ["exercise_set", "project", "reflection", "ai_generated_task"]
  },
  "status": "draft",
  "visible": { "schools": [], "partners": [], "tutors": [] }
}

🤖 AI & Import Studio Planned · No backend

Planned authoring assists for pathway construction. Every output here is a draft — no node, exercise, or document is published without explicit human review.

Planned

🧭Generate pathway outline with AI

Propose a sequence of nodes from a topic, target exam, or subject — for teacher and admin review.

Planned

✏️Generate exercises

Draft exercise sets at chosen difficulty bands; tagged to skills and standards for downstream review.

Planned

🏗️Generate project tasks

Draft project milestones, rubrics, and reflection prompts from a learning objective.

Planned

⬆Upload CV / syllabus / reading / project brief

Stage source documents into Imports for parsing. Storage and upload APIs are not wired yet.

Planned

🔍Extract tasks from uploaded source

Parse CVs, syllabi, readings, or briefs into draft pathway nodes.

Planned

📝Create draft nodes for review

Stage AI- and import-derived nodes as drafts so canonical authors can review, edit, and approve.

⚠️ AI and document import create drafts only. Human review is required before publishing.

📊 Spreadsheet import format Reference · No upload wired

Admins can stage source documents through a CSV/Excel template before upload and parsing are enabled. Export Excel files as CSV UTF-8 comma-delimited. Use commas for columns and use | inside a cell for multi-value fields.

CSV UTF-8 · comma-delimited Header row + one row per source document

doc_alg1_syllabus_2026,Algebra I Syllabus 2026,syllabus,en,US,NY,Grade 8|Grade 9,Mathematics,Algebra I,lp_algebra1_readiness,,create_pathway_node,,,imports/algebra1/syllabus_2026.pdf,Math Department,School,school_owned,not_started,TRUE,TRUE,staged,Use to generate course sequence nodes

Use | for multi-value cells.
document_type can be cv, syllabus, reading, project_brief, rubric, worksheet, essay, external_curriculum, answer_key, exam_pdf.
intended_use can be generate_assignment, generate_project, generate_exercises, map_standards, create_pathway_node, reference_only.
AI-generated outputs are drafts only and require human review.
License / source status must be reviewed before publishing.

No learning pathways are connected yet. This page defines the architecture before enabling writes, publishing, and downstream assignment. The runtime, builder, fanout layer, AI assists, and import APIs are intentionally not wired.

🔁 Downstream flow

How a published pathway moves across Kairos surfaces.

1SuperAdminCreates and publishes the pathway after validation in the Publishing Queue.

2TetrahedronAssigns or recommends the pathway to a course, group, or individual student.

3CubeStudent progresses through pathway nodes — lessons, practice, checkpoints, exams, projects.

4RuntimeProgress signals from AssignedAssignments and StandardizedExams update pathway state.

5OctahedronSurfaces readiness, mastery, and intervention signals for partner tutors and stakeholders.

Technical context

Planned collection

LearningPathways

Planned versions

LearningPathwayVersions

Planned nodes

LearningPathways/{pathway_id}/nodes

Depends on

Lessons · masterAssignments · StandardizedExams · Assignments · AssignedAssignments · StudentCourseProgress

Runtime status

planned

Writes on this page

none

Authoring builder

planned

AI / Import APIs

planned (no backend wired)

Fanout / assignment

planned (handled by Tetrahedron later)