diff --git a/komorebi-for-kde/docs/dev/COMPARE.md b/komorebi-for-kde/docs/dev/COMPARE.md
index a78478f1..ce8ebd71 100644
--- a/komorebi-for-kde/docs/dev/COMPARE.md
+++ b/komorebi-for-kde/docs/dev/COMPARE.md
@@ -1,5 +1,7 @@
 # komorebi for KDE Plasma compared with komorebi for Windows and for macOS
 
+> **STALE (snapshot of 2026-10-27, kfw 173aa802, kfm 125a9a5):** this comparison predates the consolidation. The three programs now share `crates/` (protocol, config, collections, transport, backend, core, settings, komorebic-core) and one `komorebi`, `komorebic`, `komorebi-client` and `komorebi-bar` package, so counts of duplicated commands, messages and keys below are out of date, and `scripts/compare-gen.py` no longer runs against the current tree (it fails with `cannot find '^enum SubCommand'`, because the command definitions moved to `crates/komorebic-core`). For what is shared and what differs on purpose now, read the repository-level [docs/dev/ARCHITECTURE-UNIFIED.md](../../../docs/dev/ARCHITECTURE-UNIFIED.md) and [docs/dev/core-model.md](../../../docs/dev/core-model.md). The platform-difference tables (KWin versus Win32 versus AppKit mechanisms) remain a fair description of the platform layers.
+
 This document compares komorebi for KDE Plasma on KWin and Wayland (kfde) with komorebi for
 Windows (kfw), the original, and komorebi for macOS (kfm). It is written for a reader who knows
 komorebi on one of those two systems and wants to know what is the same on KDE, what is different,
diff --git a/komorebi-for-kde/scripts/compare-gen.py b/komorebi-for-kde/scripts/compare-gen.py
index 5834502a..b49cd5a7 100644
--- a/komorebi-for-kde/scripts/compare-gen.py
+++ b/komorebi-for-kde/scripts/compare-gen.py
@@ -1,6 +1,12 @@
 #!/usr/bin/env python3
 """Generate the tables of docs/dev/COMPARE.md from the source trees.
 
+NOTE (wip-cand4): STALE. The command definitions moved to crates/komorebic-core, the daemons' message
+types to crates/komorebi-protocol and the configuration types to crates/komorebi-config, so the
+readers below (`Tree.commands`, `socket_messages`, `struct_keys`, ...) find nothing and the script
+exits with "cannot find ^enum SubCommand". It runs only against the pre-consolidation checkouts
+named in COMPARE.md. Port it to the crates before using it again, or retire it with COMPARE.md.
+
 komorebi for Windows (kfw), komorebi for macOS (kfm) and komorebi for KDE Plasma (kfde, this
 repository) are read as they are on disk. Nothing in the tables is typed from memory, except the
 small hand-written tables in the NOTES section of this file, which hold what a source file cannot