diff --git a/README.md b/README.md
index 52df8c1a..bebe7a18 100644
--- a/README.md
+++ b/README.md
@@ -44,7 +44,7 @@
 
 ### Кроссплатформенный режим (Python)
 
-Для работы на **Linux/Mac** можно переключить навыки на Python 3:
+На Windows рекомендуется использовать PS1-рантайм (по умолчанию) как более стабильный и протестированный. Python-порты — для **Linux/Mac** или если PowerShell недоступен. PS1-скрипты — мастер-версия; Python-порты производные (см. [Python Porting Guide](docs/python-porting-guide.md)).
 
 ```bash
 python scripts/switch-to-python.py     # переключить на Python
diff --git a/docs/python-porting-guide.md b/docs/python-porting-guide.md
index eef357e9..e0255b8a 100644
--- a/docs/python-porting-guide.md
+++ b/docs/python-porting-guide.md
@@ -6,6 +6,16 @@
 
 PowerShell 5.1 доступен только на Windows. Python-порты обеспечивают кроссплатформенность (Linux, Mac). Модель opt-in: PS1 — по умолчанию, Python — переключается скриптами.
 
+## PS1 — мастер-версия
+
+**Приоритет при разработке, доработке, отладке и тестировании — у PS1-скриптов.** Python-порты являются производными копиями. Порядок работы:
+
+1. Вносите изменения в `.ps1`
+2. Тестируйте и отлаживайте `.ps1`
+3. Переносите готовые изменения в `.py`
+
+Не дорабатывайте `.py` без аналогичного изменения в `.ps1` — они должны оставаться функционально идентичными.
+
 ## Переключение рантайма
 
 ```bash