diff --git a/CLAUDE.md b/CLAUDE.md
index 297808a..510897a 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -16,3 +16,8 @@ See `docs/yino-fsd.md` for the full functional specification and changelog.
 - Minimize dependencies, less is more; discuss with owner before adding any
 - Never install global Python packages; use a venv in this repository when Python dependencies are needed (e.g.
   `python3 -m venv venv && source venv/bin/activate && pip install ...`)
+
+## Upstream tracking
+
+- When re-analyzing or updating `docs/Omarchy.md`, always update the "Last analyzed" line at the top of the
+  document with the current date and the latest commit hash from `basecamp/omarchy` (`dev` branch).
diff --git a/docs/Omarchy.md b/docs/Omarchy.md
index ae3bbd0..9eb6be5 100644
--- a/docs/Omarchy.md
+++ b/docs/Omarchy.md
@@ -1,5 +1,7 @@
 # Omarchy Analysis
 
+> **Last analyzed:** 2026-02-16 · basecamp/omarchy @ `463417a` (`dev` branch)
+
 A comprehensive reference document analyzing the upstream Omarchy project and its ecosystem, serving as a
 blueprint for the Yino (Debian-based) port.