diff --git a/README.md b/README.md
index f3150f3..2f819c9 100644
--- a/README.md
+++ b/README.md
@@ -369,6 +369,29 @@ off — тесты герметичны), точечно `SIMBIOT_DECISION_<TASK
 исходом). Статус/статистика: `cli.py decide`, `cli.py decide --stats`.
 Тест: `./venv/bin/python tests/test_decision.py` (фейковый эндпоинт).
 
+## Ядро Коди — обучаемые ученики решений (harness/kodi_core.py)
+
+Цикл как в systemone-bench (engine42/router42): учитель → маленькая
+своя модель + kNN-память новизны → роутер → дообучение на исходах.
+Первая голова — `addressing` (отвечать ли в группе), режим
+`SIMBIOT_CORE_ADDRESSING=shadow|on|off` (дефолт shadow: решает учитель
+`clef:27b`, ученик пишет прогноз `CorePrediction`).
+
+- **Метки** (события `core`, подписаны): учитель (живые вердикты и
+  разметка истории `cli.py core backfill`, вес 1), неявная обратная
+  связь чата (`CoreFeedback`: «не тебе/продолжает» после ответа → 0,
+  «@juno42bot»/«Коди?» сразу после молчания → 1, вес 3), Alex —
+  кнопки «Это было мне?» в личку на незнакомых спорных (≤ 5/сут, вес 5).
+- **Ученик**: эмбеддинг сообщения (локальный `nomic-embed-text`, кеш в
+  `<home>/core/emb.sqlite`) + 8 флагов → логрегрессия (numpy); новизна —
+  kNN к обучающей памяти, пороги калибруются на холдауте.
+- **Роутер**: знакомо и |p−0.5| ≥ 0.4 → ученик; незнакомо и учитель
+  сомневается → вопрос Alex; иначе учитель.
+- **Тренировка**: дневной тик (и `cli.py core train`) — временной
+  холдаут, претендент сменяет чемпиона только при лучшем log-loss;
+  `CoreModelPromoted` с sha256 файла; подменённый файл не грузится;
+  `cli.py core rollback`. Метрики и тень за 7 дней — `cli.py core status`.
+
 ## Модели
 
 9router (router.cil.by), отдельный ключ `sk-simbiot` в `.env`, комбо `auto`: