diff --git a/deploy/docker-compose.dev.yml b/deploy/docker-compose.dev.yml
index 1097bd3..6bed89a 100644
--- a/deploy/docker-compose.dev.yml
+++ b/deploy/docker-compose.dev.yml
@@ -8,10 +8,11 @@
 # Логи:        make dev-logs
 # Остановка:   make dev-down        (тома/каталоги состояния сохраняются)
 #
-# AC-1 (health 200) выполняется только после реализации FastAPI-каркаса (#31):
-# до этого контейнер отдаёт healthcheck unhealthy, а `/config` `/data` уже
-# проверяются скриптом deploy/verify-dev-stand.sh. Заглушка для ранней проверки
-# стенда — deploy/docker-compose.stub.yml + `make dev-up-stub`.
+# AC-1 (health 200) до реализации FastAPI-каркаса (#31): сам образ API не поднимает,
+# поэтому `make dev-up` автоматически добавляет оверрайд с health-заглушкой
+# (deploy/docker-compose.stub.yml, ответ помечен "stub": true) и стенд проходит
+# healthcheck. После появления backend/awg_api/app.py оверрайд не добавляется.
+# Явные режимы: `make dev-up-app` (только реальный образ), `make dev-up-stub`.
 
 name: ${COMPOSE_PROJECT_NAME:-awg-dash-dev}