From 7b9b696874d1818d31816fb425937caad9e0c3bb Mon Sep 17 00:00:00 2001
From: grok-bot-andresmgsl <grok-bot-andresmgsl@users.noreply.github.com>
Date: Sat, 18 Jul 2026 17:45:04 +0000
Subject: [PATCH] docs: document org-wide repo scope and auto-discovery

---
 docs/ORG_SCOPE.md | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)
 create mode 100644 docs/ORG_SCOPE.md

diff --git a/docs/ORG_SCOPE.md b/docs/ORG_SCOPE.md
new file mode 100644
index 0000000..af3493c
--- /dev/null
+++ b/docs/ORG_SCOPE.md
@@ -0,0 +1,21 @@
+# Organization scope
+
+The watcher monitors **every repository** under [github.com/heavy-duty](https://github.com/heavy-duty).
+
+Discovery is **search-based** (`gh search … --owner heavy-duty`), so new org repos are included automatically — no allowlist edit required.
+
+As of 2026-07-18 the org includes (non-exhaustive snapshot):
+
+- platform, box, rig, cast, infra, handbook, incubator
+- bulldozer, bulldozer-examples, wallet-adapter, nx-anchor, anchor
+- znap (+ example, shuttle, tokio, hats)
+- solana-utils, spl-utils, calculate-leaderboard
+- drill-* actions, bounty-program helpers
+- metaplex-series, nft-as-a-wallet, solfate-images, solana-colombia-hacker-house-bounty-program
+- .github
+
+Refresh anytime:
+
+```bash
+gh api orgs/heavy-duty/repos --paginate --jq '.[].full_name' | sort
+```