kin: KIN-FIX-005 Починить регрессию KIN-055: execution_mode=NULL после pipeline→review

README.md

@@ -1,3 +1,54 @@
 # kin
 
-Kin project
+Мультиагентный оркестратор проектов. Виртуальная софтверная компания: Intake → PM → специалисты.
+
+## Быстрый старт
+
+### Зависимости
+
+```bash
+# Python-зависимости
+pip install -e .
+
+# Frontend-зависимости
+make install
+```
+
+### Разработка
+
+```bash
+# Запустить frontend в dev-режиме (vite, hot-reload на :5173)
+make dev
+
+# Запустить API-сервер отдельно
+make run
+```
+
+### Production-сборка
+
+Frontend собирается в `web/frontend/dist/` и раздаётся FastAPI как static files.
+
+```bash
+# Собрать frontend
+make build-frontend
+
+# Собрать + запустить
+make deploy
+```
+
+> **Важно:** `web/frontend/dist/` не хранится в git. Перед запуском в production всегда выполни `make build-frontend`.
+
+### Тесты
+
+```bash
+make test
+```
+
+## Архитектура
+
+Подробная спецификация: [DESIGN.md](DESIGN.md)
+
+## Стек
+
+- **Backend:** Python 3.11+, FastAPI, SQLite
+- **Frontend:** Vue 3 Composition API, TypeScript, Tailwind CSS, Vite