From 69032ce5b5e1e1054247e3d5142f112060b2ecc8 Mon Sep 17 00:00:00 2001
From: ArchonVII <josephmaguirre@gmail.com>
Date: Thu, 4 Jun 2026 22:20:53 -0500
Subject: [PATCH] feat(examples): add doc-orphan-detector caller template (#46)

---
 examples/doc-orphan-detector.yml | 25 +++++++++++++++++++++++++
 1 file changed, 25 insertions(+)
 create mode 100644 examples/doc-orphan-detector.yml

diff --git a/examples/doc-orphan-detector.yml b/examples/doc-orphan-detector.yml
new file mode 100644
index 0000000..763e1f9
--- /dev/null
+++ b/examples/doc-orphan-detector.yml
@@ -0,0 +1,25 @@
+# Copy to `.github/workflows/doc-orphan-detector.yml`. Runs weekly (Mon 07:00 UTC).
+#
+# The doc-sweep gh-cron backstop (spec §4.7): for every branch with no open PR it
+# opens or updates a tracking issue listing committed allow-list docs whose newest
+# touching commit is older than `stale-hours`. Detection only — never commits or
+# pushes, and reports paths only (file contents are never read).
+
+name: Doc Orphan Detector
+
+on:
+  schedule:
+    - cron: "0 7 * * 1"
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  issues: write
+
+jobs:
+  detect:
+    uses: ArchonVII/github-workflows/.github/workflows/doc-orphan-detector.yml@v1
+    # with:
+    #   stale-hours: 12
+    #   base-label: doc-orphan
+    #   default-branch: main