diff --git a/README.md b/README.md
index 12fcae8..d72167b 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,28 @@
+
 # dags_scripts
 
-Скрипты DAG для AIRFLOW
\ No newline at end of file
+Репозиторий для DAG-файлов Airflow.
+
+## Как добавить свой DAG
+1. Клонируйте репозиторий.
+2. Положите файл `my_dag.py` в папку `dags/`.
+3. Сделайте `git push`.
+4. Через 1–5 минут DAG появится в Airflow UI.
+
+## Правила
+- Уникальные `dag_id`.
+- Никаких секретов в коде — токены и пароли храните в Airflow Variables.
+- Кастомные pip-пакеты согласовывайте — они запекаются в образ.
+EOF
+
+cat > AIRFLOW_SETUP.md <<'EOF'
+# Настройка Airflow для dags_scripts
+
+## git-sync
+В docker-compose.yaml добавить сервис git-sync с REPO_URL на этот репозиторий
+и dest /opt/airflow/dags.
+
+## Variables
+- migrations_repo_dir
+- migrations_reports_dir
+- migrations_git_token
\ No newline at end of file