diff --git a/plugins/kbagent/skills/kbagent/references/gotchas.md b/plugins/kbagent/skills/kbagent/references/gotchas.md
index 4c5177dc..96820b5c 100644
--- a/plugins/kbagent/skills/kbagent/references/gotchas.md
+++ b/plugins/kbagent/skills/kbagent/references/gotchas.md
@@ -458,7 +458,9 @@ Versioning convention:
   `--allow-plaintext-on-encrypt-failure`, which would write the PAT in
   plaintext into Storage.
 
-## `sync push` no longer leaves phantom `REMOTE MODIFIED` drift; `transform.sql` carries statement boundaries (since 0.91.0, #686)
+## `sync push` no longer leaves phantom `REMOTE MODIFIED` drift; `transform.sql` carries statement boundaries
+
+*(since 0.91.0, #686)*
 
 `pull_config_hash` in `.keboola/manifest.json` is the 3-way diff's base, and it
 means "the hash of this config **as the API returns it**". `sync pull` and the
@@ -527,7 +529,9 @@ it, and the next deploy re-created it (field report: 18 phantom configs hiding
   statements into one. Run `sync pull` for that project, then push again.
   Genuine SQL edits are never blocked by this guard.
 
-## `sync push` runs the same script-shape guard as `config update` (since 0.91.0)
+## `sync push` runs the same script-shape guard as `config update`
+
+*(since 0.91.0)*
 
 `sync push` now runs `normalize_blocks_codes_script` -- the runtime-safety guard
 `config update` and `transformation edit/create` have always run -- on every
diff --git a/plugins/kbagent/skills/kbagent/references/sync-workflow.md b/plugins/kbagent/skills/kbagent/references/sync-workflow.md
index b7903010..e8836426 100644
--- a/plugins/kbagent/skills/kbagent/references/sync-workflow.md
+++ b/plugins/kbagent/skills/kbagent/references/sync-workflow.md
@@ -489,7 +489,9 @@ the 3-way diff state per config (and per row):
 > stops you loudly instead of losing work. To intentionally drop a local edit,
 > delete the file (or the config directory) and pull.
 
-## Migrating a tree pulled before 0.91.0 (#686)
+## Migrating a legacy sync tree (#686)
+
+*Applies to any tree last pulled before 0.91.0.*
 
 `sync push` used to stamp the manifest baseline from the files on disk while
 `sync pull` / `sync diff` computed it from the API. Any config the two
diff --git a/src/keboola_agent_cli/changelog.py b/src/keboola_agent_cli/changelog.py
index b585aca3..2adde9b0 100644
--- a/src/keboola_agent_cli/changelog.py
+++ b/src/keboola_agent_cli/changelog.py
@@ -89,6 +89,15 @@
         "which beats `KBAGENT_CONFIG_DIR` / the `.kbagent` walk-up / global. Only an "
         "explicit root flag propagates; an env-var or walk-up resolution is left to the "
         "server, which reaches the identical directory on its own.",
+        "New (#625): the plugin gained `/kbagent:setup`, one command that runs first-time "
+        "setup end to end. The documented flow is now `/plugin marketplace add keboola/ai-kit` "
+        "then `/plugin install kbagent@keboola-claude-kit` then `/kbagent:setup`, replacing "
+        "five manual steps spread across a browser, a terminal and Claude Code. It installs "
+        "the CLI when missing (respecting a standalone `install_channel` rather than layering "
+        "a second kbagent over it), connects a project, and verifies with `kbagent doctor`. "
+        "Every step is conditional on a check, so it is idempotent and safe to re-run on a "
+        "half-finished setup, and it never overwrites an existing project or alias. No new "
+        "CLI surface -- it orchestrates existing verbs.",
         "Change (#627): the kbagent Claude Code plugin is now published through the "
         "`keboola-claude-kit` marketplace in `keboola/ai-kit`. Keboola had two competing "
         "marketplaces and no way for a user to tell which was real; this leaves one. Install "