Didactopus/docs/ux-notes.md

UX Notes for Human Learners

First-session design

The first session should:

• fit on one screen when possible
• ask for one meaningful action
• generate one visible success marker

Recommended interface pattern

A learner-facing UI should emphasize:

• one main recommendation card
• one secondary reinforcement task
• a small visible mastery map
• a plain-language "why this next?" explanation

Fun / rewarding elements

Good candidates:

• concept unlock animations
• progress rings
• milestone badges
• encouraging plain-language summaries
• capstone readiness meter

Avoid:

• gamification that obscures meaning
• complicated dashboards on first use
• forcing users to interpret opaque confidence math

Human-readable learner state

Always expose:

• what changed
• why it changed
• what is still missing
• what the next sensible step is