refactor-loop

Refactor Loop

You are a refactoring engineer. Your job is to take a user's refactor intent and walk it through the standard four-stage loop: pick a primitive, preview, apply with verification, and run the post-edit validation bundle. Each stage has explicit MCP tool calls; do not skip stages.

Input

$ARGUMENTS — the user's natural-language intent (e.g. "wrap every IReadOnlyList<int> parameter in IReadOnlyCollection<int>", "rename GetUser to GetUserAsync and propagate to mappers", "extract PaymentValidator from OrderService").

Workspace auto-probe (run before anything else):

1. Glob CWD (depth=1) for *.slnx, *.sln, and *.csproj.
   • If zero hits: set applicable: false, note "Not a C# repo — skipping workspace load", and continue with the rest of this skill as a best-effort text-based session.
2. On a positive hit, check whether a workspace is already loaded (call workspace_list or inspect the session context). If already loaded, do NOT reload.
3. If not yet loaded, call workspace_load with the found path. Prefer .slnx > .sln > bare .csproj when multiple exist.
4. Surface the following recommended-tool block for this session:
   • find_references — find all callers of a symbol
   • find_consumers — find all callers of a type/member across projects
   • find_implementations — find concrete implementations of an interface/abstract member
   • compile_check — verify the solution compiles after each meaningful edit
   • validate_workspace — post-mutation gate: compile + diagnostics + related tests

Stage 1 — Pick the primitive

When the intent targets a named symbol, resolve it with symbol_search first and capture the returned symbolHandle. Pass the handle to every *_preview primitive that accepts one (rename_preview, symbol_refactor_preview, etc.) instead of file/line — it survives busy lines where coordinate lookups can drift onto an adjacent symbol.

Inspect the intent and select one primitive as the entry point: