diff --git a/README.md b/README.md
index d048e705a..e7d555ffb 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,12 @@
+> [!WARNING]
+> **NPM PUBLISH FIX FOR v1.32.0**
+> If `npx get-shit-done-cc@latest` does not resolve to v1.32.0, install directly from source:
+> ```bash
+> git clone https://github.com/gsd-build/get-shit-done && cd get-shit-done
+> node scripts/build-hooks.js && node bin/install.js --claude --global
+> ```
+> See **[docs/manual-update.md](docs/manual-update.md)** for all runtime flags and update instructions.
+
 <div align="center">
 
 # GET SHIT DONE
diff --git a/docs/README.md b/docs/README.md
index 8fb9b2430..609c4240d 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -13,14 +13,14 @@ Language versions: [English](README.md) · [Português (pt-BR)](pt-BR/README.md)
 | [Command Reference](COMMANDS.md) | All users | Every command with syntax, flags, options, and examples |
 | [Configuration Reference](CONFIGURATION.md) | All users | Full config schema, workflow toggles, model profiles, git branching |
 | [CLI Tools Reference](CLI-TOOLS.md) | Contributors, agent authors | `gsd-tools.cjs` programmatic API for workflows and agents |
-| [Agent Reference](AGENTS.md) | Contributors, advanced users | All 15 specialized agents — roles, tools, spawn patterns |
+| [Agent Reference](AGENTS.md) | Contributors, advanced users | All 18 specialized agents — roles, tools, spawn patterns |
 | [User Guide](USER-GUIDE.md) | All users | Workflow walkthroughs, troubleshooting, and recovery |
 | [Context Monitor](context-monitor.md) | All users | Context window monitoring hook architecture |
 | [Discuss Mode](workflow-discuss-mode.md) | All users | Assumptions vs interview mode for discuss-phase |
 
 ## Quick Links
 
-- **What's new in v1.28:** Forensics, milestone summary, workstreams, assumptions mode, UI auto-detect, manager dashboard
+- **What's new in v1.32:** STATE.md consistency gates, `--to N` autonomous flag, research gate, verifier scope filtering, read-before-edit guard, 4 new runtimes (Trae, Kilo, Augment, Cline), context reduction, response language config — see [CHANGELOG](../CHANGELOG.md)
 - **Getting started:** [README](../README.md) → install → `/gsd-new-project`
 - **Full workflow walkthrough:** [User Guide](USER-GUIDE.md)
 - **All commands at a glance:** [Command Reference](COMMANDS.md)