docs: stop claiming tracker-tag/comment-block lint are non-required

.forgejo/workflows/ci.yml

@@ -34,11 +34,9 @@ jobs:
       - uses: actions/checkout@v3
       - name: lint
         # Flags hash-number tracker tags in source (hive convention is
-        # prose, not tags — /knowledge/hive-rules.md). Runs as its own
+        # prose, not tags — /knowledge/hive-rules.md). Its own job, and
-        # job, kept out of the required checks while the legacy backlog
+        # IS a required check on the forge (branch protection) — a hit
-        # is cleaned up: a hit fails this check (red) without blocking
+        # blocks merge. See scripts/check-issue-refs.sh.
-        # merge. Promote to a required check once the tree is clean.
-        # See scripts/check-issue-refs.sh.
         run: sh scripts/check-issue-refs.sh
 
   comment-blocks:
@@ -51,7 +49,7 @@ jobs:
       - name: lint
         # Flags contiguous comment blocks over 30 lines (a giant prose
         # block belongs in docs/ as implementation notes, not in source).
-        # Own job, kept out of required checks while the tree settles: a
+        # Own job, and IS a required check on the forge (branch
-        # hit reds this check without blocking merge. Promote to required
+        # protection) — a hit blocks merge. See
-        # once clean. See scripts/check-comment-blocks.sh.
+        # scripts/check-comment-blocks.sh.
         run: sh scripts/check-comment-blocks.sh

scripts/check-comment-blocks.sh

@@ -5,9 +5,8 @@
 # comments stay, walls of text move out. See the hive convention in #2077.
 #
 # Emits a CI error annotation per offending block and exits 1 if any block
-# exceeds MAX. Runs as its own CI job, kept OUT of the required checks while
+# exceeds MAX. Runs as its own CI job and IS a required check on the forge
-# the tree settles: a hit turns the job red (visible, non-blocking) without
+# (branch protection) — a hit blocks merge.
-# blocking merge. Promote to required once the tree is clean.
 #
 # Scope: tracked *.rs *.nix *.sh *.js *.ts *.css *.html. Markdown is exempt
 # (it is prose by nature). Comment forms: `#` line comments (nix/sh), `//`

scripts/check-issue-refs.sh

@@ -5,11 +5,8 @@
 # targets and leak tracker coupling into the source tree.
 #
 # Emits a CI error annotation per hit and exits 1 if any tag is found,
-# 0 otherwise. It runs as its own CI job, deliberately kept OUT of the
+# 0 otherwise. It runs as its own CI job and IS a required check on the
-# required checks while the legacy backlog is cleaned up: a hit turns
+# forge (branch protection) — a hit blocks merge.
-# the job red (a visible, non-blocking signal on the PR) without
-# blocking merge. Promote it to a required check once the tree is clean
-# to make it a hard gate — no code change, just branch-protection.
 #
 # Scope: tracked *.rs *.nix *.js *.ts *.css *.html. Markdown is exempt
 # (prose docs may legitimately cite the tracker). The pattern matches a