From 7fccdbeeca4e916619c19e07019f86132ac2992d Mon Sep 17 00:00:00 2001 From: Dai Ha Date: Mon, 13 Jul 2026 13:45:20 +0200 Subject: [PATCH] docs: enforce IDE MCP tool usage + per-file diagnostics; mvn clean install for overall health --- CLAUDE.md | 43 +++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 43 insertions(+) create mode 100644 CLAUDE.md diff --git a/CLAUDE.md b/CLAUDE.md new file mode 100644 index 0000000..e299d7f --- /dev/null +++ b/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`.