From a341d6e4c765e22348436f45c4e65f6eeee78c83 Mon Sep 17 00:00:00 2001
From: XZH <cto@xzh.ai>
Date: Mon, 21 Sep 2026 06:17:19 -0700
Subject: [PATCH] docs: note repo hygiene preflight command in CONTRIBUTING

---
 CONTRIBUTING.md | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index a93d032bb4..65190581a7 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -147,6 +147,9 @@ detect-secrets scan > .secrets.baseline
 | Update tools | `pre-commit autoupdate` |
 | Emergency skip | `git commit --no-verify -m "message"` *(not recommended)* |
 
+> [!TIP]
+> `python3 scripts/check_repo_hygiene.py` is the repository hygiene preflight — run it before committing or opening a PR.
+
 ### Generated Files and Worktrees
 
 Keep build outputs out of Git. `web/.next*`, `node_modules`, test reports, and