docs(functions): standardize all function doc blocks to UNIX man-page style

Replace all ad-hoc inline comments between license headers and function
declarations with consistent SYNOPSIS / DESCRIPTION / ARGUMENTS / RETURNS /
EXAMPLE blocks across all 99 project-owned functions/ files. No executable
logic, variable names, or exit codes were modified.

Completes Task #6 from AGENTS.md (Retroactive Function Documentation
Standardization).

functions/claude-pr.fish

@@ -1,7 +1,16 @@
 # Copyright (C) 2026 Rootiest
 # SPDX-License-Identifier: AGPL-3.0-or-later
 
-# Create a new git branch, commit, push, and PR using Claude-code
+# SYNOPSIS
+#   claude-pr
+#
+# DESCRIPTION
+#   Invokes Claude Code to perform a full PR workflow: create a kebab-case
+#   branch, write a Conventional Commit, run verification, push, and open a
+#   pull request with a manual verification checklist.
+#
+# EXAMPLE
+#   claude-pr
 function claude-pr --description 'Claude-code: New branch, commit, push, and PR'
     claude "Act as a senior engineer. Execute this sequence: 1. Create a new git branch (kebab-case). 2. Stage changes and write a Conventional Commit message. 3. Self-verify the changes by running relevant build/test commands or linting. 4. Push to remote. 5. Create a PR to 'main' including a summary of changes and a 'Manual Verification' section containing a Markdown checklist (- [ ]) of specific, bite-sized steps required to manually verify the functionality."
 end