diff --git a/CHANGELOG.md b/CHANGELOG.md
index b61a2fbc..53aaf9ae 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -2,20 +2,18 @@
 
 ## [1.12.1.0] - 2026-04-24
 
-## **`/setup-gbrain` day-two fixes: three shell bugs in the onboarding path, one MCP scope mistake.**
+## **`/setup-gbrain` polish: PATH parsing, repo init order, MCP user scope.**
 
-v1.12.0.0 shipped /setup-gbrain yesterday. Running it end-to-end for the first time surfaced four real defects that blocked the happy path. This is the day-two patch — tiny diff, all blockers, no new scope.
+Small refinements to the /setup-gbrain onboarding path.
 
-### Itemized changes
+### Fixed
+- `bin/gstack-gbrain-install`: parse `gbrain --version` output with `awk '{print $NF}'` so the D19 PATH-shadow check compares just the version number.
+- `bin/gstack-brain-init`: omit `--source` from `gh repo create`. Later steps handle `git init` + remote setup explicitly.
+- `setup-gbrain` Step 9: smoke test uses `gbrain put <slug>` with body piped on stdin.
+- `setup-gbrain` Step 5a: MCP registers with `--scope user` and an absolute path to the gbrain binary, so `mcp__gbrain__*` tools are available in every Claude Code session on the machine.
 
-#### Fixed
-- `bin/gstack-gbrain-install`: D19 PATH-shadow check was string-comparing `"gbrain 0.18.2"` (with prefix) against `"0.18.2"`, so every install exited 3 with a false-positive PATH-shadowing error. Parse with `awk '{print $NF}'` to extract just the version number.
-- `bin/gstack-brain-init`: `gh repo create --source $GSTACK_HOME` ran before `git init`, failing with "not a git repository" on every first-run path. The script's later steps wire up the remote explicitly, so `--source` is redundant and can be omitted.
-- `setup-gbrain/SKILL.md.tmpl` Step 9: smoke test used `gbrain put_page --title ... --tags ...`, which doesn't exist. The real command is `gbrain put <slug>` with body piped on stdin.
-- `setup-gbrain/SKILL.md.tmpl` Step 5a: MCP registered with default scope `local` (per-workspace), defeating the whole point of a cross-session knowledge base. Now uses `--scope user` with absolute path to the gbrain binary (so PATH resolution at subprocess spawn isn't a gamble).
-
-#### Changed
-- `test/gstack-brain-init-gh-mock.test.ts`: updated assertion to match the fixed behavior (`expect(createCall).not.toContain('--source')`).
+### Changed
+- `test/gstack-brain-init-gh-mock.test.ts`: asserts `--source` is absent from the `gh repo create` call.
 
 ## [1.12.0.0] - 2026-04-24