lsp-refactor

name	lsp-refactor
description	End-to-end safe refactor workflow — blast-radius analysis, speculative preview, apply to disk, verify build, run affected tests. Inlines lsp-impact + lsp-safe-edit + lsp-verify + lsp-test-correlation into one coordinated sequence.
argument-hint	[symbol-or-file] [intent]
user-invocable	true
allowed-tools	mcp__lsp__blast_radius mcp__lsp__preview_edit mcp__lsp__simulate_chain mcp__lsp__get_diagnostics mcp__lsp__run_build mcp__lsp__run_tests mcp__lsp__get_tests_for_file mcp__lsp__apply_edit mcp__lsp__replace_symbol_body mcp__lsp__open_document mcp__lsp__format_document Edit Write
license	MIT
compatibility	Requires the agent-lsp MCP server (github.com/blackwell-systems/agent-lsp)
metadata	{"required-capabilities":"referencesProvider","optional-capabilities":"documentFormattingProvider","tool_permissions":{"phases":{"blast_radius":"[Truncated]","speculative_preview":"[Truncated]","apply":"[Truncated]","build_verification":"[Truncated]","test_execution":"[Truncated]"},"global_forbidden":["mcp__lsp__rename_symbol"]}}

Requires the agent-lsp MCP server.

lsp-refactor

End-to-end safe refactor workflow. Sequences blast-radius analysis, speculative preview, disk apply, build verification, and targeted test execution in one coordinated pass.

This skill does NOT replace lsp-safe-edit or lsp-impact.

• lsp-safe-edit wraps a single edit with before/after diagnostic comparison — use it when you need to make one targeted change with careful error diffing.
• lsp-impact is read-only blast-radius analysis — use it when you want to understand scope before deciding whether to proceed.
• lsp-refactor sequences ALL four workflows (lsp-impact → lsp-safe-edit → lsp-verify → lsp-test-correlation) in order. Use it when you know your target and intent up front and want the complete workflow without switching skills.

---

Input

• target: symbol name in dot notation (e.g. "codec.Encode", "Buffer.Reset") OR file path (e.g. "internal/lsp/client.go")
• intent: description of the change to make (e.g. "rename to ParseConfigV2", "add a second parameter timeout time.Duration")
• workspace_root: absolute path to the workspace root

---

Phase 1 — Blast-Radius Analysis (inlined from lsp-impact)

This phase is mandatory. Do not skip it, even for "small" refactors.

Call mcp__lsp__blast_radius with changed_files set to the file containing the target symbol. If the user provided a file path directly, use it. If the user provided a symbol name, resolve the file first (e.g. via mcp__lsp__go_to_symbol).

mcp__lsp__blast_radius({
  "changed_files": ["/abs/path/to/file"],
  "include_transitive": false
})

Returns:

• affected_symbols — exported symbols with reference counts
• test_callers — test files and enclosing test function names
• non_test_callers — production call sites

Display:

• Affected symbol count
• Test callers (each with enclosing test function name)
• Non-test callers (each with file:line)
• Total reference count

High blast-radius gate: If the total reference count exceeds 20, STOP and ask the user to confirm before continuing: