gitnexus-refactoring

Map symbol dependents and execution flows to refactor code across files.

Updated Mar 5, 2026
One-click install
npx skills add https://github.com/truongnat/emplus --skill gitnexus-refactoring-truongnat
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gitnexus-refactoring
Source: https://github.com/truongnat/emplus/tree/main/.claude/skills/gitnexus/gitnexus-refactoring
Command: npx skills add https://github.com/truongnat/emplus --skill gitnexus-refactoring-truongnat

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents risky refactors by mapping symbol relationships and planned update order across dependent code paths, so renames, extracts, splits, and moves don’t silently break callers or tests.

Core Features & Use Cases

  • Safe rename across files: Automatically renames symbols while separating high-confidence graph edits from lower-confidence AST edits for careful review.
  • Impact-aware restructuring: Finds upstream/downstream dependents and execution flows that involve the target, helping you update interfaces, implementations, and callers in the right sequence.
  • Change verification: Detects and summarizes affected files, symbols, and processes after the refactor to reduce scope surprises.
  • Use Case: You need to rename a validation function that is referenced by middleware and tests; use impact mapping, rename with dry-run review, then verify changes and run the affected flows.

Quick Start

Ask the AI to refactor safely by renaming the target symbol, mapping its dependents, applying the edits, and then verifying the changed scope and running the relevant tests.

Frequently Asked Questions about gitnexus-refactoring

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I safely rename a function across multiple files without breaking callers?

To safely rename a function across multiple files, this Skill maps symbol dependents and execution flows, separating high-confidence graph edits from lower-confidence AST edits for careful review. It ensures interfaces, implementations, callers, and tests are updated in a controlled order to prevent breaking callers.

What's the best way to extract logic into a module without missing dependencies?

The best way to extract logic into a module without missing dependencies is using impact-aware restructuring. This process finds upstream and downstream dependents involving the target, helping you update interfaces, implementations, and callers in the right sequence to avoid scope surprises.

How does impact analysis work when splitting services in an existing codebase?

Impact analysis for splitting services works by mapping symbol relationships and planned update order across dependent code paths. It uses impact, context, and query steps to find upstream and downstream dependents, ensuring interconnected call graphs are updated safely.

Can I verify code changes and run affected tests after a multi-file refactor?

Yes, you can verify code changes and run affected tests after a multi-file refactor. The Skill includes change detection verification that detects and summarizes affected files, symbols, and processes to reduce scope surprises and ensure tests are updated.

Does this refactoring approach work for moving code and reorganizing files with interconnected call graphs?

Yes, this refactoring approach works for moving code and reorganizing files with interconnected call graphs. It applies to restructuring code across an existing codebase by mapping symbol dependents and execution flows to ensure safe multi-file refactoring.

Why do I need change detection verification when renaming classes or functions?

You need change detection verification when renaming classes or functions to prevent risky refactors. It detects and summarizes affected files, symbols, and processes after the refactor, reducing scope surprises and ensuring callers and tests are not silently broken.