| name | refactoring-code |
| description | Use when semantic refactoring is needed in Rider-supported solutions and projects, including .NET/C#, F#, VB, C++, Unity, Unreal Engine, XAML, Razor, and other GameDev or mixed-language projects. Trigger when edits must update declarations and usages across IDE-resolved references — rename symbols, move types or namespaces, safe-delete unused code, extract interface/base class/method, change signatures, or reorganize namespaces. Do not use for file-only moves, config keys, strings, comments, prose-only edits, generated output, or logic changes with unchanged names/signatures. |
| allowed-tools | execute_tool |
| metadata | {"author":"JetBrains"} |
Code Refactoring
Rider/ReSharper-driven semantic refactorings across solutions opened in Rider. Each tool resolves the target through the IDE's reference index and rewrites every affected site — language-aware usages such as nameof, XML-doc <see cref>, XAML x:Name, Razor, C++/Unreal references, and ordinary references that grep cannot resolve — instead of a grep + text replace.
Invoking a tool
Always call a refactoring tool through execute_tool — direct calls are not routed:
execute_tool(command="<tool> --arg value [--flag true]")
reference/tools.md lists every available tool; the linked reference/tools/<tool>.md gives the exact parameters, response shape, outcomes, and error kinds for the one tool you are about to call. Read only that one — do not pre-load the whole tree.
Shared rules
- Prefer the MCP tool. It resolves references semantically across the solution; a text edit cannot. On any error you cannot fix by adjusting the input, or when
execute_tool is unavailable, fall back to a text-based edit.
- Trust the success signal. When a tool reports success, do not re-read the mutated files to verify. When a tool reports a count of touched/affected sites, a value of 1 for a type, method, property, field, or namespace is suspicious (declaration only, no callers) — surface it to the user.
- Do not retry blindly. Adjust the arguments (query, name, file path, namespace, member selection) between calls; a second identical call fails the same way.
- Argument hygiene. Parameter names are camelCase — hyphenated variants like
--new-name are rejected. Pass real values or omit optional parameters entirely; never encode an omitted value with a placeholder such as "", "/", "__omit__", or a fake path. Treat file paths and identifiers as opaque: copy them from search_* / get_symbol_info output (solution-relative, / separators) rather than synthesizing them.
- Library / external symbols cannot be refactored — the change must be made upstream. Confirm with the user.
Preview before applying
When a tool offers an analysis-only mode — rename's --preview true (the older --dryRun is a deprecated alias) returns the blast radius in affects without mutating files — use it first for:
- public / protected API changes;
- targets with many call sites or cross-language references (XAML, Razor, C++/Unreal,
<see cref>);
- any change where the user signalled hesitation.
Audit affects, then re-issue without --preview to apply. Preview resolves the symbol and counts usages only — it does not run conflict analysis, so a clean preview can still come back with conflicts on apply. Which tools expose an analysis mode is documented per tool in the reference; a tool without one (e.g. a namespace move) applies directly and reports no blast-radius counts, so for a high-impact call narrate what you are about to change before issuing it.
Conflicts and ambiguity
Tools that rewrite or remove use sites (rename, safe-delete, the extract family) can refuse the operation and report conflicts; a symbol query can also match more than one candidate (ambiguous). Both come back in the tool's response — see its reference file for the exact fields. A non-empty conflicts list always means no files were touched.
Each conflict entry is {kind, file, context}: kind mirrors ReSharper's ConflictType (snake_case); context is the engine's localized description; file is the first occurrence's path, or null for a textual-only conflict or a clash with a compiled-only symbol.
| Kind | Meaning | Action |
|---|
same_name_conflict | New name collides with an existing member in the same scope. | Pick a different name and retry. |
default_element_conflict | Generic element-level conflict without a more specific category. | Read context; if it names a colliding member, treat like same_name_conflict, else escalate. |
cannot_update_usage_conflict | A call site can't be rewritten safely — downstream code would break. | Escalate to user; do not auto-retry. |
cannot_remove, cannot_delete_safely, cannot_inline_usage_conflict, will_be_removed | Engine refuses to remove/delete/inline/rewrite a use site. | Escalate to user; do not auto-retry. |
not_accessible | The symbol becomes invisible from one or more use sites after the change. | Escalate to user — a visibility regression. |
will_be_made_public | Access widens as a side-effect (e.g. promoted from private). | Narrate the trade-off to the user before retrying. |
hierarchy_conflict | Override/implementation hierarchy clashes with the result. | Escalate to user; cross-type effect. |
text_only, default_conflict, invalid | Generic textual conflict the engine couldn't categorise structurally. | Read context; decide from the message. |
Escalate to the user (instead of auto-deciding) when there are more than 5 conflicts, or any entry is cannot_update_usage_conflict, cannot_remove, cannot_delete_safely, cannot_inline_usage_conflict, will_be_removed, not_accessible, or hierarchy_conflict. For a rename, also escalate when affects.callSites == 0 for a public/protected symbol — it usually means the query resolved to the wrong target.
For ambiguous matches, each candidate carries name, kind, fqn, file, and line. Re-issue with a more specific query — a fully qualified path like Namespace.Type.Method, or Type._field for a private member (bare short-name lookup prioritises type-level entries and misses private fields/methods). The candidate list is capped at 5; if you see 5, the query is too broad — narrow it rather than expecting the full set.
Known limitations
These hold across the toolset and are not reported in tool output:
- String and comment occurrences of an old name or namespace are not updated. Fix them with a regular edit pass afterward.
- XML-doc
<see cref> references: a method rename rewrites <see cref="Type.Method(int, int)"/> to <see cref="NewName"/>, dropping the containing type and parameter list. Surface to the user after method renames and offer a separate edit pass.
- Moving a type does not move its file — only the namespace declaration and references change. If the user also wants the file relocated to match, do that as a separate file operation.
Tool reference
reference/tools.md is the auto-generated index of every tool in the Rider refactoring toolset, each entry linking to its full parameter and response contract. It is regenerated from the live MCP descriptors, so it — not this file — is the source of truth for tool names, signatures, and response shapes. This skill carries only the workflow and judgment the contracts don't.
