docs: enforce IDE MCP tool usage + per-file diagnostics; mvn clean install for overall health

CLAUDE.md

@@ -0,0 +1,43 @@
+# claude-bridge — project instructions
+
+## IDE MCP tools & validation workflow (enforced)
+
+Two IDE MCP servers are connected: **intellij-index** (semantic code intelligence) and
+**jetbrains** (file problems, reformat, debugger). IntelliJ has multiple projects open; our
+module is **`bridged`**. Always pass these to IDE MCP tools:
+
+- `project_path` = `/Users/dai.ha/LTMS/claude-bridge/bridged`
+- IDE paths are relative to `bridged/` (e.g. `src/main/java/dev/ltms/bridged/...`)
+
+### After editing any file — mandatory
+
+1. **`ide_sync_files{paths}`** — the built-in Edit/Write tools write to disk; the IDE index is
+   stale until synced, or IDE nav/refactor/diagnostics give wrong results.
+2. **`ide_diagnostics{file}`** (or `jetbrains get_file_problems`) — clear **all** errors *and*
+   warnings. IDE inspections catch what a build won't (unused params/fields, redundant
+   modifiers, resource leaks, "always same arg", …). These diagnostics are **per-file**.
+3. **`mvn clean install`** (Bash) — required for **overall project health** (clean build + full
+   test run). A per-file-clean file can still break the build or another module. This is the
+   whole-project gate before declaring work done or committing.
+
+### Use IDE MCP tools for navigation, refactoring, and diagnostics only
+
+- **Navigate (prefer over Grep/Read for symbols):** `ide_find_definition`, `ide_find_class`,
+  `ide_find_file`, `ide_find_references`, `ide_find_implementations`, `ide_find_super_methods`,
+  `ide_call_hierarchy`, `ide_type_hierarchy`, `ide_search_text` (regex: `jetbrains
+  search_in_files_by_regex`).
+- **Refactor (prefer over multi-file Edit / rm / mv):** `ide_refactor_rename` (position-based,
+  updates all refs/overrides/tests), `ide_refactor_safe_delete`, `ide_move_file`,
+  `jetbrains reformat_file`.
+- **Diagnose:** `ide_diagnostics` / `jetbrains get_file_problems`.
+
+### Do NOT route build/test/one-offs through the IDE
+
+Keep `mvn` (compile/test/package/`clean install`) and **all** one-off shell commands on **Bash**.
+Do not use `jetbrains build_project`, `execute_run_configuration`, or `execute_terminal_command`
+to replace them.
+
+### Java 25 notes
+
+Prefer the unnamed lambda parameter `_` for required-but-unused params; a non-public
+`static void main(String[])` is valid (JEP 512) and boots via `java -jar`.