docs: split handbook into docs/ by topic, slim root README, add docs index

Made-with: Cursor

docs/concepts-and-terms.md

@@ -0,0 +1,37 @@
+# Термины: LLM, токены, MCP и сценарии OpenClaude
+
+Коротко — что есть что, прежде чем переходить к установке и железу.
+
+## LLM и токены
+
+- **LLM (Large Language Model)** — большая языковая модель, которая генерирует текст токен за токеном.
+- **Токен** — кусок текста (слово, часть слова, знак, пробел), не всегда «целое слово».
+- **Скорость (например 1–5 токенов/с)** — скорость генерации ответа моделью (decode speed).
+- Очень грубо: `5 ток/с` часто ощущается как `~15–25 символов/с`, но это зависит от языка и модели.
+
+## MCP
+
+**MCP (Model Context Protocol)** — стандарт для подключения инструментов и источников данных к AI-агенту.
+
+Простая схема:
+
+- Модель = «мозг»
+- MCP-сервер = «шлюз к инструментам»
+- MCP-инструменты = конкретные действия (`search_docs`, `run_sql`, `create_ticket` и т.д.)
+
+Польза MCP:
+
+- подключение к актуальным данным (документы, БД, API);
+- контролируемое выполнение действий через схемы входа/выхода;
+- повторяемая интеграция для локальных и облачных сценариев.
+
+## Сценарии работы OpenClaude
+
+`openclaude` поддерживает разные провайдеры, в том числе:
+
+- OpenAI-compatible API
+- Ollama (локально)
+- DeepSeek (через OpenAI-compatible endpoint)
+- Gemini, GitHub Models, Codex и др.
+
+Дальше: [установка CLI и зависимостей](install-openclaude-cli.md) → [профили и переменные окружения](configure-profiles-direnv.md).