Project Briefing
Purpose: A child-centered learning companion with strict cognitive-load and dignity constraints. Designed for Rosie's specific needs — visual impairment, learning differences, and the need for calm, supportive instruction.
Current Phase: Phase 3 — Teaching System
| Feature | Status | Location |
| Lesson Hub | Live | /lessons |
| Classic Lessons (46 lessons) | Live | /lessons/rosie |
| Support controls (Hear, Repeat, Hint, Not Today) | Live | Bottom bar during lessons |
| Digital Binder (document library) | Live | /admin/binder |
| AI Advisor (questions & briefs) | Live | /advisor |
| Rosie Profile & Knowledge Layer | Live | /admin/advisor |
| Context Manager (events, specialists) | Live | Dynamic council on /advisor |
| Helper System (4 personalities) | Live | Mira, Benny, Gus, Wednesday |
| Speech Recognition | Live | /admin/speech-profile |
| Usage Dashboard | Live | /admin/usage |
| Multi-provider AI routing | Live | OpenAI, Anthropic, Gemini, Ollama, DeepSeek, xAI |
| Phase 3 Lesson Player (with speech) | Testing | /lessons/v2 |
Lessons (46 Total)
Core Lessons (3)
- Fast Words: Blends + -ck — CVC blends, -ck ending (6 min)
- The -er Ending — R-controlled vowels (6 min)
- Short Passage: Slow and Accurate — Fluency practice (7 min)
Barton Reading System — Level Lessons (25)
- Level 1: 5 lessons — Consonants and Short Vowels
- Level 2: 5 lessons — Consonant Blends and Digraphs
- Level 3: 5 lessons — Closed and Unit Syllables
- Level 4: 5 lessons — Syllable Division and Accent
- Level 5: 5 lessons — Prefixes and Suffixes
Barton Reading System — Practice & Fluency (18)
- Decoding: Vowel Hunt, Digraph Practice, Sight Words List 1
- Fluency: Fat Jack Rap, Dent in His Rig, The Lump, Flip the Frog, The Pack Rat, Gramps and the Pig, Munch the Lunch, The Grand Gift, Swell Ranch, Clem and the Clam, At Camp, Clash at Lunch, Bat and Ball, Nick is Sick, Chess Champ
Helper Companions
Five personalities available for lesson support, each with provider-specific tuning:
- Mira — Calm, gentle deer. Warm and reassuring.
- Benny — Cheerful bear. Enthusiastic and encouraging.
- Gus — Goofy owl. Silly humor, keeps things light.
- Wednesday — Deadpan cat. Dry wit, matter-of-fact.
- Bob — Patient teacher/dad. Steady, reassuring, warm.
Design Principles
- Large text, high contrast — Visual fatigue is a factor
- Short steps, repetition — Low cognitive load
- Proactive supports — Hear/Repeat/Hint always visible (Rosie won't ask for help)
- Not Today = valid choice — Ends cleanly with calm message, no judgment
- No animations, no gamification — No pressure, no streaks
- Literal language — No metaphors in story beats
- Ingestion AI is upload-time only — Advisor uses curated knowledge layer, never raw PDFs
Roadmap
| Phase | Status | Focus |
| Phase 1 | Complete | Static lessons, support controls, story beats |
| Phase 2 | Complete | Auth, digital binder, document uploads |
| Phase 2.5 | Complete | AI Advisor, knowledge layer, context manager |
| Phase 3 | Current | Teaching system — helpers, speech, adaptive lessons |
| Phase 4 | Planned | Brief Builder — templates, PDF export |
| Phase 5 | Future | Collaboration — educator invites, sharing |
Technical Stack
- Framework: Astro 5 with Cloudflare adapter
- Hosting: Cloudflare Pages
- Auth: Cloudflare Access (JWT verification)
- Database: Cloudflare D1
- Storage: Cloudflare R2 (private bucket)
- AI Providers: OpenAI, Anthropic, Google Gemini, Ollama (local), DeepSeek, xAI
- TTS: Browser speechSynthesis API
Site Map
| Route | Access | Purpose |
/ | Public | Landing page |
/lessons | Public | Lesson hub |
/lessons/rosie | Public | Classic lesson player (46 lessons) |
/lessons/v2 | Public | Phase 3 lesson player with speech |
/advisor | Protected | AI Advisor chat |
/admin/binder | Protected | Document library & upload |
/admin/review | Protected | Duplicates & extraction review |
/admin/lessons | Protected | Lesson catalog |
/admin/sessions | Protected | Session history |
/admin/usage | Protected | API usage dashboard |
/admin/advisor | Protected | Rosie Profile editor |
/admin/briefing | Protected | This page |
/briefs | Protected | Brief Builder (coming soon) |
Last updated: December 2025
