@@ -117,7 +117,7 @@ Un pipeline multi-agente escanea tu proyecto, extrae cada archivo, función, cla
# Genera contenido en el idioma preferido (descripciones de nodos y UI del dashboard)
/understand --language en
-# Idiomas soportados: en (default), zh, zh-TW, ja, ko
+# Idiomas soportados: en (default), zh, zh-TW, ja, ko, ru
```
El parámetro `--language` afecta:
diff --git a/READMEs/README.ja-JP.md b/READMEs/README.ja-JP.md
index 3be96fc..d981250 100644
--- a/READMEs/README.ja-JP.md
+++ b/READMEs/README.ja-JP.md
@@ -7,7 +7,7 @@
@@ -117,7 +117,7 @@ Understand Anything은 [Claude Code Plugin](https://code.claude.com/docs/en/plug
# 한국어로 내용 생성 (지식 그래프 노드 설명과 대시보드 UI)
/understand --language ko
-# 지원 언어: en(기본값), zh, zh-TW, ja, ko
+# 지원 언어: en(기본값), zh, zh-TW, ja, ko, ru
```
`--language` 매개변수는 다음에 영향합니다:
diff --git a/READMEs/README.ru-RU.md b/READMEs/README.ru-RU.md
new file mode 100644
index 0000000..ad8894a
--- /dev/null
+++ b/READMEs/README.ru-RU.md
@@ -0,0 +1,307 @@
+
Understand Anything
+
+
+ Превращай любую кодовую базу, базу знаний или документацию в интерактивный граф знаний, который можно исследовать, искать в нём и задавать вопросы.
+
+ Работает с Claude Code, Codex, Cursor, Copilot, Gemini CLI и другими.
+
+
+---
+
+**Вы только что присоединились к новой команде. Кодовая база — 200 000 строк. С чего вообще начинать?**
+
+Understand Anything — это [плагин для Claude Code](https://code.claude.com/docs/en/plugins-reference#plugins-reference), который анализирует ваш проект с помощью мультиагентного пайплайна, строит граф знаний из всех файлов, функций, классов и зависимостей, а затем предоставляет интерактивную панель, чтобы исследовать всё это визуально. Хватит читать код вслепую. Пора увидеть общую картину.
+
+> **Цель — не граф, который поражает сложностью вашей кодовой базы, а граф, который ненавязчиво объясняет, как все части складываются вместе.**
+
+---
+
+## ✨ Возможности
+
+> [!NOTE]
+> **Хотите пропустить чтение?** Попробуйте [живое демо](https://understand-anything.com/demo/) на нашем [сайте](https://understand-anything.com/) — полностью интерактивная панель, по которой можно перемещаться, масштабировать, искать и исследовать прямо в браузере.
+
+### Исследуйте структурный граф
+
+Перемещайтесь по своему коду как по интерактивному графу знаний — каждый файл, функция и класс является узлом, который можно кликнуть, найти и изучить. Выберите любой узел, чтобы увидеть понятные описания, связи и пошаговые обзоры.
+
+### Понимайте бизнес-логику
+
+Переключитесь на доменное представление и увидите, как ваш код отображается на реальные бизнес-процессы — домены, потоки и шаги, выстроенные в виде горизонтального графа.
+
+### Анализируйте базы знаний
+
+Направьте `/understand-knowledge` на [LLM-вики в стиле Карпати](https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f) и получите force-directed граф знаний с кластеризацией по сообществам. Детерминированный парсер извлекает wikilinks и категории из `index.md`, а LLM-агенты находят неявные связи, извлекают сущности и выявляют утверждения — превращая вашу вики в навигируемый граф взаимосвязанных идей.
+
+
+
+
+
🧭 Пошаговые обзоры
+
Автоматически создаваемые экскурсии по архитектуре, упорядоченные по зависимостям. Изучайте кодовую базу в правильном порядке.
+
+
+
🔍 Нечёткий и семантический поиск
+
Находите что угодно по имени или по смыслу. Поищите «какие части отвечают за авторизацию?» и получите релевантные результаты по всему графу.
+
+
+
+
+
📊 Анализ влияния изменений
+
Смотрите, какие части системы затрагивают ваши изменения, ещё до коммита. Понимайте каскадные эффекты по всей кодовой базе.
+
+
+
🎭 UI, адаптирующийся к роли
+
Панель подстраивает уровень детализации под пользователя — junior-разработчика, PM или продвинутого пользователя.
+
+
+
+
+
🏗️ Визуализация слоёв
+
Автоматическая группировка по архитектурным слоям — API, Service, Data, UI, Utility — с цветовой легендой.
+
+
+
📚 Концепции языка
+
12 шаблонов программирования (дженерики, замыкания, декораторы и т.д.) объясняются в контексте там, где они встречаются.
+
+
+
+
+---
+
+## 🚀 Быстрый старт
+
+### 1. Установите плагин
+
+```bash
+/plugin marketplace add Lum1104/Understand-Anything
+/plugin install understand-anything
+```
+
+### 2. Проанализируйте кодовую базу
+
+```bash
+/understand
+```
+
+Мультиагентный пайплайн сканирует ваш проект, извлекает каждый файл, функцию, класс и зависимость, а затем строит граф знаний и сохраняет его в `.understand-anything/knowledge-graph.json`.
+
+**Локализованный вывод:** используйте `--language`, чтобы генерировать контент на нужном языке:
+
+```bash
+# Генерация контента на русском (описания узлов графа знаний и UI панели)
+/understand --language ru
+
+# Поддерживаемые языки: en (по умолчанию), zh, zh-TW, ja, ko, ru
+```
+
+Параметр `--language` влияет на:
+- Резюме и описания узлов в графе знаний
+- Подписи, кнопки и подсказки UI панели
+- Объяснения в пошаговых обзорах
+
+### 3. Откройте панель
+
+```bash
+/understand-dashboard
+```
+
+Открывается интерактивная веб-панель с визуализацией вашей кодовой базы в виде графа — с цветовой кодировкой по архитектурным слоям, поиском и кликабельными узлами. Выберите любой узел, чтобы увидеть его код, связи и описание простым языком.
+
+### 4. Продолжайте учиться
+
+```bash
+# Задайте любой вопрос о кодовой базе
+/understand-chat How does the payment flow work?
+
+# Проанализируйте влияние ваших текущих изменений
+/understand-diff
+
+# Подробно разберитесь с конкретным файлом или функцией
+/understand-explain src/auth/login.ts
+
+# Сгенерируйте онбординг-гайд для новых членов команды
+/understand-onboard
+
+# Извлеките знания о бизнес-доменах (домены, потоки, шаги)
+/understand-domain
+
+# Проанализируйте LLM-вики в стиле Карпати
+/understand-knowledge ~/path/to/wiki
+```
+
+---
+
+## 🌐 Установка на разных платформах
+
+Understand-Anything работает с несколькими платформами AI-разработки.
+
+### Claude Code (нативно)
+
+```bash
+/plugin marketplace add Lum1104/Understand-Anything
+/plugin install understand-anything
+```
+
+### Установка одной командой (Codex / OpenCode / OpenClaw / Antigravity / Gemini CLI / Pi Agent / Vibe CLI / VS Code Copilot / Hermes / Cline / KIMI CLI)
+
+**macOS / Linux:**
+```bash
+curl -fsSL https://raw.githubusercontent.com/Lum1104/Understand-Anything/main/install.sh | bash
+# или передайте платформу, чтобы пропустить интерактивный выбор:
+curl -fsSL https://raw.githubusercontent.com/Lum1104/Understand-Anything/main/install.sh | bash -s codex
+```
+
+**Windows (PowerShell):**
+```powershell
+iwr -useb https://raw.githubusercontent.com/Lum1104/Understand-Anything/main/install.ps1 | iex
+```
+
+Установщик клонирует репозиторий в `~/.understand-anything/repo` и создаёт нужные симлинки для выбранной платформы. После установки перезапустите свой CLI/IDE.
+
+- Поддерживаемые значения ``: `gemini`, `codex`, `opencode`, `pi`, `openclaw`, `antigravity`, `vibe`, `vscode`, `hermes`, `cline`, `kimi`
+- Обновление: `./install.sh --update`
+- Удаление: `./install.sh --uninstall `
+
+### Cursor
+
+Cursor автоматически обнаруживает плагин через `.cursor-plugin/plugin.json` при клонировании этого репозитория. Ручная установка не требуется — просто склонируйте и откройте в Cursor.
+
+### VS Code + GitHub Copilot
+
+VS Code с GitHub Copilot (v1.108+) автоматически обнаруживает плагин через `.copilot-plugin/plugin.json` при клонировании этого репозитория. Ручная установка не требуется — просто склонируйте и откройте в VS Code.
+
+Для персональных skills (доступных во всех проектах) запустите `install.sh` выше с платформой `vscode`.
+
+### Copilot CLI
+
+```bash
+copilot plugin install Lum1104/Understand-Anything:understand-anything-plugin
+```
+
+### Совместимость с платформами
+
+| Платформа | Статус | Способ установки |
+|----------|--------|----------------|
+| Claude Code | ✅ Нативно | Marketplace плагинов |
+| Cursor | ✅ Поддерживается | Автообнаружение |
+| VS Code + GitHub Copilot | ✅ Поддерживается | Автообнаружение |
+| Copilot CLI | ✅ Поддерживается | Установка плагина |
+| Codex | ✅ Поддерживается | `install.sh codex` |
+| OpenCode | ✅ Поддерживается | `install.sh opencode` |
+| OpenClaw | ✅ Поддерживается | `install.sh openclaw` |
+| Antigravity | ✅ Поддерживается | `install.sh antigravity` |
+| Gemini CLI | ✅ Поддерживается | `install.sh gemini` |
+| Pi Agent | ✅ Поддерживается | `install.sh pi` |
+| Vibe CLI | ✅ Поддерживается | `install.sh vibe` |
+| Hermes | ✅ Поддерживается | `install.sh hermes` |
+| Cline | ✅ Поддерживается | `install.sh cline` |
+| KIMI CLI | ✅ Поддерживается | `install.sh kimi` |
+
+---
+
+## 📦 Поделитесь графом с командой
+
+Граф — это просто JSON. **Зафиксируйте его один раз, и коллеги смогут пропустить весь пайплайн.** Полезно для онбординга, ревью PR и подхода docs-as-code.
+
+> **Пример:** [GoogleCloudPlatform/microservices-demo (форк)](https://github.com/Lum1104/microservices-demo) — мультиязыковой проект (Go / Java / Python / Node) с уже зафиксированным графом.
+
+**Что коммитить:** всё содержимое `.understand-anything/`, *кроме* `intermediate/` и `diff-overlay.json` (это локальные временные файлы).
+
+```gitignore
+.understand-anything/intermediate/
+.understand-anything/diff-overlay.json
+```
+
+**Держите граф в актуальном состоянии:** включите `/understand --auto-update` — post-commit хук будет инкрементально обновлять граф, так что каждый коммит сопровождается соответствующим графом. Либо запускайте `/understand` вручную перед релизами.
+
+**Большие графы (10 МБ+):** храните через **git-lfs**.
+
+```bash
+git lfs install
+git lfs track ".understand-anything/*.json"
+git add .gitattributes .understand-anything/
+```
+
+---
+
+## 🔧 Под капотом
+
+### Мультиагентный пайплайн
+
+Команда `/understand` оркестрирует 5 специализированных агентов, а `/understand-domain` добавляет шестого:
+
+| Агент | Роль |
+|-------|------|
+| `project-scanner` | Обнаружение файлов, определение языков и фреймворков |
+| `file-analyzer` | Извлечение функций, классов, импортов; создание узлов и рёбер графа |
+| `architecture-analyzer` | Определение архитектурных слоёв |
+| `tour-builder` | Генерация пошаговых обучающих обзоров |
+| `graph-reviewer` | Проверка полноты и целостности ссылок графа (по умолчанию выполняется inline; используйте `--review` для полного ревью с участием LLM) |
+| `domain-analyzer` | Извлечение бизнес-доменов, потоков и шагов процессов (используется командой `/understand-domain`) |
+| `article-analyzer` | Извлечение сущностей, утверждений и неявных связей из статей вики (используется командой `/understand-knowledge`) |
+
+Анализаторы файлов работают параллельно (до 5 одновременно, 20–30 файлов на батч). Поддерживаются инкрементальные обновления — повторно анализируются только файлы, изменившиеся с прошлого запуска.
+
+---
+
+## 🤝 Вклад в проект
+
+Будем рады вашим контрибьюшенам! Как начать:
+
+1. Сделайте форк репозитория
+2. Создайте ветку для фичи (`git checkout -b feature/my-feature`)
+3. Запустите тесты (`pnpm --filter @understand-anything/core test`)
+4. Закоммитьте изменения и откройте pull request
+
+Для крупных изменений сначала откройте issue, чтобы можно было обсудить подход.
+
+---
+
+
+ Хватит читать код вслепую. Начните понимать всё.
+
+ Спасибо всем, кто пользовался проектом и вкладывался в него — знание того, что это экономит людям время, и было главной причиной, ради которой стоило его делать.
+