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,63 @@
# learning-progression Specification
## ADDED Requirements
### Requirement: Learning progression is evidence-backed and game-inspired
The system SHALL use game-inspired progression loops to make study sessions
rewarding while tying progress to learning evidence.
#### Scenario: session loop ends with visible progress
- **GIVEN** a user completes an interview-practice loop
- **WHEN** the system grades the answer and extracts memory
- **THEN** the user sees what improved, what remains weak, and the next
recommended challenge
- **AND** any progress shown is linked to grading or memory evidence.
#### Scenario: adaptive challenge stays near learner ability
- **GIVEN** the learner repeatedly fails a concept at the current difficulty
- **WHEN** the next challenge is selected
- **THEN** the system lowers difficulty, changes explanation strategy, or inserts
a recovery question
- **AND** does not simply continue escalating difficulty.
### Requirement: Progression surfaces support interview readiness
The system SHALL expose progression surfaces that help job seekers understand
interview readiness.
#### Scenario: readiness map summarizes concept state
- **GIVEN** the learner has completed diagnostic or practice sessions
- **WHEN** the readiness map is displayed
- **THEN** each concept has a readiness state
- **AND** the state can be traced to answer evidence, misconception evidence, or
review completion.
#### Scenario: boss question unlocks after prerequisite stability
- **GIVEN** a cluster of prerequisite concepts is stable enough
- **WHEN** the user reaches the next milestone
- **THEN** the system may unlock an integrated boss-style interview question
- **AND** the question combines multiple concepts under realistic constraints.
### Requirement: Engagement mechanics avoid exploitative patterns
The system SHALL avoid engagement mechanics that encourage unhealthy compulsion
or shame.
#### Scenario: streaks do not punish missed days
- **GIVEN** a user misses a scheduled practice day
- **WHEN** the user returns
- **THEN** the system helps the user resume with a recovery plan
- **AND** does not erase durable learning progress.
#### Scenario: rewards are connected to learning value
- **GIVEN** the system awards progress, badges, unlocks, or generated assets
- **WHEN** the reward is shown
- **THEN** it reflects mastery, effort, review completion, or interview readiness
- **AND** is not primarily a gambling-like random reward.