diff --git a/docs/systems/desktop.md b/docs/systems/desktop.md
index 0c44d0a8..6297d3c6 100644
--- a/docs/systems/desktop.md
+++ b/docs/systems/desktop.md
@@ -751,11 +751,11 @@ output: dist-electron
 
 ### Icon Generation
 
-**`scripts/gen-icns.sh`** — macOS-only, generates `.icns` from `icon.png` via:
-1. `sips` to resize into all required icon sizes (16-1024px, including @2x variants)
-2. `iconutil -c icns` to pack the iconset
+All desktop and web brand assets are generated by `scripts/gen-icons.mjs` from three SVG sources in `assets/brand/` (`app-icon.svg`, `mark.svg`, `mark-mono-dark.svg`). Run via `pnpm gen-icons` after artwork changes; commit the diff. The generator uses `sharp` (SVG → PNG), `png-to-ico` (multi-size `.ico`), and `png2icons` (`.icns`). Output is byte-stable for a given lockfile.
 
-Used in `pnpm dev` to set the dev Electron icon.
+The `dev` script copies the committed `build/icon.icns` into Electron's bundled `Resources/electron.icns` so the macOS dev dock shows the Backspace mark instead of the default Electron logo. This dev-only patch is independent of how `.icns` is generated.
+
+See [the icon system spec](../superpowers/specs/2026-04-27-icon-system-design.md) for the full output matrix and `scripts/gen-icons.README.md` for the regeneration workflow and version-bump caveat.
 
 ### Auto-Update Publishing