linter

CLAUDE.md

@@ -55,6 +55,26 @@ cmake --build build --clean-first
 
 **Important:** The build directory is `/Users/sergio/Gitea/jaildoctors_dilemma/build` and the output executable is placed in the project root directory.
 
+### Linter (clang-tidy)
+
+**IMPORTANT:** Always run the linter on specific files, NOT on the entire project, to avoid long execution times and errors in unrelated files.
+
+```bash
+# Analyze a specific file (RECOMMENDED)
+tools/linter/run_clang-tidy.sh source/game/entities/player.cpp
+
+# Analyze multiple specific files
+tools/linter/run_clang-tidy.sh source/game/entities/player.cpp source/game/entities/enemy.cpp
+
+# Apply fixes automatically to a specific file
+tools/linter/run_clang-tidy.sh --fix source/game/entities/player.cpp
+
+# Analyze entire project (SLOW, may have errors in defaults.hpp)
+tools/linter/run_clang-tidy.sh
+```
+
+**Note:** Running the linter on the entire project can produce errors in files like `defaults.hpp` that are unrelated to your changes. Always target specific files you're working on.
+
 ---
 
 ## 1. High-Level Architecture Overview