initial

docs/PRODUCT.md

@@ -0,0 +1,22 @@
+# AdventureOS — Product Overview
+
+AdventureOS is a self-hosted personal companion for building long-term consistency through a nostalgic personal-OS adventure experience.
+
+See the full product specification in your Cursor plan file. Key modules:
+
+- **Command Centre** — Character overview, Today's Adventure, Daily Reflection
+- **Library Wing** — Books, page logging, soft streaks, completion celebrations
+- **Cartographer's Desk** — Weekly Explorations (optional curiosity quests)
+- **Statistics Hall** — Historical views and trends
+- **Weekly Review** — Mentor's letter and week summary
+- **The Guide** — Local LLM quest giver (Ollama)
+- **The Teacher** — Flashcards, quizzes, research assignments
+- **Achievement Gallery** — 20+ milestones
+- **Control Panel** — Settings, templates, export, themes
+
+## Anti-Burnout Rules
+
+- No XP loss, no streak destruction, no failure screens
+- Grace days and rest days
+- Welcome back flow after absence
+- Partial credit on all adventure items