Adaptr

Documentation

Everything you need to upload content, validate concept graphs, and run diagnostics with full teacher control.

Overview

Adaptr.ia helps teachers turn teaching documents into competency maps, track student mastery, and communicate with parents — always with the teacher in control of what gets activated, evaluated, or sent.

AI proposes. The teacher decides. Nothing is ever activated, sent, or made visible to a student or parent without an explicit, separate human validation action.
Quick start
StepAction
1Create a class — a join code is generated on the class page.
2Add students manually or import a roster. Each student receives a personal PIN.
3Upload a PDF or write content directly in the app.
4Wait for AI processing. Confirm document sections if prompted (multi-lesson PDFs).
5Review the proposed concept graph, correct links, then activate the learning path.
Teacher workflow

How a teacher moves from first login to an active class — and where diagnostics, quizzes, and the tutor queue fit after activation.

End-to-end overview

Entry

Login / Sign up
Dashboard — My classes

Class setup (once per class)

Create class (join code issued)
Add students or import roster
Share join code + personal PINs → students use /join

Core Adaptr flow (document → graph)

Add document (PDF or in-app text)
Processing — AI extracts concepts and links
Optional: confirm document sections (multi-lesson PDFs only)
Review graph — accept, reject, or edit links
Optional: simulate path before activating
Activate learning path

Teaching & follow-up (after activation)

Launch diagnostic (live in class)
Assign formal quiz
Grading inbox (open-ended responses)
Tutor queue (moderated Q&A)
Parent reports per student (draft → you approve → send)

Also available (parallel)

Shared graphs from colleagues
School / institution settings
Billing & referral

Recommended 15-minute pilot path

Step 1

Create class

Join code appears on the class page

Step 2

Add 2–3 students

Each gets a personal PIN for /join

Step 3

Add document

PDF or written content → processing screen

Step 4

Review → Activate

Section split if needed, then graph review

Step 5

Launch diagnostic

Requires an activated path; live results in class

Recommended first session for a pilot teacher — about 15 minutes end to end, plus processing time for the document.

Three tools after activation

Each tool has a different purpose — they are not interchangeable.

Diagnostic

Launch → students answer on /student → you watch live results

Quick in-class check

Formal quiz

Assign → student session → grading inbox for open answers

Assessment + correction

AI Tutor

Student asks on /student → tutor queue → you approve the reply

Moderated Q&A

Class page — recommended order

Recommended sequence for a new class — what to do first, even though the app does not force this order.

  1. 1
    Add students or import roster

    PINs are generated here

  2. 2
    Add document → processing → review → activate

    Core Adaptr setup

  3. 3
    Check learning path

    Confirm entry concepts look right

  4. 4
    Launch diagnostic or assign a quiz

    Only after the path is active

  5. 5
    Share join code + PINs with students

    They sign in at /join

  6. 6
    Monitor tutor queue & grading inbox

    Ongoing during the term

The dashboard setup checklist mirrors this order and auto-completes steps as you work. Most steps live on the Students or Teach tabs on the class page.

Class page — tabs

The class page at /dashboard/classes/[id] uses four tabs in the header. The class name and subject stay visible above the tab bar; deep links such as graph review and live diagnostics open on their own pages.

  1. 1
    Overview (?tab=overview — default)

    Setup checklist, status banners, at-a-glance counts, quick links to tutor queue / grading / Teach tab

  2. 2
    Students (?tab=students)

    Join code card, add student, roster import, student list with PINs and preview links

  3. 3
    Teach (?tab=teach)

    Documents (first), learning path & simulation, AI tutor queue, quizzes & diagnostics

  4. 4
    Settings (?tab=settings)

    Class metadata, student ID cards, delete class

On Teach, documents are listed first — closer to the recommended setup order than the old single-page scroll layout.

Glossary
Concept
A specific skill or knowledge item a student must master.
Strict prerequisite
A concept that must be mastered before another can be unlocked.
Supporting tool
A related concept that helps learning but does not block progress.
One-minute diagnostic
A short in-class quiz (3–5 questions) with live teacher results.
Mastery
A score of 0.85 or higher on a concept, indicating solid understanding.
Learning path
The validated graph of concepts and prerequisites you activate for a class.
Task guides

Importing a roster

  1. Download the official template from your class import page.
  2. Fill in first name, last name, and optional school student ID.
  3. Upload the file and review any conflicts before confirming.

Validating a graph

  1. Review proposed concepts and prerequisite links on the graph view.
  2. Accept, reject, or adjust uncertain links using the review tools.
  3. Add any missing foundational concepts manually before activating.

Sending a parent report

  1. Add parent contact information for the student.
  2. Generate a draft report and edit any activity suggestions.
  3. Approve the report, then send it explicitly to parent email addresses.
Trust & transparency
QuestionAnswer
Does AI activate content automatically?No. You must explicitly validate and activate every learning path.
Can students see proposed graphs before activation?No. Students only see paths you have activated.
Are parent reports sent automatically?No. You approve the draft first, then send it in a separate step.
Can I see how a score was calculated?Yes. Mastery and success estimates always show their underlying data.
For institutions
  • Privacy compliance documentation available for district review.
  • School student IDs supported for roster matching — never auto-invented.
  • Teachers sign in with email/password or Google.
  • Student data export available on request for authorized administrators.
FAQ
Do students need accounts?
No. Students go to /join, enter the class join code and their personal PIN (from you). No password or email required.
Do parents get logins?
No. Parents receive approved PDF reports by email only.
What file types can I upload?
PDF uploads and in-app written content are supported for concept extraction.
What does mastery mean?
A mastery score of 0.85 or higher indicates a concept is mastered.
Status glossary
pending
Waiting for processing or teacher action.
needs_split_review
The document may contain multiple lessons — confirm sections before review.
validated
The teacher has approved and activated the learning path.
pending_review
Imported roster rows or proposed links awaiting teacher review.
sent
A parent report has been emailed after explicit approval.