diff --git a/tests/deploy/pytest.ini b/tests/deploy/pytest.ini
index ab6bac0..7299b6b 100644
--- a/tests/deploy/pytest.ini
+++ b/tests/deploy/pytest.ini
@@ -1,3 +1,12 @@
+# Профиль тестов dev/тест-стенда (#21, issue #56).
+#
+# Отдельный pytest.ini обязателен: без него `pytest tests/deploy` наследует
+# addopts корневого pyproject.toml (--cov=awg_agent --cov=awg_api), покрытие
+# выходит 0.00 % и RC=1 — гейт приходилось запускать с --no-cov в обход порога.
+#
+# Измеряется код стенда: deploy/*.py (api_stub.py — то, что реально работает в
+# контейнере) и tests/deploy/validate_compose.py (валидатор манифестов).
+# Тестовые модули из покрытия исключены через tests/deploy/.coveragerc.
 [pytest]
 testpaths = .
 addopts = -q --cov=deploy --cov=tests/deploy --cov-config=tests/deploy/.coveragerc --cov-report=term-missing --cov-fail-under=70