claude-dev-env 1.64.1 → 1.64.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CLAUDE.md +48 -0
- package/package.json +1 -1
package/CLAUDE.md
CHANGED
|
@@ -86,3 +86,51 @@ When changing how skills, rules, or hooks install or sync in this repo (for exam
|
|
|
86
86
|
- **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.
|
|
87
87
|
- **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).
|
|
88
88
|
- **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.
|
|
89
|
+
|
|
90
|
+
## Serena (Code Intelligence MCP)
|
|
91
|
+
|
|
92
|
+
The `mcp__serena__*` tools expose LSP-level code intelligence for any activated project.
|
|
93
|
+
|
|
94
|
+
### CRITICAL: Call `initial_instructions` first
|
|
95
|
+
Before any coding task, call the `initial_instructions` tool to load the Serena Instructions Manual.
|
|
96
|
+
|
|
97
|
+
### When to use Serena
|
|
98
|
+
- **Symbol declaration** → `mcp__serena__find_declaration`
|
|
99
|
+
- **All references to a symbol** → `mcp__serena__find_referencing_symbols`
|
|
100
|
+
- **Implementations of an interface/class** → `mcp__serena__find_implementations`
|
|
101
|
+
- **Rename across codebase** → `mcp__serena__rename_symbol`
|
|
102
|
+
- **Targeted body replacement / insertion** → `replace_symbol_body`, `insert_after_symbol`, `insert_before_symbol`
|
|
103
|
+
- **Safe symbol removal (no references)** → `mcp__serena__safe_delete_symbol`
|
|
104
|
+
- **File diagnostics** → `mcp__serena__get_diagnostics_for_file`
|
|
105
|
+
|
|
106
|
+
### Tool hierarchy for code navigation
|
|
107
|
+
1. **Serena** — symbol-level navigation (declarations, references, implementations, rename)
|
|
108
|
+
2. **Zoekt MCP** (`mcp__zoekt__*`) — content/text search within indexed repos
|
|
109
|
+
3. **Everything** (`everything_search`) — file-system search by name/path/extension
|
|
110
|
+
4. **Grep/Glob** — fallback pattern matching
|
|
111
|
+
|
|
112
|
+
## Everything Search (MCP Tool)
|
|
113
|
+
|
|
114
|
+
This machine has **Everything (voidtools)** running with an HTTP server on port 54321.
|
|
115
|
+
The `everything_search` MCP tool is available in every session.
|
|
116
|
+
|
|
117
|
+
### Use Everything for file-system searches
|
|
118
|
+
Use `everything_search` for finding files by name, path, extension, size, or date. For content searches within Zoekt-indexed repos, prefer `mcp__zoekt__search` — Everything's `content:` search is the fallback when Zoekt is unavailable or returns nothing.
|
|
119
|
+
|
|
120
|
+
### Fallback order
|
|
121
|
+
1. **Zoekt MCP** (`mcp__zoekt__search`) — content search within indexed repos
|
|
122
|
+
2. **Everything** (`everything_search`) — file-system search by name/path/extension/size/date, and content search outside indexed repos
|
|
123
|
+
3. **Grep** — complex regex content searches if Everything's `content:` returns nothing
|
|
124
|
+
4. **Glob** — precise relative-path pattern matching within the current project
|
|
125
|
+
|
|
126
|
+
### Search syntax quick reference
|
|
127
|
+
- `ext:py` — find by extension (multiple: `ext:ts;js`)
|
|
128
|
+
- `path:src\components` — match against full path
|
|
129
|
+
- `count:10` — limit number of results to 10
|
|
130
|
+
- `*.config.*` — wildcards
|
|
131
|
+
- `size:>10mb` — size filter
|
|
132
|
+
- `dm:today` / `dm:thisweek` — date modified filter
|
|
133
|
+
- `content:keyword` — search inside file contents
|
|
134
|
+
- `parent:node_modules package.json` — match parent folder
|
|
135
|
+
- `foo bar` — AND, `foo | bar` — OR, `!foo` — NOT
|
|
136
|
+
- `"exact phrase"` — literal match
|