diff --git a/.gitignore b/.gitignore
index f7d0f31..584271c 100644
--- a/.gitignore
+++ b/.gitignore
@@ -42,3 +42,6 @@ deploy/gitea-runner/data/
 
 # Служебные скрипты не входят в репозиторий (правило: в репе только код) — живут только локально
 scripts/
+
+# Локальный клон вики
+.wiki-clone/
diff --git a/README.md b/README.md
index 8bcb6b6..c375db5 100644
--- a/README.md
+++ b/README.md
@@ -2,18 +2,21 @@
 
 SaaS-мониторинг Telegram: реальные заказы и клиенты вместо рекламы и дубликатов.
 
-## Документация (актуальное)
+## Документация
 
-- **ТЗ**: `docs/spec/ТЗ-дейл-новая-архитектура.md`
-- **Инструкция пользователя**: `docs/user-guide/Инструкция-пользователя-Дейл.md`
-- **Техническая документация** (стек, развёртывание, эксплуатация): `docs/technical/Техническая-документация-Дейл.md`
-- **Карта API**: `docs/api/api-map.md`
-- **Статус и борд состояния**: `docs/superpowers/STATUS.md`
-- **Бэклог (техдолг и отложенное)**: `docs/superpowers/backlog.md`
-- **Код-стайл (полный свод правил)**: `docs/spec/Код-стайл-Дейл.md`
+Актуальные версии для людей — в [вики проекта](https://gitea.khomegeneric.keenetic.pro/rust/Deal/wiki/Home);
+в `docs/` — зеркала для работы агентов (дублирование разрешено и нужно).
+
+- **ТЗ**: [https://gitea.khomegeneric.keenetic.pro/rust/Deal/wiki/ТЗ](https://gitea.khomegeneric.keenetic.pro/rust/Deal/wiki/ТЗ)
+- **Инструкция пользователя**: [https://gitea.khomegeneric.keenetic.pro/rust/Deal/wiki/Инструкция-пользователя](https://gitea.khomegeneric.keenetic.pro/rust/Deal/wiki/Инструкция-пользователя)
+- **Техническая документация** (стек, развёртывание, эксплуатация): [https://gitea.khomegeneric.keenetic.pro/rust/Deal/wiki/Техническая-документация](https://gitea.khomegeneric.keenetic.pro/rust/Deal/wiki/Техническая-документация)
+- **Карта API**: [https://gitea.khomegeneric.keenetic.pro/rust/Deal/wiki/API-карта](https://gitea.khomegeneric.keenetic.pro/rust/Deal/wiki/API-карта)
+- **Статус и борд состояния**: [https://gitea.khomegeneric.keenetic.pro/rust/Deal/wiki/Статус-разработки](https://gitea.khomegeneric.keenetic.pro/rust/Deal/wiki/Статус-разработки)
+- **Бэклог (техдолг и отложенное)**: [https://gitea.khomegeneric.keenetic.pro/rust/Deal/wiki/Бэклог](https://gitea.khomegeneric.keenetic.pro/rust/Deal/wiki/Бэклог)
+- **Код-стайл (полный свод правил)**: [https://gitea.khomegeneric.keenetic.pro/rust/Deal/wiki/Код-стайл](https://gitea.khomegeneric.keenetic.pro/rust/Deal/wiki/Код-стайл)
 
 Исходники: `src/` (`core`, `frontend`, `ai-service`, `ml-service`, `telegram-service`, `contracts`, `grpc-hosting`).
-Планы и ledgers этапов: `docs/superpowers/plans/`, `.superpowers/sdd/`.
+Планы и ledgers этапов — в вики (раздел «Историческое» в Sidebar).
 Легаси-прототип LeadRadar и служебные скрипты в репозиторий не входят — живут локально, вне кода.
 
 ## Запуск dev-окружения