docs: Update local launch documentation for multi-mode interface

- Updated QUICK_START.md with comprehensive launch instructions
- Added description of 4 assistant modes (Medical, Lifestyle, Spiritual, Combined)
- Documented all interface tabs (Main Chat, Testing Lab, Edit Prompts, Instructions)
- Added both API keys requirement (Gemini + Anthropic)
- Updated troubleshooting section with common errors
- Added information about K/L/S/T automatic classification
- Included Gradio 6.0.2 specific notes

QUICK_START.md

@@ -1,24 +1,80 @@
 # ⚡ Швидкий Старт - Medical Brain
 
+## 🎯 Що Включає Додаток
+
+**🏥 Lifestyle Journey + 🕊️ Spiritual Health Assessment + 🧪 Testing Lab + 🔧 Prompt Editor**
+
+Комплексна система з 4 режимами роботи:
+- **Medical Only** - медичний тріаж та консультації
+- **Lifestyle Focus** - персоналізовані рекомендації щодо способу життя
+- **Spiritual Focus** - оцінка духовного дистресу
+- **Combined** - координована підтримка Lifestyle + Spiritual
+
 ## 🚀 Запуск за 3 Кроки
 
 ### 1️⃣ Налаштування (Перший раз)
 
 ```bash
-# Створити .env файл з API ключем
-echo "GEMINI_API_KEY=your_api_key_here" > .env
+# Створити .env файл з API ключами
+cat > .env << EOF
+GEMINI_API_KEY=your_gemini_api_key_here
+ANTHROPIC_API_KEY=your_anthropic_api_key_here
+EOF
 ```
 
-### 2️⃣ Запуск
+**Примітка:** Потрібні обидва ключі для повної функціональності:
+- **Gemini API** - для класифікації та швидких операцій
+- **Anthropic API** - для діалогів та аналізу (Claude Sonnet 4.5)
+
+### 2️⃣ Запуск Інтерфейсу
 
 ```bash
+# Автоматичний запуск (рекомендовано)
 ./start.sh
+
+# АБО ручний запуск
+source venv/bin/activate
+python src/interface/gradio_app.py
 ```
 
 ### 3️⃣ Використання
 
 Відкрийте браузер: **http://localhost:7860**
 
+**Доступні вкладки:**
+- 💬 **Main Chat** - основний інтерфейс з вибором режиму асистента
+- 🧪 **Testing Lab** - тестування з готовими пацієнтами
+- 🔧 **Edit Prompts** - редагування системних промптів
+- 📖 **Instructions** - інструкції та приклади використання
+
+---
+
+## 🎯 Вибір Режиму Асистента
+
+У вкладці **Main Chat** доступні 4 режими:
+
+### 🏥 Medical Only
+- Медичний тріаж та консультації
+- Обробка симптомів та скарг
+- Рекомендації щодо звернення до лікаря
+
+### 💚 Lifestyle Focus
+- Персоналізовані рекомендації щодо способу життя
+- Програми вправ та харчування
+- Відстеження прогресу
+
+### 🕊️ Spiritual Focus
+- Оцінка духовного та емоційного дистресу
+- Автоматичне виявлення red/yellow flags
+- Генерація referrals для chaplain team
+
+### 🌟 Combined (Lifestyle + Spiritual)
+- Координована підтримка обох асистентів
+- Інтелектуальна пріоритизація відповідей
+- Комплексний підхід до здоров'я
+
+**Автоматична класифікація:** Система використовує Entry Classifier (K/L/S/T) для визначення найкращого режиму на основі повідомлення пацієнта.
+
 ---
 
 ## 🎯 Що Далі?
@@ -27,7 +83,8 @@ echo "GEMINI_API_KEY=your_api_key_here" > .env
 📖 Читайте: [docs/spiritual/ЗАПУСК_ДОДАТКУ.md](docs/spiritual/ЗАПУСК_ДОДАТКУ.md)
 
 ### Для Розробників
-💻 Читайте: [docs/spiritual/spiritual_README.md](docs/spiritual/spiritual_README.md)
+💻 Читайте: [docs/spiritual/spiritual_README.md](docs/spiritual/spiritual_README.md)  
+💻 Конфігурація LLM: [LLM_MODELS_CONFIGURATION.md](LLM_MODELS_CONFIGURATION.md)
 
 ### Для Адміністраторів
 🔧 Читайте: [docs/spiritual/SPIRITUAL_DEPLOYMENT_CHECKLIST.md](docs/spiritual/SPIRITUAL_DEPLOYMENT_CHECKLIST.md)
@@ -39,10 +96,13 @@ echo "GEMINI_API_KEY=your_api_key_here" > .env
 ```bash
 # Запустити тести
 source venv/bin/activate
-pytest tests/spiritual/ -v
+pytest tests/ -v
+
+# Або тільки ключові тести
+pytest tests/test_combined_assistant.py tests/test_spiritual_assistant.py tests/test_entry_classifier.py -v
 ```
 
-**Очікуваний результат:** ✅ 145/145 тестів пройдено
+**Очікуваний результат:** ✅ Всі тести пройдено (32+ тестів для multi-mode integration)
 
 ---
 
@@ -58,6 +118,17 @@ pytest tests/spiritual/ -v
 
 ## ❓ Проблеми?
 
+### Помилка: "No AI providers available"
+
+```bash
+# Перевірте наявність обох API ключів
+cat .env
+
+# Повинно бути:
+# GEMINI_API_KEY=...
+# ANTHROPIC_API_KEY=...
+```
+
 ### Помилка: "venv not found"
 
 ```bash
@@ -72,10 +143,24 @@ pip install -r requirements.txt
 lsof -i :7860 | grep LISTEN | awk '{print $2}' | xargs kill -9
 ```
 
-### Помилка: "API Key not found"
+### Помилка: "Module not found"
 
 ```bash
-echo "GEMINI_API_KEY=your_api_key_here" > .env
+# Переконайтесь, що venv активовано
+source venv/bin/activate
+
+# Переінсталюйте залежності
+pip install -r requirements.txt
+```
+
+### Помилка при запуску Gradio 6.0.2
+
+```bash
+# Перевірте версію Gradio
+pip show gradio
+
+# Якщо потрібно, оновіть
+pip install --upgrade gradio==6.0.2
 ```
 
 ---

README.md

@@ -15,10 +15,30 @@ pinned: false
 
 ## ⚡ Швидкий Старт
 
+### Локальний Запуск
+
+**🏥 Lifestyle Journey + 🕊️ Spiritual Health Assessment + 🧪 Testing Lab + 🔧 Prompt Editor**
+
 ```bash
+# 1. Налаштувати API ключі (перший раз)
+cat > .env << EOF
+GEMINI_API_KEY=your_gemini_api_key_here
+ANTHROPIC_API_KEY=your_anthropic_api_key_here
+EOF
+
+# 2. Запустити додаток
 ./start.sh
+
+# 3. Відкрити в браузері
+# http://localhost:7860
 ```
 
+**Що включає інтерфейс:**
+- 💬 **Main Chat** - 4 режими асистента (Medical, Lifestyle, Spiritual, Combined)
+- 🧪 **Testing Lab** - тестування з готовими пацієнтами
+- 🔧 **Edit Prompts** - редагування системних промптів (4 типи)
+- 📖 **Instructions** - інструкції та приклади
+
 Детальніше: [QUICK_START.md](QUICK_START.md)
 
 ---