docs: strip gitignored AGENTS/ and JOB-BRIEF-FINDINGS references from code comments

Comments in tracked files pointed readers at AGENTS/specs/*.md,
AGENTS.md, and JOB-BRIEF-FINDINGS.md -- all gitignored, transient
dev notes not part of the base repo. Rewrote each to be self-contained
or point at tracked docs (docs/fish-config.md) instead.

tests/test-guards.fish

@@ -141,10 +141,10 @@ set -e __fish_config_opinionated
 section "cascade: C5 logging is opt-in"
 
 # Uses the REAL __fish_config_op_logging name because the opt-in list lives
-# inside the cascade keyed on it. AGENTS.md: "C5 is opt-in (do not 'fix' this)"
-# -- unset or unrecognized means off, and the master switch cannot enable it.
-# If any of these three fail, that is a real defect: record it in
-# JOB-BRIEF-FINDINGS.md, do not repair the guard.
+# inside the cascade keyed on it. C5 logging is opt-in by design (see
+# docs/fish-config.md's "C5 -- Logging and Capture" section): unset or
+# unrecognized means off, and the master switch cannot enable it. If any of
+# these three fail, that is a regression in the guard itself, not the test.
 set -e __fish_config_op_logging __fish_config_opinionated
 
 __fish_config_op_cascade __fish_config_op_logging

tests/test-help.fish

@@ -202,8 +202,8 @@ function test_help_never_executes_destructive_path
 end
 
 # Functions published in the manual that are exempt from the -h/--help
-# rule. Rationale per entry: AGENTS/specs/2026-09-07-header-driven-help-design.md
-# §4. This array is the ONLY machine-readable copy of the exempt set.
+# rule. Rationale per entry is in the EXEMPT-* comments below. This array
+# is the ONLY machine-readable copy of the exempt set.
 #
 # EXEMPT-A -- shadows a same-named binary, or forwards $argv to one named
 # tool that owns its own --help. Intercepting would hide that tool's help,
@@ -228,8 +228,8 @@ function test_every_user_facing_function_has_help
         # manualtools.parse_functions.
         contains -- "# CATEGORY" (string trim -- $lines); or continue
         # Resolve the real defined name; the file stem can disagree with it
-        # (formerly dops.fish defined `docker` -- see JOB-BRIEF-FINDINGS.md
-        # §1, fixed by splitting it into dops.fish and docker.fish).
+        # (formerly dops.fish defined `docker`, fixed by splitting it into
+        # dops.fish and docker.fish).
         set -l name (string match -rg '^\s*function\s+(\S+)' -- $lines)[1]
         test -n "$name"; or continue
         set name (string trim -c "'\"" -- $name)