The guide said a required migration is simply carried out, which contradicts upgrade-instance.md: the agent can stop after the first publish, leaving a valid intermediate state that migrate status resumes and doctor warns about. The guide now says so without retelling the instruction's steps. Files changed: - docs/how-to/update-an-instance.md Co-Authored-By: Claude Code <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SnAJ7Z3CpVD3PRbN73QtU2