claude-dev-env 1.64.1 → 1.64.3

package/CLAUDE.md

@@ -86,3 +86,49 @@ When changing how skills, rules, or hooks install or sync in this repo (for exam
 - **task_scope:** Match every action to what was explicitly requested. When intent is ambiguous, research official docs and present options via AskUserQuestion before making any changes. Proceed with edits only on explicit instruction.
 - **confirm_implementation_forks:** When two or more viable paths would satisfy the goal and the choice changes the deliverable — its scope, completeness, deferred work, dependencies, or a hard-to-reverse contract — stop and ask which path via AskUserQuestion before implementing. A path that defers work or leaves a placeholder creating a follow-up task is itself a fork to surface, not a default to take silently. Phrase the question in plain language with only the detail needed to decide. See [`confirm-implementation-forks`](rules/confirm-implementation-forks.md).
 - **disambiguate_overloaded_terms:** When a word in the request has two different technical meanings — "conflict" (git-merge versus functional/behavioral), "sync" (fast-forward versus commit), and the like — confirm which one is meant via AskUserQuestion before analyzing or acting.
+
+## Serena (Code Intelligence MCP)
+
+The `mcp__serena__*` tools expose LSP-level code intelligence for any activated project.
+
+### CRITICAL: Call `initial_instructions` first
+Before any coding task, call the `initial_instructions` tool to load the Serena Instructions Manual.
+
+### When to use Serena
+- **Symbol declaration** → `mcp__serena__find_declaration`
+- **All references to a symbol** → `mcp__serena__find_referencing_symbols`
+- **Implementations of an interface/class** → `mcp__serena__find_implementations`
+- **Rename across codebase** → `mcp__serena__rename_symbol`
+- **Targeted body replacement / insertion** → `replace_symbol_body`, `insert_after_symbol`, `insert_before_symbol`
+- **Safe symbol removal (no references)** → `mcp__serena__safe_delete_symbol`
+- **File diagnostics** → `mcp__serena__get_diagnostics_for_file`
+
+### Tool hierarchy for code navigation
+1. **Serena** — symbol-level navigation (declarations, references, implementations, rename)
+2. **Everything** (`everything_search`) — file-system search by name/path/extension
+3. **Grep/Glob** — content and pattern matching
+
+## Everything Search (MCP Tool)
+
+This machine has **Everything (voidtools)** running with an HTTP server on port 54321.
+The `everything_search` MCP tool is available in every session.
+
+### Use Everything for file-system searches
+Use `everything_search` for finding files by name, path, extension, size, or date. For content searches, use Grep — Everything's `content:` search is a fallback when Grep returns nothing.
+
+### Fallback order
+1. **Everything** (`everything_search`) — file-system search by name/path/extension/size/date, and content search
+2. **Grep** — complex regex content searches if Everything's `content:` returns nothing
+3. **Glob** — precise relative-path pattern matching within the current project
+
+### Search syntax quick reference
+- `ext:py` — find by extension (multiple: `ext:ts;js`)
+- `path:src\components` — match against full path
+- `count:10` — limit number of results to 10
+- `*.config.*` — wildcards
+- `size:>10mb` — size filter
+- `dm:today` / `dm:thisweek` — date modified filter
+- `content:keyword` — search inside file contents
+- `parent:node_modules package.json` — match parent folder
+- `foo bar` — AND, `foo | bar` — OR, `!foo` — NOT
+- `"exact phrase"` — literal match

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "claude-dev-env",
-    "version": "1.64.1",
+    "version": "1.64.3",
     "description": "Claude Code development standards — rules, hooks, agents, commands, and skills",
     "type": "module",
     "bin": {