diff --git a/INSTALL.md b/INSTALL.md
index b673430..cc8aa55 100644
--- a/INSTALL.md
+++ b/INSTALL.md
@@ -137,17 +137,26 @@
 
 ## 7. Обновление агента
 
-Владелец передаёт новый файл `vasily-<новая версия>.bundle`. Дальше:
+Владелец передаёт новый файл `vasily-<новая версия>.bundle`. Дальше в PowerShell:
 
 ```powershell
 cd $env:USERPROFILE\Downloads
 git clone vasily-v1.0.2.bundle vasily-dist-new
-hermes profile install .\vasily-dist-new --force
+
+# снять флаг «только чтение» с внутренних файлов агента (Windows-особенность git)
+powershell -Command "Get-ChildItem -Force -Recurse `"$env:LOCALAPPDATA\hermes\profiles\vasily\.git`" | ForEach-Object { $_.Attributes = 'Normal' }"
+
+hermes profile install .\vasily-dist-new --force --yes
 ```
 
 `--force` перезаписывает файлы агента (`SOUL.md`, `config.yaml`, `skills/`),
 **не трогая** ваши `.env` с ключом, память и историю переписки.
 
+> Строка со снятием «только чтение» — не украшение: git кладёт внутренние файлы
+> (`…\vasily\.git\objects\pack\*`) с атрибутом ReadOnly, а установщик при `--force`
+> пытается удалить старую копию и падает с `PermissionError: [WinError 5]`. Если
+> видите эту ошибку — выполните строку с `Attributes = 'Normal'` и повторите установку.
+
 Посмотреть, что стоит:
 
 ```powershell
@@ -180,5 +189,6 @@
 | `Profile 'vasily' does not exist` | агент не установлен — вернуться к шагу 3 |
 | Ответы вида «нет доступа к модели», 401 | ключ в `.env` пустой/с опечаткой — проверить строку и `hermes -p vasily config env-path` |
 | Установка не находит файл агента | файл не в текущем каталоге — проверить `cd $env:USERPROFILE\Downloads` и имя файла |
+| `PermissionError: [WinError 5]` при обновлении с `--force` | снять «только чтение» в `…\profiles\vasily\.git` (шаг 7) и повторить |
 | `vasily: команда не найдена` | `C:\Users\<вы>\.local\bin` не в PATH — использовать `hermes -p vasily chat` |
 | Общий диагноз | `hermes -p vasily doctor` |
diff --git a/README.md b/README.md
index 40d856e..d87e44a 100644
--- a/README.md
+++ b/README.md
@@ -45,6 +45,14 @@
 Получатель ставит его с флагом `--force` (шаг 7 в `INSTALL.md`): файлы агента
 перезаписываются, `.env` с ключом, память и история остаются.
 
+**Windows-ловушка при `--force`:** git кладёт файлы внутри `.git/objects/pack` с
+атрибутом ReadOnly, и установщик падает с `PermissionError: [WinError 5]` при попытке
+удалить прежнюю копию. Лечится снятием атрибута (команда в `INSTALL.md`, шаг 7).
+Альтернатива без этого шага — установить поверх через `hermes profile update vasily`,
+если источник в манифесте указывает на актуальный каталог/URL: `update` тянет
+дистрибутив заново и тоже упирается в тот же ReadOnly, так что снятие атрибута —
+основной путь.
+
 ## Проверка перед передачей
 
 ```bash
diff --git a/distribution.yaml b/distribution.yaml
index 44d74bf..d85d2c0 100644
--- a/distribution.yaml
+++ b/distribution.yaml
@@ -1,5 +1,5 @@
 name: vasily
-version: 1.1.0
+version: 1.2.0
 description: "Личный помощник руководителя: документы, письма, договоры, расчёты, поиск, задачи."
 hermes_requires: ">=0.21.6"
 author: "AI laboratory SCRUM company"