updated readme

README.md

@@ -1,11 +1,19 @@
 # Jules
 
-Life-changing AI-assistant. 
+Jules is a cross-platform AI secretary with memory. It connects to Telegram, email, Viber, Discord, and MAX as a single persona — remembers facts about users, sets reminders, messages their contacts, and nudges them toward better habits.
 
+## How it works
 
-можно заставить его спрашивать про мемы и давать рандомным людям.
+Every chat implements a minimal interface (`Send` / `Receive`). The engine pulls messages, loads full user context from PostgreSQL (facts, contacts, notifications, recent actions), builds a structured prompt with DeepSeek, parses the response into typed actions, validates them, and executes. If the LLM makes a mistake, the error is fed back into the next prompt so it self-corrects — retry loop with context propagation.
 
+## Stack
 
-шутки про отправку дикпиков, специфические мемы
+Go, PostgreSQL, DeepSeek (reasoner model), Brave Search API, production-grade test coverage (100% across all core packages).
 
+## Quick start
 
+```bash
+cp .env.example .env    # fill in your tokens
+docker compose up -d    # postgres
+go run cmd/jules/main.go
+```