How donroy26/icm-foundations-tutor works
Foundation Companion offers two learning routes: a hands-on Claude Code tutor workflow and a no-install browser game that simulates building the same 11 lessons before exporting real workspace files. The graph emphasizes the sampled V2 runtime and its lesson, guided-action, quiz, simulated desktop, and workspace stages; it also preserves the documented V1 route. Several modules are represented from README capabilities and tree paths because their source was not sampled, so those connections are limited to documented behavior.
Main entry points: engine.js Lesson loop · main.js Game boot · vfs.js Virtual filesystem · INSTRUCTIONS.md V1 tutor guidance
Components 19
Learning content
- V1 tutor guidance
_tutor/INSTRUCTIONS.md - 11-lesson curriculum
_tutor/curriculum - Lesson content
v2/js/data/content.js - Build directives
v2/js/data/directives.js
Game runtime
- Browser game entry
v2/index.html - Game boot
v2/js/main.js - Lesson loop
v2/js/engine.js - Teaching guide
v2/js/guide.js - Checks and reflection
v2/js/quiz.js - Claude simulation
v2/js/claudesim.js - Audio feedback
v2/js/audio.js
Simulated workspace
- Desktop windows
v2/js/windows.js - Virtual filesystem
v2/js/vfs.js
Progress and export
- Save and settings
v2/js/state.js - XP and achievements
v2/js/xp.js - Workspace download
v2/js/zip.js
Other components
- Learner
- Web browser
- Claude Code
Connections 22
- Learner → V1 tutor guidance: follows
- V1 tutor guidance → 11-lesson curriculum: routes through
- Learner → Claude Code: prompts
- Claude Code → 11-lesson curriculum: reads project context
- Web browser → Browser game entry: opens
- Browser game entry → Game boot: loads
- Game boot → Lesson loop: starts or resumes
- Lesson loop → Lesson content: reads lessons
- Lesson loop → Build directives: runs beats
- Lesson loop → Teaching guide: shows instruction
- Lesson loop → Checks and reflection: opens checks
- Lesson loop → Desktop windows: drives build actions
- Lesson loop → Claude simulation: runs scripted prompts
- Desktop windows → Virtual filesystem: reads and writes
- Claude simulation → Virtual filesystem: writes scripted effects
- Lesson loop → Save and settings: saves progress
- Game boot → Save and settings: loads save
- Lesson loop → XP and achievements: awards progress
- Game boot → Workspace download: downloads workspace
- Workspace download → Virtual filesystem: packages files
- Lesson loop → Audio feedback: plays feedback
- Learner → Lesson loop: plays lessons