gitnexus-refactoring

Plan and execute safe code refactors by mapping blast radius and dependencies.

45.2k|5.0k|Updated Aug 2, 2025
One-click install
npx skills add https://github.com/abhigyanpatwari/GitNexus --skill gitnexus-refactoring-abhigyanpatwari
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gitnexus-refactoring
Source: https://github.com/abhigyanpatwari/GitNexus/tree/main/gitnexus-cursor-integration/skills/gitnexus-refactoring
Command: npx skills add https://github.com/abhigyanpatwari/GitNexus --skill gitnexus-refactoring-abhigyanpatwari

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps engineers plan safe refactors by understanding how changes ripple through the codebase using blast-radius and dependency mapping, reducing risk and manual rework.

Core Features & Use Cases

  • Impact analysis: map dependents and affected modules before changes.
  • Context queries: inspect incoming/outgoing references for a symbol.
  • Refactor workflow: coordinate rename, extract, split, or move operations with checklists and safe sequencing.
  • Automatic guidance: recommended update order: interfaces → implementations → callers → tests.

Quick Start

Begin by mapping dependencies with impact to identify affected areas, then review references with context, and execute the planned updates in the recommended order.

Frequently Asked Questions about gitnexus-refactoring

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

FAQPage Schema
How do I analyze the blast radius of a code refactor before making changes?

Blast-radius analysis maps dependents and affected modules before executing refactors. It reveals how changes ripple across interdependent components, reducing risk and manual rework during symbol renames, module extractions, splits, or file moves.

What is the safest update order for executing module extractions and symbol renames?

The recommended update order for safe refactoring is interfaces, then implementations, followed by callers, and finally tests. This sequencing prevents breaking changes by updating dependencies systematically from foundational definitions outward.

How do I inspect incoming and outgoing references for a symbol during a refactor?

Use context queries to inspect incoming and outgoing references for a symbol. This reviews how the symbol is used across the codebase, ensuring all affected areas are captured before proceeding with file moves or splits.

Can I plan refactors across multiple interdependent components at the same time?

Yes, refactors can be planned across multiple interdependent components simultaneously. Dependency mapping coordinates changes across the entire codebase, ensuring splits and moves are tracked comprehensively rather than in isolation.

Why do I need to run impact analysis when the codebase index is stale?

Running impact analysis when the index is stale ensures accurate dependency mapping. A stale index may miss recently modified references, leading to incomplete blast-radius calculations and unsafe refactor execution.