understand-diff

What problem does it solve?

Developers and reviewers often struggle to understand the full impact of code changes across a codebase; this Skill connects git diffs and PRs to a precomputed knowledge graph so you can quickly see what changed, what depends on it, and where to focus review and testing effort.

Core Features & Use Cases

• Changed component discovery: Locate file, function, and class nodes in the knowledge graph that correspond to changed file paths.
• One-hop impact analysis: Find upstream callers and downstream dependencies via edges to surface affected components and estimate blast radius.
• Risk assessment & layers: Report affected architectural layers, complexity-based risk scoring, and reviewer guidance for high-impact changes.
• Dashboard overlay generation: Emit a structured diff-overlay JSON for visualizing changed and affected nodes in the understand-anything dashboard.
• Use Case: Use on a feature branch or PR to prioritize code review, identify integration risks, and generate a dashboard overlay for cross-team communication.

Quick Start

Run the understand-diff skill against the current branch to list changed files, matched knowledge-graph node IDs, one-hop affected components, risk notes, and produce the diff overlay file.