docs: bootstrap tutor planning

This commit is contained in:
user
2026-04-26 15:35:26 +09:00
commit 9edaddd092
25 changed files with 2205 additions and 0 deletions

View File

@@ -0,0 +1,33 @@
# learner-memory Specification
## ADDED Requirements
### Requirement: Durable learner memory is structured and evidence-backed
The system SHALL store durable learner memory as structured learning state
rather than an untyped RAG transcript.
#### Scenario: answer grading updates concept mastery
- **GIVEN** a user answers a technical interview question
- **WHEN** the answer is graded
- **THEN** the system may update concept mastery
- **AND** the update includes the original answer or grading evidence.
#### Scenario: repeated mistakes become misconceptions
- **GIVEN** the same reasoning error appears across multiple answers
- **WHEN** the memory extraction workflow runs
- **THEN** the system records or strengthens a misconception entry
- **AND** links it to the supporting answers.
### Requirement: Temporary context does not become durable truth automatically
The system SHALL separate session context from durable learner memory.
#### Scenario: inferred memory requires evidence
- **GIVEN** a tutor infers that a learner may misunderstand a concept
- **WHEN** the inference lacks enough evidence
- **THEN** the system records it as tentative or ignores it
- **AND** does not promote it to durable mastery state as confirmed truth.