From a9737b0bfd6a9ced150c4a3fe3c1608a2e8eba94 Mon Sep 17 00:00:00 2001
From: JSONbored <49853598+JSONbored@users.noreply.github.com>
Date: Fri, 3 Jul 2026 02:48:23 -0700
Subject: [PATCH] docs(selfhost): clarify checkRunMode duplicates the required
 gate check

Document that the checkRunMode advisory check surface is independent of,
and largely duplicative with, the required Gittensory Orb Review Agent
gate check and the PR comment, so one-shot self-host installs know to
leave it at its default off unless they specifically want a second,
low-detail check-run surface.

Closes #2691
---
 .gittensory.yml.example | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/.gittensory.yml.example b/.gittensory.yml.example
index 942d37e90d..bc269a0bb0 100644
--- a/.gittensory.yml.example
+++ b/.gittensory.yml.example
@@ -267,6 +267,13 @@ settings:
   publicSignalLevel: standard
 
   # Publish a GitHub check-run. off | enabled. Default: off.
+  # Independent, legacy advisory surface (#2691) -- separate from, and not gated
+  # by, the required `Gittensory Orb Review Agent` gate check under `gate:`
+  # above. At the default `checkRunDetailLevel: minimal` below it posts no
+  # findings at all; at standard/deep it only re-renders findings already shown
+  # in the gate check and the PR comment. One-shot self-host installs should
+  # leave this at the default `off` unless you specifically want a second,
+  # low-detail check-run surface alongside the required gate check.
   checkRunMode: off
 
   # Check-run detail. minimal | standard | deep. Default: minimal.