gitnexus-refactoring

Rename, extract, split, or move code with dependency-aware impact analysis.

Updated Dec 15, 2025
One-click install
npx skills add https://github.com/fpt-devteam/app-backtrack --skill gitnexus-refactoring-fpt-devteam
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gitnexus-refactoring
Source: https://github.com/fpt-devteam/app-backtrack/tree/main/.agents/skills/gitnexus/gitnexus-refactoring
Command: npx skills add https://github.com/fpt-devteam/app-backtrack --skill gitnexus-refactoring-fpt-devteam

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Safe and controlled code refactoring with GitNexus that minimizes breakage by mapping impact, updating dependent code, and guiding developers through extraction, renaming, and restructuring tasks.

Core Features & Use Cases

  • Safe symbol renaming with dependency-aware updates
  • Module extraction and service splitting
  • Move and restructure code with validated imports and references
  • Guidance workflow for planning changes and rollback readiness

Quick Start

Run gitnexus_rename to rename a symbol safely, then review graph edits before applying changes.

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 code symbol across multiple files?

To safely rename a code symbol across multiple files, use dependency graphs to map impact and update all downstream callers. This prevents breakage by validating references and reviewing graph edits before applying changes.

What is dependency-aware refactoring and when do I need it?

Dependency-aware refactoring uses static analysis to map upstream and downstream code relationships before modifying structures. You need it when extracting modules or splitting services to ensure multi-file changes do not break existing callers.

How do I split a module and restructure code without breaking imports?

To split a module without breaking imports, follow a prescribed execution order updating interfaces, implementations, and callers. Validate references using impact analysis to ensure safe extraction and maintain rollback readiness.

Can I move code and extract services for large software projects?

Yes, you can move and extract services for large software projects using dependency graphs and context queries. This supports safe multi-file restructuring by validating imports and guiding developers through prescribed plan execution.

What is the best way to plan a code refactor and ensure rollback readiness?

The best way to plan a code refactor is using a guidance workflow that maps dependency impacts and prescribes execution order for interfaces, implementations, callers, and tests. This ensures controlled restructuring and rollback readiness.

Why does renaming a function break its callers and how do I fix it?

Renaming a function breaks callers when downstream dependencies are not updated. Fix this by applying static analysis to map the impact, updating all references across files, and validating imports before applying changes.