Design Principles¶
Source:
Captainswords.app/docs/VISION.md·.cursor/rules/project-rules.mdc
Product¶
- Emotionally safe learning for children aged 6–9
- Calm, readable UI — no shame-based feedback
- Build small vertical slices; validate each phase before expanding
- Core learning first — no features driven only by "it looks unfinished"
Technical¶
- TypeScript strict; minimize diff scope
- Learning engine stays isolated — plain JSON in/out, no React/Phaser/Supabase imports
- Do not put educational logic only inside Phaser scenes
- Prefer simple deterministic rules before AI
Architecture (MVP)¶
Single App · Single Database · Single Deployment
No microservices, Kubernetes, or distributed infrastructure until proven necessary.
Engine rule (Captain Engine)¶
The engine decides what happens. The renderer decides how it appears.
Wrong answers produce calm not yet guidance — the renderer does not punish with harsh world failure.