learning-memory

Purpose

Maintain a structured learner profile across sessions so agents start at the right depth, avoid re-teaching covered material, and prioritize known weak areas.

Activation

• New session begins and prior context may exist. Learner references prior sessions or covered topics. Session ends and state should be preserved. Agent needs to personalize without re-asking onboarding questions.
• Skip if: one-off session with no continuity desired, no persistent storage available, or narrow stateless task.
• Routing: run at session start (restore) and end (save). Feed weak areas to weak-area-tracker. Profile drives find-your-level for returning learners with uncertain level.

Inputs

• Prior session summary/profile, current session transcript, concepts + outcomes, learner self-reports, error patterns from assessment skills.

Profile Schema (compact)

learner_profile:
  level: beginner | intermediate | advanced
  stated_goal: "<goal>"
  learning_style: code-first | concept-first | mixed
  weak_areas: [{topic, type, last_seen, correction_attempted}]
  covered_topics: [{topic, confidence: low|medium|high, last_confirmed}]
  active_checkpoint: "<last concept/milestone in progress>"
  session_count: N
  last_session: "<ISO date>"

Workflow

Session Start (Restore)

1. Retrieve — Check for prior profile. If exists: summarize and confirm accuracy with learner. If none: run find-your-level.
2. Staleness Check — Last session 2+ weeks ago → flag for light review. Goal changed → update target.
3. Inject — Feed relevant profile data (level, weak areas, last checkpoint) into current session. Don't re-explain confirmed material unless requested.

Session End (Save)

1. Extract — Record: concepts covered, understanding outcomes, new weak areas, self-reported confidence.
2. Update — Merge into profile. Promote "in-progress" → "covered" when confirmed. Add new weak areas.
3. Handoff — Output compact summary: where to resume, what to skip, top 1–2 priorities for next session.