diff --git a/openspec/changes/wiki-module/design.md b/openspec/changes/wiki-module/design.md
index 4ef8c2d..2fde333 100644
--- a/openspec/changes/wiki-module/design.md
+++ b/openspec/changes/wiki-module/design.md
@@ -400,13 +400,17 @@ jira безвреден.
 
 ## Migration Plan
 
-- Хаб: merge → `make web` → kickstart (владелец) → `/mcp` reconnect. jira-agent не обновляется.
+- Хаб: merge → `git pull` → **сразу** kickstart (владелец) → `make web` → `/mcp` reconnect. jira-agent не
+  обновляется. До kickstart не запускать `jira-hub mcp` и CLI (`tokens`, `agent publish`): новый код при подключении к
+  базе мигрирует её в v7, а хаб на старом коде после этого не работает (нет колонки `agent_status.id`, токена
+  `tokens.agent`). Старый фронт работает с новым API, поэтому `make web` можно после kickstart.
 - После kickstart:
   - проверить `agent_status` jira (v14 онлайн);
   - проставить корни проектам (`root_set` или веб);
   - добавить `jira-hub-wiki` в `.mcp.json` awp-ca.
 - eva-agent: отдельный PR и ручная установка на виртуалке владельцем; дальше публикация `--module wiki`.
-- Откат хаба: предыдущий коммит и копия базы v6 из `backups/`.
+- Откат хаба: предыдущий коммит, копия базы v6 из `backups/` и возврат `release/jira/agent.py`, `manifest.json` в
+  `release/` (иначе старый код увидит «публикации нет»; для v14 безвредно, самообновление молчит).
 
 ## Decisions made without discussion