feat: add filename linter and AI coding guidelines (#1477)

Add a configurable filename linter to enforce naming conventions and an AGENTS.md to guide
AI coding agents in following project conventions.

The guidelines steer code generation; the linter independently verifies filename compliance.
Together, they improve consistency and reduce unnecessary files and review effort.

Conflicting file names were renamed.

Signed-off-by: Bobby Noelte <b0661n0e17e@gmail.com>

.pre-commit-config.yaml

@@ -1,3 +1,4 @@
+default_stages: [pre-commit]
 # Exclude some file types from automatic code style
 exclude: \.(json|csv)$
 repos:
@@ -29,6 +30,16 @@ repos:
       # Run the formatter
       - id: ruff-format
 
+  - repo: local
+    hooks:
+    # Run EOS custom file name linter
+    - id: eos-filename-linter
+      name: EOS filename linter
+      entry: uv run --locked --exact --extra dev python scripts/lint_filenames.py
+      language: system
+      types: [python]
+      pass_filenames: true
+
   # --- Static type checking ---
   - repo: local
     hooks: