# Phase 3: Learner Memory - Context

**Gathered:** 2026-04-26
**Status:** Ready for planning
**Source:** GSD continuation after Phase 2 completion

<domain>
## Phase Boundary

Phase 3 converts graded answer evidence into structured learner memory. It
should build the memory boundary needed by later progression work while keeping
storage in-memory for now.

</domain>

<decisions>
## Implementation Decisions

### Persistence

- Use in-memory learner memory storage in Phase 3.
- Do not introduce a database until the product loop needs durability across
  restarts.
- Preserve a clear store interface so persistent storage can replace it later.

### Memory Model

- Store learner profile.
- Store concept mastery with evidence.
- Store misconception records linked to answer evidence.
- Store intervention history and review schedule placeholders.
- Do not promote temporary session context unless workflow output includes
  evidence.

### Integration

- Diagnostic answer submission should invoke memory extraction after typed
  grading.
- The workflow runner should emit `MemoryUpdateCandidate` values.
- Memory service should apply only updates with evidence.

</decisions>

<canonical_refs>
## Canonical References

- `docs/planning/PRD.md` - learner memory product goals.
- `docs/planning/ARCHITECTURE.md` - memory strategy.
- `docs/planning/WORKFLOW_CONTRACTS.md` - memory update contract.
- `.planning/REQUIREMENTS.md` - MEM-01 through MEM-05.
- `.planning/ROADMAP.md` - Phase 3 success criteria.
- `openspec/changes/bootstrap-job-tutor-platform/specs/learner-memory/spec.md`
  - learner memory requirements.

</canonical_refs>

<specifics>
## Specific Ideas

- Add `internal/learnermemory`.
- Add `GET /api/v1/learners/{userID}/memory`.
- Wire diagnostic answer submission to memory ingestion.
- Keep memory extraction deterministic in the workflow stub.

</specifics>

<deferred>
## Deferred Ideas

- Database persistence.
- Cross-session ranking/decay.
- UI readiness map.
- Spaced repetition scheduling details.

</deferred>

---
*Phase: 003-learner-memory*
*Context gathered: 2026-04-26*