Add Russian README and agentic RAG description

- README.md: add "How it works" section explaining agentic RAG pattern,
  link to Russian version at the top
- README-RU.md: full Russian translation

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: rodion-m

README-RU.md

@@ -0,0 +1,88 @@
+# fpf-simple-skill
+
+Скилл AI-агента для [First Principles Framework (FPF)](https://github.com/ailev/FPF) авторства [Анатолия Левенчука](https://github.com/ailev).
+
+FPF — трансдисциплинарная архитектура мышления для системной инженерии, координации знаний и смешанных команд человек/ИИ.
+
+## Как это работает
+
+Скилл работает как **агентный RAG** — retrieval-augmented generation, управляемый самим агентом, без внешней векторной базы данных или пайплайна эмбеддингов. Спецификация FPF на 56 000 строк разбита на двухуровневую иерархию (20 директорий, 224 файла). SKILL.md содержит роутер на основе «глаголов мышления», который сопоставляет намерение пользователя с нужным разделом. Агент навигирует по файлам `_index.md`, выбирает минимальный подраздел (~300 строк) и загружает в контекст только его. Агент одновременно является ретривером, роутером и генератором — всё в одном цикле.
+
+## Установка
+
+```bash
+npx skills add CodeAlive-AI/fpf-simple-skill -g
+```
+
+## Структура
+
+```
+sections/
+  04-part-a-kernel-architecture-cluster/
+    _index.md                          # Оглавление с описаниями всех подразделов
+    01-a-0---onboarding-glossary.md    # 137 строк
+    02-a-1---holonic-foundation.md     # 185 строк
+    ...                                # 19 подразделов
+  08-part-c-kernel-extensions-specifications/
+    _index.md
+    ...                                # 30 подразделов
+  ...                                  # 20 директорий всего
+```
+
+Агент сначала читает `_index.md`, выбирает нужный подраздел и загружает только его.
+
+## Разделы
+
+| # | Раздел | Подразд. |
+|---|--------|:---:|
+| 01 | Титульная страница | 0 |
+| 02 | Оглавление | 0 |
+| 03 | Предисловие | 17 |
+| 04 | Часть A — Архитектура ядра | 19 |
+| 05 | A.IV.A — Стек сигнатур и границы | 18 |
+| 06 | A.V — Конституционные принципы | 29 |
+| 07 | Часть B — Трансдисциплинарное рассуждение | 24 |
+| 08 | Часть C — Расширения ядра | 30 |
+| 09 | Часть D — Этика и конфликты | 1 |
+| 10 | Часть E — Конституция и авторство | 0 |
+| 11 | E-I — Конституция FPF | 29 |
+| 12 | Часть F — Унификация | 0 |
+| 13 | F.I — Контекст значения | 19 |
+| 14 | UTS Layout A | 0 |
+| 15 | UTS Layout B | 1 |
+| 16 | Часть G — SoTA-паттерны | 15 |
+| 17 | Часть H — Глоссарий | 0 |
+| 18 | Часть I — Приложения | 0 |
+| 19 | Часть J — Указатели | 0 |
+| 20 | Часть K — Лексический долг | 2 |
+
+## Обновление при изменениях спецификации FPF
+
+При изменении upstream-спецификации FPF нужно обновить две вещи:
+
+### 1. Перегенерировать файлы разделов
+
+Обновить подмодуль и перезапустить сплиттер для пересборки иерархии `sections/`:
+
+```bash
+git submodule update --remote
+python3 scripts/split_spec.py
+```
+
+### 2. Обновить навигацию в SKILL.md
+
+Файлы разделов — это сырой контент, а `SKILL.md` — навигационный слой поверх него.
+После перегенерации проверьте, нужно ли обновить роутер глаголов мышления, юзкейсы или
+индекс разделов в `SKILL.md`.
+
+Полная методология описана в **[FPF-SKILL-UPDATE-GUIDE.md](FPF-SKILL-UPDATE-GUIDE.md)** —
+что проверять, как валидировать записи роутера и как провести FPF-самоаудит скилл-файла.
+
+## Авторы
+
+- **Спецификация FPF**: [Анатолий Левенчук](https://github.com/ailev) — [github.com/ailev/FPF](https://github.com/ailev/FPF)
+- **Упаковка в скилл**: [CodeAlive-AI](https://github.com/CodeAlive-AI)
+
+## Лицензия
+
+MIT

README.md

@@ -1,8 +1,14 @@
 # fpf-simple-skill
 
+[Русская версия (README-RU.md)](README-RU.md)
+
 AI coding agent skill for the [First Principles Framework (FPF)](https://github.com/ailev/FPF) by [Anatoly Levenchuk](https://github.com/ailev).
 
-FPF is a transdisciplinary reasoning architecture for systems engineering, knowledge coordination, and mixed human/AI teams. This skill splits the 56,000-line FPF specification into a two-level hierarchy (20 directories, 224 files) so an agent loads only the ~300-line sub-section it needs instead of the entire spec.
+FPF is a transdisciplinary reasoning architecture for systems engineering, knowledge coordination, and mixed human/AI teams.
+
+## How it works
+
+This skill functions as **agentic RAG** — retrieval-augmented generation driven by the agent itself, with no external vector database or embedding pipeline. The 56,000-line FPF specification is split into a two-level hierarchy (20 directories, 224 files). SKILL.md provides a thinking-verb router that maps the user's intent to the right section. The agent then navigates `_index.md` files to pick the narrowest sub-section (~300 lines) and loads only that into context. The agent is the retriever, the router, and the reasoner — all in one loop.
 
 ## Install