Every interactive surface enumerated (~150 controls). Ten atomic phases — each with scope · design ref · test. Three milestones (M1 demo · M2 productize · M3 differentiate) with what's in & what's deferred for each.
The stable rules. v2 extensibility pass adds multi-tenancy seam, canonical subjects/topics, plan revisions, asset dedup, idempotency keys, soft-delete pattern. Plus M2 stubs for subscriptions and mastery_records. 14 entities · 18 API endpoints · SSE streaming · cache · auth · 13 logging fields · 6 error codes · 21 events.
Haiku-first + Sonnet-stream pattern. 4-lane sequence diagram (user · UI · Haiku · Sonnet). Model picks per role. Eight rules (4 never · 4 always). The ≤3s latency budget that powers M1.
The "outside" entry point. Prominent owl hero. 4 lanes: Academic · Big Questions · Skills · Test prep. Search bar, recents, paths. Tagline: "Learn anything, on your terms."
The full shell. 5 modes (Teach · Coach · Test · Whiteboard). Mini-owl rail companion. Setup & Plan modals overlay only the board (shell stays put). Cycle stages with the bottom-right demo toggle.
5 subject-aware engagement overlays for any moment of latency. Physics: equations cascade. Math: curve drawing in. History: parchment + timeline. Languages: scripts + bubbles. Curiosity: question constellation.
Science archetype. 8 topic cards with equation decoration. 6 problem libraries (Irodov, Griffiths, Goldstein, Halliday, Sakurai, MIT). 7 exam tracks. 4 levels. Trending.
Math-flavored science archetype. 8 topics from algebra to combinatorics. 8 canonical libraries (Spivak, Apostol, Rudin, Strang, Putnam, IMO, Hatcher, Dummit-Foote). 6 exams.
Humanities archetype. Era timeline · 8 regions · 10 themes · 6 big questions · 9 figures. Warmer parchment palette. Owl wears coral bow tie + tiny scroll.
Language archetype — radically different. Why-are-you-learning, CEFR ladder A1→C2 with placement test, four core skills, 8 conversation roleplay scenarios, 6 English exams.
Four-blue palette (light sky · deep sky · sea · ink) + warm anchors (gold · coral · mint). Color tokens, role table, sample components, type pairing, 6 design principles.
Mascot · 3 expressions (attentive · thinking · listening) · 6 logo lockups · color from the owl · 6 visual elements · 4 applications (favicon, app icon, social, business card) · 7 owl-handling rules.
Done · 2026-05-10. Own repo · own Postgres-16 container on port 5460 · own FastAPI service on port 8790 · all stage URLs verified untouched · old omnitutor-canvas-a.service stopped + archived · audit clean. Live API at /v1/healthz · Swagger at /v1/docs.
FastAPI scaffolding · session/log/rate/moderation middleware · Anthropic + ElevenLabs clients with auto cost-tracking · frontend tokens · owl SVG component · KaTeX · GitHub Actions CI · pytest + Playwright + k6 harnesses · backup + cost-cap crons.
First user-facing surface. omnitutor.ai/ + /physics + /math + /history + /english render real pages from seeded subjects · topics tables. Search bar wired · every tile clickable · recents + trending queries · friendly 404 on /setup until P3.
Each phase gets its own p<n>_lld.html page using the same 5-section template (scope · before/after · work plan · test plan · acceptance gate). Written just-in-time, one phase ahead.
Queue: p1_lld.html (foundation) → p2_lld.html (discovery + subjects) → p3 setup modal → p4 plan + drama → p5 streaming pipeline → p6 runtime + Teach → p7 Coach + Test → p8 Whiteboard + viz/anim → p9 adjust + cross-cutting → p10 audio + cache + polish.
Cross-cutting contracts that all phases consume live in → Contracts & schema.
~67 entry points across the 4 lanes — 31 academic subjects (8 sci · 6 eng · 6 hum · 6 soc · 5 langs), 6 question domains, 12 skills, 18 exams. Per-row concepts & problems estimates. Cached vs on-demand.
Info-gathering form. 4 quick choices (why · level · time · style) + free text + advanced (pace · tone · outputs · textbook · exclude) + skip path.
Game plan + welcome. Owl avatar lip-syncing, audio with typing subtitle, 7-beat plan. Iterate chips + textarea + mic + Send/Lock.
The full lesson runtime. Beat strip, 5 mode boards, mini-owl rail, ask area with new viz/animate chips, gold "Adjust level" button.