initial

docs/DESIGN.md

@@ -0,0 +1,26 @@
+# AdventureOS Design Tokens
+
+## Colors
+
+| Token | Hex | Usage |
+|-------|-----|-------|
+| XP Blue | `#3A6EA5` | Title bars, primary actions |
+| Bliss Green | `#74B749` | Progress fills, positive accents |
+| Parchment | `#F0E6D2` | Content backgrounds |
+| Warm Grey | `#8B8678` | Borders, secondary text |
+| Gold Trim | `#C8A951` | Level badges, milestones |
+| Ink | `#2C2416` | Body text |
+
+## Typography
+
+- UI: Tahoma, Segoe UI, system-ui (14–16px)
+- Mentor/Review: Georgia, serif (15px, line-height 1.6)
+
+## Components
+
+- `retro-window` — raised panel with XP-style double border
+- `retro-titlebar` — Luna blue gradient header
+- `retro-btn` — beveled button with press state
+- `skill-bar-track` / `skill-bar-fill` — RuneScape-style stat bars
+
+See `apps/web/src/app/globals.css` for CSS variables.

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