Merge pull request InsightSoftwareConsortium#5999 from hjmjohnson/common-code-pitfals-md

DOC: Add compiler-cautions.md — compiler-specific pitfalls from 10 years of COMP: commits

Author: hjmjohnson

.clang-tidy

@@ -9,7 +9,7 @@
 # % clang-tidy --version                                                                                                (clang-tidy-new-cast↓1↑7|⚑5✔)
 #   Homebrew LLVM version 20.1.6                        # <- Version of clang-tidy used to create this file
 ---
-Checks:          'clang-diagnostic-*,clang-analyzer-*,*'
+Checks:          'clang-diagnostic-*,clang-analyzer-*,*,-llvmlibc-*,-modernize-use-trailing-return-type,-readability-redundant-member-init'
 WarningsAsErrors: ''
 HeaderFileExtensions:
   - ''
@@ -433,7 +433,7 @@ CheckOptions:
   readability-function-size.VariableThreshold: none
   readability-identifier-length.IgnoredExceptionVariableNames: '^[e]$'
   readability-identifier-length.IgnoredLoopCounterNames: '^[ijk_]$'
-  readability-identifier-length.IgnoredParameterNames: '^[n]$'
+  readability-identifier-length.IgnoredParameterNames: '^[ijknxyzrgbav]$'
   readability-identifier-length.IgnoredVariableNames: ''
   readability-identifier-length.MinimumExceptionNameLength: '2'
   readability-identifier-length.MinimumLoopCounterNameLength: '2'

AGENTS.md

@@ -15,8 +15,9 @@ Load only what your task requires:
 | Writing or running tests | [./Documentation/AI/testing.md](./Documentation/AI/testing.md) |
 | Code style, naming conventions | [./Documentation/AI/style.md](./Documentation/AI/style.md) |
 | Writing ITK C++ classes, CMake build configuration, and Python wrapping configuration | [./Documentation/AI/conventions.md](./Documentation/AI/conventions.md) |
-| Creating a git commit | [./Documentation/AI/git-commits.md](./Documentation/AI/git-commits.md) |
+| Creating a git commit with C++ changes | [./Documentation/AI/git-commits.md](./Documentation/AI/git-commits.md), [./Documentation/AI/compiler-cautions.md](./Documentation/AI/compiler-cautions.md), [./Documentation/AI/building.md](./Documentation/AI/building.md), [./Documentation/AI/testing.md](./Documentation/AI/testing.md) |
 | Opening or updating a pull request | [./Documentation/AI/pull-requests.md](./Documentation/AI/pull-requests.md) |
+| Avoiding compiler-specific pitfalls and refactoring hazards | [./Documentation/AI/compiler-cautions.md](./Documentation/AI/compiler-cautions.md) |
 
 ## Critical Pitfalls