Update README.md

README.md

@@ -1,3 +1,35 @@
----
-license: mit
----
+# 🤖 Alva-MVP
+
+Welcome to the official repository for **Alva-MVP**, the first working prototype of Alva — an AI-powered conversational assistant built by **Verskod**.
+
+Alva simulates an intelligent alarm clock that engages users through morning and evening check-ins. It’s designed for mobile experiences and built to explore human-AI relationships centered around rhythm, motivation, and well-being.
+
+---
+
+## 🚀 Purpose
+
+This MVP serves as the **starting point** for building and testing Alva’s behavior using a lightweight model and a core system prompt. It’s optimized for rapid iteration and feedback during early-stage development.
+
+---
+
+## 📦 What’s Inside
+
+- 🔹 **System Prompt** — A first version defining Alva’s morning and evening personalities.
+- 🔹 **Usage Guidelines** — Suggestions for how to run or integrate the prompt using OpenRouter, Hugging Face Inference API, or a local backend.
+- 🔹 **License** — Open-source under MIT for fast experimentation and public contributions.
+
+---
+
+## 🧠 Prompt Summary
+
+Alva behaves like a voice-based AI companion who:
+
+- Gently wakes you up and asks about your energy and mood.
+- Offers a motivational quote, mantra, or playlist link.
+- In the evening, checks how your day went and guides you toward rest.
+
+Its tone is **caring**, **human-like**, and **focused on well-being**.
+
+---
+license: mit
+---