Skip to content

Learning Session Protocol

Use this protocol whenever Codex teaches, grades, or updates progress for the QEM-QEC learning system.

The goal is to keep learner progress evidence-based. Generated files are not evidence of learner mastery.

Required Reads

Before teaching or grading, read:

  1. learner-progress.md
  2. the active course progress tracker:
  3. session-log.md
  4. alignment-dashboard.md
  5. the relevant lesson, chapter, or rubric

For Conjecture 3 frontier content, also read:

  1. ../index.md
  2. ../research/graph-audit.md

Session Modes

Use exactly one mode per session-log entry.

Mode When to use Primary artifact
diagnostic first contact or lesson-entry checks diagnostic-intake.md and diagnostic-intake-key.md
lesson teaching a specific lesson the lesson file
placement testing out of foundations foundation rubric
assessment testing frontier alignment frontier rubric
research handoff choosing Target A, B, or C after alignment Lesson 10

Grading Rules

  1. Grade only against the relevant rubric or lesson diagnostic.
  2. Quote or paraphrase the learner evidence briefly in the session-log entry.
  3. Distinguish:
    • correct;
    • partially correct;
    • unsupported;
    • wrong;
    • not attempted.
  4. Do not fill missing learner answers from Codex's own explanation.
  5. If the learner answer is ambiguous, ask one follow-up before recording a miss.

Update Rules

After grading, first tell the learner the proposed update. Then update durable files only when the learner confirms or explicitly asks Codex to record it.

When recording a lesson completion:

  1. Append a dated entry to session-log.md.
  2. Update the relevant course progress tracker or frontier progress tracker.
  3. Update learner-progress.md if the next recommended lesson changes.
  4. Update alignment-dashboard.md only when a gate status changes.

When recording a placement or assessment:

  1. Append score and missed items to session-log.md.
  2. Update the assessment record in the relevant course progress tracker.
  3. Update learner-progress.md with the new course state.
  4. Update alignment-dashboard.md gate status.

Gate Rules

Foundation readiness is passed only if:

  • all nine foundation lessons are complete or skipped by diagnostic; or
  • foundation assessment score is at least 16/20, with no 0 on required gate questions.

Frontier alignment is passed only if:

  • the frontier course is unlocked;
  • Lessons 01-09 are complete or skipped by diagnostic;
  • Lesson 10 is complete;
  • frontier assessment score is at least 16/20, with no 0 on questions 1, 3, 5, or 10.

No-Overclaim Rule

Do not mark the active goal complete merely because:

  • lessons exist;
  • chapters exist;
  • rubrics exist;
  • source maps pass validation;
  • Codex can answer the rubric questions.

Completion requires learner evidence recorded in session-log.md, the relevant progress tracker, learner-progress.md, and alignment-dashboard.md.

Current Next Action

The current recorded state has no learner evidence. Ask the learner for diagnostic-intake.md Mode A answers, then grade with diagnostic-intake-key.md.