gitnexus-impact-analysis

Analyzes code change blast radius and dependency impact using GitNexus symbol graphs.

1|Updated Oct 11, 2025
One-click install
npx skills add https://github.com/ibytechaos/claude --skill gitnexus-impact-analysis-ibytechaos
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gitnexus-impact-analysis
Source: https://github.com/ibytechaos/claude/tree/main/plugins/gitnexus/skills/gitnexus-impact-analysis
Command: npx skills add https://github.com/ibytechaos/claude --skill gitnexus-impact-analysis-ibytechaos

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires gitnexus.

What problem does it solve? Before editing code, developers often cannot tell which functions, callers, and execution flows will break. This Skill answers "is it safe to change X?" by mapping the blast radius of a symbol through the GitNexus dependency graph. ## Core Features & Use Cases - Upstream Impact Analysis: Runs gitnexus_impact to list direct callers (d=1, will break) and indirect dependents (d=2/d=3) with confidence scores. - Pre-Commit Change Detection: Uses gitnexus_detect_changes on staged git changes to map edits to affected execution processes and assign a risk level. - Risk Assessment Framework: Classifies results as LOW, MEDIUM, HIGH, or CRITICAL based on affected symbol counts, processes, and critical paths like auth or payments. - Use Case: Before renaming a shared validateUser function, run the impact workflow to discover that loginHandler and apiMiddleware call it directly and that the LoginFlow process is affected, then decide whether the change is safe. ## Quick Start Ask the assistant to check what will break if you change a specific function, for example: "What depends on validateUser and is it safe to modify it?"

Frequently Asked Questions about gitnexus-impact-analysis

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

FAQPage Schema
How do I check what will break before changing a function?

Run gitnexus_impact with the target symbol and direction set to upstream. It returns direct callers at depth 1 that will break, plus indirect dependents at depths 2 and 3 with confidence scores, so you can assess the blast radius before editing.

How to analyze the impact of staged git changes before committing?

Use gitnexus_detect_changes with scope set to staged. It maps your current git diff to affected symbols and execution processes, then reports a risk level such as LOW, MEDIUM, or HIGH based on how many flows are touched.

What does the GitNexus impact analysis require to work?

It requires the GitNexus MCP server, started with npx gitnexus mcp, and a current repository index. If the index is stale, run npx gitnexus analyze in the terminal to rebuild it before querying.

Why does GitNexus report that the index is stale?

The index becomes stale when the codebase changes after the last analysis run. Rebuild it by running npx gitnexus analyze in the repository root, then retry the impact or detect_changes query.

What do depth levels d=1, d=2, and d=3 mean in impact results?

Depth indicates dependency distance from the target symbol. d=1 items are direct callers that will break, d=2 items are indirect dependents likely affected, and d=3 items are transitive effects that may need testing.