docs(worksheets): add constrained 2D difficulty system specification

Browse Source

Add comprehensive technical specification for the smart difficulty system:

**Status**: ✅ Phases 1-3 implemented, Phase 4 (testing) in progress

**Key Documentation:**
- Hybrid discrete/continuous architecture explained
- Pedagogical constraint band with theoretical foundation
- Movement modes (both/challenge/support) with algorithms
- DEBUG features (clickable graph, live preview)
- Implementation phases and testing strategy
- Research implications (publishable contributions)

**Spec Updated to Match Reality:**
- Documents actual index-based navigation (not score-based)
- Explains constraint enforcement at multiple points
- Clarifies clickable graph as debugging/verification tool
- Distinguishes primary features from DEBUG tools

**Theoretical Contributions:**
- Zone of Proximal Development (Vygotsky)
- Cognitive Load Theory (Sweller)
- Scaffolding Fading (Wood, Bruner, Ross)
- Novel constrained 2D pedagogical manifold

Potential publication venues: ACM Learning @ Scale, IJAIED, LAK Conference

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

...

This commit is contained in:

Thomas Hallock 2025-11-07 06:25:41 -06:00

parent d72009776a

commit 7d72865d4d

1 changed files with 2207 additions and 0 deletions

Show all changes Ignore whitespace when comparing lines Ignore changes in amount of whitespace Ignore changes in whitespace at EOL

Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2207

apps/web/src/app/create/worksheets/addition/SMART_DIFFICULTY_SPEC.md Normal file

View File

File diff suppressed because it is too large Load Diff