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.

functions/__fish_config_sync_logging.fish

@@ -54,7 +54,7 @@ function __fish_config_sync_logging --description 'Sync C5 logging state: sentin
     # function carried its own inferior copy (tee instead of a PTY, no
     # progress-bar rendering, hard-coded /usr/bin/paru|yay), which fought
     # the canonical generator for the wrapper file on every version-marker
-    # mismatch. See startup-latency-JOB-BRIEF-FINDINGS.md §2.
+    # mismatch.
     #
     # Routed through _fish_source_scoped: both files `return` early on
     # several guard checks, and a sourced `return` exits the *calling*

functions/__fish_help_header.fish

@@ -67,8 +67,8 @@ function __fish_help_header --argument-names name
     # accurate at runtime: in dops.fish it finds the header above
     # `function docker` rather than attributing it to the file stem.
     # One blank separator line is tolerated -- sponge_filter_secrets.fish
-    # is the only file that has one, and JOB-BRIEF-FINDINGS.md records it
-    # so this skip is not mistaken for dead code.
+    # is the only file that has one. Do not remove this tolerance as dead
+    # code.
     set -l lines (string split \n -- (command cat $file))
     set -l pat '^\s*function\s+'(string escape --style=regex -- $name)'(\s|$)'
     set -l start 0