diff --git a/docs/v8-project-guide.md b/docs/v8-project-guide.md
index 80dd7984..7fd7e70b 100644
--- a/docs/v8-project-guide.md
+++ b/docs/v8-project-guide.md
@@ -4,6 +4,8 @@
 
 Размещается в корне проекта (рядом с `.git/`). Создаётся навыком `/db-list add` или вручную.
 
+> **Безопасность**: файл содержит секреты (пароли баз данных, API-ключи TTS) и добавлен в `.gitignore` — он не попадает в репозиторий. Каждый разработчик заводит свой `.v8-project.json` локально.
+
 ## Полная схема
 
 ```jsonc