diff --git a/README.md b/README.md
index a828a6f..b43527b 100644
--- a/README.md
+++ b/README.md
@@ -5,6 +5,8 @@ Per-app whitelist, минимальный расход батареи, мале
 Дизайн — в стиле мессенджера vojo (Dawn/Fleet: тёмные поверхности, hairline-границы,
 один фиолетовый акцент, monospace для технических данных).
 
+> Для AI-агентов: карта кодовой базы, как собирать/тестировать и список инвариантов — в [`docs/`](docs/README.md).
+
 ## Стек
 
 - **Kotlin + Jetpack Compose + Material3**, Coroutines, DataStore, kotlinx.serialization.
@@ -57,7 +59,8 @@ Per-app whitelist, минимальный расход батареи, мале
 ./gradlew :app:assembleDebug
 ```
 
-Требуется Android SDK (platform-35, build-tools 35), NDK 27.2.x. Путь к SDK — в `local.properties`.
+Требуется Android SDK (platform-35, build-tools 35) и NDK — версия закреплена в
+`app/build.gradle.kts` (`ndkVersion`). Путь к SDK — в `local.properties`.
 
 ## Оптимизация батареи