diff --git a/doc/git-guide.md b/doc/git-guide.md
new file mode 100644
index 0000000..83a9172
--- /dev/null
+++ b/doc/git-guide.md
@@ -0,0 +1,75 @@
+# Инструкция по Git
+
+> v0.36.0-dev, 3 июня 2026
+
+## Структура репозиториев
+
+Один проект — два git-репо в одной папке:
+
+```
+elmer/                   ← git-репо #1 (gitea)
+├── api/                 серверный код
+├── brain/               LLM-клиент
+├── obd/                 ELM327
+├── web/                 Flask, сайт, APK
+├── doc/                 документация
+├── android/             ← git-репо #2 (github) — Android-приложение
+│   ├── app/             исходники Kotlin
+│   ├── build.gradle.kts сборка
+│   └── ...
+├── config.yaml          конфиг сервера
+└── ...
+```
+
+## Ремоуты
+
+| Репо | URL |
+|------|-----|
+| Сервер (elmer/) | `https://gitea.services.ngcloud.ru/Nail/elmer.git` |
+| Android (elmer/android/) | `https://github.com/Repinoid/elmer-android.git` |
+
+## Команды
+
+### Сервер
+
+```bash
+cd elmer
+git pull origin master      # забрать изменения
+git add -A                  # добавить всё
+git commit -m "..."         # закоммитить
+git push origin master      # отправить
+```
+
+### Android
+
+```bash
+cd elmer/android
+git pull origin master      # забрать изменения
+git add -A                  # добавить всё
+git commit -m "..."         # закоммитить
+git push origin master      # отправить
+```
+
+## Деплой на сервер (obdai.ru)
+
+```bash
+ssh -i ~/.ssh/naeel_vm_id_ed25519 naeel@5.172.178.213 \
+  "cd /opt/elmer && git pull origin master && sudo systemctl restart elmer"
+```
+
+## Сборка APK (на сервере)
+
+```bash
+ssh -i ~/.ssh/naeel_vm_id_ed25519 naeel@5.172.178.213 \
+  "export ANDROID_SDK_ROOT=\$HOME/android-sdk && \
+   export ANDROID_HOME=\$ANDROID_SDK_ROOT && \
+   cd /opt/elmer/android && \
+   ./gradlew clean assembleDebug && \
+   cp app/build/outputs/apk/debug/app-debug.apk /opt/elmer/web/static/"
+```
+
+## Важно
+
+- `android/` в `.gitignore` родительского репо — его изменения коммитятся отдельно
+- Ветка везде `master`
+- Перед началом работы всегда делать `git pull` в обоих репо